License (iObjects Java Help)

java.lang.Object
- com.supermap.data.License

已过时。

@Deprecated
public class License
extends Object

构造器概要

构造器
构造器和说明

License()
已过时。

构造一个新的许可认证信息类对象。

构造器
构造器和说明
`License()` 已过时。构造一个新的许可认证信息类对象。

方法概要

所有方法静态方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`static void`	`addLicenseVerifyFailedListener(LicenseVerifyFailedListener l)` 已过时。添加一个用于接收许可验证失败结束事件（`LicenseVerifyFailedEvent`）的监听器。
`int`	`connect(int featureID)` 已过时。
`int`	`connect(ProductType product)` 已过时。根据用户的产品配置，查找相对应的许可信息。
`void`	`disconnect()` 已过时。断开与许可的连接。
`void`	`dispose()` 已过时。释放该对象所占用的资源。
`String`	`getCompany()` 已过时。返回许可单位名称。
`String`	`getConnectErrorMessage(int code)` 已过时。
`static int`	`getConnectionHeartbeat()` 已过时。
`static String`	`getErrorMessage(int code)` 已过时。返回错误码所代表的详细信息。
`Date`	`getExpiredDate()` 已过时。
`LicenseFeatureInfo`	`getFeatureInfo()` 已过时。返回许可模块信息。
`static Element`	`getFirstElementByName(Element element, String tagName)` 已过时。
`String`	`getIdentifyCode()` 已过时。
`HardwareKeyType`	`getKeyType()` 已过时。
`static LicenseConnectMode`	`getLicenseConnectMode()` 已过时。
`static String`	`getLicenseConnectServer()` 已过时。
`LicenseMode`	`getLicenseMode()` 已过时。
`String`	`getLicenseServer()` 已过时。
`int`	`getMaxConnection()` 已过时。
`ProductType`	`getProduct()` 已过时。
`static String`	`getSpecifyLicenseFilePath()` 已过时。
`static String`	`getSpecifyLicenseXML()` 已过时。
`String`	`getUser()` 已过时。返回许可用户名称。
`ProductVersion`	`getVersion()` 已过时。
`Boolean`	`isCloudLicense()` 已过时。
`static void`	`removeLicenseVerifyFailedListener(LicenseVerifyFailedListener l)` 已过时。移除一个用于接收许可验证失败结束事件（`LicenseVerifyFailedEvent`）的监听器。
`static void`	`setConnectionHeartbeat(int value)` 已过时。
`static void`	`setLicenseConnectMode(LicenseConnectMode value)` 已过时。
`static void`	`setLicenseConnectServer(String value)` 已过时。
`static void`	`setSpecifyLicenseFilePath(String value)` 已过时。
`static void`	`setSpecifyLicenseXML(String value)` 已过时。
`String`	`toString()` 已过时。
`int`	`verify()` 已过时。验证许可是否有效。

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - License
```
public License()
```
    已过时。
    
    构造一个新的许可认证信息类对象。
- 方法详细资料
  - dispose
```
public void dispose()
```
    已过时。
    
    释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
  - connect
```
public int connect(ProductType product)
```
    已过时。
    
    根据用户的产品配置，查找相对应的许可信息。
    
    参数:
    
    product - 用户的产品类型。
    
    返回:
    
    查询成功返回0，否则返回非0的值，代表不同的错误。
    
    示范代码:
    
    请参见 License 类的示例。
  - connect
```
public int connect(int featureID)
```
    已过时。
  - verify
```
public int verify()
```
    已过时。
    
    验证许可是否有效。
    
    返回:
    
    许可有效返回0，否则返回非0的值。
    
    示范代码:
    
    请参见 License 类的示例。
  - getFeatureInfo
```
public LicenseFeatureInfo getFeatureInfo()
```
    已过时。
    
    返回许可模块信息。
    
    返回:
    
    返回许可模块信息。
    
    从以下版本开始:
    
    SuperMap iObjects Java 7.0.0
  - disconnect
```
public void disconnect()
```
    已过时。
    
    断开与许可的连接。
    
    示范代码:
    
    请参见 License 类的示例。
  - getUser
```
public String getUser()
```
    已过时。
    
    返回许可用户名称。
    
    返回:
    
    许可用户名称。
    
    示范代码:
    
    请参见 License 类的示例。
    
    默认值:
    
    默认值为一个空字符串。
  - getCompany
```
public String getCompany()
```
    已过时。
    
    返回许可单位名称。
    
    返回:
    
    许可单位名称。
    
    示范代码:
    
    请参见 License 类的示例。
    
    默认值:
    
    默认值为一个空字符串。
  - isCloudLicense
```
public Boolean isCloudLicense()
```
    已过时。
  - getErrorMessage
