com.swak.license.api.UncheckedVendorLicenseManager Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of swak-license-core Show documentation
swak component of trueLicense core
The newest version!
/*
 * Copyright (C) 2005 - 2019 Schlichtherle IT Services.
 * All rights reserved. Use is subject to license terms.
 */
package com.swak.license.api;


import com.swak.license.api.io.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 LicenseManagerParameters parameters() {
        return checked().parameters();
    }

    /**
     * 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.
     */
    @Override
    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();
}