LicenseManager (Marvin API documentation (c) 1998-2014 ChemAxon Ltd.)

java.lang.Object
- chemaxon.license.LicenseManager

```
public class LicenseManager
extends Object
```
LicenseManager is a helper class to manage licenses of ChemAxon products. The licenses are stored in xml files (license.cxl) and are digitally signatured by ChemAxon. The default location of the license file is USER_HOME/chemaxon/license.cxl, but this can arbitrarily be changed. The old license files (licenses.dat) are supported till September 2008.

Since:

Marvin 5.0.1

Version:

5.0 Jan 28, 2008

Author:

Judit Vasko-Szedlar

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ALIGNMENT` Identifier of product: Alignment
`static String`	`CALCULATIONS_PACK` Identifier of product: Calculations Pack
`static String`	`CARTRIDGE` Identifier of product: JChem Cartridge
`static String`	`CHARGE_PLUGIN_GROUP` Identifier of plugin: Charge Plugin Group
`static String`	`CHEM_CURATOR_COMPOUND` Identifier of product: ChemCurator Compound
`static String`	`CHEM_CURATOR_FULL` Identifier of product: ChemCurator Markush
`static String`	`CHEM_CURATOR_VIEWER` Identifier of product: ChemCurator Viewer
`static String`	`CHINESE_NAME_TO_STRUCTURE` Identifier of product: Chinese Name to Structure
`static String`	`CONFORMATION_PLUGIN_GROUP` Identifier of plugin: Conformation Plugin Group
`static String`	`DOCUMENT_TO_DATABASE` Identifier of product: Document to Structure
`static String`	`DOCUMENT_TO_STRUCTURE` Identifier of product: Document to Database
`static String`	`ECFP_FCFP` Identifier of product: Molecular Descriptors
`static String`	`FRAGMENTER` Identifier of product: Fragmenter
`static String`	`GEOMETRY_PLUGIN_GROUP` Identifier of plugin: Geometry Plugin Group
`static String`	`HBDA_PLUGIN` Identifier of plugin: HBDA Plugin
`static String`	`HUCKEL_ANALYSIS_PLUGIN` Identifier of plugin: Huckel Analysis Plugin
`static String`	`INSTANT_JCHEM` Identifier of product: Instant JChem
`static String`	`INSTANT_JCHEM_SERVER` Identifier of product: Instant JChem Server
`static String`	`INSTANT_JCHEM_VIZ` Identifier of product: Instant JChem VIZ
`static String`	`ISOMERS_PLUGIN_GROUP` Identifier of plugin: Isomers Plugin Group
`static String`	`IUPAC_NAMING_PLUGIN` Identifier of plugin: IUPAC Naming Plugin
`static String`	`JAPANESE_NAME_TO_STRUCTURE` Identifier of product: Japanese Name to Structure
`static String`	`JCHEM` Identifier of product: JChem Base
`static String`	`JCHEM_FOR_EXCEL` Identifier of product: JChem for Excel
`static String`	`JCHEM_FOR_OFFICE` Identifier of product: JChem for Office
`static String`	`JCHEM_FOR_SHAREPOINT` Identifier of product: JChem for SharePoint
`static String`	`JCHEM_FOR_SHAREPOINT_SEARCH` Identifier of product: JChem for SharePoint Search
`static String`	`JKLUSTOR` Identifier of product: JKlustor
`static String`	`MARKUSH_EDITOR` Identifier of product: Markush Editor
`static String`	`MARKUSH_ENUM_PLUGIN` Identifier of plugin: Markush Enumeration Plugin
`static String`	`MARKUSH_SEARCH` Identifier of product: Markush Search
`static String`	`MARVIN_APPLETS` Identifier of product: Marvin Applets
`static String`	`MARVIN_BEANS` Identifier of product: Marvin Beans
`static String`	`MCES` Identifier of product: MCES
`static String`	`METABOLIZER` Identifier of product: Metabolizer
`static String`	`MOLECULAR_DESCRIPTORS` Identifier of product: Molecular Descriptors
`static String`	`NAME_TO_STRUCTURE` Identifier of product: Name to Structure
`static String`	`NMR` Identifier of product: NMR plugin
`static String`	`PARTITIONING_PLUGIN_GROUP` Identifier of plugin: Partitioning Plugin Group
`static String`	`PLEXUS` Identifier of product: Plexus
`static String`	`PREDICTOR_PLUGIN` Identifier of product: Predictor Plugin
`static String`	`PROTONATION_PLUGIN_GROUP` Identifier of plugin: Protonation Plugin Group
`static String`	`REACTOR` Identifier of product: Reactor
`static String`	`REFRACTIVITY_PLUGIN` Identifier of plugin: Refractivity Plugin
`static String`	`REGISTRATION_SYSTEM` Identifier of product: Structure Checker
`static String`	`SCREEN` Identifier of product: Screen
`static String`	`SCREEN3D` Identifier of product: 3D Screen
`static String`	`STANDARDIZER` Identifier of product: Standardizer
`static String`	`STRUCTURAL_FRAMEWORKS_PLUGIN` Identifier of product: Structural Frameworks Plugin
`static String`	`STRUCTURE_CHECKER` Identifier of product: Structure Checker
`static String`	`STRUCTURE_TO_NAME` Identifier of product: Structure to Name
`static String`	`WEB_SERVICES_SERVER` Identifier of product: Web Services Server

Constructor Summary

Constructors
Constructor and Description

LicenseManager()

Constructors
Constructor and Description
`LicenseManager()`

Method Summary

Methods
Modifier and Type	Method and Description
`static JPanel`	`createLicenseManagerPanel()` Creates the main panel which is used for end-user license managing.
`static String`	`getLicenseExceptionMessage()` Returns the common message used at license problems.
`static JPanel`	`getLicenseExceptionPanel(chemaxon.license.LicenseException exc)` Returns the common swing component used to indicate missing license.
`static JPanel`	`getLicenseExceptionPanel(String product)` Returns the common swing component used to indicate missing license.
`static ArrayList<String>`	`getPluginList()` Returns the list of the plugin identifiers known by the license manager.
`static ArrayList<String>`	`getProductList(boolean includePlugins)` Returns the list of the product identifiers known by the license manager.
`static boolean`	`isLicensed(String product)` Returns true if the license manager recognizes the given product to be licensed.
`static void`	`refresh()` Re-reads licenses from the default locations.
`static void`	`setLicense(String s)` Sets a pre-read license file to the license manager to read and validate licenses from.
`static void`	`setLicenseFile(String licensePath)` Sets the license file location to the license manager to read and validate licenses from.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - MARVIN_APPLETS
```
public static final String MARVIN_APPLETS
```
    Identifier of product: Marvin Applets
    
    See Also:
    Constant Field Values
  - MARVIN_BEANS
```
public static final String MARVIN_BEANS
```
    Identifier of product: Marvin Beans
    
    See Also:
    Constant Field Values
  - INSTANT_JCHEM
```
public static final String INSTANT_JCHEM
```
    Identifier of product: Instant JChem
    
    See Also:
    Constant Field Values
  - INSTANT_JCHEM_VIZ
```
public static final String INSTANT_JCHEM_VIZ
```
    Identifier of product: Instant JChem VIZ
    
    See Also:
    Constant Field Values
  - INSTANT_JCHEM_SERVER
```
public static final String INSTANT_JCHEM_SERVER
```
    Identifier of product: Instant JChem Server
    
    See Also:
    Constant Field Values
  - JCHEM
```
public static final String JCHEM
```
    Identifier of product: JChem Base
    
    See Also:
    Constant Field Values
  - CARTRIDGE
```
public static final String CARTRIDGE
```
    Identifier of product: JChem Cartridge
    
    See Also:
    Constant Field Values
  - STANDARDIZER
```
public static final String STANDARDIZER
```
    Identifier of product: Standardizer
    
    See Also:
    Constant Field Values
  - SCREEN
```
public static final String SCREEN
```
    Identifier of product: Screen
    
    See Also:
    Constant Field Values
  - MCES
```
public static final String MCES
```
    Identifier of product: MCES
    
    See Also:
    Constant Field Values
  - SCREEN3D
```
public static final String SCREEN3D
```
    Identifier of product: 3D Screen
    
    See Also:
    Constant Field Values
  - ALIGNMENT
```
public static final String ALIGNMENT
```
    Identifier of product: Alignment
    
    See Also:
    Constant Field Values
  - MOLECULAR_DESCRIPTORS
```
public static final String MOLECULAR_DESCRIPTORS
```
    Identifier of product: Molecular Descriptors
    
    See Also:
    Constant Field Values
  - ECFP_FCFP
```
public static final String ECFP_FCFP
```
    Identifier of product: Molecular Descriptors
    
    See Also:
    Constant Field Values
  - REACTOR
```
public static final String REACTOR
```
    Identifier of product: Reactor
    
    See Also:
    Constant Field Values
  - FRAGMENTER
```
public static final String FRAGMENTER
```
    Identifier of product: Fragmenter
    
    See Also:
    Constant Field Values
  - JKLUSTOR
```
public static final String JKLUSTOR
```
    Identifier of product: JKlustor
    
    See Also:
    Constant Field Values
  - METABOLIZER
```
public static final String METABOLIZER
```
    Identifier of product: Metabolizer
    
    See Also:
    Constant Field Values
  - MARKUSH_EDITOR
```
public static final String MARKUSH_EDITOR
```
    Identifier of product: Markush Editor
    
    See Also:
    Constant Field Values
  - MARKUSH_SEARCH
```
public static final String MARKUSH_SEARCH
```
    Identifier of product: Markush Search
    
    See Also:
    Constant Field Values
  - CHEM_CURATOR_VIEWER
```
public static final String CHEM_CURATOR_VIEWER
```
    Identifier of product: ChemCurator Viewer
    
    See Also:
    Constant Field Values
  - CHEM_CURATOR_COMPOUND
```
public static final String CHEM_CURATOR_COMPOUND
```
    Identifier of product: ChemCurator Compound
    
    See Also:
    Constant Field Values
  - CHEM_CURATOR_FULL
```
public static final String CHEM_CURATOR_FULL
```
    Identifier of product: ChemCurator Markush
    
    See Also:
    Constant Field Values
  - NAME_TO_STRUCTURE
```
public static final String NAME_TO_STRUCTURE
```
    Identifier of product: Name to Structure
    
    See Also:
    Constant Field Values
  - CHINESE_NAME_TO_STRUCTURE
```
public static final String CHINESE_NAME_TO_STRUCTURE
```
    Identifier of product: Chinese Name to Structure
    
    See Also:
    Constant Field Values
  - JAPANESE_NAME_TO_STRUCTURE
```
public static final String JAPANESE_NAME_TO_STRUCTURE
```
    Identifier of product: Japanese Name to Structure
    
    See Also:
    Constant Field Values
  - DOCUMENT_TO_STRUCTURE
```
public static final String DOCUMENT_TO_STRUCTURE
```
    Identifier of product: Document to Database
    
    See Also:
    Constant Field Values
  - DOCUMENT_TO_DATABASE
```
public static final String DOCUMENT_TO_DATABASE
```
    Identifier of product: Document to Structure
    
    See Also:
    Constant Field Values
  - STRUCTURE_TO_NAME
```
public static final String STRUCTURE_TO_NAME
```
    Identifier of product: Structure to Name
    
    See Also:
    Constant Field Values
  - JCHEM_FOR_EXCEL
```
public static final String JCHEM_FOR_EXCEL
```
    Identifier of product: JChem for Excel
    
    See Also:
    Constant Field Values
  - JCHEM_FOR_OFFICE
```
public static final String JCHEM_FOR_OFFICE
```
    Identifier of product: JChem for Office
    
    See Also:
    Constant Field Values
  - CALCULATIONS_PACK
```
public static final String CALCULATIONS_PACK
```
    Identifier of product: Calculations Pack
    
    See Also:
    Constant Field Values
  - WEB_SERVICES_SERVER
```
public static final String WEB_SERVICES_SERVER
```
    Identifier of product: Web Services Server
    
    See Also:
    Constant Field Values
  - JCHEM_FOR_SHAREPOINT
```
public static final String JCHEM_FOR_SHAREPOINT
```
    Identifier of product: JChem for SharePoint
    
    See Also:
    Constant Field Values
  - JCHEM_FOR_SHAREPOINT_SEARCH
```
public static final String JCHEM_FOR_SHAREPOINT_SEARCH
```
    Identifier of product: JChem for SharePoint Search
    
    See Also:
    Constant Field Values
  - STRUCTURE_CHECKER
```
public static final String STRUCTURE_CHECKER
```
    Identifier of product: Structure Checker
    
    See Also:
    Constant Field Values
  - REGISTRATION_SYSTEM
```
public static final String REGISTRATION_SYSTEM
```
    Identifier of product: Structure Checker
    
    See Also:
    Constant Field Values
  - PLEXUS
```
public static final String PLEXUS
```
    Identifier of product: Plexus
    
    See Also:
    Constant Field Values
  - PROTONATION_PLUGIN_GROUP
```
public static final String PROTONATION_PLUGIN_GROUP
```
    Identifier of plugin: Protonation Plugin Group
    
    See Also:
    Constant Field Values
  - PARTITIONING_PLUGIN_GROUP
```
public static final String PARTITIONING_PLUGIN_GROUP
```
    Identifier of plugin: Partitioning Plugin Group
    
    See Also:
    Constant Field Values
  - CHARGE_PLUGIN_GROUP
```
public static final String CHARGE_PLUGIN_GROUP
```
    Identifier of plugin: Charge Plugin Group
    
    See Also:
    Constant Field Values
  - ISOMERS_PLUGIN_GROUP
```
public static final String ISOMERS_PLUGIN_GROUP
```
    Identifier of plugin: Isomers Plugin Group
    
    See Also:
    Constant Field Values
  - CONFORMATION_PLUGIN_GROUP
```
public static final String CONFORMATION_PLUGIN_GROUP
```
    Identifier of plugin: Conformation Plugin Group
    
    See Also:
    Constant Field Values
  - GEOMETRY_PLUGIN_GROUP
```
public static final String GEOMETRY_PLUGIN_GROUP
```
    Identifier of plugin: Geometry Plugin Group
    
    See Also:
    Constant Field Values
  - HUCKEL_ANALYSIS_PLUGIN
```
public static final String HUCKEL_ANALYSIS_PLUGIN
```
    Identifier of plugin: Huckel Analysis Plugin
    
    See Also:
    Constant Field Values
  - REFRACTIVITY_PLUGIN
```
public static final String REFRACTIVITY_PLUGIN
```
    Identifier of plugin: Refractivity Plugin
    
    See Also:
    Constant Field Values
  - HBDA_PLUGIN
```
public static final String HBDA_PLUGIN
```
    Identifier of plugin: HBDA Plugin
    
    See Also:
    Constant Field Values
  - MARKUSH_ENUM_PLUGIN
```
public static final String MARKUSH_ENUM_PLUGIN
```
    Identifier of plugin: Markush Enumeration Plugin
    
    See Also:
    Constant Field Values
  - IUPAC_NAMING_PLUGIN
```
public static final String IUPAC_NAMING_PLUGIN
```
    Identifier of plugin: IUPAC Naming Plugin
    
    See Also:
    Constant Field Values
  - STRUCTURAL_FRAMEWORKS_PLUGIN
```
public static final String STRUCTURAL_FRAMEWORKS_PLUGIN
```
    Identifier of product: Structural Frameworks Plugin
    
    See Also:
    Constant Field Values
  - PREDICTOR_PLUGIN
```
public static final String PREDICTOR_PLUGIN
```
    Identifier of product: Predictor Plugin
    
    See Also:
    Constant Field Values
  - NMR
```
public static final String NMR
```
    Identifier of product: NMR plugin
    
    See Also:
    Constant Field Values
- Constructor Detail
  - LicenseManager
```
public LicenseManager()
```
- Method Detail
  - getProductList
```
public static ArrayList<String> getProductList(boolean includePlugins)
```
    Returns the list of the product identifiers known by the license manager.
    
    Parameters:
    includePlugins - whether the list should contain the name of the plugins as well
    
    Returns:
    list containing names as identifiers
  - getPluginList
```
public static ArrayList<String> getPluginList()
```
    Returns the list of the plugin identifiers known by the license manager.
    
    Returns:
    list containing names as identifiers
  - getLicenseExceptionMessage
```
public static String getLicenseExceptionMessage()
```
    Returns the common message used at license problems.
    
    Returns:
    error message string
  - getLicenseExceptionPanel
```
public static JPanel getLicenseExceptionPanel(String product)
```
    Returns the common swing component used to indicate missing license.
    
    Parameters:
    product - identifier of a product
    
    Returns:
    JPanel with detailed information about the missing license
  - getLicenseExceptionPanel
```
public static JPanel getLicenseExceptionPanel(chemaxon.license.LicenseException exc)
```
    Returns the common swing component used to indicate missing license.
    
    Parameters:
    exc - a LicenseException thrown at license checking
    
    Returns:
    JPanel with detailed information about the missing license
  - createLicenseManagerPanel
```
public static JPanel createLicenseManagerPanel()
```
    Creates the main panel which is used for end-user license managing.
    
    Returns:
    JPanel
  - setLicenseFile
```
public static void setLicenseFile(String licensePath)
                           throws chemaxon.license.LicenseProcessingException
