java.lang.Object Class Reference

List of all members.


Detailed Description

This class must be implemented by the vm vendor.

Object is the root of the java class hierarchy. All non-base types respond to the messages defined in this class.

Public Member Functions

 Object ()
 Constructs a new instance of this class.
boolean equals (Object o)
 Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
final Class<?extends ObjectgetClass ()
 Answers the unique instance of java.lang.Class which represents the class of the receiver.
int hashCode ()
 Answers an integer hash code for the receiver.
final void notify ()
 Causes one thread which is wait ing on the receiver to be made ready to run.
final void notifyAll ()
 Causes all threads which are wait ing on the receiver to be made ready to run.
String toString ()
 Answers a string containing a concise, human-readable description of the receiver.
final void wait () throws InterruptedException
 Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void wait (long time) throws InterruptedException
 Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void wait (long time, int frac) throws InterruptedException
 Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Protected Member Functions

Object clone () throws CloneNotSupportedException
 Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
void finalize () throws Throwable
 Called by the virtual machine when there are no longer any (non-weak) references to the receiver.


Constructor & Destructor Documentation

java.lang.Object.Object (  ) 

Constructs a new instance of this class.


Member Function Documentation

Object java.lang.Object.clone (  )  throws CloneNotSupportedException [protected]

Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.

Classes which wish to support cloning must specify that they implement the Cloneable interface, since the implementation checks for this.

Returns:
Object a shallow copy of this object.
Exceptions:
CloneNotSupportedException if the receiver's class does not implement the interface Cloneable.

boolean java.lang.Object.equals ( Object  o  ) 

Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.

The implementation in Object answers true only if the argument is the exact same object as the receiver (==).

Parameters:
o Object the object to compare with this object.
Returns:
boolean true if the object is the same as this object false if it is different from this object.
See also:
hashCode

void java.lang.Object.finalize (  )  throws Throwable [protected]

Called by the virtual machine when there are no longer any (non-weak) references to the receiver.

Subclasses can use this facility to guarantee that any associated resources are cleaned up before the receiver is garbage collected. Uncaught exceptions which are thrown during the running of the method cause it to terminate immediately, but are otherwise ignored.

Note: The virtual machine assumes that the implementation in class Object is empty.

Exceptions:
Throwable The virtual machine ignores any exceptions which are thrown during finalization.

final Class<? extends Object> java.lang.Object.getClass (  ) 

Answers the unique instance of java.lang.Class which represents the class of the receiver.

Returns:
Class the receiver's Class

int java.lang.Object.hashCode (  ) 

Answers an integer hash code for the receiver.

Any two objects which answer true when passed to .equals must answer the same value for this method.

Returns:
int the receiver's hash.
See also:
equals

final void java.lang.Object.notify (  ) 

Causes one thread which is wait ing on the receiver to be made ready to run.

This does not guarantee that the thread will immediately run. The method can only be invoked by a thread which owns the receiver's monitor.

See also:
notifyAll

wait()

wait(long)

wait(long,int)

java.lang.Thread

final void java.lang.Object.notifyAll (  ) 

Causes all threads which are wait ing on the receiver to be made ready to run.

The threads are scheduled according to their priorities as specified in class Thread. Between any two threads of the same priority the one which waited first will be the first thread that runs after being notified. The method can only be invoked by a thread which owns the receiver's monitor.

See also:
notify

wait()

wait(long)

wait(long,int)

java.lang.Thread

String java.lang.Object.toString (  ) 

Answers a string containing a concise, human-readable description of the receiver.

Returns:
String a printable representation for the receiver.

final void java.lang.Object.wait (  )  throws InterruptedException

Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).

The method can only be invoked by a thread which owns the receiver's monitor. A waiting thread can be sent interrupt() to cause it to prematurely stop waiting, so senders of wait should check that the condition they were waiting for has been met.

When the thread waits, it gives up ownership of the receiver's monitor. When it is notified (or interrupted) it re-acquires the monitor before it starts running.

Exceptions:
InterruptedException to interrupt the wait.
See also:
Thread.interrupt

notify

notifyAll

wait(long)

wait(long,int)

java.lang.Thread

final void java.lang.Object.wait ( long  time  )  throws InterruptedException

Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

The method can only be invoked by a thread which owns the receiver's monitor. A waiting thread can be sent interrupt() to cause it to prematurely stop waiting, so senders of wait should check that the condition they were waiting for has been met.

When the thread waits, it gives up ownership of the receiver's monitor. When it is notified (or interrupted) it re-acquires the monitor before it starts running.

Parameters:
time long The maximum time to wait in milliseconds.
Exceptions:
InterruptedException to interrupt the wait.
See also:
notify

notifyAll

wait()

wait(long,int)

java.lang.Thread

final void java.lang.Object.wait ( long  time,
int  frac 
) throws InterruptedException

Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

The method can only be invoked by a thread which owns the receiver's monitor. A waiting thread can be sent interrupt() to cause it to prematurely stop waiting, so senders of wait should check that the condition they were waiting for has been met.

When the thread waits, it gives up ownership of the receiver's monitor. When it is notified (or interrupted) it re-acquires the monitor before it starts running.

Parameters:
time long The maximum time to wait in milliseconds.
frac int The fraction of a mSec to wait, specified in nanoseconds.
Exceptions:
InterruptedException to interrupt the wait.
See also:
notify

notifyAll

wait()

wait(long)

java.lang.Thread


The documentation for this class was generated from the following file:

Genereated on Tue Dec 9 14:09:47 2008 by Doxygen.

(c) Copyright 2005, 2008 The Apache Software Foundation or its licensors, as applicable.