DatasourceConnectionInfo

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

public class DatasourceConnectionInfo
extends java.lang.Object

数据源连接信息类。

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

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

示例:

以下代码示范如何打开 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`	`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`	`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()
```
    返回数据源别名。别名是数据源的唯一标识。该标识不区分大小写。
    
    返回:
    
    数据源别名。
    
    默认值:
    
    默认值为 "UntitledDatasource"。
  - setAlias
```
public void setAlias(java.lang.String value)
```
    设置数据源别名。别名是数据源的唯一标识。该标识不区分大小写。
    
    参数:
    
    value - 数据源别名。
  - getEngineType
```
public EngineType getEngineType()
```
    返回数据源连接的引擎类型。目前提供的引擎类型包括 UDB 引擎(UDB)等请参见 EngineType 类。
    
    返回:
    
    数据源连接的引擎类型。
    
    另请参阅:
    
    EngineType
    
    默认值:
    
    默认值为 UDB。
  - setEngineType
```
public void setEngineType(EngineType value)
```
    设置数据源连接的引擎类型。目前提供的引擎类型包括 UDB 引擎(UDB)等请参见 EngineType 类。
    
    参数:
    
    value - 数据源连接的引擎类型。
    
    另请参阅:
    
    EngineType
  - getServer
```
public java.lang.String getServer()
```
    返回数据库服务器名或文件名。
    对于UDB 文件，为其文件的名称，其中包括路径名称和文件的后缀名。特别地，此处的路径为绝对路径。
    
    返回:
    
    数据库服务器名或文件名。
    
    默认值:
    
    默认值为一个空字符串。
  - setServer
```
public void setServer(java.lang.String value)
```
    设置数据库服务器名或文件名。
    对于 UDB 文件，为其文件的名称，其中包括路径名称和文件的后缀名。特别地，此处的路径为绝对路径。
    
    参数:
    
    value - 数据库服务器名或文件名。
  - getUser
```
public java.lang.String getUser()
```
    返回登录数据库的用户名。对于数据库类型数据源适用。
    
    返回:
    
    登录数据库的用户名。
    
    默认值:
    
    默认值为一个空字符串。
  - setUser
```
public void setUser(java.lang.String value)
```
    设置登录数据库的用户名。对于数据库类型数据源适用。
    
    参数:
    
    value - 登录数据库的用户名。
  - getPassword
```
public java.lang.String getPassword()
```
    获取连接信息中的密码，仅支持原有加密类型，即DEFAULT类型，若是AES加密,则返回空字符串
    
    返回:
    
    登录数据源连接的数据库或文件的密码。
    
    默认值:
    
    默认值为一个空字符串。
  - 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。
    
    默认值:
    
    默认值为 false。
  - setReadOnly
```
public void setReadOnly(boolean value)
```
    设置是否以只读方式打开数据源。如果以只读方式打开数据源，数据源的相关信息以及其中的数据都不可修改。
    对于 UDB 数据源，如果其文件属性为只读的，那么必须将 DatasourceConnectionInfo.setReadOnly() 方法的参数设置为 true，才能打开数据源。
    
    参数:
    
    value - 指定是否以只读方式打开数据源。
  - getDriver
```
public java.lang.String getDriver()
```
    返回数据源连接所需的驱动名称。
    对于 iServer 发布的 WMTS 服务，返回的驱动名称为 WMTS。
    
    返回:
    
    数据源连接所需的驱动名称。
    
    默认值:
    
    默认值为一个空字符串。
  - setDriver
```
public void setDriver(java.lang.String value)
```
    设置数据源连接所需的驱动名称。
    对于 iServer 发布的 WMTS 服务，设置的驱动名称为 WMTS，并且WMTS地图必须调用该方法设置其驱动名称。
    参数:
    
    value - 数据源连接所需的驱动名称。
    
    示例:
    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服务请求的瓦片是否透明
    
    返回:
    
    是否透明

类 DatasourceConnectionInfo

构造器概要

方法概要

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

构造器详细资料

DatasourceConnectionInfo

DatasourceConnectionInfo

方法详细资料

getAlias

setAlias

getEngineType

setEngineType

getServer

setServer

getUser

setUser

getPassword

setPassword

setPassword

isReadOnly

setReadOnly

getDriver

setDriver

dispose

setWebCoordinate

getWebCoordinate

setWebVersion

getWebVersion

setWebFormat

getWebFormat

setWebVisibleLayers

getWebVisibleLayers

setWebBBox

getWebBBox

getWebExtendParam

setWebExtendParam

setProxy

getProxyAddress

getProxyPort

setWebImageSize

setWebTransparent

getWebTransparent