com.supermap
类 License

java.lang.Object
  com.supermap.License

public class License
extends java.lang.Object

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

示例:

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

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

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

        // 断开连接
        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 java.lang.String	getErrorMessage(int code) 返回错误码所代表的详细信息。
LicenseFeatureInfo	getFeatureInfo() 返回许可模块信息。
static LicenseConnectMode	getLicenseConnectMode() 返回许可连接方式。
static java.lang.String	getLicenseConnectServer() 获取许可连接的服务器。
java.lang.String	getSpecifyLicenseFilePath() 返回查找文件许可的位置。
java.lang.String	getUser() 返回许可用户名称。
static void	removeLicenseVerifyFailedListener(LicenseVerifyFailedListener l) 移除一个用于接收许可验证失败结束事件（LicenseVerifyFailedEvent）的监听器。
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()

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

方法详细信息

getUser

public java.lang.String getUser()

返回许可用户名称。

返回：

许可用户名称。

示例:

请参见 License 类的示例。

默认值:

默认值为一个空字符串。

getCompany

public java.lang.String getCompany()

返回许可单位名称。

返回：

许可单位名称。

示例:

请参见 License 类的示例。

默认值:

默认值为一个空字符串。

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()

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

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），如不指定则连接失败。

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

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



了解 SuperMap 许可中心

2. 通过 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()

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

返回：

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