License

概述

软件包

类

树

已过时

索引

帮助

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

com.supermap.data
类 License

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

已过时。 从 10.0.0 版本过时。使用 com.supermap.License 替代。

@Deprecated public class License
extends java.lang.Object
extends java.lang.Object

许可信息类，该类用于获得许可的相关信息，连接与断开许可，验证许可是否有效，以及获得许可模块的信息。

示例:

以下代码示范对许可的一些操作，比如验证许可是否可用，返回一些许可信息等。

 public void licenseTest(){
        // 实例化一个 License 对象，连接 SuperMap Objects 核心组件开发版，验证是否可用
        License license = new License();
        int i = license.connect(ProductType.OBJECTS_CORE_DEVELOP);
        if (i == 0) {
            int j = license.verify();

            // 许可有效时，返回许可相关的一些信息
            if (j == 0) {
                System.out.println("公司的名称:" + license.getCompany());
                System.out.println("当前许可的用户名:" + license.getUser());
                System.out.println("许可方式:" + license.getLicenseMode());
            }
        }

        // 断开连接
        license.disconnect();
    }

构造方法摘要
`License()` 已过时。构造一个新的许可认证信息类对象。

方法摘要
`static void`	`addLicenseVerifyFailedListener(LicenseVerifyFailedListener l)` 已过时。添加一个用于接收许可验证失败结束事件（`LicenseVerifyFailedEvent`）的监听器。
`int`	`connect(int featureID)` 已过时。根据指定的模块 ID，查找相对应的许可信息。
`int`	`connect(ProductType product)` 已过时。根据用户的产品配置，查找相对应的许可信息。
`void`	`disconnect()` 已过时。断开与许可的连接。
`void`	`dispose()` 已过时。释放该对象所占用的资源。
`java.lang.String`	`getCompany()` 已过时。返回许可单位名称。
`static int`	`getConnectionHeartbeat()` 已过时。返回许可客户端与服务端的通信间隔，单位为：秒。
`static java.lang.String`	`getErrorMessage(int code)` 已过时。返回错误码所代表的详细信息。
`java.util.Date`	`getExpiredDate()` 已过时。返回许可过期日期。
`LicenseFeatureInfo`	`getFeatureInfo()` 已过时。返回许可模块信息。
`java.lang.String`	`getIdentifyCode()` 已过时。返回查询文件许可时使用的识别码。
`HardwareKeyType`	`getKeyType()` 已过时。返回硬件锁的类型。
`static LicenseConnectMode`	`getLicenseConnectMode()` 已过时。返回许可连接方式。
`static java.lang.String`	`getLicenseConnectServer()` 已过时。获取许可连接的服务器。
`LicenseMode`	`getLicenseMode()` 已过时。返回许可模式。
`java.lang.String`	`getLicenseServer()` 已过时。返回硬件加密时许可服务器名称。
`int`	`getMaxConnection()` 已过时。返回许可最大用户数。
`ProductType`	`getProduct()` 已过时。返回产品的类型。
`java.lang.String`	`getSpecifyLicenseFilePath()` 已过时。返回查找文件许可的位置。
`java.lang.String`	`getUser()` 已过时。返回许可用户名称。
`ProductVersion`	`getVersion()` 已过时。返回产品的版本。
`static void`	`removeLicenseVerifyFailedListener(LicenseVerifyFailedListener l)` 已过时。移除一个用于接收许可验证失败结束事件（`LicenseVerifyFailedEvent`）的监听器。
`static void`	`setConnectionHeartbeat(int value)` 已过时。设置许可客户端与服务端的通信间隔，单位为：秒。
`static void`	`setLicenseConnectMode(LicenseConnectMode value)` 已过时。设置许可连接方式。
`static void`	`setLicenseConnectServer(java.lang.String value)` 已过时。设置许可连接的服务器。
`void`	`setSpecifyLicenseFilePath(java.lang.String value)` 已过时。设置查找文件许可的位置，可以指定一个文件，也可以指定一个目录。
`int`	`verify()` 已过时。验证许可是否有效。

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

构造方法详细信息

License

public License()

已过时。

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

方法详细信息

getVersion

public ProductVersion getVersion()

已过时。

返回产品的版本。

返回：: 产品的版本。
默认值:: 默认值为 V600。

