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)
设置连接信息中的密码,密码类型为Defaultvoid
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.comvoid
setWebTransparent(boolean value)
设置外设参数的WMS服务请求的瓦片是否透明void
setWebVersion(java.lang.String value)
设置WMS服务的版本号 。void
setWebVisibleLayers(java.lang.String value)
设置WMS服务的可见图层集合。
-
-
-
构造器详细资料
-
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
-
-
-