| java.lang.Object
 com.sun.org.apache.xml.internal.resolver.Catalog
com.sun.org.apache.xml.internal.resolver.Resolver
| Resolver | | public class Resolver extends Catalog (Code) | | An extension to OASIS Open Catalog files, this class supports
suffix-based matching and an external RFC2483 resolver.
See Also: Catalog
author:
Norman Walsh
author:
Norman.Walsh@Sun.COM
version:
1.0 |
| Field Summary | |
| final public static int | RESOLVER
The RESOLVER Catalog Entry type. | | final public static int | SYSTEMREVERSE
The SYSTEMREVERSE Catalog Entry type.
This is a bit of a hack. | | final public static int | SYSTEMSUFFIX
The SYSTEMSUFFIX Catalog Entry type. | | final public static int | URISUFFIX
The URISUFFIX Catalog Entry type. |
| Method Summary | |
| public void | addEntry(CatalogEntry entry)
Cleanup and process a Catalog entry. | | protected Resolver | queryResolver(String resolver, String command, String arg1, String arg2)
Query an external RFC2483 resolver.
Parameters:
resolver - The URL of the RFC2483 resolver.
Parameters:
command - The command to send the resolver.
Parameters:
arg1 - The first argument to the resolver.
Parameters:
arg2 - The second argument to the resolver, usually null. | | public Vector | resolveAllSystem(String systemId)
Return the applicable SYSTEM system identifiers.
If one or more SYSTEM entries exists in the Catalog
for the system ID specified, return the mapped values.
The caller is responsible for doing any necessary
normalization of the system identifier before calling
this method. | | public Vector | resolveAllSystemReverse(String systemId)
Find the URNs for a given system identifier in all catalogs.
Parameters:
systemId - The system ID to locate. | | protected String | resolveExternalPublic(String publicId, String resolver)
Query an external RFC2483 resolver for a public identifier.
Parameters:
publicId - The system ID to locate.
Parameters:
resolver - The name of the resolver to use. | | protected String | resolveExternalSystem(String systemId, String resolver)
Query an external RFC2483 resolver for a system identifier.
Parameters:
systemId - The system ID to locate.
Parameters:
resolver - The name of the resolver to use. | | public String | resolvePublic(String publicId, String systemId)
Return the applicable PUBLIC or SYSTEM identifier, resorting
to external resolvers if necessary.
This method searches the Catalog and returns the system
identifier specified for the given system or
public identifiers. | | public String | resolveSystem(String systemId)
Return the applicable SYSTEM system identifier, resorting
to external RESOLVERs if necessary.
If a SYSTEM entry exists in the Catalog
for the system ID specified, return the mapped value.
In the Resolver (as opposed to the Catalog) class, if the
URI isn't found by the usual algorithm, SYSTEMSUFFIX entries are
considered.
On Windows-based operating systems, the comparison between
the system identifier provided and the SYSTEM entries in the
Catalog is case-insensitive.
Parameters:
systemId - The system ID to locate in the catalog. | | public String | resolveSystemReverse(String systemId)
Find the URN for a given system identifier.
Parameters:
systemId - The system ID to locate. | | public String | resolveURI(String uri)
Return the applicable URI.
If a URI entry exists in the Catalog
for the URI specified, return the mapped value.
In the Resolver (as opposed to the Catalog) class, if the
URI isn't found by the usual algorithm, URISUFFIX entries are
considered.
URI comparison is case sensitive.
Parameters:
uri - The URI to locate in the catalog. | | public void | setupReaders()
Setup readers. |
| RESOLVER | | final public static int RESOLVER(Code) | | The RESOLVER Catalog Entry type.
A hook for providing support for web-based backup resolvers.
|
| SYSTEMREVERSE | | final public static int SYSTEMREVERSE(Code) | | The SYSTEMREVERSE Catalog Entry type.
This is a bit of a hack. There's no actual SYSTEMREVERSE entry,
but this entry type is used to indicate that a reverse lookup is
being performed. (This allows the Resolver to implement
RFC2483 I2N and I2NS.)
|
| SYSTEMSUFFIX | | final public static int SYSTEMSUFFIX(Code) | | The SYSTEMSUFFIX Catalog Entry type.
System suffix entries match system identifiers that end in a
specified suffix.
|
| URISUFFIX | | final public static int URISUFFIX(Code) | | The URISUFFIX Catalog Entry type.
URI suffix entries match URIs that end in a specified suffix.
|
| addEntry | | public void addEntry(CatalogEntry entry)(Code) | | Cleanup and process a Catalog entry.
This method processes each Catalog entry, changing mapped
relative system identifiers into absolute ones (based on the current
base URI), and maintaining other information about the current
catalog.
Parameters:
entry - The CatalogEntry to process. |
| queryResolver | | protected Resolver queryResolver(String resolver, String command, String arg1, String arg2)(Code) | | Query an external RFC2483 resolver.
Parameters:
resolver - The URL of the RFC2483 resolver.
Parameters:
command - The command to send the resolver.
Parameters:
arg1 - The first argument to the resolver.
Parameters:
arg2 - The second argument to the resolver, usually null. The Resolver constructed. |
| resolveAllSystem | | public Vector resolveAllSystem(String systemId) throws MalformedURLException, IOException(Code) | | Return the applicable SYSTEM system identifiers.
If one or more SYSTEM entries exists in the Catalog
for the system ID specified, return the mapped values.
The caller is responsible for doing any necessary
normalization of the system identifier before calling
this method. For example, a relative system identifier in
a document might be converted to an absolute system identifier
before attempting to resolve it.
Note that this function will force all subordinate catalogs
to be loaded.
On Windows-based operating systems, the comparison between
the system identifier provided and the SYSTEM entries in the
Catalog is case-insensitive.
Parameters:
systemId - The system ID to locate in the catalog. The system identifier to use for the notation.
throws:
MalformedURLException - The formal system identifier of asubordinate catalog cannot be turned into a valid URL.
throws:
IOException - Error reading subordinate catalog file. |
| resolveAllSystemReverse | | public Vector resolveAllSystemReverse(String systemId) throws MalformedURLException, IOException(Code) | | Find the URNs for a given system identifier in all catalogs.
Parameters:
systemId - The system ID to locate. A vector of URNs that map to the systemId. |
| resolveExternalPublic | | protected String resolveExternalPublic(String publicId, String resolver) throws MalformedURLException, IOException(Code) | | Query an external RFC2483 resolver for a public identifier.
Parameters:
publicId - The system ID to locate.
Parameters:
resolver - The name of the resolver to use. The system identifier to use for the systemId. |
| resolveExternalSystem | | protected String resolveExternalSystem(String systemId, String resolver) throws MalformedURLException, IOException(Code) | | Query an external RFC2483 resolver for a system identifier.
Parameters:
systemId - The system ID to locate.
Parameters:
resolver - The name of the resolver to use. The system identifier to use for the systemId. |
| resolvePublic | | public String resolvePublic(String publicId, String systemId) throws MalformedURLException, IOException(Code) | | Return the applicable PUBLIC or SYSTEM identifier, resorting
to external resolvers if necessary.
This method searches the Catalog and returns the system
identifier specified for the given system or
public identifiers. If
no appropriate PUBLIC or SYSTEM entry is found in the Catalog,
null is returned.
Note that a system or public identifier in the current catalog
(or subordinate catalogs) will be used in preference to an
external resolver. Further, if a systemId is present, the external
resolver(s) will be queried for that before the publicId.
Parameters:
publicId - The public identifier to locate in the catalog.Public identifiers are normalized before comparison.
Parameters:
systemId - The nominal system identifier for the entityin question (as provided in the source document).
throws:
MalformedURLException - The formal system identifier of asubordinate catalog cannot be turned into a valid URL.
throws:
IOException - Error reading subordinate catalog file. The system identifier to use.Note that the nominal system identifier is not returned if amatch is not found in the catalog, instead null is returnedto indicate that no match was found. |
| resolveSystem | | public String resolveSystem(String systemId) throws MalformedURLException, IOException(Code) | | Return the applicable SYSTEM system identifier, resorting
to external RESOLVERs if necessary.
If a SYSTEM entry exists in the Catalog
for the system ID specified, return the mapped value.
In the Resolver (as opposed to the Catalog) class, if the
URI isn't found by the usual algorithm, SYSTEMSUFFIX entries are
considered.
On Windows-based operating systems, the comparison between
the system identifier provided and the SYSTEM entries in the
Catalog is case-insensitive.
Parameters:
systemId - The system ID to locate in the catalog. The system identifier to use for systemId.
throws:
MalformedURLException - The formal system identifier of asubordinate catalog cannot be turned into a valid URL.
throws:
IOException - Error reading subordinate catalog file. |
| resolveSystemReverse | | public String resolveSystemReverse(String systemId) throws MalformedURLException, IOException(Code) | | Find the URN for a given system identifier.
Parameters:
systemId - The system ID to locate. A (single) URN that maps to the systemId. |
| resolveURI | | public String resolveURI(String uri) throws MalformedURLException, IOException(Code) | | Return the applicable URI.
If a URI entry exists in the Catalog
for the URI specified, return the mapped value.
In the Resolver (as opposed to the Catalog) class, if the
URI isn't found by the usual algorithm, URISUFFIX entries are
considered.
URI comparison is case sensitive.
Parameters:
uri - The URI to locate in the catalog. The resolved URI.
throws:
MalformedURLException - The system identifier of asubordinate catalog cannot be turned into a valid URL.
throws:
IOException - Error reading subordinate catalog file. |
| setupReaders | | public void setupReaders()(Code) | | Setup readers.
|
| Methods inherited from com.sun.org.apache.xml.internal.resolver.Catalog | protected void addDelegate(CatalogEntry entry)(Code)(Java Doc)
public void addEntry(CatalogEntry entry)(Code)(Java Doc)
public void addReader(String mimeType, CatalogReader reader)(Code)(Java Doc)
protected void copyReaders(Catalog newCatalog)(Code)(Java Doc)
protected String encodedByte(int b)(Code)(Java Doc)
protected String fixSlashes(String sysid)(Code)(Java Doc)
public CatalogManager getCatalogManager()(Code)(Java Doc)
public String getCurrentBase()(Code)(Java Doc)
public String getDefaultOverride()(Code)(Java Doc)
public void loadSystemCatalogs() throws MalformedURLException, IOException(Code)(Java Doc)
protected String makeAbsolute(String sysid)(Code)(Java Doc)
protected Catalog newCatalog()(Code)(Java Doc)
protected String normalizeURI(String uriref)(Code)(Java Doc)
public void parseAllCatalogs() throws MalformedURLException, IOException(Code)(Java Doc)
public synchronized void parseCatalog(String fileName) throws MalformedURLException, IOException(Code)(Java Doc)
public synchronized void parseCatalog(String mimeType, InputStream is) throws IOException, CatalogException(Code)(Java Doc)
public synchronized void parseCatalog(URL aUrl) throws IOException(Code)(Java Doc)
protected synchronized void parseCatalogFile(String fileName) throws MalformedURLException, IOException, CatalogException(Code)(Java Doc)
protected synchronized void parsePendingCatalogs() throws MalformedURLException, IOException(Code)(Java Doc)
public String resolveDoctype(String entityName, String publicId, String systemId) throws MalformedURLException, IOException(Code)(Java Doc)
public String resolveDocument() throws MalformedURLException, IOException(Code)(Java Doc)
public String resolveEntity(String entityName, String publicId, String systemId) throws MalformedURLException, IOException(Code)(Java Doc)
protected synchronized String resolveLocalPublic(int entityType, String entityName, String publicId, String systemId) throws MalformedURLException, IOException(Code)(Java Doc)
protected String resolveLocalSystem(String systemId) throws MalformedURLException, IOException(Code)(Java Doc)
protected String resolveLocalURI(String uri) throws MalformedURLException, IOException(Code)(Java Doc)
public String resolveNotation(String notationName, String publicId, String systemId) throws MalformedURLException, IOException(Code)(Java Doc)
public String resolvePublic(String publicId, String systemId) throws MalformedURLException, IOException(Code)(Java Doc)
protected synchronized String resolveSubordinateCatalogs(int entityType, String entityName, String publicId, String systemId) throws MalformedURLException, IOException(Code)(Java Doc)
public String resolveSystem(String systemId) throws MalformedURLException, IOException(Code)(Java Doc)
public String resolveURI(String uri) throws MalformedURLException, IOException(Code)(Java Doc)
public void setCatalogManager(CatalogManager manager)(Code)(Java Doc)
public void setupReaders()(Code)(Java Doc)
public void unknownEntry(Vector strings)(Code)(Java Doc)
|
|
|