com.newrelic.agent

Class TransactionApiImpl

java.lang.Object

com.newrelic.agent.TransactionApiImpl

All Implemented Interfaces:

com.newrelic.api.agent.Transaction

Direct Known Subclasses:

BoundTransactionApiImpl, WeakRefTransaction

public class TransactionApiImpl
extends java.lang.Object
implements com.newrelic.agent.bridge.Transaction

Public API implementation for Transaction class.

Implementation note: this object normally does not hold a reference to the Agent's internal Transaction object. Instead, this object re-fetches the inner Transaction from the current thread's local storage on demand. This is important, because otherwise the calling would need to release references to this object after making a call to Transaction.startAsyncActivity() because it changes the transaction on the current thread.

Field Summary

Fields

Modifier and Type	Field and Description
static TransactionApiImpl	INSTANCE

Constructor Summary

Constructors

Constructor and Description
TransactionApiImpl()

Method Summary

Modifier and Type	Method and Description
void	acceptDistributedTraceHeaders(com.newrelic.api.agent.TransportType transportType, com.newrelic.api.agent.Headers headers)
void	acceptDistributedTracePayload(com.newrelic.api.agent.DistributedTracePayload payload)
void	acceptDistributedTracePayload(java.lang.String payload)
void	addOutboundResponseHeaders()
void	beforeSendResponseHeaders()
boolean	clearTransaction()
void	convertToWebTransaction()
com.newrelic.agent.bridge.TracedActivity	createAndStartTracedActivity()
com.newrelic.api.agent.DistributedTracePayload	createDistributedTracePayload()
boolean	equals(java.lang.Object obj) Two ApiImpl classes are equal if their wrapped Transactions are the same object.
void	expireAllTokens()
void	finishFlyweightTracer(com.newrelic.agent.bridge.TracedMethod parent, long startInNanos, long finishInNanos, java.lang.String className, java.lang.String methodName, java.lang.String methodDesc, java.lang.String metricName, java.lang.String[] rollupMetricNames)
java.util.Map<java.lang.String,java.lang.Object>	getAgentAttributes()
com.newrelic.agent.bridge.CrossProcessState	getCrossProcessState()
com.newrelic.api.agent.TracedMethod	getLastTracer()
java.lang.String	getRequestMetadata()
java.lang.String	getResponseMetadata()
java.lang.Object	getSecurityMetaData()
com.newrelic.agent.bridge.Token	getToken()
com.newrelic.api.agent.TracedMethod	getTracedMethod()
protected Transaction	getTransactionIfExists() Get the thread's transaction.
java.util.Map<java.lang.String,java.lang.Object>	getUserAttributes()
com.newrelic.agent.bridge.WebResponse	getWebResponse()
int	hashCode() The hash code of an ApiImpl is equal to the hash code of its wrapped Transaction if it has one, else it is necessarily equal to a constant.
void	ignore()
void	ignoreApdex()
void	ignoreErrors()
void	insertDistributedTraceHeaders(com.newrelic.api.agent.Headers headers)
boolean	isAutoAppNamingEnabled()
boolean	isStarted()
boolean	isTransactionNameSet()
boolean	isWebRequestSet()
boolean	isWebResponseSet()
boolean	isWebTransaction()
boolean	markFirstByteOfResponse()
boolean	markLastByteOfResponse()
void	markResponseAtTxaEnd()
boolean	markResponseSent()
void	processRequestMetadata(java.lang.String metadata)
void	processResponseMetadata(java.lang.String metadata)
void	processResponseMetadata(java.lang.String metadata, java.net.URI uri)
void	provideHeaders(com.newrelic.api.agent.InboundHeaders headers)
boolean	registerAsyncActivity(java.lang.Object asyncContext)
void	requestDestroyed()
void	requestInitialized(com.newrelic.api.agent.Request request, com.newrelic.api.agent.Response response)
void	saveMessageParameters(java.util.Map<java.lang.String,java.lang.String> parameters)
void	setApplicationName(com.newrelic.api.agent.ApplicationNamePriority priority, java.lang.String appName)
boolean	setTransactionName(com.newrelic.api.agent.TransactionNamePriority namePriority, boolean override, java.lang.String category, java.lang.String... parts)
boolean	setTransactionName(com.newrelic.agent.bridge.TransactionNamePriority namePriority, boolean override, java.lang.String category, java.lang.String... parts)
void	setTransportType(com.newrelic.api.agent.TransportType transportType)
void	setWebRequest(com.newrelic.api.agent.ExtendedRequest request)
void	setWebRequest(com.newrelic.api.agent.Request request)
void	setWebResponse(com.newrelic.api.agent.Response response)
com.newrelic.agent.bridge.TracedMethod	startFlyweightTracer()
com.newrelic.api.agent.Segment	startSegment(java.lang.String segmentName)
com.newrelic.api.agent.Segment	startSegment(java.lang.String category, java.lang.String segmentName)