```
public static String getErrorMessage(int code)
```
    已过时。
    
    返回错误码所代表的详细信息。
    License 类的 connect() 方法的返回值为整数，不同的值表示不同的信息，而 getErrorMessage() 方法则是用来获取这些整数所表达的具体信息。
    
    参数:
    
    code - 错误码。
    
    返回:
    
    错误码所代表的详细信息。
  - getConnectErrorMessage
```
public String getConnectErrorMessage(int code)
```
    已过时。
  - getFirstElementByName
```
public static Element getFirstElementByName(Element element,
                                            String tagName)
```
    已过时。
  - toString
```
public String toString()
```
    已过时。
    
    覆盖:
    
    toString 在类中 Object
  - addLicenseVerifyFailedListener
```
public static void addLicenseVerifyFailedListener(LicenseVerifyFailedListener l)
```
    已过时。
    
    添加一个用于接收许可验证失败结束事件（LicenseVerifyFailedEvent）的监听器。
    
    参数:
    
    l - 一个用于接收许可验证失败结束事件的监听器。
  - removeLicenseVerifyFailedListener
```
public static void removeLicenseVerifyFailedListener(LicenseVerifyFailedListener l)
```
    已过时。
    
    移除一个用于接收许可验证失败结束事件（LicenseVerifyFailedEvent）的监听器。
    
    参数:
    
    l - 一个用于接收许可验证失败结束事件的监听器。
  - getConnectionHeartbeat
```
@Deprecated
public static int getConnectionHeartbeat()
```
    已过时。
    
    返回许可客户端与服务端的通信间隔，单位为：秒。该设置只针对硬件锁。
    对于安装了硬件锁的许可服务器，客户端请求许可后，许可服务器将在该属性指定的时间间隔内，检查客户端是否使用请求的许可，如果客户端不再使用许可，服务端将回收其请求的许可资源。
    
    返回:
    
    许可客户端与服务端的通信间隔，单位为：秒。
  - setConnectionHeartbeat
```
@Deprecated
public static void setConnectionHeartbeat(int value)
```
    已过时。
    
    设置许可客户端与服务端的通信间隔，单位为：秒。该设置只针对硬件锁。
    对于安装了硬件锁的许可服务器，客户端请求许可后，许可服务器将在该属性指定的时间间隔内，检查客户端是否使用请求的许可，如果客户端不再使用许可，服务端将回收其请求的许可资源。
    
    参数:
    
    value - 许可客户端与服务端的通信间隔，单位为：秒。
  - getVersion
```
@Deprecated
public ProductVersion getVersion()
```
    已过时。
    
    返回产品的版本。
    
    返回:
    
    产品的版本。
    
    默认值:
    
    默认值为 V600。
  - getProduct
```
@Deprecated
public ProductType getProduct()
```
    已过时。
    
    返回产品的类型。
    
    返回:
    
    产品的类型。
    
    默认值:
    
    默认值为 OBJECTS_CORE_DEVELOP。
  - getLicenseMode
```
@Deprecated
public LicenseMode getLicenseMode()
```
    已过时。
    
    返回许可模式。
    
    返回:
    
    许可模式。
    
    示范代码:
    
    请参见 License 类的示例。
    
    默认值:
    
    默认值为 -842150451。
  - getKeyType
```
@Deprecated
public HardwareKeyType getKeyType()
```
    已过时。
    
    返回硬件锁的类型。
    
    返回:
    
    硬件锁的类型。
    
    默认值:
    
    默认值为 INVALIDTYPE。
  - getIdentifyCode
```
@Deprecated
public String getIdentifyCode()
```
    已过时。
    
    返回查询文件许可时使用的识别码。
    
    返回:
    
    查询文件许可时使用的识别码。
    
    默认值:
    
    默认值为一个空字符串。
  - getExpiredDate
```
@Deprecated
public Date getExpiredDate()
```
    已过时。
    
    返回许可过期日期。
    
    返回:
    
    许可过期日期。
    
    默认值:
    
    默认值为 0001-1-1 0:00:00。
  - getLicenseServer
```
@Deprecated
public String getLicenseServer()
```
    已过时。
    
    返回硬件加密时许可服务器名称。当许可模式为文件许可时，该名称就是本机计算机名称。
    
    返回:
    
    硬件加密时许可服务器名称。
    
    默认值:
    
    默认值为一个空字符串。
  - getMaxConnection
```
@Deprecated
public int getMaxConnection()
```
    已过时。
    
    返回许可最大用户数。由于文件许可、单机硬件锁没有限制，其值均为65535。
    
    返回:
    
    许可最大用户数。
    
    默认值:
    
    默认值为 -1。
  - getLicenseConnectServer