```
    Sets the license file location to the license manager to read and validate licenses from. This additive setting will not clear already read licenses. The old license file, licenses.dat is not allowed to set for security reasons.
    
    Parameters:
    licensePath - path of the license file that can be absolute file location or URL
    
    Throws:
    
    LicenseProcessingException - when a problem occurs reading or validating licenses
  - setLicense
```
public static void setLicense(String s)
                       throws chemaxon.license.LicenseProcessingException
```
    Sets a pre-read license file to the license manager to read and validate licenses from. This additive setting will not clear already read licenses. Non-server mode licenses and the old license keys are not allowed to set with this method for security reasons.
    
    Parameters:
    s - license file content as String
    
    Throws:
    
    LicenseProcessingException - when a problem occurs reading or validating licenses
  - refresh
```
public static void refresh()
```
    Re-reads licenses from the default locations.
  - isLicensed
```
public static boolean isLicensed(String product)
```
    Returns true if the license manager recognizes the given product to be licensed.
    
    Parameters:
    product - identifier of a product
    
    Returns:
    informative state value

Class LicenseManager

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MARVIN_APPLETS

MARVIN_BEANS

INSTANT_JCHEM

INSTANT_JCHEM_VIZ

INSTANT_JCHEM_SERVER

JCHEM

CARTRIDGE

STANDARDIZER

SCREEN

MCES

SCREEN3D

ALIGNMENT

MOLECULAR_DESCRIPTORS

ECFP_FCFP

REACTOR

FRAGMENTER

JKLUSTOR

METABOLIZER

MARKUSH_EDITOR

MARKUSH_SEARCH

CHEM_CURATOR_VIEWER

CHEM_CURATOR_COMPOUND

CHEM_CURATOR_FULL

NAME_TO_STRUCTURE

CHINESE_NAME_TO_STRUCTURE

JAPANESE_NAME_TO_STRUCTURE

DOCUMENT_TO_STRUCTURE

DOCUMENT_TO_DATABASE

STRUCTURE_TO_NAME

JCHEM_FOR_EXCEL

JCHEM_FOR_OFFICE

CALCULATIONS_PACK

WEB_SERVICES_SERVER

JCHEM_FOR_SHAREPOINT

JCHEM_FOR_SHAREPOINT_SEARCH

STRUCTURE_CHECKER

REGISTRATION_SYSTEM

PLEXUS

PROTONATION_PLUGIN_GROUP

PARTITIONING_PLUGIN_GROUP

CHARGE_PLUGIN_GROUP

ISOMERS_PLUGIN_GROUP

CONFORMATION_PLUGIN_GROUP

GEOMETRY_PLUGIN_GROUP

HUCKEL_ANALYSIS_PLUGIN

REFRACTIVITY_PLUGIN

HBDA_PLUGIN

MARKUSH_ENUM_PLUGIN

IUPAC_NAMING_PLUGIN

STRUCTURAL_FRAMEWORKS_PLUGIN

PREDICTOR_PLUGIN

NMR

Constructor Detail

LicenseManager

Method Detail

getProductList

getPluginList

getLicenseExceptionMessage

getLicenseExceptionPanel

getLicenseExceptionPanel

createLicenseManagerPanel

setLicenseFile

setLicense

refresh

isLicensed