Methods inherited from class java.lang.Object

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

Field Detail

INSTANCE

public static final TransactionApiImpl INSTANCE

Constructor Detail

TransactionApiImpl

public TransactionApiImpl()

Method Detail

equals

public boolean equals(java.lang.Object obj)

Two ApiImpl classes are equal if their wrapped Transactions are the same object. They are also equal if neither currently wraps a transaction.

Overrides:

equals in class java.lang.Object

Returns:

true if this object is equal to the argument.

hashCode

public int hashCode()

The hash code of an ApiImpl is equal to the hash code of its wrapped Transaction if it has one, else it is necessarily equal to a constant.

Overrides:

hashCode in class java.lang.Object

getTransactionIfExists

protected Transaction getTransactionIfExists()

Get the thread's transaction. The return value may be null since we do not force creation of an inner Transaction instance on the current thread.
Subclass should override this method. All methods of this class that need to get a hold of the inner Transaction should use this method.

Returns:

the real transaction bound to this object, if any; else null.

See Also:

InstrumentationImpl

registerAsyncActivity

public boolean registerAsyncActivity(java.lang.Object asyncContext)

setTransactionName

public boolean setTransactionName(com.newrelic.api.agent.TransactionNamePriority namePriority,
                                  boolean override,
                                  java.lang.String category,
                                  java.lang.String... parts)

Specified by:

setTransactionName in interface com.newrelic.api.agent.Transaction

isTransactionNameSet

public boolean isTransactionNameSet()

Specified by:

isTransactionNameSet in interface com.newrelic.api.agent.Transaction

getLastTracer

public com.newrelic.api.agent.TracedMethod getLastTracer()

Specified by:

getLastTracer in interface com.newrelic.api.agent.Transaction

getTracedMethod

public com.newrelic.api.agent.TracedMethod getTracedMethod()

Specified by:

getTracedMethod in interface com.newrelic.api.agent.Transaction

ignore

public void ignore()

Specified by:

ignore in interface com.newrelic.api.agent.Transaction

ignoreApdex

public void ignoreApdex()

Specified by:

ignoreApdex in interface com.newrelic.api.agent.Transaction

ignoreErrors

public void ignoreErrors()

Specified by:

ignoreErrors in interface com.newrelic.api.agent.Transaction

setTransactionName

public boolean setTransactionName(com.newrelic.agent.bridge.TransactionNamePriority namePriority,
                                  boolean override,
                                  java.lang.String category,
                                  java.lang.String... parts)

beforeSendResponseHeaders

public void beforeSendResponseHeaders()

addOutboundResponseHeaders

public void addOutboundResponseHeaders()

Specified by:

addOutboundResponseHeaders in interface com.newrelic.api.agent.Transaction

isStarted

public boolean isStarted()

setApplicationName

public void setApplicationName(com.newrelic.api.agent.ApplicationNamePriority priority,
                               java.lang.String appName)

isAutoAppNamingEnabled

public boolean isAutoAppNamingEnabled()

isWebRequestSet

public boolean isWebRequestSet()

isWebResponseSet

public boolean isWebResponseSet()

setWebRequest

public void setWebRequest(com.newrelic.api.agent.Request request)

setWebResponse

public void setWebResponse(com.newrelic.api.agent.Response response)

Specified by:

setWebResponse in interface com.newrelic.api.agent.Transaction

getWebResponse

public com.newrelic.agent.bridge.WebResponse getWebResponse()

convertToWebTransaction

public void convertToWebTransaction()

Specified by:

convertToWebTransaction in interface com.newrelic.api.agent.Transaction

isWebTransaction

public boolean isWebTransaction()

Specified by:

isWebTransaction in interface com.newrelic.api.agent.Transaction

requestInitialized

public void requestInitialized(com.newrelic.api.agent.Request request,
                               com.newrelic.api.agent.Response response)

requestDestroyed

public void requestDestroyed()

saveMessageParameters