```
@Deprecated
public static String getLicenseConnectServer()
```
    已过时。
    
    获取许可连接的服务器。当许可连接方式为 LOCAL_ONLY 或 REMOTE_ONLY 时无效。
    详细介绍请参见 setLicenseConnectServer 方法。
    
    返回:
    
    许可连接的服务器。
    
    从以下版本开始:
    
    SuperMap iObjects Java 7.0.0
    
    默认值:
    
    默认值为一个空字符串。
  - setLicenseConnectServer
```
@Deprecated
public static void setLicenseConnectServer(String value)
```
    已过时。
    设置许可连接的服务器。当许可连接方式为 LOCAL_ONLY 或 REMOTE_ONLY 时无效。
    当使用如下方式连接许可时，可通过此方法指定相应的许可（许可服务器）的信息，以连接到目标许可服务器，节省许可查找时间。
    - 当许可连接方式为 HL_ONLY 时，指定相应的许可服务器的计算机名或 IP 地址是可选的，如不指定，则自动连接可用许可。
    - 当许可连接方式为 SPECIFIED_HOSTNAME 时，必须指定相应的许可服务器的计算机名，如不指定则连接失败。
    - 当许可连接方式为 SPECIFIED_IP 时，必须指定相应的许可服务器的 IP 地址，如不指定则连接失败。
    - 当许可连接方式为 SPECIFIED_KEYID 时，必须指定相应的锁号（即硬件锁 ID 或软许可 ID），如不指定则连接失败。
    注意：许可连接类型与指定的服务器名称/IP 要相互匹配。
    参数:
    
    value - 许可连接的服务器。
    
    从以下版本开始:
    
    SuperMap iObjects Java 7.0.0
  - getLicenseConnectMode
```
@Deprecated
public static LicenseConnectMode getLicenseConnectMode()
```
    已过时。
    
    返回许可连接方式。
    关于许可连接方式的详细介绍请参见 setLicenseConnectMode 方法。
    
    返回:
    
    许可连接方式。
    
    从以下版本开始:
    
    SuperMap iObjects Java 7.0.0
    
    默认值:
    
    默认值为 LicenseConnectMode.DEFAULT，即按照默认方式连接许可。
  - setLicenseConnectMode
```
@Deprecated
public static void setLicenseConnectMode(LicenseConnectMode value)
```
    已过时。
    设置许可连接方式。
    SuperMap 提供了灵活的许可连接方式，由 LicenseConnectMode 类定义，包括：按照默认方式连接（DEFAULT）、只连接硬件许可（HL_ONLY）、只连接本地许可（LOCAL_ONLY）、只连接远程许可（REMOTE_ONLY）、按服务器名称连接（SPECIFIED_HOSTNAME）、按服务器 IP 地址连接（SPECIFIED_IP）和连接指定锁号的许可（SPECIFIED_KEYID）。
    
    通过此方法设置连接方式后，应用程序在验证许可时，将按照指定的许可连接方式查找可用许可并连接。根据需要选择适当的许可连接方式，可以在一定程度上提高许可连接性能。例如，网络许可的连接时间通常是本地许可连接时间的数倍并容易受网络状况影响，尽管每次连接的时间都非常短暂，但在需要频繁验证许可时，在整体上可能带来一定程度的性能损失。
    
    注意：
    - 请确保存在与指定的许可连接方式相对应的可用许可，否则查找不到可用许可将导致许可验证失败。
    - 使用 HL_ONLY、SPECIFIED_HOSTNAME、SPECIFIED_IP、SPECIFIED_KEYID 方式连接许可时，需要通过 setLicenseConnectServer 方法设置许可信息，以连接到指定的许可。
    参数:
    
    value - 许可连接方式。
    
    从以下版本开始:
    
    SuperMap iObjects Java 7.0.0
  - getSpecifyLicenseFilePath
```
public static String getSpecifyLicenseFilePath()
```
    已过时。
  - setSpecifyLicenseFilePath
```
public static void setSpecifyLicenseFilePath(String value)
```
    已过时。
  - getSpecifyLicenseXML
```
public static String getSpecifyLicenseXML()
```
    已过时。
  - setSpecifyLicenseXML
```
public static void setSpecifyLicenseXML(String value)
```
    已过时。

类 License

构造器概要

方法概要

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

构造器详细资料

License

方法详细资料

dispose

connect

connect

verify

getFeatureInfo

disconnect

getUser

getCompany

isCloudLicense

getErrorMessage

getConnectErrorMessage

getFirstElementByName

toString

addLicenseVerifyFailedListener

removeLicenseVerifyFailedListener

getConnectionHeartbeat

setConnectionHeartbeat

getVersion

getProduct

getLicenseMode

getKeyType

getIdentifyCode

getExpiredDate

getLicenseServer

getMaxConnection

getLicenseConnectServer

setLicenseConnectServer

getLicenseConnectMode

setLicenseConnectMode

getSpecifyLicenseFilePath

setSpecifyLicenseFilePath

getSpecifyLicenseXML

setSpecifyLicenseXML