public class OcHttpServletUtil extends Object
| Modifier and Type | Method and Description |
|---|---|
static io.opencensus.common.Scope |
withScope(javax.servlet.ServletRequest request)
Enters the scope of code where the given
ServletRequest will be processed and returns
an object that represents the scope. |
@MustBeClosed public static io.opencensus.common.Scope withScope(javax.servlet.ServletRequest request)
ServletRequest will be processed and returns
an object that represents the scope. The scope is exited when the returned object is closed. A
span created for the ServletRequest is set to the current Context.
Supports try-with-resource idiom.
Example of usage:
void AsyncRequestProcessor(AsyncContext asyncCtx) {
try (Scope ws = OcHttpServletUtil.withScope(asyncCtx.getRequest) {
tracer.getCurrentSpan().addAnnotation("my annotation");
doSomeOtherWork(); // Here "span" is the current Span.
}
}
Prior to Java SE 7, you can use a finally block to ensure that a resource is closed regardless of whether the try statement completes normally or abruptly.
Example of usage prior to Java SE7:
void AsyncRequestProcessor(AsyncContext asyncCtx) {
Scope ws = OcHttpServletUtil.withScope(asyncCtx.getRequest)
try {
tracer.getCurrentSpan().addAnnotation("my annotation");
doSomeOtherWork(); // Here "span" is the current Span.
} finally {
ws.close();
}
}
request - The ServletRequest request that is about to be processed.ServletRequest will be set to the current Context.NullPointerException - if request is null.