4-8 Programming Resource Adapters for Oracle WebLogic Server
4.4.1 Diagnostic Context ID
In the WebLogic Server diagnostic framework, a thread may have an associated diagnostic context. A request on the thread carries its diagnostic context throughout its
lifetime, as it proceeds along its path of execution. The ExtendedBootstrapContext
allows the resource adapter developer to set a diagnostic context payload consisting of a String that can be used, for example, to trace
the execution of a request from an EIS all the way to a message endpoint. This capability can serve a variety of diagnostic purposes. For example, you can set the
String to the client ID or session ID on an inbound message from an EIS. During message dispatch, various diagnostics can be gathered to show the request flow
through the system. As you develop your resource adapter classes, you can make use of the setDiagnosticContextID and getDiagnosticContextID methods
for this purpose.
Note the following regarding the contents of the diagnostic context payload:
■
The payload can be viewed by other code in the same execution context, and it can also flow out of the process along with the Work instance. Therefore, you should
ensure that the application does not include any sensitive data in the payload that, for example, could be returned by the getDiagnosticContextID method.
■
The payload can be overwritten by other code in the same execution context. Therefore, the application must never have a dependency on a specific context ID
being available in the payload. In addition, the application should also verify that the context ID in the payload matches what is expected before using it.
For more information about the diagnostic context, see Oracle Fusion Middleware Configuring and Using the Diagnostics Framework for Oracle WebLogic Server.
4.4.2 Dye Bits
The WebLogic Server diagnostic framework also provides the ability to dye a request. The ExtendedBootstrapContext allows you to set and retrieve four dye bits on
the current thread for whatever diagnostic purpose the resource adapter developer chooses. For example, you might set priority of a request using the dye bits. For more
information about request dyeing, see Oracle Fusion Middleware Configuring and Using the Diagnostics Framework for Oracle WebLogic Server
4.4.3 Callback Capabilities