package com.wonders.week01.object;

/**
 * JDK1.7
 * wait()
 * (1)java.lang.Object
 * (2)权限访问修饰符是public
 * (3)无返回值
 * (4)是final修饰的方法，不可以被重写
 * (5)如果当前线程不是对象监听器上的所有者，则会抛出 异常IllegalMonitorStateException 
 * (6)如果当前线程之前或者在当前线程正在等待通知的时候被任何线程中断，当异常InterruptedException被抛出的时候，
 * 当前线程的中断状态会被清除。
 * (7)直到另一个线程调用notify或者notifyAll方法后这个线程才可以不用继续等待。换句话就是,该方法的行为与执行调用wait(0)完全相同。
 * (8)当前的线程必须拥有对象的监听器。线程放弃了当前对象的监听器的所有权，并且在等待另一个线程来唤醒在对象监听器上正在等待的线程，通过调用
 * notify或者notifAll方法来唤醒线程。直到线程获得对象监听器的所有权并且可以恢复执行之前，线程会一直处于等待状态。
 * (9)中断线程和假的唤醒线程是有可能的，这个方法应该总会被用于循环之中：
 * synchronized (obj) {
 *       while (<condition does not hold>)
 *            obj.wait();
 *        ... // Perform action appropriate to condition
 *    }
 * 这个方法只能被当前对象上的线程所有者调用,
 * @author liyongyong
 *
 */
public class WaitTest {

	/**
	 * wait(long timeout)
	 * (1)java.lang.Object
	 * (2)权限访问修饰符是public
	 * (3)无返回值
	 * (4)是final修饰的方法，不可以被重写
	 * (5)导致当前线程等待，直到另一个线程调用该对象的notify()方法或notifyAll()方法
	 * (6)当前线程必须有自己的对象监听器。
	 * (7)该方法导致当前线程(call it T)将自己放置在该对象的等待设置中，然后放弃所有关于该对象的同步声明,根据线程的时序安排，线程T是不可以使用的，
	 * 并且会一直处于睡眠状态，直到下面四种情况发生时：
	 * (a)这个对象的其他线程调用了notify方法,恰巧线程T被选择为即将唤醒的线程。
	 * (b)这个对象的其他线程调用了notify方法
	 * (c)一些其它的线程中断了线程T
	 * (d)或多或少已经有一些时间过去了,然而，如果时间超时，那么真实的时间将不会被考虑直到该线程被唤醒。
	 * (8)然后将线程T从该对象的等待设置中删除，并为线程调度重新启用。然后接着和其他线程用普通的方式争取同步对象的权力。
	 * 所有关于对象的同步声明都会被存储到之前的状态中，一直到调用wait方法的时候。通过调用wait方法线程T就可以返回了。
	 * 因此，关于从wait方法返回时，对象和线程T的同步状态与调用wait方法时完全一样。
	 * (9)除了notify，中断和超时可以唤醒线程外，线程还可以被虚假唤醒。实际中虚假唤醒线程是很少出现的。应用程序必须对其进行测试，以测试导致线程被唤醒的条件，
	 * 并在条件不满足的情况下继续等待。换句话说，wait应该总出现在循环中,像下面这个:
	 * synchronized (obj) {
     *    while (<condition does not hold>)
     *        obj.wait(timeout);
     *    ... // Perform action appropriate to condition
     *}
	 *(10)如果当前线程在等待时被任何线程打断,则会抛出异常InterruptedException。这个异常直到对象的锁的状态恢复的时候才会抛出。
	 *(11)注意wait方法，当它将当前线程放到该对象的等待设置中，仅仅只有该对象没有被锁住;当线程等待的时候,当前线程可能同步的任何其他对象仍然被锁定.
	 *(12)该方法只能由一个线程调用，该线程是该对象监视器的所有者. 
	 *(13)参数timeout:在毫秒内等待的最长时间
	 *(14)抛出的异常
	 *(a)如果参数的值是一个负数就会抛出异常IllegalArgumentException
	 *(b)如果当前线程不是对象的监听器则会抛出异常IllegalMonitorStateException
	 *(c)如果任何线程在当前线程等待通知之前中断了当前线程。当抛出这个异常时，当前线程的中断状态被清除,会抛出异常InterruptedException 。
	 */
	
	/**
	 * wait(long timeout,int nanos)
	 * (1)java.lang.Object
	 * (2)权限访问修饰符是public
	 * (3)无返回值
	 * (4)是final修饰的方法，不可以被重写
	 * (5)方法的参数
	 * (a)timeout:在毫秒内等待的最长时间
	 * (b)nanos:额外的时间，在纳秒范围0 - 999999
	 * (6)抛出的异常
	 * (a)如果参数的值是一个负数就会抛出异常IllegalArgumentException
	 * (b)如果当前线程不是对象的监听器则会抛出异常IllegalMonitorStateException
	 * (c)如果任何线程在当前线程等待通知之前中断了当前线程。当抛出这个异常时，当前线程的中断状态被清除,会抛出异常InterruptedException 。
	 * (7)导致当前线程等待，直到另一个线程调用该对象的notify()方法或notifyAll()方法，或者其他线程中断当前线程.
	 * (8)这个方法和带有一个参数的wait方法是很类似的,但是它允许对于放弃等待唤醒的时间长短有更好的控制。真正的时间是以纳秒级别来计算的,计算公式：1000000*timeout+nanos
	 * (9)在所有的其他层面,该方法和wait(long)这个方法做的是相同的事情,其中wait(0,0)和wait(0)是等价的。
	 * (10)当前线程必须要有自己的事件监听对象。线程将释放该监视器的所有权，并等待直到发生以下两个条件：
	 * (a)另一个线程通知等待这个对象监视器上的线程，通过调用notify方法或notifyAll方法来唤醒它们。
	 * (b)超时时间(以超时毫秒为单位)加上nanos nanoseconds参数，已经过去了.
	 * (11)然后线程等待，直到它重新获得监视器的所有权并恢复执行
	 * (12)中断和虚假唤醒线程是可能的，而且这个方法应该总是在一个循环中使用：
	 * synchronized (obj) {
     *    while (<condition does not hold>)
     *        obj.wait(timeout, nanos);
     *    ... // Perform action appropriate to condition
     *	}
     *(13)该方法只能由一个线程调用，该线程是该对象监视器的所有者
	 */
}