XMLResolver (Java EE 5)

This interface is used to resolve resources during an XML parse. If an application wishes to perform custom entity resolution it must register an instance of this interface with the XMLInputFactory using the setXMLResolver method.

Version:

1.0

Author:

Copyright (c) 2003 by BEA Systems. All Rights Reserved.

public Object resolveEntity(String publicID, String systemID, String baseURI, String namespace) throws XMLStreamException
检索资源。此资源可以是下列三种返回类型之一：(1) java.io.InputStream (2) javax.xml.stream.XMLStreamReader (3) java.xml.stream.XMLEventReader。如果此方法返回 null，则处理器将尝试用其默认机制解析实体。

publicID	被引用的外部实体的公共标识符，如果未提供此类标识符，则该参数为 null。
systemID	被引用外部实体的系统标识符。
baseURI	与 systemId 关联的绝对基本 URI。
namespace	要解析的实体名称空间。
return	请求的资源或 null。
Throws	XMLStreamException: 如果尝试解析资源时出现错误。

英文文档：

resolveEntity

Object resolveEntity(String publicID,
                     String systemID,
                     String baseURI,
                     String namespace)
                     throws XMLStreamException

Retrieves a resource. This resource can be of the following three return types: (1) java.io.InputStream (2) javax.xml.stream.XMLStreamReader (3) java.xml.stream.XMLEventReader. If this method returns null the processor will attempt to resolve the entity using its default mechanism.

Parameters:

publicID - The public identifier of the external entity being referenced, or null if none was supplied.

systemID - The system identifier of the external entity being referenced.

baseURI - Absolute base URI associated with systemId.

namespace - The namespace of the entity to resolve.

Returns:

The resource requested or null.

Throws:

XMLStreamException - if there was a failure attempting to resolve the resource.

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.