com.supermap.services.providers

类 AbstractDocumentGetRequest

java.lang.Object

com.supermap.services.providers.AbstractDocumentGetRequest

直接已知子类:

AbstractCapabilitiesRequest, AbstractFeatureTypeRequest, AbstractGetFeatureRequest

public abstract class AbstractDocumentGetRequest
extends java.lang.Object

XML 文档获取类。

通过 HTTP 的 GET 请求方法从指定 URI 获取 XML 文档。

字段概要

字段

限定符和类型	字段和说明
protected java.lang.String	password 访问 serviceURL 所需的密码。
protected java.lang.String	serviceURL 可以获取 XML 文档的 URI 地址。
static java.lang.String	URL_CHARSET 编辑 URI 地址（serviceURL）使用的字符集。
protected java.lang.String	userName 访问 serviceURL 所需的用户名。

构造器概要

构造器

限定符	构造器和说明
protected	AbstractDocumentGetRequest(java.lang.String serviceURL, java.lang.String userName, java.lang.String password) 通过 URI 地址、用户名、密码构建 AbstractDocumentGetRequest 对象。

方法概要

方法

限定符和类型	方法和说明
protected void	appendKVP(java.lang.StringBuffer sbToAdd, java.lang.String key, java.lang.String value) 在指定字符串缓冲区后添加关键字-值对，格式形如 “&key=value”，其中 key 为关键字，value 为取值。
protected void	appendKVP(java.lang.StringBuffer sbToAdd, java.lang.String key, java.lang.String[] values) 在指定字符串缓冲区后添加关键字-值对，格式形如 “&key=value”，其中 key 为关键字，value 为取值。
protected org.w3c.dom.Document	getDocument(java.lang.String url, java.lang.String userName, java.lang.String psd) 通过 HTTP 的 GET 请求方法从指定 URI 获取 XML 文档。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

serviceURL

protected final java.lang.String serviceURL

可以获取 XML 文档的 URI 地址。

userName

protected final java.lang.String userName

访问 serviceURL 所需的用户名。

password

protected final java.lang.String password

访问 serviceURL 所需的密码。

URL_CHARSET

public static final java.lang.String URL_CHARSET

编辑 URI 地址（serviceURL）使用的字符集。

构造器详细资料

AbstractDocumentGetRequest

protected AbstractDocumentGetRequest(java.lang.String serviceURL,
                          java.lang.String userName,
                          java.lang.String password)

通过 URI 地址、用户名、密码构建 AbstractDocumentGetRequest 对象。

参数:

serviceURL - 可以获取 XML 文档的 URI 地址。

userName - 用户名。

password - 密码。

方法详细资料

appendKVP

protected void appendKVP(java.lang.StringBuffer sbToAdd,
             java.lang.String key,
             java.lang.String value)

在指定字符串缓冲区后添加关键字-值对，格式形如 “&key=value”，其中 key 为关键字，value 为取值。

用于在 URI 后添加请求参数，其中 key 为参数名，value 为参数值，value 会使用 URLEncoder 对象进行编码，编码用的字符集为 URL_CHARSET，如果编码失败，则添加原 value。

参数:

sbToAdd - 保存 URI 的字符串缓冲区。

key - 参数名。

value - 参数值。

appendKVP

protected void appendKVP(java.lang.StringBuffer sbToAdd,
             java.lang.String key,
             java.lang.String[] values)

在指定字符串缓冲区后添加关键字-值对，格式形如 “&key=value”，其中 key 为关键字，value 为取值。

用于在 URI 后添加请求参数，其中 key 为参数名，value 为参数值，value 会使用 URLEncoder 对象进行编码，编码用的字符集为 URL_CHARSET，如果编码失败，则添加原 value。

参数:

sbToAdd - 保存 URI 的字符串缓冲区。

key - 参数名。

value - 参数值。

getDocument

protected org.w3c.dom.Document getDocument(java.lang.String url,
                               java.lang.String userName,
                               java.lang.String psd)
                                    throws HttpException,
                                           java.io.IOException

通过 HTTP 的 GET 请求方法从指定 URI 获取 XML 文档。

参数:

url - URI 文档的地址。

userName - 用户名，如果不需要可以为空（null 或 ""）。

psd - 密码，如果不需要可以为空（null 或 ""）。

返回:

XML 文档。

抛出:

HttpException - HTTP 请求异常。

java.io.IOException - 输入/输出异常。