com.dynatrace.openkit.core.objects

Class BaseActionImpl

java.lang.Object

com.dynatrace.openkit.core.objects.OpenKitComposite

com.dynatrace.openkit.core.objects.BaseActionImpl

All Implemented Interfaces:

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

Direct Known Subclasses:

LeafActionImpl, RootActionImpl

public abstract class BaseActionImpl
extends OpenKitComposite
implements Action

Abstract base class implementing the Action interface.

Method Summary

Modifier and Type	Method and Description
void	close()
int	getActionID() Get the action id of this composite or 0 if the composite is not an action.
int	getEndSequenceNo()
long	getEndTime()
int	getID()
java.lang.String	getName()
protected abstract Action	getParentAction() Get the parent Action, which might be null in case the parent does not implement Action.
int	getParentID()
int	getStartSequenceNo()
long	getStartTime()
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

Method Detail

close

public void close()

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

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

getParentAction

protected abstract Action getParentAction()

Get the parent Action, which might be null in case the parent does not implement Action.

Returns:

The parent action object, or null if parent does not implement Action.

getActionID

public int getActionID()

Description copied from class: OpenKitComposite

Get the action id of this composite or 0 if the composite is not an action.

The default return value of 0 is implemented here. Action related composites need to override this method and return the appropriate value.

Overrides:

getActionID in class OpenKitComposite

Returns:

The action id of this composite.

getID

public int getID()

getName

public java.lang.String getName()

getParentID

public int getParentID()

getStartTime

public long getStartTime()

getEndTime

public long getEndTime()

getStartSequenceNo

public int getStartSequenceNo()

getEndSequenceNo

public int getEndSequenceNo()