public void saveMessageParameters(java.util.Map<java.lang.String,java.lang.String> parameters)

getCrossProcessState

public com.newrelic.agent.bridge.CrossProcessState getCrossProcessState()

startFlyweightTracer

public com.newrelic.agent.bridge.TracedMethod startFlyweightTracer()

finishFlyweightTracer

public void finishFlyweightTracer(com.newrelic.agent.bridge.TracedMethod parent,
                                  long startInNanos,
                                  long finishInNanos,
                                  java.lang.String className,
                                  java.lang.String methodName,
                                  java.lang.String methodDesc,
                                  java.lang.String metricName,
                                  java.lang.String[] rollupMetricNames)

getAgentAttributes

public java.util.Map<java.lang.String,java.lang.Object> getAgentAttributes()

getUserAttributes

public java.util.Map<java.lang.String,java.lang.Object> getUserAttributes()

provideHeaders

public void provideHeaders(com.newrelic.api.agent.InboundHeaders headers)

getRequestMetadata

public java.lang.String getRequestMetadata()

Specified by:

getRequestMetadata in interface com.newrelic.api.agent.Transaction

processRequestMetadata

public void processRequestMetadata(java.lang.String metadata)

Specified by:

processRequestMetadata in interface com.newrelic.api.agent.Transaction

getResponseMetadata

public java.lang.String getResponseMetadata()

Specified by:

getResponseMetadata in interface com.newrelic.api.agent.Transaction

processResponseMetadata

public void processResponseMetadata(java.lang.String metadata)

Specified by:

processResponseMetadata in interface com.newrelic.api.agent.Transaction

processResponseMetadata

public void processResponseMetadata(java.lang.String metadata,
                                    java.net.URI uri)

Specified by:

processResponseMetadata in interface com.newrelic.api.agent.Transaction

setWebRequest

public void setWebRequest(com.newrelic.api.agent.ExtendedRequest request)

Specified by:

setWebRequest in interface com.newrelic.api.agent.Transaction

markFirstByteOfResponse

public boolean markFirstByteOfResponse()

markLastByteOfResponse

public boolean markLastByteOfResponse()

markResponseAtTxaEnd

public void markResponseAtTxaEnd()

markResponseSent

public boolean markResponseSent()

Specified by:

markResponseSent in interface com.newrelic.api.agent.Transaction

createAndStartTracedActivity

public com.newrelic.agent.bridge.TracedActivity createAndStartTracedActivity()

createDistributedTracePayload

public com.newrelic.api.agent.DistributedTracePayload createDistributedTracePayload()

Specified by:

createDistributedTracePayload in interface com.newrelic.api.agent.Transaction

getToken

public com.newrelic.agent.bridge.Token getToken()

Specified by:

getToken in interface com.newrelic.api.agent.Transaction

startSegment

public com.newrelic.api.agent.Segment startSegment(java.lang.String segmentName)

Specified by:

startSegment in interface com.newrelic.api.agent.Transaction

startSegment

public com.newrelic.api.agent.Segment startSegment(java.lang.String category,
                                                   java.lang.String segmentName)

Specified by:

startSegment in interface com.newrelic.api.agent.Transaction

expireAllTokens

public void expireAllTokens()

clearTransaction

public boolean clearTransaction()

acceptDistributedTracePayload

public void acceptDistributedTracePayload(java.lang.String payload)

Specified by:

acceptDistributedTracePayload in interface com.newrelic.api.agent.Transaction

acceptDistributedTracePayload

public void acceptDistributedTracePayload(com.newrelic.api.agent.DistributedTracePayload payload)

Specified by:

acceptDistributedTracePayload in interface com.newrelic.api.agent.Transaction

insertDistributedTraceHeaders

public void insertDistributedTraceHeaders(com.newrelic.api.agent.Headers headers)

Specified by:

insertDistributedTraceHeaders in interface com.newrelic.api.agent.Transaction

acceptDistributedTraceHeaders

public void acceptDistributedTraceHeaders(com.newrelic.api.agent.TransportType transportType,
                                          com.newrelic.api.agent.Headers headers)

Specified by:

acceptDistributedTraceHeaders in interface com.newrelic.api.agent.Transaction

getSecurityMetaData

public java.lang.Object getSecurityMetaData()

Specified by:

getSecurityMetaData in interface com.newrelic.api.agent.Transaction

setTransportType

public void setTransportType(com.newrelic.api.agent.TransportType transportType)