org.apache.xml.resolver
public class CatalogManager extends Object
CatalogManager provides an interface to the catalog properties.
Properties can come from two places: from system properties or from a CatalogManager.properties file. This class provides a transparent interface to both, with system properties preferred over property file values.
The following table summarizes the properties:
System Property | CatalogManager.properties Property |
Description |
xml.catalog.ignoreMissing | If true, a missing CatalogManager.properties file or missing properties within that file will not generate warning messages. See also the ignoreMissingProperties method. | |
xml.catalog.files | catalogs | The |
relative-catalogs | If false, relative catalog URIs are made absolute with respect to the base URI of
the CatalogManager.properties file. This setting only applies to catalog
URIs obtained from the catalogs property |
|
xml.catalog.verbosity | verbosity | If non-zero, the Catalog classes will print informative and debugging messages. The higher the number, the more messages. |
xml.catalog.prefer | prefer | Which identifier is preferred, "public" or "system"? |
xml.catalog.staticCatalog | static-catalog | Should a single catalog be constructed for all parsing, or should a different catalog be created for each parser? |
xml.catalog.allowPI | allow-oasis-xml-catalog-pi | If the source document contains "oasis-xml-catalog" processing instructions, should they be used? |
xml.catalog.className | catalog-class-name | If you're using the convenience classes org.apache.xml.resolver.tools.*), this setting allows you to specify an alternate class name to use for the underlying catalog. |
Version: 1.0
Method Summary | |
---|---|
static boolean | allowOasisXMLCatalogPI() Obtain the oasisXMLCatalogPI setting from the properties. In the properties, a value of 'yes', 'true', or '1' is considered true, anything else is false. |
static String | catalogClassName() Obtain the Catalog class name setting from the properties. |
static Vector | catalogFiles() Obtain the list of catalog files from the properties. Note that the list of catalog files is always a semicolon delimited list, even on Unix systems where a colon delimited list might be considered more natural. |
static void | ignoreMissingProperties(boolean ignore) Tell the CatalogManager how to handle missing properties If ignore is true, missing or unreadable property files will not be reported. |
static boolean | preferPublic() Obtain the preferPublic setting from the properties. In the properties, a value of 'public' is true, anything else is false. |
static boolean | relativeCatalogs() Obtain the relativeCatalogs setting from the properties. This property is used when the catalogFiles property is interrogated. |
static boolean | staticCatalog() Obtain the static-catalog setting from the properties. In the properties, a value of 'yes', 'true', or '1' is considered true, anything else is false. |
static int | verbosity() Obtain the verbosity setting from the properties. |
Obtain the oasisXMLCatalogPI setting from the properties.
In the properties, a value of 'yes', 'true', or '1' is considered true, anything else is false.
UNKNOWN: The oasisXMLCatalogPI setting from the propertyFile or the defaultOasisXMLCatalogPI.
Obtain the Catalog class name setting from the properties.
Obtain the list of catalog files from the properties.
Note that the list of catalog files is always a semicolon delimited list, even on Unix systems where a colon delimited list might be considered more natural.
UNKNOWN: A vector of the catalog file names or null if no catalogs are available in the properties.
Tell the CatalogManager how to handle missing properties
If ignore is true, missing or unreadable property files will not be reported. Otherwise, a message will be sent to System.err.
Obtain the preferPublic setting from the properties.
In the properties, a value of 'public' is true, anything else is false.
UNKNOWN: True if prefer is public or the defaultPreferSetting.
Obtain the relativeCatalogs setting from the properties.
This property is used when the catalogFiles property is interrogated. If true, then relative catalog entry file names are returned. If false, relative catalog entry file names are made absolute with respect to the properties file before returning them.
This property
In the properties, a value of 'yes', 'true', or '1' is considered true, anything else is false.
UNKNOWN: The relativeCatalogs setting from the propertyFile or the defaultRelativeCatalogs.
Obtain the static-catalog setting from the properties.
In the properties, a value of 'yes', 'true', or '1' is considered true, anything else is false.
UNKNOWN: The static-catalog setting from the propertyFile or the defaultStaticCatalog.
Obtain the verbosity setting from the properties.
UNKNOWN: The verbosity level from the propertyFile or the defaultVerbosity.