net.java.truelicense.json

Class V2JsonLicenseManagementContext

java.lang.Object

net.java.truelicense.core.BasicLicenseManagementContext

net.java.truelicense.core.BasicV2LicenseManagementContext

net.java.truelicense.json.V2JsonLicenseManagementContext

All Implemented Interfaces:

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

@Immutable
public class V2JsonLicenseManagementContext
extends BasicV2LicenseManagementContext

The root context for the management of Version-2-with-JSON (V2/JSON) 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 V2JsonLicenseManagementContext("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
V2JsonLicenseManagementContext(String subject) Constructs a V2/JSON license management context.

Method Summary

Modifier and Type	Method and Description
JsonCodec	codec() The implementation in the class V2JsonLicenseManagementContext returns a new JsonCodec.
com.fasterxml.jackson.databind.ObjectMapper	mapper() Returns the object mapper to use for codec().
protected com.fasterxml.jackson.databind.ObjectMapper	newMapper() Returns a new object mapper 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

V2JsonLicenseManagementContext

public V2JsonLicenseManagementContext(String subject)

Constructs a V2/JSON 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 JsonCodec codec()

The implementation in the class V2JsonLicenseManagementContext returns a new JsonCodec.

mapper

public com.fasterxml.jackson.databind.ObjectMapper mapper()

Returns the object mapper to use for codec().

The implementation in the class V2JsonLicenseManagementContext lazily resolves this property by calling newMapper().

newMapper

protected com.fasterxml.jackson.databind.ObjectMapper newMapper()

Returns a new object mapper 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.