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
      • 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.