youys
/
ant
Not watched
1
0
Fork 1
Code
Releases 0 Wiki Activity
Issues 0 Pull Requests 0 Datasets Model Cloudbrain
Browse Source

new files for new <sleep> task. 

Submitted by:	Steve Loughran <steve_l@iseran.com>


git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@269211 13f79535-47bb-0310-9956-ffa450edef68
master
Stefan Bodewig 24 years ago
parent
8a23eb5f56
commit
a26511e231
4 changed files with 462 additions and 0 deletions
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. +71
    -0
      docs/manual/CoreTasks/sleep.html
  2. +30
    -0
      src/etc/testcases/taskdefs/sleep.xml
  3. +215
    -0
      src/main/org/apache/tools/ant/taskdefs/Sleep.java
  4. +146
    -0
      src/testcases/org/apache/tools/ant/taskdefs/SleepTest.java

+ 71
- 0
docs/manual/CoreTasks/sleep.html View File

@@ -0,0 +1,71 @@
<html>

<head>
<title>Sleep</title>
</head>

<body>

<h2><a name="sleep">Sleep</a></h2>
<h3>Description</h3>
<p> A task for sleeping a short period of time, useful when a build or deployment
process requires an interval between tasks.</p>

<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
<td align="center" valign="top"><b>Required</b></td>
</tr>
<tr>
<td valign="top">hours</td>
<td valign="top">hours to to add to the sleep time</td>
<td valign="top" align="center">No</td>
</tr>
<tr>
<td valign="top">minutes</td>
<td valign="top"> minutes to add to the sleep time</td>
<td valign="top" align="center">No</td>
</tr>
<tr>
<td valign="top">seconds</td>
<td valign="top">seconds to add to the sleep time</td>
<td align="center" valign="top">No</td>
</tr>
<tr>
<td valign="top">milliseconds</td>
<td valign="top">milliseconds to add to the sleep time</td>
<td align="center" valign="top">No</td>
</tr>
<tr>
<td valign="top">failonerror</td>
<td valign="top">flag controlling whether to break the build on an error.
</td>
<td align="center" valign="top">No</td>
</tr>
</table>
<p>The sleep time is the sum of specified values, hours, minutes seconds and milliseconds.
A negative value can be supplied to any of them provided the total sleep time
is positive</p>
<p>Note that sleep times are always hints to be interpred by the OS how it feels
- small times may either be ignored or rounded up to a minimum timeslice. Note
also that the system clocks often have a fairly low granularity too, which complicates
measuring how long a sleep actually took.</p>
<h3>Examples</h3>
<pre> &lt;sleep milliseconds=&quot;10&quot;/&gt;</pre>
Sleep for about 10 mS.
<pre> &lt;sleep seconds=&quot;2&quot;/&gt;</pre>
Sleep for about 2 seconds.
<pre> &lt;sleep minutes=&quot;-59&quot; seconds=&quot;-58&quot;/&gt;</pre>
<p>Sleep for -one hour less 59:58, or two seconds again </p>
<pre> &lt;sleep /&gt;</pre>
Sleep for no time at all. This may yield the CPU time to another thread or process.
<hr>

<p align="center">Copyright &copy; 2000,2001 Apache Software Foundation. All rights
Reserved.</p>

</body>
</html>


+ 30
- 0
src/etc/testcases/taskdefs/sleep.xml View File

@@ -0,0 +1,30 @@
<project name="sleeptest" default="all" >

<target name="test1">
<sleep />
</target>

<target name="test2">
<sleep milliseconds="10"/>
</target>

<target name="test3">
<sleep seconds="2"/>
</target>

<target name="test4">
<sleep hours="1" minutes="-59" seconds="-58"/>
</target>

<target name="test5">
<sleep minutes="-59" seconds="-58"/>
</target>

<target name="test6">
<sleep minutes="-59" seconds="-58" failonerror="no"/>
</target>

<target name="all"
depends="test1,test2,test3,test4,test5" />

</project>

+ 215
- 0
src/main/org/apache/tools/ant/taskdefs/Sleep.java View File

@@ -0,0 +1,215 @@
/*
* The Apache Software License, Version 1.1
*
* Copyright (c) 2001 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The end-user documentation included with the redistribution, if
* any, must include the following acknowlegement:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowlegement may appear in the software itself,
* if and wherever such third-party acknowlegements normally appear.
*
* 4. The names "The Jakarta Project", "Ant", and "Apache Software
* Foundation" must not be used to endorse or promote products derived
* from this software without prior written permission. For written
* permission, please contact apache@apache.org.
*
* 5. Products derived from this software may not be called "Apache"
* nor may "Apache" appear in their names without prior written
* permission of the Apache Group.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation. For more
* information on the Apache Software Foundation, please see
* <http://www.apache.org/>.
*/

package org.apache.tools.ant.taskdefs;

import org.apache.tools.ant.Project;
import org.apache.tools.ant.Task;
import org.apache.tools.ant.BuildException;

/**
* A task to sleep for a period of time
*
* @author steve_l@iseran.com steve loughran
* @created 01 May 2001
*/