getProduct

public ProductType getProduct()

已过时。

返回产品的类型。

返回：: 产品的类型。
默认值:: 默认值为 OBJECTS_CORE_DEVELOP。

getLicenseMode

public LicenseMode getLicenseMode()

已过时。

返回许可模式。

返回：: 许可模式。
示例:: 请参见 License 类的示例。
默认值:: 默认值为 -842150451。

getKeyType

public HardwareKeyType getKeyType()

已过时。

返回硬件锁的类型。

返回：: 硬件锁的类型。
默认值:: 默认值为 INVALIDTYPE。

getIdentifyCode

public java.lang.String getIdentifyCode()

已过时。

返回查询文件许可时使用的识别码。

返回：: 查询文件许可时使用的识别码。
默认值:: 默认值为一个空字符串。

getUser

public java.lang.String getUser()

已过时。

返回许可用户名称。

返回：: 许可用户名称。
示例:: 请参见 License 类的示例。
默认值:: 默认值为一个空字符串。

getCompany

public java.lang.String getCompany()

已过时。

返回许可单位名称。

返回：: 许可单位名称。
示例:: 请参见 License 类的示例。
默认值:: 默认值为一个空字符串。

getLicenseServer

public java.lang.String getLicenseServer()

已过时。

返回硬件加密时许可服务器名称。当许可模式为文件许可时，该名称就是本机计算机名称。

返回：: 硬件加密时许可服务器名称。
默认值:: 默认值为一个空字符串。

getExpiredDate

public java.util.Date getExpiredDate()

已过时。

返回许可过期日期。

返回：: 许可过期日期。
默认值:: 默认值为 0001-1-1 0:00:00。

getMaxConnection

public int getMaxConnection()

已过时。

返回许可最大用户数。由于文件许可、单机硬件锁没有限制，其值均为65535。

返回：: 许可最大用户数。
默认值:: 默认值为 -1。

connect

public int connect(ProductType product)

已过时。

根据用户的产品配置，查找相对应的许可信息。

参数：: product - 用户的产品类型。
返回：: 查询成功返回0，否则返回非0的值，代表不同的错误。
示例:: 请参见 License 类的示例。

connect

public int connect(int featureID)

已过时。

根据指定的模块 ID，查找相对应的许可信息。

参数：: featureID - 指定的模块 ID。
返回：: 查询成功返回0，否则返回非0的值，代表不同的错误。
从以下版本开始：: SuperMap iObjects Java 7.0.0
示例:: 请参见 License 类的示例。

verify

public int verify()

已过时。

验证许可是否有效。

返回：: 许可有效返回0，否则返回非0的值。
示例:: 请参见 License 类的示例。

disconnect

public void disconnect()

已过时。

断开与许可的连接。

示例:: 请参见 License 类的示例。

getErrorMessage

public static java.lang.String getErrorMessage(int code)

已过时。

返回错误码所代表的详细信息。

License 类的 connect() 方法的返回值为整数，不同的值表示不同的信息，而 getErrorMessage() 方法则是用来获取这些整数所表达的具体信息。

参数：: code - 错误码。
返回：: 错误码所代表的详细信息。

addLicenseVerifyFailedListener

public static void addLicenseVerifyFailedListener(LicenseVerifyFailedListener l)

已过时。

添加一个用于接收许可验证失败结束事件（LicenseVerifyFailedEvent）的监听器。

参数：: l - 一个用于接收许可验证失败结束事件的监听器。

removeLicenseVerifyFailedListener

public static void removeLicenseVerifyFailedListener(LicenseVerifyFailedListener l)

已过时。

移除一个用于接收许可验证失败结束事件（LicenseVerifyFailedEvent）的监听器。

参数：: l - 一个用于接收许可验证失败结束事件的监听器。

dispose

public void dispose()

已过时。

释放该对象所占用的资源。当调用该方法之后，此对象不再可用。

getConnectionHeartbeat

public static int getConnectionHeartbeat()

已过时。

返回许可客户端与服务端的通信间隔，单位为：秒。该设置只针对硬件锁。

对于安装了硬件锁的许可服务器，客户端请求许可后，许可服务器将在该属性指定的时间间隔内，检查客户端是否使用请求的许可，如果客户端不再使用许可，服务端将回收其请求的许可资源。

