org.apache.xml.resolver
Class CatalogManager
public class CatalogManager
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 semicolon-delimited list of catalog files. |
| 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 in the
CatalogManager.properties file |
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. |
static boolean | allowOasisXMLCatalogPI() - Obtain the oasisXMLCatalogPI setting from the properties.
|
static String | catalogClassName() - Obtain the Catalog class name setting from the properties.
|
static Vector | catalogFiles() - Obtain the list of catalog files from the properties.
|
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.
|
static boolean | relativeCatalogs() - Obtain the relativeCatalogs setting from the properties.
|
static boolean | staticCatalog() - Obtain the static-catalog setting from the properties.
|
static int | verbosity() - Obtain the verbosity setting from the properties.
|
allowOasisXMLCatalogPI
public 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.
catalogClassName
public static String catalogClassName()
Obtain the Catalog class name setting from the properties.
catalogFiles
public 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.
ignoreMissingProperties
public 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. Otherwise, a message will be sent to System.err.
preferPublic
public static boolean preferPublic()
Obtain the preferPublic setting from the properties.
In the properties, a value of 'public' is true,
anything else is false.
relativeCatalogs
public static boolean relativeCatalogs()
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
only applies when the catalog files
come from a properties file. If they come from a system property or
the default list, they are never considered relative. (What would
they be relative to?)
In the properties, a value of 'yes', 'true', or '1' is considered
true, anything else is false.
staticCatalog
public 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.
verbosity
public static int verbosity()
Obtain the verbosity setting from the properties.
Copyright B) 2001 Apache. All Rights Reserved.