global.namespace.truelicense.api.UncheckedVendorLicenseManager Maven / Gradle / Ivy
Show all versions of truelicense-api Show documentation
/*
* Copyright (C) 2005 - 2019 Schlichtherle IT Services.
* All rights reserved. Use is subject to license terms.
*/
package global.namespace.truelicense.api;
import global.namespace.fun.io.api.Sink;
/**
* Defines the life cycle management operations for license keys in vendor applications alias key generators.
*
* An unchecked vendor license manager generally throws an {@link UncheckedLicenseManagementException} with a
* (checked) {@link LicenseManagementException} as its cause if an operation fails for some reason.
*
* @see VendorLicenseManager#unchecked()
*/
public interface UncheckedVendorLicenseManager extends VendorLicenseManager {
@Override
default LicenseManagementSchema schema() {
return checked().schema();
}
/**
* Returns a license key generator for the given license bean.
*
* Calling this operation performs an initial
* {@linkplain LicenseManagementAuthorization#clearGenerate authorization check}.
*
* @param bean the license bean to process.
* This bean is not modified by the returned license key generator.
* @return A license key generator for the given license bean.
*/
default UncheckedLicenseKeyGenerator generateKeyFrom(License bean) throws UncheckedLicenseManagementException {
return UncheckedLicenseManager.callUnchecked(() -> new UncheckedLicenseKeyGenerator() {
final LicenseKeyGenerator generator = checked().generateKeyFrom(bean);
@Override
public License license() throws UncheckedLicenseManagementException {
return UncheckedLicenseManager.callUnchecked(generator::license);
}
@Override
public UncheckedLicenseKeyGenerator saveTo(Sink sink) throws UncheckedLicenseManagementException {
UncheckedLicenseManager.callUnchecked(() -> generator.saveTo(sink));
return this;
}
});
}
@Override
default UncheckedVendorLicenseManager unchecked() {
return this;
}
/**
* Adapts this vendor license manager so that it generally throws a (checked) {@link LicenseManagementException}
* instead of an {@link UncheckedLicenseManagementException} if an operation fails.
*
* @return the adapted (checked) vendor license manager.
*/
VendorLicenseManager checked();
}