Timer (Java Platform SE 8 )

java.lang.Object
- javax.management.NotificationBroadcasterSupport
- - javax.management.timer.Timer

All Implemented Interfaces:

MBeanRegistration， NotificationBroadcaster， NotificationEmitter， TimerMBean
```
public class Timer
extends NotificationBroadcasterSupport
implements TimerMBean, MBeanRegistration
```
提供的定时器MBean实现。MBean发送定时器在指定的时间，唤醒所有听众注册接收通知报警定时器。
此类管理一个过时的计时器通知列表。一种方法允许用户添加/删除所需的多个通知。当一个定时器通知由定时器发出并变得过时，它会自动从定时器通知列表中删除。
additional定时器通知可以被添加到规则重复的通知。

注：
1. 当发送定时器通知时，定时器更新通知序列号，不论通知类型。
2. 定时器服务依赖于系统日期的主机的Timer类加载。听众可能如果他们的主机都有一个不同的系统日期收到不合时宜的通知。为了避免这样的问题，同步所有主机的系统日期，在那里需要时间。
3. 定期通知的默认行为是固定延迟执行，指定Timer。为了使用固定利率执行，使用重载addNotification(String, String, Object, Date, long, long, boolean)方法。
4. 通知侦听器可能都在同一个线程中执行。因此，他们应该执行快速避免阻碍其他听众或扰动的固定延迟执行的规律。看到NotificationBroadcasterSupport。
从以下版本开始：

一点五

Field Summary

Fields
Modifier and Type	Field and Description
`static long`	`ONE_DAY` 一天中的毫秒数。
`static long`	`ONE_HOUR` 一小时内的毫秒数。
`static long`	`ONE_MINUTE` 一分钟内毫秒数。
`static long`	`ONE_SECOND` 一秒的毫秒数。
`static long`	`ONE_WEEK` 一周内的毫秒数。

构造方法摘要

