/**
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.openejb.core.transaction;
import org.apache.openejb.ApplicationException;
import org.apache.openejb.SystemException;
/**
* 17.6.2.3 Supports
*
* The Container invokes an enterprise Bean method whose transaction attribute
* is set to Supports as follows.
*
* � If the client calls with a transaction context, the Container performs
* the same steps as described in the Required case.
*
* � If the client calls without a transaction context, the Container performs
* the same steps as described in the NotSupported case.
*
* The Supports transaction attribute must be used with caution. This is
* because of the different transactional semantics provided by the two
* possible modes of execution. Only the enterprise beans that will
* execute correctly in both modes should use the Supports transaction
* attribute.
*
*/
public class TxSupports extends TransactionPolicy {
public TxSupports(TransactionContainer container) {
super(Type.Supports, container);
}
public void beforeInvoke(Object instance, TransactionContext context) throws SystemException, ApplicationException {
try {
context.clientTx = context.getTransactionManager().getTransaction();
context.currentTx = context.clientTx;
} catch (javax.transaction.SystemException se) {
throw new SystemException(se);
}
}
public void afterInvoke(Object instance, TransactionContext context) throws ApplicationException, SystemException {
}
public void handleApplicationException(Throwable appException, boolean rollback, TransactionContext context) throws ApplicationException, SystemException {
if (rollback && context.currentTx != null) markTxRollbackOnly(context.currentTx);
throw new ApplicationException(appException);
}
public void handleSystemException(Throwable sysException, Object instance, TransactionContext context) throws ApplicationException, SystemException {
boolean runningInTransaction = (context.currentTx != null);
if (runningInTransaction) {
/* [1] Log the system exception or error *********/
logSystemException(sysException, context);
/* [2] Mark the transaction for rollback. ********/
markTxRollbackOnly(context.currentTx);
/* [3] Discard instance. *************************/
discardBeanInstance(instance, context.callContext);
/* [4] TransactionRolledbackException to client **/
throwTxExceptionToServer(sysException);
} else {
/* [1] Log the system exception or error *********/
logSystemException(sysException, context);
/* [2] Discard instance. *************************/
discardBeanInstance(instance, context.callContext);
/* [3] Throw RemoteException to client ***********/
throwExceptionToServer(sysException);
}
}
}