EntitySynchronizationInterceptor

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS (src) NEXT CLASS (src)

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.jboss.ejb.plugins
Class EntitySynchronizationInterceptor

java.lang.Object
  org.jboss.ejb.plugins.AbstractInterceptor (src) 
      org.jboss.ejb.plugins.EntitySynchronizationInterceptor

All Implemented Interfaces:: AllowedOperationsFlags (src) , ContainerPlugin (src) , Interceptor (src) , Service (src)

Direct Known Subclasses:: EntityMultiInstanceSynchronizationInterceptor (src)

public class EntitySynchronizationInterceptor
extends AbstractInterceptor (src)

The role of this interceptor is to synchronize the state of the cache with the underlying storage. It does this with the ejbLoad and ejbStore semantics of the EJB specification. In the presence of a transaction this is triggered by transaction demarcation. It registers a callback with the underlying transaction monitor through the JTA interfaces. If there is no transaction the policy is to store state upon returning from invocation. The synchronization polices A,B,C of the specification are taken care of here.

WARNING: critical code, get approval from senior developers before changing.

Nested Class Summary
`protected class`	`EntitySynchronizationInterceptor.InstanceSynchronization (src)`

Field Summary
`protected int`	`commitOption` The current commit option.
`protected EntityContainer (src)`	`container` The container of this interceptor.
`protected long`	`optionDRefreshRate` The refresh rate for commit option d

Fields inherited from class org.jboss.ejb.plugins.AbstractInterceptor (src)

log, nextInterceptor

Fields inherited from interface org.jboss.ejb.AllowedOperationsFlags (src)

IN_AFTER_BEGIN, IN_AFTER_COMPLETION, IN_BEFORE_COMPLETION, IN_BUSINESS_METHOD, IN_EJB_ACTIVATE, IN_EJB_CREATE, IN_EJB_FIND, IN_EJB_HOME, IN_EJB_LOAD, IN_EJB_PASSIVATE, IN_EJB_POST_CREATE, IN_EJB_REMOVE, IN_EJB_STORE, IN_EJB_TIMEOUT, IN_INTERCEPTOR_METHOD, IN_SERVICE_ENDPOINT_METHOD, IN_SET_ENTITY_CONTEXT, IN_SET_MESSAGE_DRIVEN_CONTEXT, IN_SET_SESSION_CONTEXT, IN_UNSET_ENTITY_CONTEXT, NOT_ALLOWED

Constructor Summary
`EntitySynchronizationInterceptor()`

Method Summary
`void`	`create()` create the service, do expensive operations etc
`protected Synchronization (src)`	`createSynchronization(Transaction (src) tx, EntityEnterpriseContext (src) ctx)`
`Container (src)`	`getContainer()`
`java.lang.Object`	`invoke(Invocation (src) mi)` ???
`java.lang.Object`	`invokeHome(Invocation (src) mi)` ???
`protected void`	`register(EntityEnterpriseContext (src) ctx, Transaction (src) tx)` Register a transaction synchronization callback with a context.
`void`	`setContainer(Container (src) container)` This callback is set by the container so that the plugin may access it
`void`	`start()` start the service, create is already called
`void`	`stop()` stop the service

Methods inherited from class org.jboss.ejb.plugins.AbstractInterceptor (src)

destroy, getNext, setNext

Methods inherited from class java.lang.Object

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

Field Detail

commitOption

protected int commitOption

The current commit option.

optionDRefreshRate

protected long optionDRefreshRate

The refresh rate for commit option d

container

protected EntityContainer (src)  container

The container of this interceptor.

Constructor Detail