63 * to locate and load an implementation of the service using the {@linkplain
64 * java.util.ServiceLoader#load(java.lang.Class) default loading mechanism}:
65 * the service-provider loading facility will use the {@linkplain
66 * java.lang.Thread#getContextClassLoader() current thread's context class loader}
67 * to attempt to load the service. If the context class
68 * loader is null, the {@linkplain
69 * ClassLoader#getSystemClassLoader() system class loader} will be used.
70 * <p>
71 * In case of {@link java.util.ServiceConfigurationError service
72 * configuration error}, a {@link javax.xml.datatype.DatatypeConfigurationException}
73 * will be thrown.
74 * </li>
75 * <li>
76 * <p>
77 * The final mechanism is to attempt to instantiate the {@code Class} specified by
78 * {@link #DATATYPEFACTORY_IMPLEMENTATION_CLASS}.
79 * Any Exception thrown during the instantiation process is wrapped as a {@link DatatypeConfigurationException}.
80 * </li>
81 * </ol>
82 *
83 * @author <a href="mailto:Joseph.Fialli@Sun.COM">Joseph Fialli</a>
84 * @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
85 * @author <a href="mailto:Neeraj.Bajaj@sun.com">Neeraj Bajaj</a>
86 *
87 * @since 1.5
88 */
89 public abstract class DatatypeFactory {
90
91 /**
92 * Default property name as defined in JSR 206: Java(TM) API for XML Processing (JAXP) 1.3.
93 *
94 * <p>Default value is {@code javax.xml.datatype.DatatypeFactory}.
95 */
96 public static final String DATATYPEFACTORY_PROPERTY =
97 // We use a String constant here, rather than calling
98 // DatatypeFactory.class.getName() - in order to make javadoc
99 // generate a See Also: Constant Field Value link.
100 "javax.xml.datatype.DatatypeFactory";
101
102 /**
103 * Default implementation class name as defined in
104 * <em>JSR 206: Java(TM) API for XML Processing (JAXP) 1.3</em>.
105 *
|
63 * to locate and load an implementation of the service using the {@linkplain
64 * java.util.ServiceLoader#load(java.lang.Class) default loading mechanism}:
65 * the service-provider loading facility will use the {@linkplain
66 * java.lang.Thread#getContextClassLoader() current thread's context class loader}
67 * to attempt to load the service. If the context class
68 * loader is null, the {@linkplain
69 * ClassLoader#getSystemClassLoader() system class loader} will be used.
70 * <p>
71 * In case of {@link java.util.ServiceConfigurationError service
72 * configuration error}, a {@link javax.xml.datatype.DatatypeConfigurationException}
73 * will be thrown.
74 * </li>
75 * <li>
76 * <p>
77 * The final mechanism is to attempt to instantiate the {@code Class} specified by
78 * {@link #DATATYPEFACTORY_IMPLEMENTATION_CLASS}.
79 * Any Exception thrown during the instantiation process is wrapped as a {@link DatatypeConfigurationException}.
80 * </li>
81 * </ol>
82 *
83 * @author Joseph Fialli
84 * @author Jeff Suttor
85 * @author Neeraj Bajaj
86 *
87 * @since 1.5
88 */
89 public abstract class DatatypeFactory {
90
91 /**
92 * Default property name as defined in JSR 206: Java(TM) API for XML Processing (JAXP) 1.3.
93 *
94 * <p>Default value is {@code javax.xml.datatype.DatatypeFactory}.
95 */
96 public static final String DATATYPEFACTORY_PROPERTY =
97 // We use a String constant here, rather than calling
98 // DatatypeFactory.class.getName() - in order to make javadoc
99 // generate a See Also: Constant Field Value link.
100 "javax.xml.datatype.DatatypeFactory";
101
102 /**
103 * Default implementation class name as defined in
104 * <em>JSR 206: Java(TM) API for XML Processing (JAXP) 1.3</em>.
105 *
|