构造方法
Constructor and Description
`Timer()` 默认构造函数。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Integer`	`addNotification(String type, String message, Object userData, Date date)` 创建一个新的具有指定 `type`定时器通知， `message`和 `userData`插入到一个给定的日期和一个空的时间和次数的通知列表。
`Integer`	`addNotification(String type, String message, Object userData, Date date, long period)` 创建一个新的具有指定 `type`定时器通知， `message`和 `userData`并把它插入到列表通知与一个给定的日期和时间和空的次数。
`Integer`	`addNotification(String type, String message, Object userData, Date date, long period, long nbOccurences)` 创建一个新的具有指定 `type`定时器通知， `message`和 `userData`并把它插入到列表通知与一个给定的日期，时间和次数。
`Integer`	`addNotification(String type, String message, Object userData, Date date, long period, long nbOccurences, boolean fixedRate)` 创建一个新的具有指定 `type`定时器通知， `message`和 `userData`并把它插入到列表通知与一个给定的日期，时间和次数。
`Vector<Integer>`	`getAllNotificationIDs()` 获取已注册到通知列表中的所有计时器通知标识符。
`Date`	`getDate(Integer id)` 获取与计时器通知相关联的日期的副本。
`Boolean`	`getFixedRate(Integer id)` 获取一个副本的指示标志是否定期通知是在固定延迟或固定利率执行。
`int`	`getNbNotifications()` 获取已注册到通知列表的计时器通知的数目。
`Long`	`getNbOccurences(Integer id)` 获取与计时器通知相关联的剩余数量的副本的副本。
`Vector<Integer>`	`getNotificationIDs(String type)` 获取对应于指定类型的定时器通知的所有标识符。
`MBeanNotificationInfo[]`	`getNotificationInfo()` 返回一个数组表示，每个通知MBean可能发送的通知和通知类型的java类的名称。
`String`	`getNotificationMessage(Integer id)` 获取对应于指定标识符的计时器通知详细信息。
`String`	`getNotificationType(Integer id)` 获取对应于指定标识符的计时器通知类型。
`Object`	`getNotificationUserData(Integer id)` 获取对应于指定标识符的计时器通知用户数据对象。
`Long`	`getPeriod(Integer id)` 获取与计时器通知相关联的期间（以毫秒为单位）的副本。
`boolean`	`getSendPastNotifications()` 获取指示计时器是否发送过去通知的标志。
`boolean`	`isActive()` 测试定时器MBean是活跃的。
`boolean`	`isEmpty()` 测试定时器通知列表是否为空。
`void`	`postDeregister()` 允许计时器MBean执行任何操作的MBean服务器被注册后需要。
`void`	`postRegister(Boolean registrationDone)` 允许计时器MBean执行任何操作在MBean服务器或注册后不需要注册后。
`void`	`preDeregister()` 允许计时器MBean执行任何需要的操作之前被注册的MBean服务器。
`ObjectName`	`preRegister(MBeanServer server, ObjectName name)` 允许计时器MBean执行任何操作之前，它需要在MBean服务器注册。
`void`	`removeAllNotifications()` 删除所有的定时器通知从通知单和重置定时器标识符用于更新通知柜台。
`void`	`removeNotification(Integer id)` 从通知列表中移除与指定的标识符相对应的计时器通知。
`void`	`removeNotifications(String type)` 从通知列表中移除对应于指定类型的所有计时器通知。
`void`	`setSendPastNotifications(boolean value)` 设置指示计时器是否发送过去通知或不发送的标志。
`void`	`start()` 启动定时器。
`void`	`stop()` 停止定时器。

Methods inherited from class javax.management.NotificationBroadcasterSupport
addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - ONE_SECOND
```
public static final long ONE_SECOND
```
    一秒的毫秒数。为 addNotification方法有用的常数。
    
    另请参见：
    
    Constant Field Values
  - ONE_MINUTE
```
public static final long ONE_MINUTE
```
    一分钟内毫秒数。为 addNotification方法有用的常数。
    
    另请参见：
    
    Constant Field Values
  - ONE_HOUR
```
public static final long ONE_HOUR
```
    一小时内的毫秒数。为 addNotification方法有用的常数。
    
    另请参见：
    
    Constant Field Values
  - ONE_DAY
```
public static final long ONE_DAY
```
    一天中的毫秒数。为 addNotification方法有用的常数。
    
    另请参见：
    
    Constant Field Values
  - ONE_WEEK
```
public static final long ONE_WEEK
```
    一周内的毫秒数。为 addNotification方法有用的常数。
    
    另请参见：
    
    Constant Field Values
- Constructor Detail
  - Timer
```
public Timer()
```
    默认构造函数。
- 方法详细信息
  - preRegister
```
public ObjectName preRegister(MBeanServer server,
                              ObjectName name)
                       throws 异常
```
    允许计时器MBean执行任何操作之前，它需要在MBean服务器注册。
    在这种情况下不使用。
    
    Specified by:
    
    preRegister 接口 MBeanRegistration
    
    参数
    
    server的MBean服务器的定时器将MBean注册。
    
    name -定时器MBean对象名称。
    
    结果
    
    定时器的MBean注册名称。
    
    异常
    
    异常
  - postRegister
```
public void postRegister(Boolean registrationDone)
```
    允许计时器MBean执行任何操作在MBean服务器或注册后不需要注册后。
    在这种情况下不使用。
    
    Specified by:
    
    postRegister 接口 MBeanRegistration
    
    参数
    
    registrationDone -指示是否MBean已在MBean服务器注册成功。价值错误意味着注册阶段已经失败。
  - preDeregister
```
public void preDeregister()
                   throws 异常
```
    允许计时器MBean执行任何需要的操作之前被注册的MBean服务器。
    停止定时器。
    
    Specified by:
    
    preDeregister 接口 MBeanRegistration
    
    异常
    
    异常
  - postDeregister
```
public void postDeregister()
```
    允许计时器MBean执行任何操作的MBean服务器被注册后需要。
    在这种情况下不使用。
    
    Specified by:
    
    postDeregister 接口 MBeanRegistration
  - getNotificationInfo
```
public MBeanNotificationInfo[] getNotificationInfo()
```
    从接口复制的描述： NotificationBroadcaster
    
    返回一个数组表示，每个通知MBean可能发送的通知和通知类型的java类的名称。
    
    对于MBean发送该数组中没有描述的通知不违法。然而，这个MBean服务器的一些客户可能取决于阵列完成其正确运作。
    
    Specified by:
    
    getNotificationInfo 接口 NotificationBroadcaster
    
    重写：
    
    getNotificationInfo 方法重写，继承类 NotificationBroadcasterSupport
    
    结果
    
    可能通知的数组。
  - start
```
public void start()
```
    启动定时器。
    如果有一个或多个定时器通知通知列表中的时间之前，通知发出根据sendPastNotifications国旗，然后，根据它的周期和事件更新剩余数。如果计时器通知日期仍然比当前日期早，则此通知只从通知列表中删除。
    
    Specified by:
    
    start 接口 TimerMBean
  - stop
```
public void stop()
```
    停止定时器。
    
    Specified by:
    
    stop 接口 TimerMBean
  - addNotification
```
public Integer addNotification(String type,
                               String message,
                               Object userData,
                               Date date,
                               long period,
                               long nbOccurences,
                               boolean fixedRate)
                        throws IllegalArgumentException