public class Sleep extends Task {
/**
* failure flag
*/
private boolean failOnError = true;

/**
* Description of the Field
*/
private int seconds = 0;
/**
* Description of the Field
*/
private int hours = 0;
/**
* Description of the Field
*/
private int minutes = 0;
/**
* Description of the Field
*/
private int milliseconds = 0;



/**
* Creates new instance
*/
public Sleep() {
}


/**
* Sets the Seconds attribute of the Sleep object
*
* @param seconds The new Seconds value
*/
public void setSeconds(int seconds) {
this.seconds = seconds;
}


/**
* Sets the Hours attribute of the Sleep object
*
* @param hours The new Hours value
*/
public void setHours(int hours) {
this.hours = hours;
}


/**
* Sets the Minutes attribute of the Sleep object
*
* @param minutes The new Minutes value
*/
public void setMinutes(int minutes) {
this.minutes = minutes;
}


/**
* Sets the Milliseconds attribute of the Sleep object
*
* @param milliseconds The new Milliseconds value
*/
public void setMilliseconds(int milliseconds) {
this.milliseconds = milliseconds;
}


/**
* sleep for a period of time
*
* @param millis time to sleep
*/
public void doSleep(long millis) {
try {
Thread.currentThread().sleep(millis);
}
catch (InterruptedException ie) {
}
}


/**
* Sets the FailOnError attribute of the MimeMail object
*
* @param failOnError The new FailOnError value
*/
public void setFailOnError(boolean failOnError) {
this.failOnError = failOnError;
}


/**
* return time to sleep
*
* @return sleep time. if below 0 then there is an error
*/

private long getSleepTime() {
return ((((long) hours * 60) + minutes) * 60 + seconds) * 1000 + milliseconds;
}


/**
* verify parameters
*
* @throws BuildException if something is invalid
*/
public void validate() {
long sleepTime = getSleepTime();
if (getSleepTime() < 0) {
throw new BuildException("Negative sleep periods are not supported");
}
}


/**
* Executes this build task. throws org.apache.tools.ant.BuildException
* if there is an error during task execution.
*
* @exception BuildException Description of Exception
*/
public void execute()
throws BuildException {
try {
validate();
long sleepTime=getSleepTime();
log("sleeping for "+sleepTime+" milliseconds",
Project.MSG_VERBOSE);
doSleep(sleepTime);
}
catch (Exception e) {
if (failOnError) {
throw new BuildException(e);
}
else {
String text = e.toString();
log(text, Project.MSG_ERR);
}
}
}

}


+ 146
- 0
src/testcases/org/apache/tools/ant/taskdefs/SleepTest.java View File

@@ -0,0 +1,146 @@
/*
* The Apache Software License, Version 1.1
*
* Copyright (c) 2001 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The end-user documentation included with the redistribution, if
* any, must include the following acknowlegement:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowlegement may appear in the software itself,
* if and wherever such third-party acknowlegements normally appear.
*
* 4. The names "The Jakarta Project", "Ant", and "Apache Software
* Foundation" must not be used to endorse or promote products derived
* from this software without prior written permission. For written
* permission, please contact apache@apache.org.
*
* 5. Products derived from this software may not be called "Apache"
* nor may "Apache" appear in their names without prior written
* permission of the Apache Group.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation. For more
* information on the Apache Software Foundation, please see
* <http://www.apache.org/>.
*/

package org.apache.tools.ant.taskdefs;

/**
* @author steve_l@iseran.com steve loughran
* @created 01 May 2001
*/
public class SleepTest extends TaskdefsTest {


private final static String TASKDEFS_DIR = "src/etc/testcases/taskdefs/";
private final static boolean TRACE=false;

public SleepTest(String name) {
super(name);
}

public void setUp() {
configureProject(TASKDEFS_DIR + "sleep.xml");
}

public void test1() {
Timer timer=new Timer();
executeTarget("test1");
timer.stop();
if(TRACE) System.out.println(" test1 elapsed time="+timer.time());
assert(timer.time()>=0);
}

public void test2() {
Timer timer=new Timer();
executeTarget("test2");
timer.stop();
if(TRACE) System.out.println(" test2 elapsed time="+timer.time());
assert(timer.time()>=0);
}

public void test3() {
Timer timer=new Timer();
executeTarget("test3");
timer.stop();
if(TRACE) System.out.println(" test3 elapsed time="+timer.time());
assert(timer.time()>=2000);
}

public void test4() {
Timer timer=new Timer();
executeTarget("test3");
timer.stop();
if(TRACE) System.out.println(" test4 elapsed time="+timer.time());
assert(timer.time()>=2000 && timer.time()<60000);
}

public void test5() {
expectBuildException("test5",
"Negative sleep periods are not supported");
}

public void test6() {
Timer timer=new Timer();
executeTarget("test6");
timer.stop();
if(TRACE) System.out.println(" test6 elapsed time="+timer.time());
assert(timer.time()<2000);
}


/**
* inner timer class
*/
private static class Timer {
long start=0;
long stop=0;

public Timer() {
start();
}

public void start() {
start=System.currentTimeMillis();
}

public void stop() {
stop=System.currentTimeMillis();
}

public long time() {
return stop-start;
}
}

}


Write Preview
Loading…
Cancel
Save
Please read the following content carefully:

Dear OpenI User

Thank you for your continuous support to the Openl Qizhi Community AI Collaboration Platform. In order to protect your usage rights and ensure network security, we updated the Openl Qizhi Community AI Collaboration Platform Usage Agreement in January 2024. The updated agreement specifies that users are prohibited from using intranet penetration tools. After you click "Agree and continue", you can continue to use our services. Thank you for your cooperation and understanding.

For more agreement content, please refer to the《Openl Qizhi Community AI Collaboration Platform Usage Agreement》

Agree and continue
Disagree, exit