1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103
/* * $Id: SAAJMetaFactory.java,v 1.2.2.15 2005/02/11 07:26:15 vj135062 Exp $ * $Revision: 1.2.2.15 $ * $Date: 2005/02/11 07:26:15 $ */ /* * Copyright 2003 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package javax.xml.soap; /** * The access point for the implementation classes of the factories defined in the * SAAJ API. All of the <code>newInstance</code> methods defined on factories in * SAAJ 1.3 defer to instances of this class to do the actual object creation. * The implementations of <code>newInstance()</code> methods (in SOAPFactory and MessageFactory) * that existed in SAAJ 1.2 have been updated to also delegate to the SAAJMetaFactory when the SAAJ 1.2 * defined lookup fails to locate the Factory implementation class name. * * <p> * SAAJMetaFactory is a service provider interface. There are no public methods on this * class. * * @author SAAJ RI Development Team * @since SAAJ 1.3 */ public abstract class SAAJMetaFactory { static private final String META_FACTORY_CLASS_PROPERTY = "javax.xml.soap.MetaFactory"; static private final String DEFAULT_META_FACTORY_CLASS = "com.sun.xml.internal.messaging.saaj.soap.SAAJMetaFactoryImpl"; static private SAAJMetaFactory instance = null; /** * Creates a new instance of a concrete <code>SAAJMetaFactory</code> object. * The SAAJMetaFactory is an SPI, it pulls the creation of the other factories together into a * single place. Changing out the SAAJMetaFactory has the effect of changing out the entire SAAJ * implementation. Service providers provide the name of their <code>SAAJMetaFactory</code> * implementation. * * This method uses the following ordered lookup procedure to determine the SAAJMetaFactory implementation class to load: * <UL> * <LI> Use the javax.xml.soap.MetaFactory system property. * <LI> Use the properties file "lib/jaxm.properties" in the JRE directory. This configuration file is in standard * java.util.Properties format and contains the fully qualified name of the implementation class with the key being the * system property defined above. * <LI> Use the Services API (as detailed in the JAR specification), if available, to determine the classname. The Services API * will look for a classname in the file META-INF/services/javax.xml.soap.MetaFactory in jars available to the runtime. * <LI> Default to com.sun.xml.internal.messaging.saaj.soap.SAAJMetaFactoryImpl. * </UL> * * @return a concrete <code>SAAJMetaFactory</code> object * @exception SOAPException if there is an error in creating the <code>SAAJMetaFactory</code> */ static synchronized SAAJMetaFactory getInstance() throws SOAPException { if (instance == null) { try { instance = (SAAJMetaFactory) FactoryFinder.find( META_FACTORY_CLASS_PROPERTY, DEFAULT_META_FACTORY_CLASS); } catch (Exception e) { throw new SOAPException( "Unable to create SAAJ meta-factory" + e.getMessage()); } } return instance; } protected SAAJMetaFactory() { } /** * Creates a <code>MessageFactory</code> object for * the given <code>String</code> protocol. * * @param protocol a <code>String</code> indicating the protocol * @exception SOAPException if there is an error in creating the * MessageFactory * @see SOAPConstants#SOAP_1_1_PROTOCOL * @see SOAPConstants#SOAP_1_2_PROTOCOL * @see SOAPConstants#DYNAMIC_SOAP_PROTOCOL */ protected abstract MessageFactory newMessageFactory(String protocol) throws SOAPException; /** * Creates a <code>SOAPFactory</code> object for * the given <code>String</code> protocol. * * @param protocol a <code>String</code> indicating the protocol * @exception SOAPException if there is an error in creating the * SOAPFactory * @see SOAPConstants#SOAP_1_1_PROTOCOL * @see SOAPConstants#SOAP_1_2_PROTOCOL * @see SOAPConstants#DYNAMIC_SOAP_PROTOCOL */ protected abstract SOAPFactory newSOAPFactory(String protocol) throws SOAPException; }