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服务参数打开

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

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

getCount

public int getCount()

返回数据源集合中数据源的个数。

返回:

数据源集合中数据源的个数。

默认值:

默认值为 0。

get

public Datasource get(int index)

返回指定序号的数据源。

参数:

index - 指定的数据源的序号。

返回:

指定序号的数据源。

get

public Datasource get(java.lang.String alias)

返回指定别名的数据源。

参数:

alias - 指定的数据源的别名。

返回:

指定别名的数据源。

open

public Datasource open(DatasourceConnectionInfo connectionInfo)

根据指定的连接信息打开已经存在的数据源。指定数据源不存在时返回 Null。在打开数据源的时候需要注意的是，要明确数据源对应的数据引擎，才能正确的打开数据源。

1. 当用户想打开某一个文件型数据源（UDBPlus）时，必须要有对应的空间数据库引擎（SDX+ for UDB）；

参数:

connectionInfo - 指定的数据源连接信息。

返回:

打开的数据源。

示例:

请参见 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 - 数据源连接信息。

返回:

新创建的数据源。

示例:

以下代码示范如何创建 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