net.java.truelicense.core

Class V2XmlLicenseManagementContext

java.lang.Object

net.java.truelicense.core.BasicLicenseManagementContext

net.java.truelicense.core.BasicV2LicenseManagementContext

net.java.truelicense.core.V2XmlLicenseManagementContext

All Implemented Interfaces:

RepositoryProvider, CodecProvider, CompressionProvider, LicenseAuthorizationProvider, LicenseInitializationProvider, LicenseManagementContext, LicenseProvider, LicenseSubjectProvider, LicenseValidationProvider, PasswordPolicyProvider, CachePeriodProvider, ClassLoaderProvider, Clock

@Immutable
public class V2XmlLicenseManagementContext
extends BasicV2LicenseManagementContext

The root context for the management of Version-2-with-XML (V2/XML) format license keys. Note that there is no compatibility between different format license keys.

Use this context to create a LicenseVendorContext or a LicenseConsumerContext. Here's an example for verifying the installed license key in a consumer application:

 LicenseConsumerManager manager = new V2XmlLicenseManagementContext("MyApp 1")
         .consumer()
         .manager()
         ...
         .build();
 manager.verify();
 

DO NOT COPY-PASTE THIS CODE! Instead, use the TrueLicense Maven Archetype to generate a sample project for you.

Where required, you should subclass this class to customize its properties, e.g. its encoding, clock, class loader etc.

Note that this class is immutable. Unless stated otherwise, all no-argument methods need to return consistent objects so that caching them is not required. A returned object is considered to be consistent if it compares equal or at least behaves identical to any previously returned object.

Author:

Christian Schlichtherle

Constructor Summary

Constructors

Constructor and Description
V2XmlLicenseManagementContext(String subject) Constructs a V2/XML license management context.

Method Summary

Modifier and Type	Method and Description
JaxbCodec	codec() Returns the codec.
JAXBContext	context() Returns the JAXB context to use for codec().
protected JAXBContext	newContext() Returns a new JAXB context for use with licenses and repositories.

Methods inherited from class net.java.truelicense.core.BasicV2LicenseManagementContext

compression, encryption, license, pbeAlgorithm, repository, storeType

Methods inherited from class net.java.truelicense.core.BasicLicenseManagementContext

authentication, authorization, cachePeriodMillis, classLoader, consumer, initialization, now, policy, subject, validation, vendor

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

V2XmlLicenseManagementContext

public V2XmlLicenseManagementContext(String subject)

Constructs a V2/XML license management context. The provided string should get computed on demand from an obfuscated form, e.g. by annotating a constant string value with the @Obfuscate annotation and processing it with the TrueLicense Maven Plugin.

Parameters:

subject - the licensing subject, i.e. a product name with an optional version range, e.g. MyApp 1.

Method Detail

codec

public JaxbCodec codec()

Returns the codec.

The implementation in the class V2XmlLicenseManagementContext returns a JaxbCodec.

context

public JAXBContext context()

Returns the JAXB context to use for codec().

The implementation in the class V2XmlLicenseManagementContext lazily resolves this property by calling newContext().

newContext

protected JAXBContext newContext()

Returns a new JAXB context for use with licenses and repositories. This method is normally only called once. In a multi-threaded environment, it may get called more than once, but then each invocation must return an object which behaves equivalent to any previously returned object.

The implementation in the class V2XmlLicenseManagementContext constructs a new JAXBContext for the root element classes License and BasicRepository.