KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > wsif > util > jms > WSIFJMSFinder


1 /*
2  * The Apache Software License, Version 1.1
3  *
4  *
5  * Copyright (c) 2002 The Apache Software Foundation. All rights
6  * reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  *
12  * 1. Redistributions of source code must retain the above copyright
13  * notice, this list of conditions and the following disclaimer.
14  *
15  * 2. Redistributions in binary form must reproduce the above copyright
16  * notice, this list of conditions and the following disclaimer in
17  * the documentation and/or other materials provided with the
18  * distribution.
19  *
20  * 3. The end-user documentation included with the redistribution,
21  * if any, must include the following acknowledgment:
22  * "This product includes software developed by the
23  * Apache Software Foundation (http://www.apache.org/)."
24  * Alternately, this acknowledgment may appear in the software itself,
25  * if and wherever such third-party acknowledgments normally appear.
26  *
27  * 4. The names "WSIF" and "Apache Software Foundation" must
28  * not be used to endorse or promote products derived from this
29  * software without prior written permission. For written
30  * permission, please contact apache@apache.org.
31  *
32  * 5. Products derived from this software may not be called "Apache",
33  * nor may "Apache" appear in their name, without prior written
34  * permission of the Apache Software Foundation.
35  *
36  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
37  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
38  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
39  * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
40  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
41  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
42  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
43  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
44  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
45  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
46  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
47  * SUCH DAMAGE.
48  * ====================================================================
49  *
50  * This software consists of voluntary contributions made by many
51  * individuals on behalf of the Apache Software Foundation and was
52  * originally based on software copyright (c) 2001, 2002, International
53  * Business Machines, Inc., http://www.apache.org. For more
54  * information on the Apache Software Foundation, please see
55  * <http://www.apache.org/>.
56  */

57
58 package org.apache.wsif.util.jms;
59
60 import java.util.ArrayList JavaDoc;
61 import java.util.Arrays JavaDoc;
62
63 import javax.jms.Destination JavaDoc;
64 import javax.jms.Queue JavaDoc;
65 import javax.jms.QueueConnectionFactory JavaDoc;
66 import org.apache.wsif.WSIFException;
67 import org.apache.wsif.logging.Trc;
68 import org.apache.wsif.wsdl.extensions.jms.JMSAddress;
69
70 /**
71  * Finds JMS objects. Classes that extend WSIFJMSFinder find the factory and queues either
72  * by going directly to an implementation of JMS or by looking them up in JNDI, or by some
73  * other means. A WSIFJMSDestination can then be constructed from this finder.
74  *
75  * @author Mark Whitlock <whitlock@apache.org>
76  */

77 public abstract class WSIFJMSFinder {
78     public static final String JavaDoc STYLE_QUEUE = "queue";
79     public static final String JavaDoc STYLE_TOPIC = "topic";
80
81     protected static final ArrayList JavaDoc allStyles =
82         new ArrayList JavaDoc(Arrays.asList(new Object JavaDoc[] { STYLE_QUEUE, STYLE_TOPIC }));
83
84     private static final String JavaDoc MQ_URL_PREFIX = "mq://";
85
86     abstract public QueueConnectionFactory JavaDoc getFactory();
87     abstract public Destination JavaDoc getInitialDestination();
88     abstract Queue JavaDoc findQueue(String JavaDoc name) throws WSIFException;
89     abstract String JavaDoc getStyle();
90
91     public static WSIFJMSFinder newFinder(JMSAddress ja, String JavaDoc portName) throws WSIFException {
92         Trc.entry(null, ja);
93         boolean jndiSpecified =
94             ja.getInitCxtFact() != null
95                 || ja.getJndiProvURL() != null
96                 || ja.getDestStyle() != null
97                 || ja.getJndiConnFactName() != null
98                 || ja.getJndiDestName() != null
99                 || ja.getJmsProvDestName() != null;
100         String JavaDoc implSpecURI = ja.getJmsImplSpecURI();
101
102         if (jndiSpecified && implSpecURI != null)
103             throw new WSIFException(
104                 "Cannot specify both JNDI attributes and "
105                     + "jmsImplementationSpecificURL in the jms:address in port "
106                     + portName);
107
108         if (!jndiSpecified && implSpecURI == null)
109             throw new WSIFException(
110                 "Must specify either JNDI attributes or "
111                     + "jmsImplementationSpecificURL in the jms:address in port "
112                     + portName);
113
114         WSIFJMSFinder finder;
115         if (jndiSpecified)
116             finder =
117                 new WSIFJMSFinderForJndi(
118                     ja.getJmsVendorURI(),
119                     ja.getInitCxtFact(),
120                     ja.getJndiProvURL(),
121                     ja.getDestStyle(),
122                     ja.getJndiConnFactName(),
123                     ja.getJndiDestName(),
124                     portName);
125         else {
126             if (implSpecURI.startsWith(MQ_URL_PREFIX))
127                 finder = new WSIFJMSFinderForMq(ja.getJmsVendorURI(), implSpecURI);
128             else
129                 throw new WSIFException(
130                     "No jms implementation found for jmsImplementationSpecificURI '"
131                         + implSpecURI
132                         + "' for port "
133                         + portName);
134         }
135         Trc.exit(finder);
136         return finder;
137     }
138 }
Popular Tags