```
    创建一个新的具有指定 type定时器通知， message和 userData并把它插入到列表通知与一个给定的日期，时间和次数。
    如果要插入的计时器通知有一个在当前日期之前的日期，该方法的行为就好像指定日期是当前日期。
    一旦关闭通知，通知立即交付。定期通知
    ，第一通知立即交付和后续的参数指定的时间间隔。
    
    请注意，一旦定时器通知已被添加到通知列表中，其关联的日期、期间和出现的次数不能被更新。
    
    在一个周期的通知的情况下，参数固定收益值用于指定执行方案，指定Timer。
    
    Specified by:
    
    addNotification 接口 TimerMBean
    
    参数
    
    type -定时器通知类型。
    
    message -定时器通知的详细信息。
    
    userData -定时器通知用户数据对象。
    
    date时发生的日期通知。
    
    period -定时器的通知时间（毫秒）。
    
    nbOccurences总数的定时器的通知将发射。
    
    fixedRate -如果 true如果通知是周期性的，通知计划与执行方案固定利率。如果 false如果通知是周期性的，通知计划与执行方案固定延迟。忽略通知是不是周期性。
    
    结果
    
    新创建的计时器通知的标识符。
    
    异常
    
    IllegalArgumentException -日期 null或期间或出现的次数是负的。
    
    另请参见：
    
    addNotification(String, String, Object, Date, long, long)
  - addNotification
```
public Integer addNotification(String type,
                               String message,
                               Object userData,
                               Date date,
                               long period,
                               long nbOccurences)
                        throws IllegalArgumentException
```
    创建一个新的具有指定 type定时器通知， message和 userData并把它插入到列表通知与一个给定的日期，时间和次数。
    如果要插入的计时器通知有一个在当前日期之前的日期，该方法的行为就好像指定日期是当前日期。
    一旦关闭通知，通知立即交付。定期通知
    ，第一通知立即交付和后续的参数指定的时间间隔。
    
    请注意，一旦定时器通知已被添加到通知列表中，其关联的日期、期间和出现的次数不能被更新。
    
    在一个周期的通知的情况下，使用一个固定延迟执行方案，指定Timer。为了使用一个固定利率执行方案，而不是使用addNotification(String, String, Object, Date, long, long, boolean)。
    
    Specified by:
    
    addNotification 接口 TimerMBean
    
    参数
    
    type -定时器通知类型。
    
    message -定时器通知的详细信息。
    
    userData -定时器通知用户数据对象。
    
    date时发生的日期通知。
    
    period -定时器的通知时间（毫秒）。
    
    nbOccurences总数的定时器的通知将发射。
    
    结果
    
    新创建的计时器通知的标识符。
    
    异常
    
    IllegalArgumentException -日期 null或期间或出现的次数是负的。
    
    另请参见：
    
    addNotification(String, String, Object, Date, long, long, boolean)
  - addNotification
```
public Integer addNotification(String type,
                               String message,
                               Object userData,
                               Date date,
                               long period)
                        throws IllegalArgumentException
