编程模型总结

本节中描述的编程模型以已经引入的一些概念为基础并且概述了这些概念。本节还列示了使用需求和限制。禁止在不遵循下列编程准则方式下使用 WebSphere® Application Server JRas 扩展。

注: 不推荐使用本任务及其子任务中描述的 JRas 框架。但是,可以使用 Java™ 记录来获得类似结果。
可以通过三种不同的操作方式来使用 WebSphere Application Server JRas 扩展。编程模型概念和限制同等地应用于所有操作方式。
  • 除非另有声明,否则不能直接使用独立 JRas 记录工具箱提供的实现类。不支持直接使用那些类。如果直接使用由独立 JRas 记录工具箱提供的类,那么 IBM® 支持机构将不提供诊断辅助或错误修正。
  • 您必须直接从管理器类获取消息和跟踪记录器。您不能直接实例化记录器。
  • 不能替换 WebSphere Application Server 消息和跟踪记录器类。
  • 必须保证传递给管理器类的记录器名称是唯一的,并且遵循所描述的命名约束。从管理器类中获得了记录器时,不能尝试通过调用 setName 方法来更改该记录器的名称。
  • 命名的记录器可以多次使用。对于任何给定的名称,首次调用管理器类时将导致管理器类创建与该名称相关联的记录器。如果后续调用管理器类时指定相同名称,那么会导致返回对现有记录器的引用。
  • 管理器类维护记录器的分层名称空间。使用以点分隔的标准类名来标识任何记录器。除了点或句点之外,记录器名称中不能包含任何标点符号,例如,星号 (*)、逗号 (,)、等号 (=)、冒号 (:) 或引号。
  • 组名必须遵守与记录器名称相同的命名限制。
  • 从管理器类返回的记录器是独立 JRas 记录工具箱提供的 RASMessageLogger 和 RASTraceLogger 类的子类。可以调用由 RASMessageLogger 和 RASTraceLogger 类定义的任何公用方法。但不能调用由所提供的子类引入的任何公用方法。
  • 如果要以独立或组合方式操作,那么必须提供您自已的 Handler 和 Formatter 子类。而不能使用由独立 JRas 记录工具箱提供的 Handler 和 Formatter 类。用户写的处理程序和格式化程序必须符合已制订的指南。
  • 从管理器类获得的记录器随安装的 WebSphere Application Server 处理程序一起提供。此处理程序将消息和跟踪记录写入由 WebSphere Application Server 运行时定义的日志中。使用提供的系统管理接口管理这些日志。
  • 可以在任何时间以程序的方式从记录器添加和移除用户定义的处理程序。支持多次添加和移除用户定义的处理程序。您负责创建要添加的处理程序的实例,通过适当地设置处理程序掩码值和格式化程序配置处理程序,然后使用 addHandler 方法将处理程序添加至记录器。您负责按程序适当地更新用户定义的处理程序的掩码。
  • 可以通过对记录器调用 getHandlers 方法和处理结果来获取对安装在记录器内的处理程序的引用。不能对以此方式获得的处理程序调用任何方法。通过对记录器调用 removeHandler 方法,并传入对 WebSphere Application Server 处理程序的引用,可以从记录器中移除 WebSphere Application Server 处理程序。WebSphere Application Server 处理程序在移除后将无法再次添加至记录器。
  • 可以定义您自已的消息类型。JRas 框架(已不推荐使用)中讨论了用户定义的消息类型的行为以及对用户的定义的限制。
  • 可以定义您自已的消息事件类。JRas 框架(已不推荐使用)中讨论了如何使用用户定义的消息事件类。
  • 可以定义您自已的跟踪类型。JRas 框架(已不推荐使用)中讨论了用户定义的跟踪类型的行为以及对您的定义的限制。
  • 可以定义您自已的跟踪事件类。JRas 框架(已不推荐使用)中讨论了如何使用用户定义的跟踪事件类。
  • 必须按程序维护与任何用户定义的类型相应的消息和跟踪记录器掩码中的位。如果使用 WebSphere Application Server 设施来管理预定义的类型,那么这些更新不能修改与那些类型相对应的任何位的状态。如果对预定义的类型具有所有权,那么可以更改掩码的所有位。

指示主题类型的图标 概念主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ctrb_jrasprgsum
文件名:ctrb_jrasprgsum.html