6.18.3 Precautions related to schema definition files

1

,D that is coded at the end of a specified value of the schema_xxx property is considered as a disk cache specifier, so do not use names ending with ,D for schema document files.

2

A schema document that is referenced using xsd:import is always cached in the memory regardless of the specification of schema definition files. The schema document that is referenced using xsd:include or xsd:redefine is merged with grammar objects of the schema document of reference source, so the cache location (memory or a disk) will be the same as the location of the schema document of the reference source.

3

If a schema document that is to be used for verification is specified in the format of InputStream and array of objects within the http://java.sun.com/xml/jaxp/properties/schemaSource property, a cache will not be used during the verification.

You can use a cache only when the schema document is specified in any of the following formats: String, File, or InputSource. However, for InputSource, you must use the getSystemId method to acquire a system identifier.

4

When a parser error occurs while setting up a cache, the schema document that caused the error and the schema document referencing that document will not be cached.

5

The internal files (INFO file) used for cache setup and deletion by the schema cache functionality are saved in the cache_info directory (INFO directory) below <JAXP_DIR>. Therefore, if the disk storage of <JAXP_DIR>^# exceeds 100%, the cache functionality might not work normally.

6

The schema cache functionality changes or deletes the directories and files exist in the directory specified for the diskcache_path property. Therefore, do not specify a directory used by the system in the diskcache_path property.

7

When specifying a XML schema document, for which an external reference is to be resolved using the entity resolver, in the schema definition file, resolution of the external reference cannot be performed during the cache setup. Therefore, an attempt to parse the schema document will fail and the cache will not be set up.