001    /**
002     *
003     * Copyright 2006 The Apache Software Foundation
004     *
005     *  Licensed under the Apache License, Version 2.0 (the "License");
006     *  you may not use this file except in compliance with the License.
007     *  You may obtain a copy of the License at
008     *
009     *     http://www.apache.org/licenses/LICENSE-2.0
010     *
011     *  Unless required by applicable law or agreed to in writing, software
012     *  distributed under the License is distributed on an "AS IS" BASIS,
013     *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014     *  See the License for the specific language governing permissions and
015     *  limitations under the License.
016     */
017    
018    //
019    // This source code implements specifications defined by the BEA and IBM.
020    // For more information, see:
021    //    http://dev2dev.bea.com/technologies/commonj/index.jsp
022    // or
023    //    http://www.ibm.com/developerworks/library/j-commonj-sdowmt
024    //
025    // In order to remain compliant with the specification
026    // DO NOT add / change / or delete method signatures!
027    //
028    
029    package commonj.timers;
030    
031    import java.util.Date;
032    
033    /**
034     * @version $Rev: 46019 $ $Date: 2004-09-14 05:56:06 -0400 (Tue, 14 Sep 2004) $
035     */
036    public interface TimerManager {
037    
038        static final long IMMEDIATE = 0;
039        static final long INDEFINITE = java.lang.Long.MAX_VALUE;
040    
041        boolean isStopped();
042    
043        boolean isStopping();
044    
045        boolean isSuspended() throws IllegalStateException;
046    
047        boolean isSuspending() throws IllegalStateException;
048    
049        void resume() throws IllegalStateException;
050    
051        Timer schedule(TimerListener listener, long delayInMillis)
052            throws IllegalStateException, IllegalArgumentException;
053    
054        Timer schedule(TimerListener listener, long delayInMillis, long repeatIntervalInMillis)
055            throws IllegalStateException, IllegalArgumentException;
056    
057        Timer schedule(TimerListener listener, Date scheduleDate)
058            throws IllegalStateException, IllegalArgumentException;
059    
060        Timer schedule(TimerListener listener, Date scheduleDate, long repeatIntervalInMillis)
061            throws IllegalStateException, IllegalArgumentException;
062    
063        Timer scheduleAtFixedRate(TimerListener listener, long delayInMillis, long repeatIntervalInMillis)
064            throws IllegalStateException, IllegalArgumentException;
065    
066        Timer scheduleAtFixedRate(TimerListener listener, Date scheduleDate, long repeatIntervalInMillis)
067            throws IllegalStateException, IllegalArgumentException;
068    
069        void stop() throws IllegalStateException;
070    
071        void suspend() throws IllegalStateException;
072    
073        boolean waitForStop(long timeOut)
074            throws InterruptedException, IllegalArgumentException;
075    
076        boolean waitForSuspend(long timOut)
077            throws InterruptedException, IllegalStateException, IllegalArgumentException;
078    
079    }