com.supermap.data

类 Datasources

  • java.lang.Object
    • com.supermap.data.Datasources


  • public class Datasources
    extends java.lang.Object

    数据源的集合类。

    对数据源进行管理,包括创建、打开、关闭数据源等功能。

    • 方法详细资料

      • 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。在打开数据源的时候需要注意的是,要明确数据源对应的数据引擎,才能正确的打开数据源。
        1. 当用户想打开某一个文件型数据源(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