JRas 框架（不推荐）

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

不推荐使用：不推荐使用本主题中所描述的 JRas 框架。但是，您可以使用 Java™ 日志记录来实现类似的结果。

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

处理程序

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

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

格式化程序

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

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

消息事件类型

独立 JRas 工具箱定义 RASIMessageEvent 接口中的消息事件类型。此外， WebSphere Application Server 保留一系列消息事件类型以供将来使用。 RASIMessageEvent 接口定义三种类型，值分别为 0x01、0x02 和 0x04。 0x08 到 0x8000 范围内的值保留给将来使用。可以通过适当地扩展此接口来提供您自已的消息事件类型。用户定义的消息类型的值必须大于或等于 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 跟踪记录器无法直接创建用户定义类型的实例，以响应在跟踪记录器上调用跟踪方法 (入口，出口和跟踪)。此外，用户定义的跟踪类型的实例从不由 WebSphere Application Server 处理程序处理。您无法直接创建 RASTraceEvent 类的实例。

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

根据定义， WebSphere Application Server 处理程序处理用户定义的消息或跟踪类型，用户定义的消息或跟踪事件类。无法将用户定义类型或用户定义事件类的消息和跟踪条目写入 WebSphere Application Server 运行时日志。