jaxp/src/javax/xml/validation/SchemaFactory.java
changeset 17534 21dc0b2762da
parent 17264 3aff554ad461
child 20581 65d17ea72da3
equal deleted inserted replaced
17533:93a2cadbbd33 17534:21dc0b2762da
   388      *
   388      *
   389      * <p>The property name is any fully-qualified URI.  It is
   389      * <p>The property name is any fully-qualified URI.  It is
   390      * possible for a {@link SchemaFactory} to recognize a property name but
   390      * possible for a {@link SchemaFactory} to recognize a property name but
   391      * to be unable to change the current value.</p>
   391      * to be unable to change the current value.</p>
   392      *
   392      *
   393      * <p>{@link SchemaFactory}s are not required to recognize setting
   393      * <p>
   394      * any specific property names.</p>
   394      * All implementations that implement JAXP 1.5 or newer are required to
       
   395      * support the {@link javax.xml.XMLConstants#ACCESS_EXTERNAL_DTD} and
       
   396      * {@link javax.xml.XMLConstants#ACCESS_EXTERNAL_SCHEMA} properties.
       
   397      * </p>
       
   398      * <ul>
       
   399      *   <li>
       
   400      *      <p>Access to external DTDs in Schema files is restricted to the protocols
       
   401      *      specified by the {@link javax.xml.XMLConstants#ACCESS_EXTERNAL_DTD} property.
       
   402      *      If access is denied during the creation of new Schema due to the restriction
       
   403      *      of this property, {@link org.xml.sax.SAXException} will be thrown by the
       
   404      *      {@link #newSchema(Source)} or {@link #newSchema(File)}
       
   405      *      or {@link #newSchema(URL)} or  or {@link #newSchema(Source[])} method.</p>
       
   406      *
       
   407      *      <p>Access to external DTDs in xml source files is restricted to the protocols
       
   408      *      specified by the {@link javax.xml.XMLConstants#ACCESS_EXTERNAL_DTD} property.
       
   409      *      If access is denied during validation due to the restriction
       
   410      *      of this property, {@link org.xml.sax.SAXException} will be thrown by the
       
   411      *      {@link javax.xml.validation.Validator#validate(Source)} or
       
   412      *      {@link javax.xml.validation.Validator#validate(Source, Result)} method.</p>
       
   413      *
       
   414      *      <p>Access to external reference set by the schemaLocation attribute is
       
   415      *      restricted to the protocols specified by the
       
   416      *      {@link javax.xml.XMLConstants#ACCESS_EXTERNAL_SCHEMA} property.
       
   417      *      If access is denied during validation due to the restriction of this property,
       
   418      *      {@link org.xml.sax.SAXException} will be thrown by the
       
   419      *      {@link javax.xml.validation.Validator#validate(Source)} or
       
   420      *      {@link javax.xml.validation.Validator#validate(Source, Result)} method.</p>
       
   421      *
       
   422      *      <p>Access to external reference set by the Import
       
   423      *      and Include element is restricted to the protocols specified by the
       
   424      *      {@link javax.xml.XMLConstants#ACCESS_EXTERNAL_SCHEMA} property.
       
   425      *      If access is denied during the creation of new Schema due to the restriction
       
   426      *      of this property, {@link org.xml.sax.SAXException} will be thrown by the
       
   427      *      {@link #newSchema(Source)} or {@link #newSchema(File)}
       
   428      *      or {@link #newSchema(URL)} or {@link #newSchema(Source[])} method.</p>
       
   429      *   </li>
       
   430      * </ul>
   395      *
   431      *
   396      * @param name The property name, which is a non-null fully-qualified URI.
   432      * @param name The property name, which is a non-null fully-qualified URI.
   397      * @param object The requested value for the property.
   433      * @param object The requested value for the property.
   398      *
   434      *
   399      * @throws SAXNotRecognizedException If the property
   435      * @throws SAXNotRecognizedException If the property