com.supermap.data

类 WorkspaceConnectionInfo

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


  • public class WorkspaceConnectionInfo
    extends java.lang.Object

    工作空间连接信息类。

    包括了进行工作空间连接的所有信息,如所要连接的服务器名称,数据库名称,用户名,密码等。对不同类型的工作空间,其连接信息有所区别,所以在使用该类所包含的成员时,请注意该成员所适用的工作空间类型。

    Example:
    以下代码示范如何通过指定的工作空间连接信息打开工作空间。
     public void workspaceConnectionInfoTest(int m_WsType) {
            // 构造工作空间对象和工作空间连接信息对象
            Workspace workspace = new Workspace();
            WorkspaceConnectionInfo workspaceConnectionInfo = new WorkspaceConnectionInfo();
            String rootPath = android.os.Environment.getExternalStorageDirectory().getAbsolutePath();
            switch (m_WsType) {
    
            // SXW 文件工作空间信息设置
            case 1:
                workspaceConnectionInfo.setType(WorkspaceType.SXW);
                
                workspaceConnectionInfo.setServer(rootPath + "/SampleData/World/World.sxw");
                break;
            
            // SMW 工作空间信息设置
            case 2:
                workspaceConnectionInfo.setType(WorkspaceType.SMW);
                workspaceConnectionInfo.setServer(rootPath + "/SampleData/World/World.smw");
                break;
            
            // SXWU 文件工作空间信息设置
            case 3:
                workspaceConnectionInfo.setType(WorkspaceType.SXWU);
                workspaceConnectionInfo.setServer(rootPath + "/SampleData/World/World.sxwu");
                break;
    
            // SMWU 工作空间信息设置
            case 4:
                workspaceConnectionInfo.setType(WorkspaceType.SMWU);
                workspaceConnectionInfo.setServer(rootPath + "/SampleData/World/World.smwu");
                break;
    
            // 其他情况
            default:
                break;
            }
    
            // 以指定的工作空间连接信息打开工作空间
            boolean isOpen = workspace.open(workspaceConnectionInfo);
    
            // 判断工作空间是否打开成功
            if (isOpen) {
                System.out.println("工作空间打开成功");
            } 
          
            else {
                System.out.println("工作空间打开失败");
                return;
            }
    
            // 释放工作空间以及其连接信息
            workspaceConnectionInfo.dispose();
            workspace.dispose();
        }
     
    • 方法概要

      所有方法 实例方法 具体方法 
      限定符和类型 方法和说明
      void dispose()
      释放该对象所占用的资源。
      java.lang.String getName()
      返回工作空间在数据库中的名称。
      java.lang.String getPassword()
      返回登录工作空间连接的数据库或文件的密码。
      java.lang.String getServer()
      返回文件名。
      WorkspaceType getType()
      返回工作空间的类型。
      java.lang.String getUser()
      返回登录数据库的用户名。
      WorkspaceVersion getVersion()
      返回工作空间的版本。
      void setName(java.lang.String value)
      设置工作空间在数据库中的名称。
      void setPassword(java.lang.String value)
      设置登录工作空间连接的数据库或文件的密码。
      void setServer(java.lang.String value)
      设置文件名。
      void setType(WorkspaceType value)
      设置工作空间的类型。
      void setUser(java.lang.String value)
      设置登录数据库的用户名。
      void setVersion(WorkspaceVersion value)
      设置工作空间的版本。
      java.lang.String toString()
      将当前工作空间连接信息对象输出为格式化字符串,其格式为:{Name="",Type="",Server="",Database="",Driver="",User="",Password="",Version=""}。
      • 从类继承的方法 java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
    • 构造器详细资料

      • WorkspaceConnectionInfo

        public WorkspaceConnectionInfo(java.lang.String file)
        根据指定的参数来构造一个 WorkspaceConnectionInfo 的新对象。
        参数:
        file - SXW 文件路径名。
      • WorkspaceConnectionInfo

        public WorkspaceConnectionInfo()
        构造一个新的 WorkspaceConnectionInfo 对象,默认的类型为默认工作空间,即:WorkspaceType.DEFAULT
    • 方法详细资料

      • getName

        public java.lang.String getName()
        返回工作空间在数据库中的名称。对文件型的工作空间,此名称设为空。
        返回:
        工作空间在数据库中的名称。
        Default:
        默认值为空字符串。
      • setName

        public void setName(java.lang.String value)
        设置工作空间在数据库中的名称。对文件型的工作空间,此名称设为空。
        参数:
        value - 工作空间在数据库中的名称。
      • getType

        public WorkspaceType getType()
        返回工作空间的类型。工作空间可以存储在文件中,也可以存储在数据库中。目前支持的文件型的工作空间的类型为 SXWU,SMWU,DEFAULT。
        返回:
        工作空间的类型。
        Default:
        默认值为 DEFAULT
      • setType

        public void setType(WorkspaceType value)
        设置工作空间的类型。工作空间可以存储在文件中,也可以存储在数据库中。目前支持的文件型的工作空间的类型为 SXWU,SMWU,DEFAULT。
        参数:
        value - 工作空间的类型。
      • getServer

        public java.lang.String getServer()
        返回文件名。
        1. 此处的路径为绝对路径。
        返回:
        文件的路径名。
        Default:
        默认值为空字符串。
      • setServer

        public void setServer(java.lang.String value)
        设置文件名。
        1. 此处的路径为绝对路径。
        参数:
        value - 文件的路径名。
      • getUser

        public java.lang.String getUser()
        返回登录数据库的用户名。对数据库类型工作空间适用。
        返回:
        登录数据库的用户名。
        Default:
        默认值为空字符串。
      • setUser

        public void setUser(java.lang.String value)
        设置登录数据库的用户名。对数据库类型工作空间适用。
        参数:
        value - 登录数据库的用户名。
      • getPassword

        public java.lang.String getPassword()
        返回登录工作空间连接的数据库或文件的密码。
        返回:
        登录工作空间连接的数据库或文件的密码。
        Default:
        默认值为空字符串。
      • setPassword

        public void setPassword(java.lang.String value)
        设置登录工作空间连接的数据库或文件的密码。
        参数:
        value - 登录工作空间连接的数据库或文件的密码。
      • getVersion

        public WorkspaceVersion getVersion()
        返回工作空间的版本。
        返回:
        工作空间的版本。
        Default:
        默认值为 UGC20。
      • setVersion

        public void setVersion(WorkspaceVersion value)
        设置工作空间的版本。
        参数:
        value - 工作空间的版本。
        Default:
        默认值为 UGC20。
      • dispose

        public void dispose()
        释放该对象所占用的资源。调用该方法之后,此对象不再可用。
      • toString

        public java.lang.String toString()
        将当前工作空间连接信息对象输出为格式化字符串,其格式为:{Name="",Type="",Server="",Database="",Driver="",User="",Password="",Version=""}。
        覆盖:
        toString 在类中 java.lang.Object
        返回:
        表示此工作空间连接信息对象的字符串。