com.newrelic.agent.service.async

Class AsyncTransactionService

java.lang.Object

com.newrelic.agent.service.AbstractService

com.newrelic.agent.service.async.AsyncTransactionService

All Implemented Interfaces:

HarvestListener, Service

public class AsyncTransactionService
extends AbstractService
implements HarvestListener

Stores pending async transactions. Responsible for timing out old async keys. Most of this logic used to be in the Transaction. However, it was extracted to take advantage of the harvest thread to timeout async transaction keys. Previously the timeout was occurring during extractIfPresent and putIfAbsent. This caused a deadlock between the transaction lock and the pendingActivities lock. This class supports the legacy register and start API. The register and start should no longer be used. Instead please use getToken and link. This class checked old tokens to see if they should be timed out.

Field Summary

Fields inherited from class com.newrelic.agent.service.AbstractService

logger

Constructor Summary

Constructors

Constructor and Description
AsyncTransactionService()

Method Summary

Modifier and Type	Method and Description
void	afterHarvest(java.lang.String appName) Called after the harvest.
void	beforeHarvest(java.lang.String appName, StatsEngine statsEngine) Called before the harvest.
protected int	cacheSizeForTesting()
protected void	cleanUpPendingTransactions()
protected void	doStart()
protected void	doStop()
com.newrelic.api.agent.Token	extractIfPresent(java.lang.Object key) This method should only be called from within a transaction object.
boolean	ignoreIfUnstartedAsyncContext(java.lang.Object asyncContext)
boolean	isEnabled() Is the service enabled.
boolean	putIfAbsent(java.lang.Object key, com.newrelic.api.agent.Token tx) This method should only be called from within a transaction object.
boolean	registerAsyncActivity(java.lang.Object context) Deprecated.
boolean	startAsyncActivity(java.lang.Object context) Deprecated.

Methods inherited from class com.newrelic.agent.service.AbstractService

getLogger, getName, isStarted, isStartedOrStarting, isStopped, isStoppedOrStopping, start, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

AsyncTransactionService

public AsyncTransactionService()

Method Detail

cleanUpPendingTransactions

protected void cleanUpPendingTransactions()

putIfAbsent

public boolean putIfAbsent(java.lang.Object key,
                           com.newrelic.api.agent.Token tx)

This method should only be called from within a transaction object.

Parameters:

key - The key to register

tx - The transaction associated with the key.

extractIfPresent

public com.newrelic.api.agent.Token extractIfPresent(java.lang.Object key)

This method should only be called from within a transaction object.

Parameters:

key - The key representing some async work.

Returns:

The transaction associated with the key.

beforeHarvest

public void beforeHarvest(java.lang.String appName,
                          StatsEngine statsEngine)

Description copied from interface: HarvestListener

Called before the harvest. The service may or may not be currently connected.

Specified by:

beforeHarvest in interface HarvestListener

registerAsyncActivity

@Deprecated
public boolean registerAsyncActivity(java.lang.Object context)

Deprecated.

startAsyncActivity

@Deprecated
public boolean startAsyncActivity(java.lang.Object context)

Deprecated.

ignoreIfUnstartedAsyncContext

public boolean ignoreIfUnstartedAsyncContext(java.lang.Object asyncContext)

cacheSizeForTesting

protected int cacheSizeForTesting()

afterHarvest

public void afterHarvest(java.lang.String appName)

Description copied from interface: HarvestListener

Called after the harvest. The service may or may not be currently connected.

Specified by:

afterHarvest in interface HarvestListener

isEnabled

public boolean isEnabled()

Description copied from interface: Service

Is the service enabled.

Specified by:

isEnabled in interface Service

Returns:

true if the service is enabled

doStart

protected void doStart()
                throws java.lang.Exception

Specified by:

doStart in class AbstractService

Throws:

java.lang.Exception

doStop

protected void doStop()
               throws java.lang.Exception

Specified by:

doStop in class AbstractService

Throws:

java.lang.Exception