1 /*
2 * $Id: DefaultGroovyStaticMethods.java,v 1.5 2005/08/20 19:51:14 glaforge Exp $
3 *
4 * Copyright 2003 (C) James Strachan and Bob Mcwhirter. All Rights Reserved.
5 *
6 * Redistribution and use of this software and associated documentation
7 * ("Software"), with or without modification, are permitted provided that the
8 * following conditions are met:
9 * 1. Redistributions of source code must retain copyright statements and
10 * notices. Redistributions must also contain a copy of this document.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * 3. The name "groovy" must not be used to endorse or promote products
15 * derived from this Software without prior written permission of The Codehaus.
16 * For written permission, please contact info@codehaus.org.
17 * 4. Products derived from this Software may not be called "groovy" nor may
18 * "groovy" appear in their names without prior written permission of The
19 * Codehaus. "groovy" is a registered trademark of The Codehaus.
20 * 5. Due credit should be given to The Codehaus - http://groovy.codehaus.org/
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE CODEHAUS AND CONTRIBUTORS ``AS IS'' AND ANY
23 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
24 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
25 * DISCLAIMED. IN NO EVENT SHALL THE CODEHAUS OR ITS CONTRIBUTORS BE LIABLE FOR
26 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
28 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
29 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
32 * DAMAGE.
33 *
34 */
35 package org.codehaus.groovy.runtime;
36
37 import groovy.lang.Closure;
38
39 import java.util.regex.Matcher;
40
41 /***
42 * This class defines all the new static groovy methods which appear on normal JDK
43 * classes inside the Groovy environment. Static methods are used with the
44 * first parameter as the destination class.
45 *
46 * @author Guillaume Laforge
47 * @author Dierk Koenig
48 * @version $Revision: 1.5 $
49 */
50 public class DefaultGroovyStaticMethods {
51
52 /***
53 * Start a Thread with the given closure as a Runnable instance.
54 *
55 * @param closure the Runnable closure
56 * @return the started thread
57 */
58 public static Thread start(Thread self, Closure closure) {
59 Thread thread = new Thread(closure);
60 thread.start();
61 return thread;
62 }
63
64 /***
65 * Start a daemon Thread with the given closure as a Runnable instance.
66 *
67 * @param closure the Runnable closure
68 * @return the started thread
69 */
70 public static Thread startDaemon(Thread self, Closure closure) {
71 Thread thread = new Thread(closure);
72 thread.setDaemon(true);
73 thread.start();
74 return thread;
75 }
76
77 /***
78 * Get the last hidden matcher that system used to do a match.
79 *
80 * @param matcher
81 * @return the last regex matcher
82 */
83 public static Matcher getLastMatcher(Matcher matcher) {
84 return RegexSupport.getLastMatcher();
85 }
86
87 /***
88 * Sleep for so many milliseconds, even if interrupted.
89 * @param object receiver
90 * @param milliseconds the number of milliseconds to sleep
91 */
92 public static void sleep(Object object, long milliseconds){
93 sleepImpl(object, milliseconds);
94 }
95
96 protected static void sleepImpl(Object object, long millis) {
97 long start = System.currentTimeMillis();
98 try {
99 Thread.sleep(millis);
100 } catch (InterruptedException e) {
101 long slept = System.currentTimeMillis() - start;
102 long rest = millis - slept;
103 if (rest > 0) sleepImpl(object, rest); // recursion to sleep the rest
104 }
105 }
106
107 /***
108 * Sleep for so many milliseconds
109 * @param object receiver
110 * @param milliseconds the number of milliseconds to sleep
111 * @param onInterrupt interrupt handler, InterruptedException is passed to the Closure
112 */
113 public static void sleep(Object object, long milliseconds, Closure onInterrupt){
114 try {
115 Thread.sleep(milliseconds);
116 } catch (InterruptedException e) {
117 onInterrupt.call(e);
118 }
119 }
120 }