KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > mr > api > jms > MantaXASession


1 /*
2  * Copyright 2002 by
3  * <a HREF="http://www.coridan.com">Coridan</a>
4  * <a HREF="mailto: support@coridan.com ">support@coridan.com</a>
5  *
6  * The contents of this file are subject to the Mozilla Public License Version
7  * 1.1 (the "License"); you may not use this file except in compliance with the
8  * License. You may obtain a copy of the License at
9  * http://www.mozilla.org/MPL/
10  *
11  * Software distributed under the License is distributed on an "AS IS" basis,
12  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
13  * for the specific language governing rights and limitations under the
14  * License.
15  *
16  * The Original Code is "MantaRay" (TM).
17  *
18  * The Initial Developer of the Original Code is Nimo.
19  * Portions created by the Initial Developer are Copyright (C) 2006
20  * Coridan Inc. All Rights Reserved.
21  *
22  * Contributor(s): all the names of the contributors are added in the source
23  * code where applicable.
24  *
25  * Alternatively, the contents of this file may be used under the terms of the
26  * LGPL license (the "GNU LESSER GENERAL PUBLIC LICENSE"), in which case the
27  * provisions of LGPL are applicable instead of those above. If you wish to
28  * allow use of your version of this file only under the terms of the LGPL
29  * License and not to allow others to use your version of this file under
30  * the MPL, indicate your decision by deleting the provisions above and
31  * replace them with the notice and other provisions required by the LGPL.
32  * If you do not delete the provisions above, a recipient may use your version
33  * of this file under either the MPL or the GNU LESSER GENERAL PUBLIC LICENSE.
34  
35  *
36  * This library is free software; you can redistribute it and/or modify it
37  * under the terms of the MPL as stated above or under the terms of the GNU
38  * Lesser General Public License as published by the Free Software Foundation;
39  * either version 2.1 of the License, or any later version.
40  *
41  * This library is distributed in the hope that it will be useful, but WITHOUT
42  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
43  * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
44  * License for more details.
45  */
46 package org.mr.api.jms;
47
48 import java.io.ByteArrayInputStream JavaDoc;
49 import java.io.ByteArrayOutputStream JavaDoc;
50 import java.io.IOException JavaDoc;
51 import java.io.ObjectInputStream JavaDoc;
52 import java.io.ObjectOutputStream JavaDoc;
53 import java.util.ArrayList JavaDoc;
54 import java.util.Collection JavaDoc;
55 import java.util.Iterator JavaDoc;
56
57 import javax.jms.JMSException JavaDoc;
58 import javax.jms.QueueSession JavaDoc;
59 import javax.jms.Session JavaDoc;
60 import javax.jms.TextMessage JavaDoc;
61 import javax.jms.TopicSession JavaDoc;
62 import javax.jms.TransactionInProgressException JavaDoc;
63 import javax.jms.XAQueueSession JavaDoc;
64 import javax.jms.XASession JavaDoc;
65 import javax.jms.XATopicSession JavaDoc;
66 import javax.transaction.xa.XAException JavaDoc;
67 import javax.transaction.xa.XAResource JavaDoc;
68 import javax.transaction.xa.Xid JavaDoc;
69
70 import org.mr.core.persistent.PersistentMap;
71 import org.mr.core.protocol.MantaBusMessage;
72 import org.mr.core.util.byteable.ByteableByteArray;
73
74
75 /**
76  *
77  * @author Nimo
78  *
79  * This class implements the javax.jms.XASession interface.
80  * The XASession is given to a user that wishes to have the MantaRay participate
81  * in a JTA/XA transactional activity.
82  * The MantaXASession uses an XAResource as specified by the JTA/XA spec.
83  *
84  */
85 public class MantaXASession extends MantaSession implements XASession JavaDoc, XATopicSession JavaDoc, XAQueueSession JavaDoc
86 {
87       
88       /**
89        * Constructor
90        *
91        * Creates a MantaXASession. An xa session is actually a regular MantaSession,
92        * that has some methods hidden and some methods added.
93        *
94        * @param cnx - The creating connection
95        */
96       MantaXASession(MantaConnection cnx) throws JMSException JavaDoc
97       {
98         super(cnx.messageChannel.getMessageId(), cnx, Session.SESSION_TRANSACTED,true);//, true, 0);
99 }
100       
101       /**
102        * from API: gets the session for this XASession. This simply returns
103        * the MantaXASession object itself.
104        *
105        */
106       public Session JavaDoc getSession() throws JMSException JavaDoc
107       {
108         checkLegalOperation();
109         
110         return this;
111       }
112      
113       /**
114        * from API: Get the XAResource connected to this session.
115        * The XAResource is the actual resource participating in an XA transaction,
116        *
117        */
118       public XAResource JavaDoc getXAResource()
119       {
120         return transactionContext;
121       }
122
123     
124       /**
125        * This method is hidden, since it is forbidden for use on an XA Session.
126        * Therefore - it will throw an exception.
127        *
128        */
129       public void commit() throws JMSException JavaDoc {
130         throw new TransactionInProgressException JavaDoc("MNJMS00019 : CAN NOT commit() AN XA SESSION.");
131       }
132
133       /**
134        * This method is hidden, since it is forbidden for use on an XA Session.
135        * Therefore - it will throw an exception.
136        *
137        */
138       public void rollback() throws JMSException JavaDoc {
139         throw new TransactionInProgressException JavaDoc("MNJMS0001A : CAN NOT rollback() AN XA SESSION.");
140       }
141
142       
143     public TopicSession JavaDoc getTopicSession() throws JMSException JavaDoc {
144         return (TopicSession JavaDoc)this;
145     }
146
147     public QueueSession JavaDoc getQueueSession() throws JMSException JavaDoc {
148         return (QueueSession JavaDoc)this;
149     }
150     
151     // overrides the method in MantaSession to prevent
152 // starting local transactions.
153 void startLocalTransactionIfNeeded() throws JMSException JavaDoc {
154         // do nothing
155 }
156           
157 }
158
Popular Tags