Class DesignerLicenseGate

java.lang.Object
com.iizix.license.DesignerLicenseGate

public final class DesignerLicenseGate extends Object
The decision of iiziGo's license gate (LICENSE-V2-DESIGN.md sections 7.2, 8.2 and 11.2, order B-5e): from what the license system says about the installation at a start to what iiziGo does - nothing, the setup wizard, the trial banner, a warning, or no IIZI functions with the reason. Pure: no user interface, no clock and no license system of its own, so that a reactor test runs it; com.iizigo.setup.SetupWizard reads the facts, asks here and shows the answer.

Where the gate does not apply (applies(boolean, boolean, String, String, boolean, boolean)): a build that started without a license system (the reactor bypass of com.iizigo.Startup let it go on), a reactor build by its version, a test harness by its Eclipse application, and a development build whose license client is dormant. None of them ever meets the wizard.

The rules (decide(Facts,boolean,boolean)), ruled or listed for a ruling in the order's report (rows B5E-D-a to B5E-D-d):

  • No license document: the installation was never activated - the setup wizard. Once the wizard completed without a document (a registration off-line), iiziGo works with a warning until the installation's own trial period ends, and not after it.
  • A trial: the banner with the days left. A trial or a validity that ended by the document's own dates: no IIZI functions, with the date.
  • A revoked or deactivated installation: no IIZI functions, with the reason.
  • A document that expired because no license server answered: a warning at every start that names the day of the lock, and iiziGo keeps working (ruling T1-096) - for what the document would still license by its own dates, and for 14 days after expires (ruling B5E-D-a (b), the grace a server has by LV-20). After them: no IIZI functions until a license server answers, so that an installation that never reconnects loses its license (7.4 step 3).
  • A license server this build cannot verify (no pinned root): a state of its own, a warning; never the wizard, which could not register, and never "revoked".

The enforcement switch (DesignerLicenseGate.Facts.enforcing(), what the license system answers to IGenericLicenseSystem.isLicenseEnforced() - LicenseEnforcement, order CC-LICENSE-ENFORCE-SWITCH; before it a field of this class, order CC-LIC-V5-OBSERVE-DESIGNER, rulings L-1 and L-2 of 2026-10-06): off in every v5.0 build and document, which ship the license system installed but not enforcing (ruled 2026-10-05). While it is off, every rule above that would leave no IIZI functions is a warning that gives the reason and says that they stay enabled; a build without a root key, and a client without a license server to contact, are one line to log (DesignerLicenseGate.Action.NOTE) and no box, since there is nothing to register with or to refresh from. The switch changes the consequence of a verdict and nothing else: the wizard, the banner, the refresh and the release of an installation run as before when a license server answers. While it is on, the reactor-build exemption of applies(boolean, boolean, String, String, boolean, boolean) does not hold either: only a test harness, which has no user to answer a wizard, and a start without a license system are let through, and the latter is a lock of com.iizigo.Startup.setError (lockOrWarn(String, boolean)).

