Fix Javadoc generation issues

This commit is contained in:
JeremyStar™ 2024-11-05 03:07:34 +01:00
parent 5021f2cc35
commit 4281f946be
Signed by: JeremyStarTM
GPG key ID: E366BAEF67E4704D
5 changed files with 35 additions and 30 deletions

View file

@ -137,6 +137,8 @@ public final class Logger {
/** /**
* Redirects regular log messages. * Redirects regular log messages.
* *
* @param level level of the log call
* @param message message
* @since v1-alpha8 * @since v1-alpha8
*/ */
public static void redirectCall(@NotNull LogLevel level, @NotNull String message) { public static void redirectCall(@NotNull LogLevel level, @NotNull String message) {
@ -146,6 +148,9 @@ public final class Logger {
/** /**
* Redirects crash calls. * Redirects crash calls.
* *
* @param message message
* @param throwable {@link Throwable} which caused the error
* @param fatal if to terminate the engine
* @since v1-alpha8 * @since v1-alpha8
*/ */
public static void redirectCall(@NotNull String message, @Nullable Throwable throwable, boolean fatal) { public static void redirectCall(@NotNull String message, @Nullable Throwable throwable, boolean fatal) {

View file

@ -57,6 +57,13 @@ public final class CrashHandler {
"$ git blame", "$ git blame",
}; };
/**
* Creates and initializes an instance of this class.
*
* @since v1-alpha8
*/
private CrashHandler() {}
/** /**
* Handles crash reports. * Handles crash reports.
* *

View file

@ -19,8 +19,6 @@
package de.staropensource.engine.base.type; package de.staropensource.engine.base.type;
import de.staropensource.engine.base.logging.Logger;
/** /**
* Determines in which state the engine is currently in. * Determines in which state the engine is currently in.
* *
@ -28,58 +26,52 @@ import de.staropensource.engine.base.logging.Logger;
*/ */
public enum EngineState { public enum EngineState {
/** /**
* The state of the engine is currently unknown. * Indicates that the state of the engine is
* The engine likely has not been initialized yet. * currently unknown. The engine is most likely
* not initialized yet.
* *
* @since v1-alpha2 * @since v1-alpha2
*/ */
UNKNOWN, UNKNOWN,
/** /**
* The engine is in early startup. * Indicates that the engine is largely
* The engine is largely uninitialized and * uninitialized and unsafe to use.
* the logging infrastructure is not yet ready
* to be used.
* <p>
* This state is used to indicate that the
* {@link InitLogger} shall be used instead
* of {@link Logger}.
* *
* @since v1-alpha4 * @since v1-alpha8
*/ */
EARLY_STARTUP, EARLY_STARTUP,
/** /**
* The engine is starting up. * Indicates that the core engine has fully
* Some parts of the engine may not be initialized * initialized, except for all subsystems.
* yet and may be unsafe to access. The logging
* infrastructure is ready to be used though and is
* safe to access.
* *
* @since v1-alpha2 * @since v1-alpha8
*/ */
STARTUP, STARTUP,
/** /**
* The engine is in normal operation mode. * Indicates that the engine is running
* and operating normally.
* *
* @since v1-alpha2 * @since v1-alpha2
*/ */
RUNNING, RUNNING,
/** /**
* The engine has crashed, either by itself or the application. * Indicates that the engine or the
* application has crashed.
* *
* @since v1-alpha2 * @since v1-alpha2
*/ */
CRASHED, CRASHED,
/** /**
* The engine is shutting down. * Indicates that the engine is shutting
* Some parts of the engine may have already * down. The engine is unusable in this
* shut down and may be unsafe to access. * state and should not be used.
* *
* @since v1-alpha2 * @since v1-alpha8
*/ */
SHUTDOWN, SHUTDOWN,
} }

View file

@ -29,6 +29,7 @@ import org.junit.jupiter.api.Test;
import java.util.HashMap; import java.util.HashMap;
import java.util.Map; import java.util.Map;
import java.util.Properties; import java.util.Properties;
import java.util.Set;
import static org.junit.jupiter.api.Assertions.*; import static org.junit.jupiter.api.Assertions.*;
@ -53,11 +54,10 @@ class EngineConfigurationTest extends TestBase {
settings.put("debug", new Object[]{ "true", Boolean.TRUE }); settings.put("debug", new Object[]{ "true", Boolean.TRUE });
settings.put("debugEvents", new Object[]{ "true", Boolean.TRUE }); settings.put("debugEvents", new Object[]{ "true", Boolean.TRUE });
settings.put("errorShortcodeParser", new Object[]{ "false", Boolean.FALSE }); settings.put("errorShortcodeParser", new Object[]{ "false", Boolean.FALSE });
settings.put("loggerLevel", new Object[]{ "verbose", LogLevel.VERBOSE }); settings.put("logLevel", new Object[]{ "verbose", LogLevel.VERBOSE });
settings.put("loggerTemplate", new Object[]{ "%log_path% says: %message%", "%log_path% says: %message%" }); settings.put("logFeatures", new Object[]{ "formatting,runtime,time", Set.of("formatting", "runtime", "time") });
settings.put("loggerImmediateShutdown", new Object[]{ "true", Boolean.TRUE }); settings.put("logForceStandardOutput", new Object[]{ "true", Boolean.TRUE });
settings.put("loggerForceStandardOutput", new Object[]{ "true", Boolean.TRUE }); settings.put("logPollingSpeed", new Object[]{ "9999", 9999 });
settings.put("loggerPollingSpeed", new Object[]{ "9999", 9999 });
settings.put("optimizeLogging", new Object[]{ "false", Boolean.FALSE }); settings.put("optimizeLogging", new Object[]{ "false", Boolean.FALSE });
settings.put("optimizeEvents", new Object[]{ "false", Boolean.FALSE }); settings.put("optimizeEvents", new Object[]{ "false", Boolean.FALSE });

View file

@ -22,6 +22,7 @@ package de.staropensource.engine.notification;
import de.staropensource.engine.base.annotation.EngineSubsystem; import de.staropensource.engine.base.annotation.EngineSubsystem;
import de.staropensource.engine.base.implementable.SubsystemClass; import de.staropensource.engine.base.implementable.SubsystemClass;
import de.staropensource.engine.base.implementation.versioning.StarOpenSourceVersioningSystem; import de.staropensource.engine.base.implementation.versioning.StarOpenSourceVersioningSystem;
import de.staropensource.engine.base.logging.Logger;
import de.staropensource.engine.base.type.DependencyVector; import de.staropensource.engine.base.type.DependencyVector;
import de.staropensource.engine.base.utility.information.EngineInformation; import de.staropensource.engine.base.utility.information.EngineInformation;
import lombok.Getter; import lombok.Getter;