public class DatasourceConnectionInfo
extends java.lang.Object
implements java.io.Serializable
数据源连接信息类。
包括了进行数据源连接的所有信息,如所要连接的服务器名称、数据库名称、用户名以及密码等。当保存为工作空间时, 工作空间中的数据源的连接信息都将存储到工作空间文件中。对于不同类型的数据源,其连接信息有所区别。所以在使 用该类所包含的成员时,请注意该成员所适用的数据源类型。
对于从数据源对象中返回的数据连接信息对象,只有 connect
方法可以被修改,其 他内容是不可以被修改的。对于用户创建的数据源连接信息对象,其内容都可以修改。
限定符和类型 | 字段和说明 |
---|---|
java.lang.String |
alias
数据源别名。
|
boolean |
connect
数据源是否自动连接数据。
|
java.lang.String |
dataBase
数据源连接的数据库名。
|
java.lang.String |
driver
数据源连接所需的驱动程序名。
|
EngineType |
engineType
数据源连接的引擎类型。
|
boolean |
exclusive
是否以独占方式打开数据源。
|
boolean |
openLinkTable
是否把数据库中的其他非 SuperMap 数据表作为 LinkTable 打开。
|
java.lang.String |
password
登录数据源连接的数据库或文件的密码。
|
boolean |
readOnly
是否以只读方式打开数据源。
|
java.lang.String |
server
数据库服务器名、文件名或服务地址。
|
java.lang.String |
user
登录数据库的用户名。
|
构造器和说明 |
---|
DatasourceConnectionInfo()
默认构造函数。
|
DatasourceConnectionInfo(DatasourceConnectionInfo datasourceConnectionInfo)
拷贝构造函数。
|
限定符和类型 | 方法和说明 |
---|---|
DatasourceConnectionInfo |
copy() |
boolean |
equals(java.lang.Object obj)
比较指定对象与本数据源连接信息对象是否相等。
|
int |
hashCode()
根据数据源连接的信息,为跟数据源连接信息对象生成哈希码。
|
public java.lang.String alias
数据源别名。
public java.lang.String dataBase
数据源连接的数据库名。
public java.lang.String driver
数据源连接所需的驱动程序名。
对于SQL Server数据库,它使用ODBC连接,返回的驱动程序名为SQL Server或SQL Native Client.对于iServer发布的WMTS服务,返回的驱动程序名称为WMTS.
public EngineType engineType
数据源连接的引擎类型。
public java.lang.String password
登录数据源连接的数据库或文件的密码。
public java.lang.String server
数据库服务器名、文件名或服务地址。
1.对于SDB和UDB文件,为其文件的绝对路径。注意:当绝对路径的长度超过UTF-8编码格式的260字节长度,该数据源无法打开。
2.对于Oracle数据库,其服务器名为其TNS服务名称。
3.对于SQL Server数据库,其服务器名为其系统的DSN(Database Source Name)名称。
4.对于PostgreSQL数据库,其服务器名为“IP:端口号”,默认的端口号是 5432。
5.对于DB2数据库,已经进行了编目,所以不需要进行服务器的设置。
6.对于 Kingbase 数据库,其服务器名为其 IP 地址。
7.对于GoogleMaps数据源,其服务器地址,默认设置为“http://maps.google.com”,且不可更改。
8.对于SuperMapCould数据源,为其服务地址。
9.对于MAPWORLD数据源,为其服务地址,默认设置为“http://www.tianditu.cn”,且不可更改。
10.对于OGC和REST数据源,为其服务地址。
public java.lang.String user
登录数据库的用户名。
public boolean connect
数据源是否自动连接数据。
public boolean exclusive
是否以独占方式打开数据源。
public boolean openLinkTable
是否把数据库中的其他非 SuperMap 数据表作为 LinkTable 打开。
public boolean readOnly
是否以只读方式打开数据源。
public DatasourceConnectionInfo()
默认构造函数。
public DatasourceConnectionInfo(DatasourceConnectionInfo datasourceConnectionInfo)
拷贝构造函数。
datasourceConnectionInfo
- 数据源连接信息对象。java.lang.IllegalArgumentException
- 当数据源连接信息对象为 Null 时抛出异常。public int hashCode()
根据数据源连接的信息,为跟数据源连接信息对象生成哈希码。
hashCode
在类中 java.lang.Object
public boolean equals(java.lang.Object obj)
比较指定对象与本数据源连接信息对象是否相等。
equals
在类中 java.lang.Object
obj
- 与此对象进行比较的对象。public DatasourceConnectionInfo copy()