com.supermap.data

类 DatasourceConnectionInfo

  • java.lang.Object
    • com.supermap.data.DatasourceConnectionInfo


  • public class DatasourceConnectionInfo
    extends java.lang.Object

    数据源连接信息类。

    包括了进行数据源连接的所有信息,如所要连接的服务器名称,数据库名称、用户名、密码等。当保存工作空间时,工作空间中的数据源的连接信息都将存储到工作空间文件中 。对于不同类型的数据源,其连接信息有所区别。所以在使用该类所包含的成员时,请注意该成员所适用的数据源类型。

    SuperMap iMobile for Android 支持 UDB 引擎下的内存数据源,允许用户在内存中创建数据源。

    Example:
    以下代码示范如何打开 UDB 引擎类型的数据源。
     public void main() {
            // 定义工作空间
            Workspace workspace = new Workspace();
     
            // 定义数据源连接信息,假设以下所有数据源设置都存在
            DatasourceConnectionInfo datasourceconnection = new DatasourceConnectionInfo();
     
            // 设置文件数据源连接需要的参数
            datasourceconnection.setEngineType(EngineType.UDB);
            datasourceconnection.setServer("../../SampleData/World/World.udb");
            datasourceconnection.setAlias("UDB");
            datasourceconnection.setPassword("");
     
            // 打开数据源
            Datasource datasource = workspace.getDatasources().open(datasourceconnection);
            if (datasource == null) {
                    System.out.println("打开数据源失败");
                     return;
            } 
           else {
                    System.out.println("数据源打开成功!");
            }
     
            // 释放工作空间资源
            datasourceconnection.dispose();
            workspace.dispose();
     
     }
     
    • 构造器概要

      构造器 
      构造器和说明
      DatasourceConnectionInfo()
      构造一个新的 DatasourceConnectionInfo 对象,默认的引擎类型为 UDB 引擎。
      DatasourceConnectionInfo(java.lang.String file, java.lang.String alias, java.lang.String password)
      根据指定的参数来构造一个 DatasourceConnectionInfo 的新对象。
    • 方法概要

      所有方法 实例方法 具体方法 
      限定符和类型 方法和说明
      void dispose()
      释放该对象所占用的资源。
      java.lang.String getAlias()
      返回数据源别名。
      java.lang.String getDriver()
      返回数据源连接所需的驱动名称。
      EngineType getEngineType()
      返回数据源连接的引擎类型。
      java.lang.String getPassword()
      获取连接信息中的密码,仅支持原有加密类型,即DEFAULT类型,若是AES加密,则返回空字符串
      java.lang.String getProxyAddress()
      获取代理服务器地址
      java.lang.String getProxyPort()
      获取代理服务器端口
      java.lang.String getRequestHeader()
      获取已设置的自定义的请求头
      java.lang.String getServer()
      返回数据库服务器名或文件名。
      java.lang.String getUser()
      返回登录数据库的用户名。
      Rectangle2D getWebBBox()
      获取WMS服务的地图范围。
      java.lang.String getWebCoordinate()
      获取Web服务类型(Rest/OGC)数据源的坐标参考系。
      java.lang.String getWebExtendParam()
      获取WMS服务的扩展参数
      java.lang.String getWebFormat()
      获取WMS服务的图片格式。
      boolean getWebTransparent()
      获取外设参数的WMS服务请求的瓦片是否透明
      java.lang.String getWebVersion()
      获取WMS服务的版本号。
      java.lang.String getWebVisibleLayers()
      获取WMS服务的可见图层集合。
      boolean isReadOnly()
      返回是否以只读方式打开数据源。
      void setAlias(java.lang.String value)
      设置数据源别名。
      void setDriver(java.lang.String value)
      设置数据源连接所需的驱动名称。
      void setEngineType(EngineType value)
      设置数据源连接的引擎类型。
      void setPassword(java.lang.String value)
      设置连接信息中的密码,密码类型为Default
      void setPassword(java.lang.String value, DatasourceEncrytionType type)
      设置连接信息中的密码,同时需要指明该密码使用的加密类型
      void setProxy(java.lang.String address, java.lang.String port)
      设置代理服务器地址和端口
      void setReadOnly(boolean value)
      设置是否以只读方式打开数据源。
      void setRequestHeader(<any> headers)
      设置请求头 当前版本仅适用于rest地图服务
      void setServer(java.lang.String value)
      设置数据库服务器名或文件名。
      void setUser(java.lang.String value)
      设置登录数据库的用户名。
      void setWebBBox(Rectangle2D rect)
      设置WMS服务的地图范围。
      void setWebCoordinate(java.lang.String value)
      设置Web服务类型(Rest/OGC)数据源的坐标参考系 ,默认从服务上获取,优先EPSG:4326类型。
      void setWebExtendParam(java.lang.String value)
      设置WMS服务的扩展参数
      void setWebFormat(java.lang.String value)
      设置WMS服务的图片格式。
      void setWebImageSize(int value)
      设置google地图瓦片大小,仅用于http://maps.google.com
      void setWebTransparent(boolean value)
      设置外设参数的WMS服务请求的瓦片是否透明
      void setWebVersion(java.lang.String value)
      设置WMS服务的版本号 。
      void setWebVisibleLayers(java.lang.String value)
      设置WMS服务的可见图层集合。
      • 从类继承的方法 java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • 构造器详细资料

      • DatasourceConnectionInfo

        public DatasourceConnectionInfo()
        构造一个新的 DatasourceConnectionInfo 对象,默认的引擎类型为 UDB 引擎。
      • DatasourceConnectionInfo

        public DatasourceConnectionInfo(java.lang.String file,
                                        java.lang.String alias,
                                        java.lang.String password)
        根据指定的参数来构造一个 DatasourceConnectionInfo 的新对象。
        参数:
        file - UDB 文件名。
        alias - 数据源别名。
        password - 密码。
    • 方法详细资料

      • getAlias

        public java.lang.String getAlias()
        返回数据源别名。别名是数据源的唯一标识。该标识不区分大小写。
        返回:
        数据源别名。
        Default:
        默认值为 "UntitledDatasource"。
      • setAlias

        public void setAlias(java.lang.String value)
        设置数据源别名。别名是数据源的唯一标识。该标识不区分大小写。
        参数:
        value - 数据源别名。
      • getEngineType

        public EngineType getEngineType()
        返回数据源连接的引擎类型。目前提供的引擎类型包括 UDB 引擎(UDB)等 请参见 EngineType 类。
        返回:
        数据源连接的引擎类型。
        另请参阅:
        EngineType
        Default:
        默认值为 UDB
      • setEngineType

        public void setEngineType(EngineType value)
        设置数据源连接的引擎类型。目前提供的引擎类型包括 UDB 引擎(UDB)等 请参见 EngineType 类。
        参数:
        value - 数据源连接的引擎类型。
        另请参阅:
        EngineType
      • getServer

        public java.lang.String getServer()
        返回数据库服务器名或文件名。

        对于UDB 文件,为其文件的名称,其中包括路径名称和文件的后缀名。特别地,此处的路径为绝对路径。

        返回:
        数据库服务器名或文件名。
        Default:
        默认值为一个空字符串。
      • setServer

        public void setServer(java.lang.String value)
        设置数据库服务器名或文件名。

        对于 UDB 文件,为其文件的名称,其中包括路径名称和文件的后缀名。特别地,此处的路径为绝对路径。

        参数:
        value - 数据库服务器名或文件名。
      • getUser

        public java.lang.String getUser()
        返回登录数据库的用户名。对于数据库类型数据源适用。
        返回:
        登录数据库的用户名。
        Default:
        默认值为一个空字符串。
      • setUser

        public void setUser(java.lang.String value)
        设置登录数据库的用户名。对于数据库类型数据源适用。
        参数:
        value - 登录数据库的用户名。
      • getPassword

        public java.lang.String getPassword()
        获取连接信息中的密码,仅支持原有加密类型,即DEFAULT类型,若是AES加密,则返回空字符串
        返回:
        登录数据源连接的数据库或文件的密码。
        Default:
        默认值为一个空字符串。
      • setPassword

        public void setPassword(java.lang.String value)
        设置连接信息中的密码,密码类型为Default
        参数:
        value - 密码
      • setPassword

        public void setPassword(java.lang.String value,
                                DatasourceEncrytionType type)
        设置连接信息中的密码,同时需要指明该密码使用的加密类型
        参数:
        value - 密码
        type - 密码使用的加密类型,如该参数为null,则按DEFAULT类型处理
      • isReadOnly

        public boolean isReadOnly()
        返回是否以只读方式打开数据源。如果以只读方式打开数据源,数据源的相关信息以及其中的数据都不可修改。
        返回:
        是否以只读方式打开数据源,如果以只读方式打开数据源为 true,否则为 false。
        Default:
        默认值为 false。
      • setReadOnly

        public void setReadOnly(boolean value)
        设置是否以只读方式打开数据源。如果以只读方式打开数据源,数据源的相关信息以及其中的数据都不可修改。

        对于 UDB 数据源,如果其文件属性为只读的,那么必须将 DatasourceConnectionInfo.setReadOnly() 方法的参数设置为 true,才能打开数据源。

        参数:
        value - 指定是否以只读方式打开数据源。
      • getDriver

        public java.lang.String getDriver()
        返回数据源连接所需的驱动名称。

        对于 iServer 发布的 WMTS 服务,返回的驱动名称为 WMTS。

        返回:
        数据源连接所需的驱动名称。
        Default:
        默认值为一个空字符串。
      • setDriver

        public void setDriver(java.lang.String value)
        设置数据源连接所需的驱动名称。

        对于 iServer 发布的 WMTS 服务,设置的驱动名称为 WMTS,并且WMTS地图必须调用该方法设置其驱动名称。

        参数:
        value - 数据源连接所需的驱动名称。
        Example:
          DatasourceConnectionInfo info = new DatasourceConnectionInfo();
          info.setEngineType(EngineType.OGC);
          info.setDriver("WMTS");
         
      • dispose

        public void dispose()
        释放该对象所占用的资源。当调用该方法之后,此对象不再可用。
      • setWebCoordinate

        public void setWebCoordinate(java.lang.String value)
        设置Web服务类型(Rest/OGC)数据源的坐标参考系 ,默认从服务上获取,优先EPSG:4326类型。
        参数:
        value - 坐标系类型,包括三种类型:EPSG:4326,EPSG:3857,CRS:84。
      • getWebCoordinate

        public java.lang.String getWebCoordinate()
        获取Web服务类型(Rest/OGC)数据源的坐标参考系。
        返回:
        Web服务类型(Rest/OGC)数据源的坐标参考系。
      • setWebVersion

        public void setWebVersion(java.lang.String value)
        设置WMS服务的版本号 。
        参数:
        value - WMS服务的版本号。
      • getWebVersion

        public java.lang.String getWebVersion()
        获取WMS服务的版本号。
        返回:
        WMS服务的版本号。
      • setWebFormat

        public void setWebFormat(java.lang.String value)
        设置WMS服务的图片格式。
        参数:
        value - WMS服务的图片格式。
      • getWebFormat

        public java.lang.String getWebFormat()
        获取WMS服务的图片格式。
        返回:
        WMS服务的图片格式。
      • setWebVisibleLayers

        public void setWebVisibleLayers(java.lang.String value)
        设置WMS服务的可见图层集合。
        参数:
        value - WMS服务的可见图层集合。
      • getWebVisibleLayers

        public java.lang.String getWebVisibleLayers()
        获取WMS服务的可见图层集合。
        返回:
        WMS服务的可见图层集合。
      • setWebBBox

        public void setWebBBox(Rectangle2D rect)
        设置WMS服务的地图范围。
        参数:
        rect - WMS服务的地图范围
      • getWebBBox

        public Rectangle2D getWebBBox()
        获取WMS服务的地图范围。
        返回:
        MS服务的地图范围
      • getWebExtendParam

        public java.lang.String getWebExtendParam()
        获取WMS服务的扩展参数
        返回:
        WMS服务的扩展参数
      • setWebExtendParam

        public void setWebExtendParam(java.lang.String value)
        设置WMS服务的扩展参数
        参数:
        value - WMS服务的扩展参数
      • setProxy

        public void setProxy(java.lang.String address,
                             java.lang.String port)
        设置代理服务器地址和端口
        参数:
        address - 代理服务器地址
        port - 代理服务器端口号
      • getProxyAddress

        public java.lang.String getProxyAddress()
        获取代理服务器地址
        返回:
        返回代理服务器地址
      • getProxyPort

        public java.lang.String getProxyPort()
        获取代理服务器端口
        返回:
        返回代理服务器端口号
      • setWebImageSize

        public void setWebImageSize(int value)
        设置google地图瓦片大小,仅用于http://maps.google.com
        参数:
        value - 瓦片大小
      • setWebTransparent

        public void setWebTransparent(boolean value)
        设置外设参数的WMS服务请求的瓦片是否透明
        参数:
        value - 是否透明
      • getWebTransparent

        public boolean getWebTransparent()
        获取外设参数的WMS服务请求的瓦片是否透明
        返回:
        是否透明
      • getRequestHeader

        public java.lang.String getRequestHeader()
        获取已设置的自定义的请求头
        返回:
      • setRequestHeader

        public void setRequestHeader(<any> headers)
        设置请求头

        当前版本仅适用于rest地图服务

        参数:
        value -