com.dynatrace.openkit.core

Class NullRootAction

java.lang.Object

com.dynatrace.openkit.core.NullRootAction

All Implemented Interfaces:

Action, RootAction, java.io.Closeable, java.lang.AutoCloseable

public class NullRootAction
extends java.lang.Object
implements RootAction

This class is returned as RootAction by Session.enterAction(String) when the Session.end() has been called before.

Constructor Summary

Constructors

Constructor and Description
NullRootAction()

Method Summary

Modifier and Type	Method and Description
void	close()
Action	enterAction(java.lang.String actionName) Enters a (child) Action with a specified name on this Action.
Action	leaveAction() Leaves this Action.
Action	reportError(java.lang.String errorName, int errorCode, java.lang.String reason) Reports an error with a specified name, error code and reason.
Action	reportEvent(java.lang.String eventName) Reports an event with a specified name (but without any value).
Action	reportValue(java.lang.String valueName, double value) Reports a double value with a specified name.
Action	reportValue(java.lang.String valueName, int value) Reports an int value with a specified name.
Action	reportValue(java.lang.String valueName, java.lang.String value) Reports a String value with a specified name.
WebRequestTracer	traceWebRequest(java.lang.String url) Allows tracing and timing of a web request handled by any 3rd party HTTP Client (e.g.
WebRequestTracer	traceWebRequest(java.net.URLConnection connection) Traces a web request - which is provided as a URLConnection - and allows adding timing information to this request.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.dynatrace.openkit.api.Action

leaveAction, reportError, reportEvent, reportValue, reportValue, reportValue, traceWebRequest, traceWebRequest

Methods inherited from interface java.io.Closeable

close

Constructor Detail

NullRootAction

public NullRootAction()

Method Detail

enterAction

public Action enterAction(java.lang.String actionName)

Description copied from interface: RootAction

Enters a (child) Action with a specified name on this Action.

If the given actionName is null or an empty string, no reporting will happen on that RootAction.

Specified by:

enterAction in interface RootAction

Parameters:

actionName - name of the Action

Returns:

Action instance to work with

reportEvent

public Action reportEvent(java.lang.String eventName)

Description copied from interface: Action

Reports an event with a specified name (but without any value).

If given eventName is null then no event is reported to the system.

Specified by:

reportEvent in interface Action

Parameters:

eventName - name of the event

Returns:

this Action (for usage as fluent API)

reportValue

public Action reportValue(java.lang.String valueName,
                          int value)

Description copied from interface: Action

Reports an int value with a specified name.

Specified by:

reportValue in interface Action

Parameters:

valueName - name of this value

value - value itself

Returns:

this Action (for usage as fluent API)

reportValue

public Action reportValue(java.lang.String valueName,
                          double value)

Description copied from interface: Action

Reports a double value with a specified name.

Specified by:

reportValue in interface Action

Parameters:

valueName - name of this value

value - value itself

Returns:

this Action (for usage as fluent API)

reportValue

public Action reportValue(java.lang.String valueName,
                          java.lang.String value)

Description copied from interface: Action

Reports a String value with a specified name.

Specified by:

reportValue in interface Action

Parameters:

valueName - name of this value

value - value itself

Returns:

this Action (for usage as fluent API)

reportError

public Action reportError(java.lang.String errorName,
                          int errorCode,
                          java.lang.String reason)

Description copied from interface: Action

Reports an error with a specified name, error code and reason.

Specified by:

reportError in interface Action

Parameters:

errorName - name of this error

errorCode - numeric error code of this error

reason - reason for this error

Returns:

this Action (for usage as fluent API)

traceWebRequest

public WebRequestTracer traceWebRequest(java.net.URLConnection connection)

Description copied from interface: Action

Traces a web request - which is provided as a URLConnection - and allows adding timing information to this request. If the web request is continued on a server-side Agent (e.g. Java, .NET, ...) this Session will be correlated to the resulting server-side PurePath.

Specified by:

traceWebRequest in interface Action

Parameters:

connection - the URLConnection of the HTTP request to be tagged and timed

Returns:

a WebRequestTracer which allows adding timing information

traceWebRequest

public WebRequestTracer traceWebRequest(java.lang.String url)

Description copied from interface: Action

Allows tracing and timing of a web request handled by any 3rd party HTTP Client (e.g. Apache, Google, Jetty, ...). In this case the Dynatrace HTTP header (OpenKitConstants.WEBREQUEST_TAG_HEADER) has to be set manually to the tag value of this WebRequestTracer.
If the web request is continued on a server-side Agent (e.g. Java, .NET, ...) this Session will be correlated to the resulting server-side PurePath.

Specified by:

traceWebRequest in interface Action

Parameters:

url - the URL of the web request to be tagged and timed

Returns:

a WebRequestTracer which allows getting the tag value and adding timing information

leaveAction

public Action leaveAction()

Description copied from interface: Action

Leaves this Action.

Specified by:

leaveAction in interface Action

Returns:

the parent Action, or null if there is no parent Action

close

public void close()

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable