com.newrelic.agent

Class BoundTransactionApiImpl

java.lang.Object

com.newrelic.agent.TransactionApiImpl

com.newrelic.agent.BoundTransactionApiImpl

All Implemented Interfaces:

com.newrelic.api.agent.Transaction

public class BoundTransactionApiImpl
extends TransactionApiImpl

In certain situations it is necessary to tie an instance of this object to a specific instance of an internal Transaction. A one-argument constructor is provided for use in these (unusual, legacy instrumentation) situations.
Use of this class can lead to functional failures in customer code. See JAVA-883. Creation of this class should be restricted to instances that will be used internally, e.g. to support legacy asynchronous servlet instrumentation.

Field Summary

Fields inherited from class com.newrelic.agent.TransactionApiImpl

INSTANCE

Constructor Summary

Constructors

Constructor and Description
BoundTransactionApiImpl(Transaction boundTransaction) Construct a TransactionApiImpl that will be bound to the argument Transaction.

Method Summary

Modifier and Type	Method and Description
protected Transaction	getTransactionIfExists() Get the thread's transaction.

Methods inherited from class com.newrelic.agent.TransactionApiImpl

acceptDistributedTraceHeaders, acceptDistributedTracePayload, acceptDistributedTracePayload, addOutboundResponseHeaders, beforeSendResponseHeaders, clearTransaction, convertToWebTransaction, createAndStartTracedActivity, createDistributedTracePayload, equals, expireAllTokens, finishFlyweightTracer, getAgentAttributes, getCrossProcessState, getLastTracer, getRequestMetadata, getResponseMetadata, getToken, getTracedMethod, getWebResponse, hashCode, ignore, ignoreApdex, ignoreErrors, insertDistributedTraceHeaders, isAutoAppNamingEnabled, isStarted, isTransactionNameSet, isWebRequestSet, isWebResponseSet, isWebTransaction, markFirstByteOfResponse, markLastByteOfResponse, markResponseAtTxaEnd, markResponseSent, processRequestMetadata, processResponseMetadata, processResponseMetadata, provideHeaders, registerAsyncActivity, requestDestroyed, requestInitialized, saveMessageParameters, setApplicationName, setTransactionName, setTransactionName, setTransportType, setWebRequest, setWebRequest, setWebResponse, startFlyweightTracer, startSegment, startSegment

Methods inherited from class java.lang.Object

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

Constructor Detail

BoundTransactionApiImpl

public BoundTransactionApiImpl(Transaction boundTransaction)

Construct a TransactionApiImpl that will be bound to the argument Transaction.

Parameters:

boundTransaction - the bound Transaction, which must not be null.

Method Detail

getTransactionIfExists

protected Transaction getTransactionIfExists()

Description copied from class: TransactionApiImpl

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.

Overrides:

getTransactionIfExists in class TransactionApiImpl

Returns:

the real transaction bound to this object

See Also:

InstrumentationImpl