DOCUMENTATION COMMENTS

Example

18.5

/**

 * Returns a String that represents this Object.

 * It is recommended that all subclasses override

 * this method.

 */

public String toString() {

return getClass().getName() + "@" +

Integer.toHexString(hashCode());

}

/**

 * Notifies a single waiting thread on a change in

 * condition of another thread. The thread effecting

 * the change notifies the waiting thread using notify().

 * Threads that want to wait for a condition to change

 * before proceeding can call wait(). 

 * The method notify() can be called only by the

 *

 * @exception

IllegalMonitorStateException If the

 *

current thread is not the owner

 *

of the Object s monitor lock.

 * @see

Object#wait

 * @see

Object#notifyAll

 */

public final native void notify();

/**

 * Notifies all the threads waiting for a condition to

 * change. Threads that are waiting are generally waiting

 * for another thread to change some condition. Thus, the

 * thread effecting a change that more than one thread is

 * waiting for notifies all the waiting threads using

 * the method notifyAll(). Threads that want to wait for

 * a condition to change before proceeding can call

 * wait(). 

 * The method notifyAll() can be called only by the

 *

 * @exception

IllegalMonitorStateException If the

 *

current thread is not the owner

 *

of the Object s monitor lock.

 * @see

Object#wait

 * @see

Object#notify

 */

public final native void notifyAll();

425