Previous | Next | Trail Map | Writing Java Programs | Using System Resources


Miscellaneous System Methods

Copying Arrays

Use System's arraycopy() method to copy data from one array into another. The arraycopy() method requires five arguments:
public static
    void arraycopy(Object source_array,
                   int src_location,
                   Object destination_array,
                   int dest_location,
                   int length,

The two Object arguments indicate the array to copy from and the array to copy to. The three integer arguments indicate the starting location in each the source and the destination array, and the number of elements to copy. This diagram illustrates how the copy takes place:

[PENDING: picture of array]

The following program uses arraycopy() to copy some elements from the copyFrom array to the copyToarray.

class ArrayCopyTest {
    public static void main(String args[]) {
        byte copyFrom[] = { 'h', 'e', 'l', 'l', 'o', ' ', 'w', 'o', 'r', 'l', 'd' };
        byte copyTo[] = new byte[5];

        System.arraycopy(copyFrom, 6, copyTo, 0, 5);
        System.out.println(new String(copyTo, 0));
    }
}
The arraycopy() method call in this example program begins the copy at element number 6 in the source array--remember that array indices start at 0 so that the copy begins at the array element 'w'. The arraycopy() method call puts the copied elements into the destination array beginning at the first element (element 0) in the destination array copyTo. The copy copies 5 elements: 'w', 'o', 'r', 'l', and 'd'. Effectively, the arraycopy() method copies the "world" part of copyFrom into copyTo, like this:

[PENDING: picture of array]

Note that the destination array must be allocated before you call arraycopy() and

Getting the Current Time

The currentTimeMillis() method returns the current time in milliseconds since 00:00:00 UTC, January 1, 1970. The currentTimeMillis() method is commonly used during performance tests: get the current time, perform the operation that you want to time, get the current time again--the difference in the two time samples is "roughly" the amount of time that the operation took to perform.

Often in graphical user interfaces the time difference between mouse clicks is used to determine whether a user double clicked in the window. The following applet uses currentTimeMillis() to compute the number of milliseconds between two mouse clicks. If the time period between the clicks is smaller than 200 milliseconds, the two mouse clicks are interpreted as a double mouse click.


Your browser doesn't understand the APPLET tag. Here's a screenshot of the TimingIsEverything applet that you would see running here if it did:


Here's the source for the TimingIsEverything applet shown above.

You could use the return value from this method to compute the current date and time. However, you'll probably find that it's more convenient to get the current date and time from the Date class.


Note: Previous versions of the System class support two other time-related methods besides the currentTimeMillis() method: currentTime() and nowMillis(). These two methods are now obsolete--you should use currentTimeMillis() instead. currentTime() and nowMillis() are no longer supported.

Exiting the Runtime Environment

To exit the Java interpreter, call the System.exit() method. You pass an integer exit code to the exit() method, and the interpreter exits with that exit code.
Note: The exit() method causes the Java interpreter to exit, not just your Java program. You should use this function with caution, particularly in applets.

Setting and Getting the Security Manager

The security manager is an object that enforces a certain security policy for a Java application. You can change the current security manager for your applications using System's setSecurityManager() method, and you can retrieve the current security manager using System's getSecurityManager() method.

Providing Your Own Security Manager(in the Networking trail)discusses security managers in detail and shows you how to create and install your own security manager using these two System methods.


Note: Applets cannot change the security manager. [PENDING: can they "get" it?] The security manager for applets is created and managed by the application in which the applet is running.

See also

java.lang.SecurityManager


Previous | Next | Trail Map | Writing Java Programs | Using System Resources