类 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 booleanadd(CloudStorageConnectionInfo connInfo)添加云存储服务连接信息。static booleancanConnect(CloudStorageConnectionInfo connInfo)判断指定的连接信息对象能否连接成功。static booleancanConnect(String name)判断指定名称的连接信息能否连接成功。static voidclear()清除当前管理的全部连接信息。static CloudStorageConnectionInfofind(String name)返回指定名称的连接信息对象。static booleanfromXML(String xml)解析 xml 格式的云存储服务连接信息字符串,并作为新的连续信息对象添加到CloudStorageConnectionInfoManager中。static intgetCacheSize()返回连接云存储服务时,下载内容共享的LRU缓存大小,默认值为256MB。static intgetCount()返回当前管理的连接信息的数目。static doublegetHTTPConnectTimeOut()返回连接云存储服务时,HTTP创建连接的超时时间,单位:秒,默认值为3秒。static intgetHTTPMaxRetry()返回连接云存储服务时,HTTP的最大重试次数,默认值为3次。static doublegetHTTPRetryDelay()返回连接云存储服务时,HTTP的重试时间间隔,默认值为1.0秒。static doublegetHTTPTimeOut()返回连接云存储服务时,HTTP单个请求的总超时时间,单位:秒,默认值为10秒。static String[]getNames()返回当前管理的全部连接信息的名称。static voidremove(String name)移除指定名称的连接信息。static voidsetCacheSize(int cacheSize)设置连接云存储服务时,下载内容共享的LRU缓存大小,默认值为256MB。static voidsetHTTPConnectTimeOut(double timeOutValue)设置连接云存储服务时,HTTP创建连接的超时时间,单位:秒,默认值为3秒。static voidsetHTTPMaxRetry(int maxRetry)设置连接云存储服务时,HTTP的最大重试次数,默认值为3次。static voidsetHTTPRetryDelay(double maxRetry)设置连接云存储服务时,HTTP的重试时间间隔,默认值为1.0秒。static voidsetHTTPTimeOut(double timeOutValue)设置连接云存储服务时,HTTP单个请求的总超时时间,单位:秒,默认值为10秒。static StringtoXML()将当前管理的全部连接信息输出为 XML 格式的字符串。static booleanupdate(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–2025 SuperMap. All rights reserved.