JRas 框架(已不推荐使用)

因为 JRas 扩展类不具备许多情况下需要的灵活性和行为,所以定义了多种扩展点。可以编写您自己的实现类,以获得所需要的行为。

不推荐使用:不推荐使用本主题中所描述的 JRas 框架。但是,可以使用 Java™ 记录来获得类似结果。

通常,JRas 扩展需要您调用管理器类来获取消息记录器或跟踪记录器。没有规定您提供自己的消息或跟踪记录器子类。通常,用户提供的扩展不能用于影响集成的操作方式。集成的操作方式的行为仅由 WebSphere® Application Server 运行时和 JRas 扩展类确定。

处理程序

独立 JRas 记录工具箱定义 RASIHandler 接口。所有处理程序必须实现此接口。可以编写您自已的处理程序类来实现 RASIHandler 接口。直接创建用户定义的处理程序的实例并将它们添加到从管理器类获得的记录器。

独立 JRas 记录工具箱提供几个处理程序实现类。这些处理程序类不适合用于 Java 2 平台企业修订版 (J2EE) 环境中。不能直接使用独立 JRas 记录工具箱提供的任何 Handler 类或者为它创建子类。这样做违反了编程模型。

格式化程序

独立 JRas 记录工具箱定义 RASIFormatter 接口。所有格式化程序必须实现此接口。可以编写您自已的格式化程序类来实现 RASIFormatter 接口。只能将这些类添加至用户定义的处理程序。WebSphere Application Server 处理程序不能配置为使用用户定义的格式化程序。而是直接创建您的格式化程序的实例并适当地将它们添加到您的处理程序中。

如处理程序一样,独立 JRas 记录工具箱提供几个格式化程序实现类。不支持直接使用这些格式化程序类。

消息事件类型

独立 JRas 工具箱定义 RASIMessageEvent 接口中的消息事件类型。另外,WebSphere Application Server 保留了一定范围的消息事件类型以供将来使用。RASIMessageEvent 接口定义三种类型,值分别为 0x010x020x040x080x8000 范围内的值保留给将来使用。可以通过适当地扩展此接口来提供您自已的消息事件类型。用户定义的消息类型的值必须大于或等于 0x1000

从管理器类中检索到的消息记录器将它们的消息掩码设置为 pass 或者处理在 RASIMessageEvent 接口中定义的所有消息事件类型。要处理用户定义的消息类型,在从管理器类中获得消息记录器之后,必须通过用户代码将消息记录器掩码手动设置为适当的状态。WebSphere Application Server 不支持使用任何内置系统管理功能来管理消息类型。

消息事件对象

独立 JRas 工具箱提供 RASMessageEvent 实现类。当对消息记录器调用消息记录方法,并且当前启用了消息类型时,记录器创建和分发此类事件到所有当前向该记录器注册的处理程序。

可以提供您自已的消息事件类,但它们必须实现 RASIEvent 接口。您必须直接创建这样的用户定义的消息事件类的实例。 创建之后,通过直接对消息记录器调用 fireRASEvent 方法,就会将消息事件传递给消息记录器。WebSphere Application Server 消息记录器无法直接创建用户定义的类型的实例,作为对记录器调用记录方法 (msg.message) 的响应。另外,用户定义的消息类型实例永远不会由 WebSphere Application Server 处理程序处理。您无法直接创建 RASMessageEvent 类的实例。

跟踪事件类型

独立 JRas 工具箱定义 RASITraceEvent 接口中的跟踪事件类型。可以通过适当地扩展此接口来提供您自已的跟踪事件类型。在这种情况下,必须确保用户定义的跟踪事件类型的值与 RASITraceEvent 接口中定义的类型值不发生冲突。

从管理器类中检索到的跟踪记录器通常将它们的跟踪掩码设置为拒绝所有类型。可以使用 WebSphere Application Server 系统管理设施来指定不同的起始状态。另外,可以在运行时使用 WebSphere Application Server 系统管理设施来更改记录器的跟踪掩码的状态。

要处理用户定义的跟踪类型,必须通过用户代码将跟踪记录器掩码手动设置为适当状态。在启动时或运行时,不能使用 WebSphere Application Server 系统管理设施来管理用户定义的跟踪类型。

跟踪事件对象

独立 JRas 工具箱提供 RASTraceEvent 实现类。当对 WebSphere Application Server 跟踪记录器调用跟踪记录方法,并且该类型当前处于启用状态时,记录器创建此类的事件并将该事件分发到当前已向该记录器注册的所有处理程序。

您可以提供您自已的跟踪事件类。这些跟踪事件类必须实现 RASIEvent 接口。您必须直接创建这些用户定义的事件类的实例。创建之后,通过直接调用跟踪记录器的 fireRASEvent 方法,就会将跟踪事件传递给跟踪记录器。WebSphere Application Server 跟踪记录器无法直接创建用户定义的类型的实例,作为对跟踪记录器调用跟踪方法(entry、exit 和 trace)的响应。另外,用户定义的跟踪类型实例永远不会由 WebSphere Application Server 处理程序处理。您无法直接创建 RASTraceEvent 类的实例。

用户定义的类型、用户定义的事件和 WebSphere Application Server

按照定义,WebSphere Application Server 处理程序处理了用户定义的消息或跟踪类型,或用户定义的消息或跟踪事件类。用户定义的类型或者用户定义的事件类的消息和跟踪条目无法写入 WebSphere Application Server 运行时日志。


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



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