< prev index next >

jaxp/src/java.xml/share/classes/javax/xml/datatype/DatatypeFactory.java

Print this page




  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  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.datatype;
  27 
  28 import java.math.BigDecimal;
  29 import java.math.BigInteger;
  30 import java.util.GregorianCalendar;
  31 import java.util.regex.Matcher;
  32 import java.util.regex.Pattern;
  33 import com.sun.org.apache.xerces.internal.jaxp.datatype.DatatypeFactoryImpl;
  34 
  35 /**
  36  * Factory that creates new {@code javax.xml.datatype} {@code Object}s that map XML to/from Java {@code Object}s.
  37  * <p>
  38  * A new instance of the {@code DatatypeFactory} is created through the {@link #newInstance()} method
  39  * that uses the following implementation resolution mechanisms to determine an implementation:
  40  * <ol>
  41  *    <li>
  42  *      If the system property specified by {@link #DATATYPEFACTORY_PROPERTY}, "{@code javax.xml.datatype.DatatypeFactory}",
  43  *      exists, a class with the name of the property value is instantiated.
  44  *      Any Exception thrown during the instantiation process is wrapped as a {@link DatatypeConfigurationException}.
  45  *    </li>
  46  *    <li>
  47  *      <p>
  48  *      Use the configuration file "jaxp.properties". The file is in standard
  49  *      {@link java.util.Properties} format and typically located in the
  50  *      {@code conf} directory of the Java installation. It contains the fully qualified
  51  *      name of the implementation class with the key being the system property
  52  *      defined above.
  53  *      <p>
  54  *      The jaxp.properties file is read only once by the JAXP implementation
  55  *      and its values are then cached for future use.  If the file does not exist
  56  *      when the first attempt is made to read from it, no further attempts are
  57  *      made to check for its existence.  It is not possible to change the value




  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  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.datatype;
  27 
  28 import java.math.BigDecimal;
  29 import java.math.BigInteger;
  30 import java.util.GregorianCalendar;
  31 import java.util.regex.Matcher;
  32 import java.util.regex.Pattern;
  33 import com.sun.org.apache.xerces.internal.jaxp.datatype.DatatypeFactoryImpl;
  34 
  35 /**
  36  * Factory that creates new {@code javax.xml.datatype} {@code Object}s that map XML to/from Java {@code Object}s.
  37  * <p id="DatatypeFactory.newInstance">
  38  * A new instance of the {@code DatatypeFactory} is created through the {@link #newInstance()} method
  39  * that uses the following implementation resolution mechanisms to determine an implementation:
  40  * <ol>
  41  *    <li>
  42  *      If the system property specified by {@link #DATATYPEFACTORY_PROPERTY}, "{@code javax.xml.datatype.DatatypeFactory}",
  43  *      exists, a class with the name of the property value is instantiated.
  44  *      Any Exception thrown during the instantiation process is wrapped as a {@link DatatypeConfigurationException}.
  45  *    </li>
  46  *    <li>
  47  *      <p>
  48  *      Use the configuration file "jaxp.properties". The file is in standard
  49  *      {@link java.util.Properties} format and typically located in the
  50  *      {@code conf} directory of the Java installation. It contains the fully qualified
  51  *      name of the implementation class with the key being the system property
  52  *      defined above.
  53  *      <p>
  54  *      The jaxp.properties file is read only once by the JAXP implementation
  55  *      and its values are then cached for future use.  If the file does not exist
  56  *      when the first attempt is made to read from it, no further attempts are
  57  *      made to check for its existence.  It is not possible to change the value


< prev index next >