Fix Javadoc generation issues
This commit is contained in:
parent
5021f2cc35
commit
4281f946be
5 changed files with 35 additions and 30 deletions
|
@ -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) {
|
||||||
|
|
|
@ -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.
|
||||||
*
|
*
|
||||||
|
|
|
@ -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,
|
||||||
}
|
}
|
||||||
|
|
|
@ -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 });
|
||||||
|
|
||||||
|
|
|
@ -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;
|
||||||
|
|
Loading…
Reference in a new issue