返回：: 许可客户端与服务端的通信间隔，单位为：秒。

setConnectionHeartbeat

public static void setConnectionHeartbeat(int value)

已过时。

设置许可客户端与服务端的通信间隔，单位为：秒。该设置只针对硬件锁。

参数：: value - 许可客户端与服务端的通信间隔，单位为：秒。

getFeatureInfo

public LicenseFeatureInfo getFeatureInfo()

已过时。

返回许可模块信息。

返回：: 返回许可模块信息。
从以下版本开始：: SuperMap iObjects Java 7.0.0

getLicenseConnectServer

public static java.lang.String getLicenseConnectServer()

已过时。

获取许可连接的服务器。当许可连接方式为 LOCAL_ONLY 或 REMOTE_ONLY 时无效。

详细介绍请参见 setLicenseConnectServer 方法。

返回：: 许可连接的服务器。
从以下版本开始：: SuperMap iObjects Java 7.0.0
默认值:: 默认值为一个空字符串。

setLicenseConnectServer

public static void setLicenseConnectServer(java.lang.String value)

已过时。

设置许可连接的服务器。当许可连接方式为 LOCAL_ONLY 或 REMOTE_ONLY 时无效。

当使用如下方式连接许可时，可通过此方法指定相应的许可（许可服务器）的信息，以连接到目标许可服务器，节省许可查找时间。

当许可连接方式为 HL_ONLY 时，指定相应的许可服务器的计算机名或 IP 地址是可选的，如不指定，则自动连接可用许可。
当许可连接方式为 SPECIFIED_HOSTNAME 时，必须指定相应的许可服务器的计算机名，如不指定则连接失败。
当许可连接方式为 SPECIFIED_IP 时，必须指定相应的许可服务器的 IP 地址，如不指定则连接失败。
当许可连接方式为 SPECIFIED_KEYID 时，必须指定相应的锁号（即硬件锁 ID 或软许可 ID），如不指定则连接失败。

注：有两种方式可以查看锁号：

通过 SuperMap 许可中心的查看许可状态，获得锁号。此方式仅支持 Windows 平台。

了解 SuperMap 许可中心

通过 connect 方法连接对应的模块后，调用 getFeatureInfo 方法返回 LicenseFeatureInfo（许可模块信息）对象，通过该对象的 getKeyID 方法查看锁号。

注意：许可连接类型与指定的服务器名称/IP 要相互匹配。

参数：: value - 许可连接的服务器。
从以下版本开始：: SuperMap iObjects Java 7.0.0

getLicenseConnectMode

public static LicenseConnectMode getLicenseConnectMode()

已过时。

返回许可连接方式。

关于许可连接方式的详细介绍请参见 setLicenseConnectMode 方法。

返回：: 许可连接方式。
从以下版本开始：: SuperMap iObjects Java 7.0.0
默认值:: 默认值为 LicenseConnectMode.DEFAULT，即按照默认方式连接许可。

setLicenseConnectMode

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

setSpecifyLicenseFilePath

public void setSpecifyLicenseFilePath(java.lang.String value)

已过时。

设置查找文件许可的位置，可以指定一个文件，也可以指定一个目录。

参数：: value - 查找文件许可的位置，可以指定一个文件，也可以指定一个目录。

getSpecifyLicenseFilePath

public java.lang.String getSpecifyLicenseFilePath()

已过时。

返回查找文件许可的位置。

返回：: 返回查找文件许可的位置，可以是一个文件，也可以是一个目录。

概述

软件包

类

树

已过时

索引

帮助

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

com.supermap.data 类 License

License

getVersion

getProduct

getLicenseMode

getKeyType

getIdentifyCode

getUser

getCompany

getLicenseServer

getExpiredDate

getMaxConnection

connect

connect

verify

disconnect

getErrorMessage

addLicenseVerifyFailedListener

removeLicenseVerifyFailedListener

dispose

getConnectionHeartbeat

setConnectionHeartbeat

getFeatureInfo

getLicenseConnectServer

setLicenseConnectServer

getLicenseConnectMode

setLicenseConnectMode

setSpecifyLicenseFilePath

getSpecifyLicenseFilePath

com.supermap.data
类 License