com.supermap.data
类 Datasources
- java.lang.Object
-
- com.supermap.data.Datasources
-
public class Datasources extends java.lang.Object
数据源的集合类。
对数据源进行管理,包括创建、打开、关闭数据源等功能。
-
-
方法概要
所有方法 实例方法 具体方法 限定符和类型 方法和说明 boolean
close(int index)
关闭指定序号的数据源。boolean
close(java.lang.String alias)
关闭指定别名的数据源。void
closeAll()
关闭所有数据源。Datasource
create(DatasourceConnectionInfo connectionInfo)
根据指定的连接信息创建数据源。Datasource
get(int index)
返回指定序号的数据源。Datasource
get(java.lang.String alias)
返回指定别名的数据源。int
getCount()
返回数据源集合中数据源的个数。int
indexOf(java.lang.String alias)
返回指定别名的数据源对象在当前数据源集合中的序号。Datasource
open(DatasourceConnectionInfo connectionInfo)
根据指定的连接信息打开已经存在的数据源。Datasource
open(DatasourceConnectionInfo connectionInfo, WebParams params)
打开数据源,通过Web服务参数打开。
-
-
-
方法详细资料
-
getCount
public int getCount()
返回数据源集合中数据源的个数。- 返回:
- 数据源集合中数据源的个数。
- Default:
- 默认值为 0。
-
get
public Datasource get(int index)
返回指定序号的数据源。- 参数:
index
- 指定的数据源的序号。- 返回:
- 指定序号的数据源。
-
get
public Datasource get(java.lang.String alias)
返回指定别名的数据源。- 参数:
alias
- 指定的数据源的别名。- 返回:
- 指定别名的数据源。
-
open
public Datasource open(DatasourceConnectionInfo connectionInfo)
根据指定的连接信息打开已经存在的数据源。指定数据源不存在时返回 Null。在打开数据源的时候需要注意的是,要明确数据源对应的数据引擎,才能正确的打开数据源。- 当用户想打开某一个文件型数据源(UDBPlus)时,必须要有对应的空间数据库引擎(SDX+ for UDB);
- 参数:
connectionInfo
- 指定的数据源连接信息。- 返回:
- 打开的数据源。
- Example:
- 请参见
DatasourceConnectionInfo
类的示例。
-
close
public boolean close(int index)
关闭指定序号的数据源。- 参数:
index
- 指定的数据源的序号。- 返回:
- 如果关闭数据源成功返回 true,否则返回 false。
-
close
public boolean close(java.lang.String alias)
关闭指定别名的数据源。- 参数:
alias
- 指定的数据源的别名。- 返回:
- 如果关闭数据源成功返回 true,否则返回 false。
-
closeAll
public void closeAll()
关闭所有数据源。
-
indexOf
public int indexOf(java.lang.String alias)
返回指定别名的数据源对象在当前数据源集合中的序号。- 参数:
alias
- 指定的数据源的别名。- 返回:
- 指定别名的数据源对象在当前数据源集合中的序号。如果数据源对象不存在,返回-1。
-
create
public Datasource create(DatasourceConnectionInfo connectionInfo)
根据指定的连接信息创建数据源。如果待创建的数据源已经存在则返回 null。- 参数:
connectionInfo
- 数据源连接信息。- 返回:
- 新创建的数据源。
- Example:
- 以下代码示范如何创建 UDB 数据源。
public void datasourcesExample() { String rootPath = android.os.Environment.getExternalStorageDirectory().getAbsolutePath(); Workspace workspace = new Workspace(); //设置 UDB 数据源连接信息 DatasourceConnectionInfo info = new DatasourceConnectionInfo(); info.setAlias("supermap_alias"); info.setEngineType(EngineType.UDB); info.setServer(rootPath + "/data/test.udb"); //创建数据源 Datasources datasources = workspace.getDatasources(); Datasource datsource = datasources.create(info); //判断是否创建成功 if (datsource == null) { System.out.println("数据源创建失败"); } else { System.out.println("数据源创建成功"); } //释放资源 workspace.dispose(); }
, 以下代码示范如何创建 内存数据源。datasourceConnnectionInfo.setEngineType(EngineType.UDB); datasourceConnnectionInfo.setServer(":memory:");
-
open
public Datasource open(DatasourceConnectionInfo connectionInfo, WebParams params)
打开数据源,通过Web服务参数打开。- 参数:
connectionInfo
- 指定的数据源连接信息params
- 指定的网络服务参数- 返回:
- 返回打开的数据源对象,打开失败,则返回null
-
-