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 的新对象。
-
方法概要
所有方法 实例方法 具体方法 限定符和类型 方法和说明 voiddispose()释放该对象所占用的资源。java.lang.StringgetAlias()返回数据源别名。java.lang.StringgetDriver()返回数据源连接所需的驱动名称。EngineTypegetEngineType()返回数据源连接的引擎类型。java.lang.StringgetPassword()获取连接信息中的密码,仅支持原有加密类型,即DEFAULT类型,若是AES加密,则返回空字符串java.lang.StringgetProxyAddress()获取代理服务器地址java.lang.StringgetProxyPort()获取代理服务器端口java.lang.StringgetRequestHeader()获取已设置的自定义的请求头java.lang.StringgetServer()返回数据库服务器名或文件名。java.lang.StringgetUser()返回登录数据库的用户名。Rectangle2DgetWebBBox()获取WMS服务的地图范围。java.lang.StringgetWebCoordinate()获取Web服务类型(Rest/OGC)数据源的坐标参考系。java.lang.StringgetWebExtendParam()获取WMS服务的扩展参数java.lang.StringgetWebFormat()获取WMS服务的图片格式。booleangetWebTransparent()获取外设参数的WMS服务请求的瓦片是否透明java.lang.StringgetWebVersion()获取WMS服务的版本号。java.lang.StringgetWebVisibleLayers()获取WMS服务的可见图层集合。booleanisReadOnly()返回是否以只读方式打开数据源。voidsetAlias(java.lang.String value)设置数据源别名。voidsetDriver(java.lang.String value)设置数据源连接所需的驱动名称。voidsetEngineType(EngineType value)设置数据源连接的引擎类型。voidsetPassword(java.lang.String value)设置连接信息中的密码,密码类型为DefaultvoidsetPassword(java.lang.String value, DatasourceEncrytionType type)设置连接信息中的密码,同时需要指明该密码使用的加密类型voidsetProxy(java.lang.String address, java.lang.String port)设置代理服务器地址和端口voidsetReadOnly(boolean value)设置是否以只读方式打开数据源。voidsetRequestHeader(<any> headers)设置请求头 当前版本仅适用于rest地图服务voidsetServer(java.lang.String value)设置数据库服务器名或文件名。voidsetUser(java.lang.String value)设置登录数据库的用户名。voidsetWebBBox(Rectangle2D rect)设置WMS服务的地图范围。voidsetWebCoordinate(java.lang.String value)设置Web服务类型(Rest/OGC)数据源的坐标参考系 ,默认从服务上获取,优先EPSG:4326类型。voidsetWebExtendParam(java.lang.String value)设置WMS服务的扩展参数voidsetWebFormat(java.lang.String value)设置WMS服务的图片格式。voidsetWebImageSize(int value)设置google地图瓦片大小,仅用于http://maps.google.comvoidsetWebTransparent(boolean value)设置外设参数的WMS服务请求的瓦片是否透明voidsetWebVersion(java.lang.String value)设置WMS服务的版本号 。voidsetWebVisibleLayers(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-
-
-