```
    创建一个新的具有指定 type定时器通知， message和 userData并把它插入到列表通知与一个给定的日期和时间和空的次数。
    定时器的通知将会不断重复使用的定时器周期使用固定延迟执行方案，指定Timer。为了使用一个固定利率执行方案，而不是使用addNotification(String, String, Object, Date, long, long, boolean)。
    
    如果要插入的计时器通知有一个在当前日期之前的日期，该方法的行为就好像指定日期是当前日期。第一通知立即发送，随后的通知按周期参数指定的间隔进行间隔开。
    
    Specified by:
    
    addNotification 接口 TimerMBean
    
    参数
    
    type -定时器通知类型。
    
    message -定时器通知的详细信息。
    
    userData -定时器通知用户数据对象。
    
    date时发生的日期通知。
    
    period -定时器的通知时间（毫秒）。
    
    结果
    
    新创建的计时器通知的标识符。
    
    异常
    
    IllegalArgumentException -日期 null或期负。
  - addNotification
```
public Integer addNotification(String type,
                               String message,
                               Object userData,
                               Date date)
                        throws IllegalArgumentException
```
    创建一个新的具有指定 type定时器通知， message和 userData插入到一个给定的日期和一个空的时间和次数的通知列表。
    定时器通知将在指定的日期处理一次。
    
    如果要插入的计时器通知有一个在当前日期之前的日期，该方法将表现为如果指定的日期是当前日期，并立即通知通知。
    
    Specified by:
    
    addNotification 接口 TimerMBean
    
    参数
    
    type -定时器通知类型。
    
    message -定时器通知的详细信息。
    
    userData -定时器通知用户数据对象。
    
    date时发生的日期通知。
    
    结果
    
    新创建的计时器通知的标识符。
    
    异常
    
    IllegalArgumentException -日期 null。
  - removeNotification
```
public void removeNotification(Integer id)
                        throws InstanceNotFoundException
```
    从通知列表中移除与指定的标识符相对应的计时器通知。
    
    Specified by:
    
    removeNotification 接口 TimerMBean
    
    参数
    
    id -定时器通知标识符。
    
    异常
    
    InstanceNotFoundException -指定的标识符不符合在该定时器MBean通知列表任何计时器的通知。
  - removeNotifications
```
public void removeNotifications(String type)
                         throws InstanceNotFoundException
