类 CloudStorageConnectionInfoManager
- java.lang.Object
-
- com.supermap.data.CloudStorageConnectionInfoManager
-
public class CloudStorageConnectionInfoManager extends Object
云存储服务连接信息管理类,负责管理整个进程的云存储服务连接信息,使应用程序能够同时访问多个云存储服务。SuperMap 支持管理和访问云存储服务后,一些功能相应地支持读写云存储服务目录和文件,包括对象存储和FTP服务,但这些功能并非同时支持对象存储服务和FTP服务。下文详细列出支持云存储服务的功能以及支持的范围:
- 地图瓦片支持对象存储。
- 支持读取对象存储和FTP服务中的影像文件,包括直接打开影像文件、镶嵌数据集添加影像文件。
- 支持为对象存储TIFF、IMAGE格式的影像创建和重建影像金字塔。
- 支持为对象存储影像的镶嵌数据集计算统计数据。
- 镶嵌数据集概视图文件支持对象存储。
- 地图输出为图片时,仅PNG、BMP、TIFF文件格式支持对象存储。
- 从以下版本开始:
- 11.2.0
-
-
方法概要
所有方法 静态方法 具体方法 限定符和类型 方法和说明 static boolean
add(CloudStorageConnectionInfo connInfo)
添加云存储服务连接信息。static boolean
canConnect(CloudStorageConnectionInfo connInfo)
判断指定的连接信息对象能否连接成功。static boolean
canConnect(String name)
判断指定名称的连接信息能否连接成功。static void
clear()
清除当前管理的全部连接信息。static CloudStorageConnectionInfo
find(String name)
返回指定名称的连接信息对象。static boolean
fromXML(String xml)
解析 xml 格式的云存储服务连接信息字符串,并作为新的连续信息对象添加到CloudStorageConnectionInfoManager
中。static int
getCacheSize()
返回连接云存储服务时,下载内容共享的LRU缓存大小,默认值为256MB。static int
getCount()
返回当前管理的连接信息的数目。static double
getHTTPConnectTimeOut()
返回连接云存储服务时,HTTP创建连接的超时时间,单位:秒,默认值为3秒。static int
getHTTPMaxRetry()
返回连接云存储服务时,HTTP的最大重试次数,默认值为3次。static double
getHTTPRetryDelay()
返回连接云存储服务时,HTTP的重试时间间隔,默认值为1.0秒。static double
getHTTPTimeOut()
返回连接云存储服务时,HTTP单个请求的总超时时间,单位:秒,默认值为10秒。static String[]
getNames()
返回当前管理的全部连接信息的名称。static void
remove(String name)
移除指定名称的连接信息。static void
setCacheSize(int cacheSize)
设置连接云存储服务时,下载内容共享的LRU缓存大小,默认值为256MB。static void
setHTTPConnectTimeOut(double timeOutValue)
设置连接云存储服务时,HTTP创建连接的超时时间,单位:秒,默认值为3秒。static void
setHTTPMaxRetry(int maxRetry)
设置连接云存储服务时,HTTP的最大重试次数,默认值为3次。static void
setHTTPRetryDelay(double maxRetry)
设置连接云存储服务时,HTTP的重试时间间隔,默认值为1.0秒。static void
setHTTPTimeOut(double timeOutValue)
设置连接云存储服务时,HTTP单个请求的总超时时间,单位:秒,默认值为10秒。static String
toXML()
将当前管理的全部连接信息输出为 XML 格式的字符串。static boolean
update(String connInfoName, CloudStorageConnectionInfo connInfo)
更新云存储服务的连接信息。
-
-
-
方法详细资料
-
getNames
public static String[] getNames()
返回当前管理的全部连接信息的名称。- 返回:
- 返回当前管理的全部连接信息的名称。
- 从以下版本开始:
- 11.2.0
-
getCount
public static int getCount()
返回当前管理的连接信息的数目。- 返回:
- 返回当前管理的连接信息的数目。
- 从以下版本开始:
- 11.2.0
-
canConnect
public static boolean canConnect(CloudStorageConnectionInfo connInfo)
判断指定的连接信息对象能否连接成功。- 参数:
connInfo
- 指定的连接信息对象。- 返回:
- 返回指定的连接信息对象能否连接成功,true表示成功,false表示失败。
- 从以下版本开始:
- 11.2.0
-
canConnect
public static boolean canConnect(String name)
判断指定名称的连接信息能否连接成功。- 参数:
name
- 指定的连接信息的名称,为已存在的连续信息的名称。- 返回:
- 返回指定名称的连接信息能否连接成功,true表示成功,false表示失败。
- 抛出:
IllegalArgumentException
- 连接信息的名称为空。- 从以下版本开始:
- 11.2.0
-
add
public static boolean add(CloudStorageConnectionInfo connInfo)
添加云存储服务连接信息。添加到
CloudStorageConnectionInfoManager
管理的CloudStorageConnectionInfo
对象均为对象的深拷贝,因此,修改CloudStorageConnectionInfoManager
中的连续信息对象后,必须调用CloudStorageConnectionInfoManager.update(String, CloudStorageConnectionInfo)
接口,才能更新CloudStorageConnectionInfoManager
中对应的连接信息对象。- 参数:
connInfo
- 待添加的云存储服务连接信息对象。若待添加的连接信息的名称与已有连接信息的名称相同,已有同名连接信息会被覆盖。- 返回:
- 添加是否成功,true表示成功,false表示失败。
- 抛出:
IllegalArgumentException
- 若云存储连接信息对象为空,或没有设置名称,则报非法参数异常。- 从以下版本开始:
- 11.2.0
-
update
public static boolean update(String connInfoName, CloudStorageConnectionInfo connInfo)
更新云存储服务的连接信息。添加到
CloudStorageConnectionInfoManager
管理的CloudStorageConnectionInfo
对象均为对象的深拷贝,因此修改CloudStorageConnectionInfoManager
中的连续信息对象后,必须调用此接口,才能更新CloudStorageConnectionInfoManager
中对应的连接信息对象。若
CloudStorageConnectionInfoManager
内没有指定名称的云存储服务连接信息对象,则对象会默认添加到CloudStorageConnectionInfoManager
中。- 参数:
connInfoName
- 待更新的云存储服务连接信息的名称。connInfo
- 用于更新的云存储服务连接信息对象。- 返回:
- 添加是否成功,true表示成功,false表示失败。
- 抛出:
IllegalArgumentException
- 若云存储连接信息的名称,或云存储连接信息对象为空,则报非法参数异常。- 从以下版本开始:
- 11.2.0
-
find
public static CloudStorageConnectionInfo find(String name)
返回指定名称的连接信息对象。添加到
CloudStorageConnectionInfoManager
管理的CloudStorageConnectionInfo
对象均为对象的深拷贝,因此,修改CloudStorageConnectionInfoManager
中的连续信息对象后,必须调用CloudStorageConnectionInfoManager.update(String, CloudStorageConnectionInfo)
接口,才能更新CloudStorageConnectionInfoManager
中对应的连接信息对象。- 参数:
name
- 指定的连接信息的名称,为已存在的连续信息的名称。- 返回:
- 返回指定名称的连接信息对象。
- 抛出:
IllegalArgumentException
- 输入的连接信息名称为空。- 从以下版本开始:
- 11.2.0
-
remove
public static void remove(String name)
移除指定名称的连接信息。- 参数:
name
- 待移除的连接信息的名称,为已存在的连续信息的名称。- 抛出:
IllegalArgumentException
- 输入的连接名称为空。- 从以下版本开始:
- 11.2.0
-
clear
public static void clear()
清除当前管理的全部连接信息。- 从以下版本开始:
- 11.2.0
-
fromXML
public static boolean fromXML(String xml)
解析 xml 格式的云存储服务连接信息字符串,并作为新的连续信息对象添加到CloudStorageConnectionInfoManager
中。- 参数:
xml
- xml 格式的云存储服务连接信息字符串。若待添加的连接信息的名称与已有连接信息的名称相同,已有同名连接信息会被覆盖。- 返回:
- 返回是否解析成功,true表示成功;false表示失败。
- 抛出:
IllegalArgumentException
- 输入的文本为空。- 从以下版本开始:
- 11.2.0
-
toXML
public static String toXML()
将当前管理的全部连接信息输出为 XML 格式的字符串。- 返回:
- 返回 XML 格式的字符串是否生成成功,true表示成功,false表示失败。
- 从以下版本开始:
- 11.2.0
-
getHTTPConnectTimeOut
public static double getHTTPConnectTimeOut()
返回连接云存储服务时,HTTP创建连接的超时时间,单位:秒,默认值为3秒。- 返回:
- 返回连接云存储服务时,HTTP创建连接的超时时间。
- 从以下版本开始:
- 11.2.0
-
setHTTPConnectTimeOut
public static void setHTTPConnectTimeOut(double timeOutValue)
设置连接云存储服务时,HTTP创建连接的超时时间,单位:秒,默认值为3秒。- 参数:
timeOutValue
- 连接云存储服务时,HTTP创建连接的超时时间,单位:秒,值要求为正数。- 抛出:
IllegalArgumentException
- HTTP创建连接的超时时间不能是负数。- 从以下版本开始:
- 11.2.0
-
getHTTPTimeOut
public static double getHTTPTimeOut()
返回连接云存储服务时,HTTP单个请求的总超时时间,单位:秒,默认值为10秒。单个请求的总超时时间指从请求开始到请求结束的总时间,包括DNS解析、连接建立、传输等。
- 返回:
- 返回连接云存储服务时,HTTP单个请求的总超时时间。
- 从以下版本开始:
- 11.2.0
-
setHTTPTimeOut
public static void setHTTPTimeOut(double timeOutValue)
设置连接云存储服务时,HTTP单个请求的总超时时间,单位:秒,默认值为10秒。单个请求的总超时时间指从请求开始到请求结束的总时间,包括DNS解析、连接建立、传输等。
- 参数:
timeOutValue
- 连接云存储服务时,HTTP单个请求的总超时时间,单位:秒,值要求为正数。- 抛出:
IllegalArgumentException
- HTTP单个请求的总超时时间不能是负数。- 从以下版本开始:
- 11.2.0
-
getHTTPMaxRetry
public static int getHTTPMaxRetry()
返回连接云存储服务时,HTTP的最大重试次数,默认值为3次。- 返回:
- 返回连接云存储服务时,HTTP的最大重试次数。
- 从以下版本开始:
- 11.2.0
-
setHTTPMaxRetry
public static void setHTTPMaxRetry(int maxRetry)
设置连接云存储服务时,HTTP的最大重试次数,默认值为3次。- 参数:
maxRetry
- 连接云存储服务时,HTTP的最大重试次数。- 抛出:
IllegalArgumentException
- 连接云存储服务时的最大重试次数不能是负数。- 从以下版本开始:
- 11.2.0
-
getHTTPRetryDelay
public static double getHTTPRetryDelay()
返回连接云存储服务时,HTTP的重试时间间隔,默认值为1.0秒。- 返回:
- 返回连接云存储服务时,HTTP的重试时间间隔。
- 从以下版本开始:
- 11.2.0
-
setHTTPRetryDelay
public static void setHTTPRetryDelay(double maxRetry)
设置连接云存储服务时,HTTP的重试时间间隔,默认值为1.0秒。- 参数:
maxRetry
- 连接云存储服务时,HTTP的重试时间间隔。- 抛出:
IllegalArgumentException
- 连接云存储服务时HTTP的重试时间间隔不能是负数。- 从以下版本开始:
- 11.2.0
-
getCacheSize
public static int getCacheSize()
返回连接云存储服务时,下载内容共享的LRU缓存大小,默认值为256MB。- 返回:
- 连接云存储服务时,下载内容共享的LRU缓存大小。
- 从以下版本开始:
- 11.2.0
-
setCacheSize
public static void setCacheSize(int cacheSize)
设置连接云存储服务时,下载内容共享的LRU缓存大小,默认值为256MB。- 抛出:
IllegalArgumentException
- 连接云存储服务时下载内容共享的LRU缓存大小不能是负数。- 从以下版本开始:
- 11.2.0
-
-
Copyright © 2021–2024 SuperMap. All rights reserved.