src/share/jaxws_classes/javax/xml/soap/SAAJMetaFactory.java

Print this page
rev 507 : 8047724: @since tag cleanup in jaxws
Reviewed-by:


  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package javax.xml.soap;
  27 
  28 /**
  29 * The access point for the implementation classes of the factories defined in the
  30 * SAAJ API. All of the <code>newInstance</code> methods defined on factories in
  31 * SAAJ 1.3 defer to instances of this class to do the actual object creation.
  32 * The implementations of <code>newInstance()</code> methods (in SOAPFactory and MessageFactory)
  33 * that existed in SAAJ 1.2 have been updated to also delegate to the SAAJMetaFactory when the SAAJ 1.2
  34 * defined lookup fails to locate the Factory implementation class name.
  35 *
  36 * <p>
  37 * SAAJMetaFactory is a service provider interface. There are no public methods on this
  38 * class.
  39 *
  40 * @author SAAJ RI Development Team
  41 * @since SAAJ 1.3
  42 */
  43 
  44 public abstract class SAAJMetaFactory {
  45     static private final String META_FACTORY_CLASS_PROPERTY =
  46         "javax.xml.soap.MetaFactory";
  47     static final String DEFAULT_META_FACTORY_CLASS =
  48         "com.sun.xml.internal.messaging.saaj.soap.SAAJMetaFactoryImpl";
  49 
  50     /**
  51      * Creates a new instance of a concrete <code>SAAJMetaFactory</code> object.
  52      * The SAAJMetaFactory is an SPI, it pulls the creation of the other factories together into a
  53      * single place. Changing out the SAAJMetaFactory has the effect of changing out the entire SAAJ
  54      * implementation. Service providers provide the name of their <code>SAAJMetaFactory</code>
  55      * implementation.
  56      *
  57      * This method uses the following ordered lookup procedure to determine the SAAJMetaFactory implementation class to load:
  58      * <UL>
  59      *  <LI> Use the javax.xml.soap.MetaFactory system property.
  60      *  <LI> Use the properties file "lib/jaxm.properties" in the JRE directory. This configuration file is in standard
  61      * java.util.Properties format and contains the fully qualified name of the implementation class with the key being the




  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package javax.xml.soap;
  27 
  28 /**
  29 * The access point for the implementation classes of the factories defined in the
  30 * SAAJ API. All of the <code>newInstance</code> methods defined on factories in
  31 * SAAJ 1.3 defer to instances of this class to do the actual object creation.
  32 * The implementations of <code>newInstance()</code> methods (in SOAPFactory and MessageFactory)
  33 * that existed in SAAJ 1.2 have been updated to also delegate to the SAAJMetaFactory when the SAAJ 1.2
  34 * defined lookup fails to locate the Factory implementation class name.
  35 *
  36 * <p>
  37 * SAAJMetaFactory is a service provider interface. There are no public methods on this
  38 * class.
  39 *
  40 * @author SAAJ RI Development Team
  41 * @since 1.6, SAAJ 1.3
  42 */
  43 
  44 public abstract class SAAJMetaFactory {
  45     static private final String META_FACTORY_CLASS_PROPERTY =
  46         "javax.xml.soap.MetaFactory";
  47     static final String DEFAULT_META_FACTORY_CLASS =
  48         "com.sun.xml.internal.messaging.saaj.soap.SAAJMetaFactoryImpl";
  49 
  50     /**
  51      * Creates a new instance of a concrete <code>SAAJMetaFactory</code> object.
  52      * The SAAJMetaFactory is an SPI, it pulls the creation of the other factories together into a
  53      * single place. Changing out the SAAJMetaFactory has the effect of changing out the entire SAAJ
  54      * implementation. Service providers provide the name of their <code>SAAJMetaFactory</code>
  55      * implementation.
  56      *
  57      * This method uses the following ordered lookup procedure to determine the SAAJMetaFactory implementation class to load:
  58      * <UL>
  59      *  <LI> Use the javax.xml.soap.MetaFactory system property.
  60      *  <LI> Use the properties file "lib/jaxm.properties" in the JRE directory. This configuration file is in standard
  61      * java.util.Properties format and contains the fully qualified name of the implementation class with the key being the