001: /*
002: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
003: *
004: * Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
005: *
006: * The contents of this file are subject to the terms of either the GNU
007: * General Public License Version 2 only ("GPL") or the Common
008: * Development and Distribution License("CDDL") (collectively, the
009: * "License"). You may not use this file except in compliance with the
010: * License. You can obtain a copy of the License at
011: * http://www.netbeans.org/cddl-gplv2.html
012: * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
013: * specific language governing permissions and limitations under the
014: * License. When distributing the software, include this License Header
015: * Notice in each file and include the License file at
016: * nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
017: * particular file as subject to the "Classpath" exception as provided
018: * by Sun in the GPL Version 2 section of the License file that
019: * accompanied this code. If applicable, add the following below the
020: * License Header, with the fields enclosed by brackets [] replaced by
021: * your own identifying information:
022: * "Portions Copyrighted [year] [name of copyright owner]"
023: *
024: * Contributor(s):
025: *
026: * The Original Software is NetBeans. The Initial Developer of the Original
027: * Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
028: * Microsystems, Inc. All Rights Reserved.
029: *
030: * If you wish your version of this file to be governed by only the CDDL
031: * or only the GPL Version 2, indicate your decision by adding
032: * "[Contributor] elects to include this software in this distribution
033: * under the [CDDL or GPL Version 2] license." If you do not indicate a
034: * single choice of license, a recipient has the option to distribute
035: * your version of this file under either the CDDL, the GPL Version 2 or
036: * to extend the choice of license to its licensees as provided above.
037: * However, if you add GPL Version 2 code and therefore, elected the GPL
038: * Version 2 license, then the option applies only if the new code is
039: * made subject to such option by the copyright holder.
040: */
041:
042: package org.netbeans.test.web;
043:
044: /**
045: * A class taht may be used for waiting e.g. for a event.
046: * <p>
047: * For example:
048: * <p><code><pre>
049: * Observable obs;
050: * final Waiter waiter = new Waiter();
051: * final PropertyChangeListener pcl = new PropertyChangeListener() {
052: * public void propertyChange(PropertyChangeEvent evt) {
053: * if (evt.getPropertyName().equals("..")) {
054: * waiter.notifyFinished();
055: * }
056: * }
057: * };
058: * obs.addPropertyChangeListener(pcl);
059: * // ...
060: * waiter.waitFinished();
061: * obs.removePropertyChangeListener(pcl);
062: * </pre></code>
063: * <p>
064: *
065: * @author ms113234
066: */
067: public class Waiter {
068:
069: private boolean finished = false;
070:
071: /** Restarts Synchronizer.
072: */
073: public void init() {
074: synchronized (this ) {
075: finished = false;
076: }
077: }
078:
079: /** Wait until the task is finished.
080: */
081: public void waitFinished() throws InterruptedException {
082: synchronized (this ) {
083: while (!finished) {
084: wait();
085: }
086: }
087: }
088:
089: /** Wait until the task is finished, but only a given time.
090: * @param milliseconds time in milliseconds to wait
091: * @return true if the task is really finished, or false if the time out
092: * has been exceeded
093: */
094: public boolean waitFinished(long milliseconds)
095: throws InterruptedException {
096: synchronized (this ) {
097: if (finished)
098: return true;
099: long expectedEnd = System.currentTimeMillis()
100: + milliseconds;
101: for (;;) {
102: wait(milliseconds);
103: if (finished)
104: return true;
105: long now = System.currentTimeMillis();
106: if (now >= expectedEnd)
107: return false;
108: milliseconds = expectedEnd - now;
109: }
110: }
111: }
112:
113: /** Notify all waiters that this task has finished.
114: */
115: public void notifyFinished() {
116: synchronized (this ) {
117: finished = true;
118: notifyAll();
119: }
120: }
121: }
|