Class CatalogManager
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
- Author:
- Norman Walsh Norman.Walsh@Sun.COM
- See Also:
-
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescriptionConstructor.CatalogManager
(String propertyFile) Constructor that specifies an explicit property file. -
Method Summary
Modifier and TypeMethodDescriptionboolean
Deprecated.No longer static; use get/set methods.Deprecated.No longer static; use get/set methods.Deprecated.No longer static; use get/set methods.boolean
Get the current XML Catalog PI setting.Get the bootstrap resolver.Get a catalog instance.Get the current Catalog class name.Return the current list of catalog files.boolean
How are missing properties handled?boolean
Return the current prefer public setting.Get a new catalog instance.boolean
Get the relativeCatalogs setting.static CatalogManager
Allow access to the static CatalogManagerboolean
Get the current use static catalog setting.int
What is the current verbosity?void
ignoreMissingProperties
(boolean ignore) Deprecated.No longer static; use get/set methods.boolean
Deprecated.No longer static; use get/set methods.boolean
Obtain the oasisXMLCatalogPI setting from the properties.Obtain the Catalog class name setting from the properties.boolean
Deprecated.No longer static; use get/set methods.void
setAllowOasisXMLCatalogPI
(boolean allowPI) Set the XML Catalog PI settingvoid
setBootstrapResolver
(BootstrapResolver resolver) Set the bootstrap resolver.void
setCatalogClassName
(String className) Set the Catalog class name.void
setCatalogFiles
(String fileList) Set the list of catalog files.void
setIgnoreMissingProperties
(boolean ignore) How should missing properties be handled?void
setPreferPublic
(boolean preferPublic) Set the prefer public setting.void
setRelativeCatalogs
(boolean relative) Set the relativeCatalogs setting.void
setUseStaticCatalog
(boolean useStatic) Set the use static catalog setting.void
setVerbosity
(int verbosity) Set the current verbosity.boolean
Deprecated.No longer static; use get/set methods.int
Deprecated.No longer static; use get/set methods.
-
Field Details
-
debug
The manager's debug object. Used for printing debugging messages.This field is public so that objects that have access to this CatalogManager can use this debug object.
-
-
Constructor Details
-
CatalogManager
public CatalogManager()Constructor. -
CatalogManager
Constructor that specifies an explicit property file.
-
-
Method Details
-
setBootstrapResolver
Set the bootstrap resolver. -
getBootstrapResolver
Get the bootstrap resolver. -
getStaticManager
Allow access to the static CatalogManager -
getIgnoreMissingProperties
public boolean getIgnoreMissingProperties()How are missing properties handled?If true, missing or unreadable property files will not be reported. Otherwise, a message will be sent to System.err.
-
setIgnoreMissingProperties
public void setIgnoreMissingProperties(boolean ignore) How should missing properties be handled?If ignore is true, missing or unreadable property files will not be reported. Otherwise, a message will be sent to System.err.
-
ignoreMissingProperties
public void ignoreMissingProperties(boolean ignore) Deprecated.No longer static; use get/set methods.How are missing properties handled?If ignore is true, missing or unreadable property files will not be reported. Otherwise, a message will be sent to System.err.
-
getVerbosity
public int getVerbosity()What is the current verbosity? -
setVerbosity
public void setVerbosity(int verbosity) Set the current verbosity. -
verbosity
public int verbosity()Deprecated.No longer static; use get/set methods.What is the current verbosity? -
getRelativeCatalogs
public boolean getRelativeCatalogs()Get the relativeCatalogs setting.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.
- Returns:
- The relativeCatalogs setting from the propertyFile or the defaultRelativeCatalogs.
-
setRelativeCatalogs
public void setRelativeCatalogs(boolean relative) Set the relativeCatalogs setting.- See Also:
-
relativeCatalogs
public boolean relativeCatalogs()Deprecated.No longer static; use get/set methods.Get the relativeCatalogs setting. -
getCatalogFiles
Return the current list of catalog files.- Returns:
- A vector of the catalog file names or null if no catalogs are available in the properties.
-
setCatalogFiles
Set the list of catalog files. -
catalogFiles
Deprecated.No longer static; use get/set methods.Return the current list of catalog files.- Returns:
- A vector of the catalog file names or null if no catalogs are available in the properties.
-
getPreferPublic
public boolean getPreferPublic()Return the current prefer public setting.- Returns:
- True if public identifiers are preferred.
-
setPreferPublic
public void setPreferPublic(boolean preferPublic) Set the prefer public setting. -
preferPublic
public boolean preferPublic()Deprecated.No longer static; use get/set methods.Return the current prefer public setting.- Returns:
- True if public identifiers are preferred.
-
getUseStaticCatalog
public boolean getUseStaticCatalog()Get the current use static catalog setting. -
setUseStaticCatalog
public void setUseStaticCatalog(boolean useStatic) Set the use static catalog setting. -
staticCatalog
public boolean staticCatalog()Deprecated.No longer static; use get/set methods.Get the current use static catalog setting. -
getPrivateCatalog
Get a new catalog instance. This method always returns a new instance of the underlying catalog class. -
getCatalog
Get a catalog instance. If this manager uses static catalogs, the same static catalog will always be returned. Otherwise a new catalog will be returned. -
queryAllowOasisXMLCatalogPI
public boolean queryAllowOasisXMLCatalogPI()Obtain the oasisXMLCatalogPI setting from the properties.
In the properties, a value of 'yes', 'true', or '1' is considered true, anything else is false.
- Returns:
- The oasisXMLCatalogPI setting from the propertyFile or the defaultOasisXMLCatalogPI.
-
getAllowOasisXMLCatalogPI
public boolean getAllowOasisXMLCatalogPI()Get the current XML Catalog PI setting. -
setAllowOasisXMLCatalogPI
public void setAllowOasisXMLCatalogPI(boolean allowPI) Set the XML Catalog PI setting -
allowOasisXMLCatalogPI
public boolean allowOasisXMLCatalogPI()Deprecated.No longer static; use get/set methods.Get the current XML Catalog PI setting. -
queryCatalogClassName
Obtain the Catalog class name setting from the properties. -
getCatalogClassName
Get the current Catalog class name. -
setCatalogClassName
Set the Catalog class name. -
catalogClassName
Deprecated.No longer static; use get/set methods.Get the current Catalog class name.
-