001: /* ====================================================================
002: * The LateralNZ Software License, Version 1.0
003: *
004: * Copyright (c) 2003 LateralNZ. All rights reserved.
005: *
006: * Redistribution and use in source and binary forms, with or without
007: * modification, are permitted provided that the following conditions
008: * are met:
009: *
010: * 1. Redistributions of source code must retain the above copyright
011: * notice, this list of conditions and the following disclaimer.
012: *
013: * 2. Redistributions in binary form must reproduce the above copyright
014: * notice, this list of conditions and the following disclaimer in
015: * the documentation and/or other materials provided with the
016: * distribution.
017: *
018: * 3. The end-user documentation included with the redistribution,
019: * if any, must include the following acknowledgment:
020: * "This product includes software developed by
021: * LateralNZ (http://www.lateralnz.org/) and other third parties."
022: * Alternately, this acknowledgment may appear in the software itself,
023: * if and wherever such third-party acknowledgments normally appear.
024: *
025: * 4. The names "LateralNZ" must not be used to endorse or promote
026: * products derived from this software without prior written
027: * permission. For written permission, please
028: * contact oss@lateralnz.org.
029: *
030: * 5. Products derived from this software may not be called "Panther",
031: * or "Lateral" or "LateralNZ", nor may "PANTHER" or "LATERAL" or
032: * "LATERALNZ" appear in their name, without prior written
033: * permission of LateralNZ.
034: *
035: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
036: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
037: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
038: * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
039: * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
040: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
041: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
042: * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
043: * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
044: * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
045: * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
046: * SUCH DAMAGE.
047: * ====================================================================
048: *
049: * This software consists of voluntary contributions made by many
050: * individuals on behalf of LateralNZ. For more
051: * information on Lateral, please see http://www.lateralnz.com/ or
052: * http://www.lateralnz.org
053: *
054: */
055: package org.lateralnz.simpletrans;
056:
057: import java.util.Iterator;
058: import java.util.HashMap;
059: import java.util.Map;
060: import java.sql.SQLException;
061:
062: import javax.transaction.Status;
063: import javax.transaction.Synchronization;
064: import javax.transaction.Transaction;
065: import javax.transaction.xa.XAResource;
066:
067: import org.apache.log4j.Logger;
068:
069: import org.lateralnz.common.util.DAOUtils;
070:
071: /**
072: * a 'simple' transaction storing a map of named 'transaction-aware' connections. This class
073: * partially implements a javax.transaction.Transaction, but adds proprietary (to this package)
074: * methods for adding TransConnection objects.
075: * Note also that this isn't a true implementation of a transaction (by any stretch of
076: * the imagination). If two connections have been enlisted from different databases
077: * and a commit succeeds on one, then fails on the other, your data will (obviously) end up
078: * in an inconsistent state.
079: *
080: * @see org.lateralnz.panther.trans.TransConnection
081: *
082: * @author J R Briggs
083: */
084: public class SimpleTransaction implements Transaction {
085: private static final Logger log = Logger
086: .getLogger(SimpleTransaction.class.getName());
087:
088: private Map connMap = new HashMap(); // the map of trans connections
089: private int status; // the status of this transaction
090:
091: /**
092: * create a new transaction and make it active
093: */
094: public SimpleTransaction() {
095: if (log.isDebugEnabled()) {
096: log.debug("starting new transaction");
097: }
098: status = Status.STATUS_ACTIVE;
099: }
100:
101: /**
102: * commit a transaction, and close any connections that have been flagged for
103: * closing
104: */
105: public void commit() {
106: status = Status.STATUS_COMMITTING;
107: Iterator iter = connMap.values().iterator();
108: while (iter.hasNext()) {
109: TransConnection conn = (TransConnection) iter.next();
110: try {
111: conn.doCommit();
112:
113: if (conn.isCloseFlagged()) {
114: conn.doClose();
115: iter.remove();
116: }
117: } catch (SQLException se) {
118: se.printStackTrace();
119: }
120: }
121: status = Status.STATUS_COMMITTED;
122: }
123:
124: public boolean delistResource(XAResource xAResource, int param) {
125: TransConnection conn = (TransConnection) xAResource;
126: DAOUtils.close(conn);
127: connMap.remove(conn.getName());
128: return true;
129:
130: }
131:
132: public boolean enlistResource(XAResource xAResource) {
133: if (!(xAResource instanceof TransConnection)) {
134: throw new UnsupportedOperationException();
135: }
136: try {
137: TransConnection conn = (TransConnection) xAResource;
138: conn.setAutoCommit(false);
139: connMap.put(conn.getName(), conn);
140: return true;
141: } catch (SQLException se) {
142: se.printStackTrace();
143: return false;
144: }
145: }
146:
147: /**
148: * get a resource by name
149: */
150: public Object getResource(String name) {
151: if (connMap.containsKey(name)) {
152: return connMap.get(name);
153: } else {
154: return null;
155: }
156: }
157:
158: /**
159: * get the status of this transaction
160: */
161: public int getStatus() {
162: return status;
163: }
164:
165: /**
166: * not supported
167: */
168: public void registerSynchronization(Synchronization synchronization) {
169: throw new UnsupportedOperationException();
170: }
171:
172: /**
173: * rollback the connections in this transaction
174: */
175: public void rollback() {
176: status = Status.STATUS_ROLLING_BACK;
177: Iterator iter = connMap.values().iterator();
178: while (iter.hasNext()) {
179: TransConnection conn = (TransConnection) iter.next();
180: try {
181: if (log.isDebugEnabled()) {
182: log.debug("rollback connection " + conn);
183: }
184: conn.doRollback(null);
185:
186: if (conn.isCloseFlagged()) {
187: if (log.isDebugEnabled()) {
188: log
189: .debug("close flagged, so closing connection");
190: }
191: conn.doClose();
192: iter.remove();
193: }
194: } catch (SQLException se) {
195: se.printStackTrace();
196: }
197: }
198: status = Status.STATUS_ROLLEDBACK;
199: }
200:
201: /**
202: * flag that a rollback is required
203: */
204: public void setRollbackOnly() {
205: status = Status.STATUS_MARKED_ROLLBACK;
206: }
207: }
|