作业
From Apache OpenOffice Wiki
OpenOffice.org 中的一个作业（job）是在发生某个事件时可由作业执行环境执行一个 UNO 组件。它可以在配置分支 org.openoffice.Office.Jobs 中读取和写入自己的配置数据集，并且可以使用特殊的时间戳从某个点及时启动和关闭。它可以从环境启动，也可以不从环境启动，并具有免受终止和生命周期问题搅扰的保护。
启动作业的事件可以通过以下方法触发：
- OpenOffice.org 中的任意代码，这些代码在运行时检测已定义状态并将事件字符串通过其接口方法 com.sun.star.task.XJobExecutor:trigger() 传送到服务 com.sun.star.task.JobExecutor。如果此事件存在已注册作业，作业执行程序将查看 OpenOffice.org 的配置并执行这些作业。
- 全局文档事件广播器
- 分发框架，提供 vnd.star.sun.job: URL 模式以使用命令 URL 启动作业。此 URL 模式可以用三种不同的方式执行作业：可以对被配置为等待作业的作业组件发出事件；可以通过已在配置中为组件指定的别名调用组件；或者通过其实现名称直接执行作业组件。
如果在作业执行程序调用 trigger() 或者使用全局事件广播器，办公软件需要每个要运行的作业的一组有效配置数据。第三种方法，即使用 vnd.star.sun.job: 命令 URL，可以具有优先配置或不具有优先配置。
以下插图显示了一个示例作业，它计算自己被事件触发的次数，并在执行两次后关闭。它使用自己的作业特定的配置层存储被调用的次数。这个值将被传送到每个新创建的作业实例作为初始化参数，并且在检查之后写回配置。当计数器超过二时，作业将使用作业执行环境的特殊关闭功能。每个作业都可以有一个用户时间戳和管理员时间戳，以控制启动和关闭。作业关闭时，执行环境将更新用户时间戳的值，以便后续事件不再启动此作业。但它可以由管理层的较新的时间戳值启用。
| Content on this page is licensed under the Public Documentation License (PDL). |
