com.jp.protection.pub
Interface LicenseHostListener

All Superinterfaces:

java.util.EventListener

All Known Subinterfaces:

LicenseListener

All Known Implementing Classes:

DefaultLicenseAdapter, LicenseAdapter, LicensingServiceSupport

public interface LicenseHostListener
extends java.util.EventListener

This class represents listener that allow getting various information about license checking process and result.

See Also:

LicenseHost

Method Summary

void	featureChecked(LicenseHost aSource, License aLicense, java.lang.String aFeature, boolean isEnabled) The License Host calls this method to notify listener that product feature is checked and available.
void	licenseAboutToExpire(LicenseHost aSource, License aLicense, int aDaysLeft) The License Host calls this method to notify listener that license is about to expire in specified number of days. Note, this method can be used with Protection! Professional edition only.
void	licenseAccepted(LicenseHost aSource, License aLicense, boolean isAccepted) The License Host calls this method to notify listener that license agreement is accepted or declined by the user.
void	licenseExpired(LicenseHost aSource, License aLicense) The License Host calls this method to notify listener that license is already expired.
void	licenseInvalid(LicenseHost aSource, License aLicense) The License Host calls this method to notify listener that license is invalid e.g.
void	licenseLockExpired(LicenseHost aSource, License aLicense, java.lang.String aReason) The License Host calls this method to notify the listener that the license lock has expired.
void	licenseLockRevoked(LicenseHost aSource, License aLicense, java.lang.String aReason) The License Host calls this method to notify the listener that the license lock revocation is requested by the Licensing Server administrator.
void	licenseLockViolation(LicenseHost aSource, License aLicense) The License Host calls this method to notify listener that license is activated for use on other computer. Note, this method can be used with Protection! Professional edition only.
void	licenseNeedActivation(LicenseHost aSource, License aLicense, int aDaysLeft) The License Host calls this method to notify listener that license need to be activated in aDaysLeft days. Note, this method can be used with Protection! Professional edition only.
void	licenseNeedLock(LicenseHost aSource, License aLicense, int aDaysLeft) The License Host calls this method to notify the listener that the requirement to acquire license lock will be mandatory in aDaysLeft days. Note, this method can be used with Protection! Professional edition only and can be fired when license need to be locked through the Licensing Server.
void	licenseNotActivated(LicenseHost aSource, License aLicense) The License Host calls this method to notify listener that license is not activated. Note, this method can be used with Protection! Professional edition only.
void	licenseNotLocked(LicenseHost aSource, License aLicense, java.lang.String aReason) The License Host calls this method to notify the listener that license lock has not been acquired.
void	licenseOk(LicenseHost aSource, License aLicense) The License Host calls this method to notify listener that license is OK.
void	licenseUseLimitAboutReach(LicenseHost aSource, License aLicense, int aUseLeft) The License Host calls this method to notify listener that license is about to expire after specified number of usages. Note, this method can be used with Protection! Professional edition only.
void	numberCopiesViolation(LicenseHost aSource, License aLicense, int aNumberInUse) The License Host calls this method to notify listener that the actual number of concurrently executing applications, which use the same license, exceed maximum allowed number. Note, this method can be used with Protection! Professional edition only.

Method Detail

licenseExpired

void licenseExpired(LicenseHost aSource,
                    License aLicense)

The License Host calls this method to notify listener that license is already expired.

Parameters:

aSource - the license host.

aLicense - instance of the license.

licenseOk

void licenseOk(LicenseHost aSource,
               License aLicense)

The License Host calls this method to notify listener that license is OK.

Parameters:

aSource - the license host.

aLicense - instance of the license.

licenseInvalid

void licenseInvalid(LicenseHost aSource,
                    License aLicense)

The License Host calls this method to notify listener that license is invalid e.g. it's issued for a different product.

Parameters:

aSource - the license host.

aLicense - instance of the license.

licenseAccepted

void licenseAccepted(LicenseHost aSource,
                     License aLicense,
                     boolean isAccepted)

The License Host calls this method to notify listener that license agreement is accepted or declined by the user.

Parameters:

aSource - the license host.

aLicense - instance of the license.

isAccepted - true if license agreement is accepted, false otherwise.

featureChecked

void featureChecked(LicenseHost aSource,
                    License aLicense,
                    java.lang.String aFeature,
                    boolean isEnabled)

The License Host calls this method to notify listener that product feature is checked and available.

