CloudStorageConnectionInfoManager (iObjects Java Help)

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)` 更新云存储服务的连接信息。

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - 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

类 CloudStorageConnectionInfoManager

方法概要

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

方法详细资料

getNames

getCount

canConnect

canConnect

add

update

find

remove

clear

fromXML

toXML

getHTTPConnectTimeOut

setHTTPConnectTimeOut

getHTTPTimeOut

setHTTPTimeOut

getHTTPMaxRetry

setHTTPMaxRetry

getHTTPRetryDelay

setHTTPRetryDelay

getCacheSize

setCacheSize