com.supermap.data

类 CloudStorageConnectionInfo

java.lang.Object

com.supermap.data.InternalHandle

com.supermap.data.InternalHandleDisposable

com.supermap.data.CloudStorageConnectionInfo

所有已实现的接口:

IDisposable

直接已知子类:

CloudStorageConnectionInfoFTP, CloudStorageConnectionInfoS3

public abstract class CloudStorageConnectionInfo
extends com.supermap.data.InternalHandleDisposable

云存储服务连接信息，为CloudStorageType 各种云存储服务类型的基类。

方法概要

限定符和类型	方法和说明
void	dispose() 销毁对象
boolean	equals(Object obj) 比较两个对象是否相同。
static CloudStorageConnectionInfo	fromXML(String xml) 解析xml格式的云存储服务连接信息字符串获得云存储服务连接信息对象。
String	getName() 返回云存储服务连接信息的名称。
String	getPath() 返回连接至云存储服务中指定文件夹的路径，即相对于云存储服务根目录路径。
CloudStorageType	getType() 返回云存储服务的类型。
void	setPath(String path) 设置连接至云存储服务中指定文件夹的路径，即相对于云存储服务根目录路径。
static String	toXML(CloudStorageConnectionInfo info) 生成xml格式的云存储服务连接信息字符串。

从类继承的方法 com.supermap.data.InternalHandleDisposable

makeSureNativeObjectLive

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

getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

fromXML

public static CloudStorageConnectionInfo fromXML(String xml)

解析xml格式的云存储服务连接信息字符串获得云存储服务连接信息对象。

参数:

xml - xml格式的云存储服务连接信息字符串。

返回:

返回云存储服务连接信息对象。

抛出:

IllegalArgumentException - 输入的XML文本为空。

从以下版本开始:

11.2.0

toXML

public static String toXML(CloudStorageConnectionInfo info)

生成xml格式的云存储服务连接信息字符串。

参数:

info - 云存储服务连接信息对象。

返回:

返回生成的xml格式的云存储服务连接信息字符串。

抛出:

IllegalArgumentException - 输入的XML文本为空。

从以下版本开始:

11.2.0

dispose

public void dispose()

销毁对象

getType

public CloudStorageType getType()

返回云存储服务的类型。

返回:

返回云存储服务的类型。

从以下版本开始:

11.2.0

getName

public String getName()

返回云存储服务连接信息的名称。

返回:

返回云存储服务连接信息的名称。

抛出:

IllegalStateException - 当前对象已被释放

从以下版本开始:

11.2.0

getPath

public String getPath()

返回连接至云存储服务中指定文件夹的路径，即相对于云存储服务根目录路径。通过CloudStorageConnectionInfo.setPath(String)方法设置，若未设置，将连接至云存储服务的根目录。对象存储服务的根目录为存储桶根目录，FTP服务的根目录为FTP服务器根目录。

• 针对对象存储服务，为了用户更方便地管理数据，对象存储服务提供了虚拟文件夹。例如：在对象存储桶下使用"/folder1/folder2/subdir/”虚拟文件夹路径来管理"image.tif”影像，其相对存储桶根目录的路径为：/folder1/folder2/subdir/image.tif。

基于上面示例，若通过该方法设置文件夹路径为/folder1/folder2/，访问对象存储桶中folder2文件夹下的文件和子文件夹时，对象存储路径要写成：//CloudStorageInfoS3/subdir/image.tif，其中，//为云存储路径的必须前缀，“CloudStorageInfoS3”为云存储服务连接信息名称，/subdir/image.tif 为连接文件夹下的子目录路径。

• 针对FTP服务，例如：ftp://127.0.0.1/folder1/folder2/subdir/image.tif,若设置文件夹路径为/folder1/folder2/，访问FTP中folder2文件夹下的文件和子文件夹时，FTP服务路径要写成：//CloudStorageInfoFTP/subdir/image.tif，其中，//为云存储路径的必须前缀，“CloudStorageInfoFTP”为云存储服务连接信息名称，/subdir/image.tif 为连接文件夹下的子目录路径。

返回:

返回连接至云存储服务中指定文件夹的路径，即相对于云存储服务根目录路径。对象存储服务的根目录为存储桶根目录，FTP服务的根目录为FTP服务器根目录。

抛出:

IllegalStateException - 当前对象已被释放

从以下版本开始:

11.2.0

setPath

public void setPath(String path)

设置连接至云存储服务中指定文件夹的路径，即相对于云存储服务根目录路径。若未设置，将连接至云存储服务的根目录。对象存储服务的根目录为存储桶根目录，FTP服务的根目录为FTP服务器根目录。

• 针对对象存储服务，为了用户更方便地管理数据，对象存储服务提供了虚拟文件夹。例如：在对象存储桶下使用"/folder1/folder2/subdir/”虚拟文件夹路径来管理"image.tif”影像，其相对存储桶根目录的路径为：/folder1/folder2/subdir/image.tif。

基于上面示例，若通过该方法设置文件夹路径为/folder1/folder2/，访问对象存储桶中folder2文件夹下的文件和子文件夹时，对象存储路径要写成：//CloudStorageInfoS3/subdir/image.tif，其中，//为云存储路径的必须前缀，“CloudStorageInfoS3”为云存储服务连接信息名称，/subdir/image.tif 为连接文件夹下的子目录路径。

• 针对FTP服务，例如：ftp://127.0.0.1/folder1/folder2/subdir/image.tif,若设置文件夹路径为/folder1/folder2/，访问FTP中folder2文件夹下的文件和子文件夹时，FTP服务路径要写成：//CloudStorageInfoFTP/subdir/image.tif，其中，//为云存储路径的必须前缀，“CloudStorageInfoFTP”为云存储服务连接信息名称，/subdir/image.tif 为连接文件夹下的子目录路径。

参数:

path - 云存储服务中指定文件夹的路径，即相对于云存储服务根目录路径。对象存储服务的根目录为存储桶根目录，FTP服务的根目录为FTP服务器根目录。

抛出:

IllegalStateException - 当前对象已被释放

从以下版本开始:

11.2.0

equals

public boolean equals(Object obj)

比较两个对象是否相同。（比较云存储服务连接信息的名称、类型）

覆盖:

equals 在类中 Object

参数:

obj - 参与比较的对象。

返回:

true表示相同，false表示不相同。