Parameters:

aSource - the license host.

aLicense - instance of the license.

aFeature - name of the feature.

isEnabled - true if feature is enabled, false otherwise.

licenseAboutToExpire

void licenseAboutToExpire(LicenseHost aSource,
                          License aLicense,
                          int aDaysLeft)

The License Host calls this method to notify listener that license is about to expire in specified number of days.
Note, this method can be used with Protection! Professional edition only.

Parameters:

aSource - the license host.

aLicense - instance of the license.

aDaysLeft - days left to license expiration.

licenseUseLimitAboutReach

void licenseUseLimitAboutReach(LicenseHost aSource,
                               License aLicense,
                               int aUseLeft)

The License Host calls this method to notify listener that license is about to expire after specified number of usages.
Note, this method can be used with Protection! Professional edition only.

Parameters:

aSource - the license host.

aLicense - instance of the license.

aUseLeft - usages left to license expiration.

licenseLockViolation

void licenseLockViolation(LicenseHost aSource,
                          License aLicense)

The License Host calls this method to notify listener that license is activated for use on other computer.
Note, this method can be used with Protection! Professional edition only.

Parameters:

aSource - the license host.

aLicense - instance of the license.

numberCopiesViolation

void numberCopiesViolation(LicenseHost aSource,
                           License aLicense,
                           int aNumberInUse)

The License Host calls this method to notify listener that the actual number of concurrently executing applications, which use the same license, exceed maximum allowed number.
Note, this method can be used with Protection! Professional edition only.

Parameters:

aSource - the license host.

aLicense - instance of the license.

aNumberInUse - actual number of copies in use.

licenseNotActivated

void licenseNotActivated(LicenseHost aSource,
                         License aLicense)

The License Host calls this method to notify listener that license is not activated.
Note, this method can be used with Protection! Professional edition only.

Parameters:

aSource - the license host.

aLicense - instance of the license.

licenseNeedActivation

void licenseNeedActivation(LicenseHost aSource,
                           License aLicense,
                           int aDaysLeft)

The License Host calls this method to notify listener that license need to be activated in aDaysLeft days.
Note, this method can be used with Protection! Professional edition only.

Parameters:

aSource - the license host.

aLicense - instance of the license.

aDaysLeft - number of days left till the license will be considered as not activated one

licenseNeedLock

void licenseNeedLock(LicenseHost aSource,
                     License aLicense,
                     int aDaysLeft)

The License Host calls this method to notify the listener that the requirement to acquire license lock will be mandatory in aDaysLeft days.
Note, this method can be used with Protection! Professional edition only and can be fired when license need to be locked through the Licensing Server.

Parameters:

aSource - the License Host.

aLicense - instance of the license.

aDaysLeft - number of days left untill the license will be considered as not locked one

Since:

3.0

licenseNotLocked

void licenseNotLocked(LicenseHost aSource,
                      License aLicense,
                      java.lang.String aReason)

The License Host calls this method to notify the listener that license lock has not been acquired.
Note, this method can be used with Protection! Professional edition only. and can be fired when license need to be locked through the Licensing Server

Parameters:

aSource - the license host.

aLicense - instance of the license.

aReason - why license lock is not acquired

Since:

3.0

licenseLockRevoked

void licenseLockRevoked(LicenseHost aSource,
                        License aLicense,
                        java.lang.String aReason)

The License Host calls this method to notify the listener that the license lock revocation is requested by the Licensing Server administrator. This issue can occur when the Licensing Server administrator marks a license session as revoked.
Note, this method can be used with Protection! Professional edition only. and can be fired when license need to be locked through the Licensing Server

Parameters:

aSource - the license host.

aLicense - instance of the license.

aReason - why license lock revocation is requested.

Since:

3.0

licenseLockExpired

void licenseLockExpired(LicenseHost aSource,
                        License aLicense,
                        java.lang.String aReason)

The License Host calls this method to notify the listener that the license lock has expired. This issue can occur when connection to the Licensing Server is lost due to the network failure or the Licensing Server failure. It is sole responsibility of client application to properly handle this state e.g. ignoring it and letting application work as usual or showing prompt to the user and exiting application etc.
Note, this method can be used with Protection! Professional edition only. and can be fired when license need to be locked through the Licensing Server

Parameters:

aSource - the license host.

aLicense - instance of the license.

aReason - why license is expired

Since:

3.0