```
    从通知列表中移除对应于指定类型的所有计时器通知。
    
    Specified by:
    
    removeNotifications 接口 TimerMBean
    
    参数
    
    type -定时器通知类型。
    
    异常
    
    InstanceNotFoundException -指定的类型不符合在该定时器MBean通知列表任何计时器的通知。
  - removeAllNotifications
```
public void removeAllNotifications()
```
    删除所有的定时器通知从通知单和重置定时器标识符用于更新通知柜台。
    
    Specified by:
    
    removeAllNotifications 接口 TimerMBean
  - getNbNotifications
```
public int getNbNotifications()
```
    获取已注册到通知列表的计时器通知的数目。
    
    Specified by:
    
    getNbNotifications 接口 TimerMBean
    
    结果
    
    定时器通知的数量。
  - getAllNotificationIDs
```
public Vector<Integer> getAllNotificationIDs()
```
    获取已注册到通知列表中的所有计时器通知标识符。
    
    Specified by:
    
    getAllNotificationIDs 接口 TimerMBean
    
    结果
    
    一个 Integer对象包含所有定时器通知标识符向量。如果没有定时器通知注册这个定时器MBean
    the向量是空的。
  - getNotificationIDs
```
public Vector<Integer> getNotificationIDs(String type)
```
    获取对应于指定类型的定时器通知的所有标识符。
    
    Specified by:
    
    getNotificationIDs 接口 TimerMBean
    
    参数
    
    type -定时器通知类型。
    
    结果
    
    一个 Integer对象包含定时器通知指定的 type所有标识符向量。如果没有定时通知注册这个定时器MBean指定的 type
    the向量是空的。
  - getNotificationType
```
public String getNotificationType(Integer id)
```
    获取对应于指定标识符的计时器通知类型。
    
    Specified by:
    
    getNotificationType 接口 TimerMBean
    
    参数
    
    id -定时器通知标识符。
    
    结果
    
    定时器的通知类型或null如果标识符没有映射到任何定时器通知注册这个定时器MBean。
  - getNotificationMessage
```
public String getNotificationMessage(Integer id)
```
    获取对应于指定标识符的计时器通知详细信息。
    
    Specified by:
    
    getNotificationMessage 接口 TimerMBean
    
    参数
    
    id -定时器通知标识符。
    
    结果
    
    定时器通知的详细信息或null如果标识符没有映射到任何定时器通知注册这个定时器MBean。
  - getNotificationUserData
```
public Object getNotificationUserData(Integer id)
```
    获取对应于指定标识符的计时器通知用户数据对象。
    
    Specified by:
    
    getNotificationUserData 接口 TimerMBean
    
    参数
    
    id -定时器通知标识符。
    
    结果
    
    定时器通知用户数据对象或null如果标识符没有映射到任何定时器通知注册这个定时器MBean。
  - getDate
```
public Date getDate(Integer id)
```
    获取与计时器通知相关联的日期的副本。
    
    Specified by:
    
    getDate 接口 TimerMBean
    
    参数
    
    id -定时器通知标识符。
    
    结果
    
    一份日期或null如果标识符没有映射到任何定时器通知注册这个定时器MBean。
  - getPeriod
```
public Long getPeriod(Integer id)
```
    获取与计时器通知相关联的期间（以毫秒为单位）的副本。
    
    Specified by:
    
    getPeriod 接口 TimerMBean
    
    参数
    
    id -定时器通知标识符。
    
    结果
    
    一份期或null如果标识符没有映射到任何定时器通知注册这个定时器MBean。
  - getNbOccurences
```
public Long getNbOccurences(Integer id)
```
    获取与计时器通知相关联的剩余数量的副本的副本。
    
    Specified by:
    
    getNbOccurences 接口 TimerMBean
    
    参数
    
    id -定时器通知标识符。
    
    结果
    
    一份事故或零剩余的号码如果标识符没有映射到任何定时器通知注册这个定时器MBean。
  - getFixedRate
```
public Boolean getFixedRate(Integer id)
```
    获取一个副本的指示标志是否定期通知是在固定延迟或固定利率执行。
    
    Specified by:
    
    getFixedRate 接口 TimerMBean
    
    参数
    
    id -定时器通知标识符。
    
    结果
    
    一个副本的指示标志是否定期通知是在固定延迟或固定利率执行。
  - getSendPastNotifications
```
public boolean getSendPastNotifications()
```
    获取指示计时器是否发送过去通知的标志。过去的通知发送开/关旗
    the默认值是 false。
    
    Specified by:
    
    getSendPastNotifications 接口 TimerMBean
    
    结果
    
    发送/关闭标志值的过去通知。
    
    另请参见：
    
    setSendPastNotifications(boolean)
  - setSendPastNotifications
```
public void setSendPastNotifications(boolean value)
```
    设置指示计时器是否发送过去通知或不发送的标志。过去的通知发送开/关标志 false
    the默认值。
    
    Specified by:
    
    setSendPastNotifications 接口 TimerMBean
    
    参数
    
    value -过去通知发送开/关的标志值。
    
    另请参见：
    
    getSendPastNotifications()
  - isActive
```
public boolean isActive()
```
    测试定时器MBean是活跃的。一个定时器MBean标记主动时， start方法称为。它成为活跃在 stop方法称为。
    the默认值主动开启/关闭旗 false。
    
    Specified by:
    
    isActive 接口 TimerMBean
    
    结果
    
    true如果定时器MBean是活跃的， false否则。
  - isEmpty
```
public boolean isEmpty()
```
    测试定时器通知列表是否为空。
    
    Specified by:
    
    isEmpty 接口 TimerMBean
    
    结果
    
    true如果定时器通知列表是空的， false否则。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Timer

Field Summary

构造方法摘要

方法摘要

Methods inherited from class javax.management.NotificationBroadcasterSupport

Methods inherited from class java.lang.Object

Field Detail

ONE_SECOND

ONE_MINUTE

ONE_HOUR

ONE_DAY

ONE_WEEK

Constructor Detail

Timer

方法详细信息

preRegister

postRegister

preDeregister

postDeregister

getNotificationInfo

start

stop

addNotification

addNotification

addNotification

addNotification

removeNotification

removeNotifications

removeAllNotifications

getNbNotifications

getAllNotificationIDs

getNotificationIDs

getNotificationType

getNotificationMessage

getNotificationUserData

getDate

getPeriod

getNbOccurences

getFixedRate

getSendPastNotifications

setSendPastNotifications

isActive

isEmpty