Author:
Christopher Mindus
  • Field Details

    • REACTOR_BUILD_PREFIX

      public static final String REACTOR_BUILD_PREFIX
      The version and build prefix of a reactor build, whose qualifier is the build's time stamp in the 2020s: the prefix com.iizigo.Startup lets go on without a license.
      See Also:
  • Method Details

    • isReactorBuild

      public static boolean isReactorBuild(String versionBuild)
      Tells whether a version and build is a reactor build's.
      Parameters:
      versionBuild - The version and build, SystemConfig.VERSION_BUILD; may be null.
      Returns:
      true for a reactor build.
    • isTestHarness

      public static boolean isTestHarness(String application)
      Tells whether an Eclipse application is a test harness: Tycho's surefire or PDE's JUnit runtime. Such a run has no user to answer a wizard.
      Parameters:
      application - The Eclipse application ID, the system property eclipse.application; may be null.
      Returns:
      true for a test harness.
    • applies

      public static boolean applies(boolean hasLicenseSystem, boolean developmentMode, String versionBuild, String application, boolean serverConfigured, boolean enforcing)
      Tells whether the gate applies to this start. It does not - no validation, no wizard, no message - without a license system, in a reactor build while the license is not enforced, under a test harness, and in a development build whose license client has no server to contact.

      A reactor build is told apart by its version and by the switch (order CC-LICENSE-ENFORCE-SWITCH, decision LE-D-4): a version and build of REACTOR_BUILD_PREFIX is a build that never went through the release's version step, and it is exempt only while nothing enforces the license. A build that enforces - by its constant, by its document or by the development override - knows no exemption by version: a release whose number started with the prefix by mistake would otherwise never lock, and a reactor build that enforces is what a release dry run starts. The test-harness exemption stays in both positions: a harness has no user to answer a wizard.

      Parameters:
      hasLicenseSystem - true when the license system was loaded.
      developmentMode - true for a development build, SystemConfig.isDevelopmentMode.
      versionBuild - The version and build, SystemConfig.VERSION_BUILD.
      application - The Eclipse application ID, may be null.
      serverConfigured - true when a license server is configured.
      enforcing - true when the license system enforces the license.
      Returns:
      true when the gate applies.
    • decide

      public static DesignerLicenseGate.Decision decide(DesignerLicenseGate.Facts facts, boolean wizardDone, boolean settled)
      Decides what the gate does.
      Parameters:
      facts - What the license system says.
      wizardDone - true once the setup wizard was completed, or its offer declined, in this start: the wizard is not asked for again.
      settled - true once the caller's short wait for the license server is over: DesignerLicenseGate.Action.WAIT is then never answered.
      Returns:
      The decision.
    • lockOrWarn

      public static DesignerLicenseGate.Decision lockOrWarn(String reason, boolean enforcing)
      Decides what a start does with a reason to disable the IIZI functions that arose outside decide(DesignerLicenseGate.Facts, boolean, boolean): the license system did not load, the setup wizard was canceled, the hardware information could not be read (com.iizigo.Startup.setError). The lock with the reason while the switch is on; while the release does not enforce the license, a warning that says that all IIZI functions remain available, and gives the reason they would otherwise be disabled for (order CC-FIX-IIZIGO-REGISTRATION-TEXTS, item 3).
      Parameters:
      reason - The reason, in English, a full sentence.
      enforcing - true when the license is enforced (LicenseEnforcement.isEnforcing(IGenericLicenseSystem): the build's position when the license system did not load).
      Returns:
      The decision: DesignerLicenseGate.Action.LOCK or DesignerLicenseGate.Action.WARN, with its message.
    • describe

      public static String describe(DesignerLicenseGate.Facts f)
      Describes the state in one line, for the license preferences: what the gate would say at a start, without its advice.
      Parameters:
      f - What the license system says.
      Returns:
      The line, in English.
    • isReleasable

      public static boolean isReleasable(boolean connected, LicenseState state)
      Tells whether the license preferences offer "Release this installation": the installation holds a document whose state is active or trial, and the license server is connected - the release is an event on the proven connection. A deactivated or revoked installation has nothing left to release; one without a document was never registered.
      Parameters:
      connected - true when the license system is connected to the license server.
      state - The state of the license document held, null for no document.
      Returns:
      true when the installation can be released now.
    • releaseQuestion

      public static String releaseQuestion(String accountName, boolean enforcing)
      The question the license preferences ask before the installation is released. What it says of the next start follows the enforcement switch: an enforcing release disables the IIZI functions then, one that observes only keeps working.
      Parameters:
      accountName - The document's account, null for none.
      enforcing - true when the license is enforced.
      Returns:
      The text, in English.
    • releasedMessage

      public static String releasedMessage(boolean enforcing)
      What the license preferences say once the installation is released; of the next start, what releaseQuestion(String,boolean) said.
      Parameters:
      enforcing - true when the license is enforced.
      Returns:
      The text, in English.
    • formatDate

      public static String formatDate(long millis)
      Formats an instant as its day in the zone of this machine.
      Parameters:
      millis - Milliseconds since the epoch.
      Returns:
      The day as yyyy-MM-dd.