Fix Javadoc generation issues
All checks were successful
build-and-test / build (push) Successful in 1m4s
build-and-test / test (push) Successful in 1m16s
build-and-test / generate-javadoc (push) Successful in 1m22s

This commit is contained in:
JeremyStar™ 2024-11-03 18:54:27 +01:00
parent 2730aa0f61
commit 0966a43d5e
Signed by: JeremyStarTM
GPG key ID: E366BAEF67E4704D

View file

@ -23,6 +23,7 @@ import de.staropensource.engine.base.Engine;
import de.staropensource.engine.base.logging.LoggerInstance; import de.staropensource.engine.base.logging.LoggerInstance;
import de.staropensource.engine.base.type.EngineState; import de.staropensource.engine.base.type.EngineState;
import de.staropensource.engine.base.type.FileType; import de.staropensource.engine.base.type.FileType;
import lombok.AccessLevel;
import lombok.Getter; import lombok.Getter;
import org.jetbrains.annotations.ApiStatus; import org.jetbrains.annotations.ApiStatus;
import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.NotNull;
@ -90,6 +91,7 @@ public final class FileAccess {
* @see LoggerInstance * @see LoggerInstance
* @since v1-alpha8 * @since v1-alpha8
*/ */
@Getter(value = AccessLevel.NONE)
private final @NotNull LoggerInstance logger; private final @NotNull LoggerInstance logger;
/** /**
@ -126,18 +128,20 @@ public final class FileAccess {
/** /**
* Creates and initializes an instance of this class. * Creates and initializes an instance of this class.
* *
* @param path path you wish to access
* @throws InvalidPathException if a {@link Path} cannot be created (see {@link FileSystem#getPath(String, String...)}) * @throws InvalidPathException if a {@link Path} cannot be created (see {@link FileSystem#getPath(String, String...)})
* @since v1-alpha8 * @since v1-alpha8
*/ */
public FileAccess(@NotNull String pathString) throws InvalidPathException { public FileAccess(@NotNull String path) throws InvalidPathException {
this.path = formatPath(pathString).toAbsolutePath(); this.path = formatPath(path).toAbsolutePath();
this.file = new File(pathString); this.file = new File(path);
logger = new LoggerInstance.Builder().setClazz(getClass()).setOrigin("ENGINE").setMetadata(path.toString()).build(); logger = new LoggerInstance.Builder().setClazz(getClass()).setOrigin("ENGINE").setMetadata(this.path.toString()).build();
} }
/** /**
* Creates and initializes an instance of this class. * Creates and initializes an instance of this class.
* *
* @param path path you wish to access
* @since v1-alpha8 * @since v1-alpha8
*/ */
public FileAccess(@NotNull Path path) { public FileAccess(@NotNull Path path) {
@ -149,6 +153,7 @@ public final class FileAccess {
/** /**
* Creates and initializes an instance of this class. * Creates and initializes an instance of this class.
* *
* @param file {@link File} to the path you wish to access
* @throws InvalidPathException if a {@link Path} cannot be created (see {@link FileSystem#getPath(String, String...)}) * @throws InvalidPathException if a {@link Path} cannot be created (see {@link FileSystem#getPath(String, String...)})
* @since v1-alpha8 * @since v1-alpha8
*/ */
@ -161,6 +166,7 @@ public final class FileAccess {
/** /**
* Creates and initializes an instance of this class. * Creates and initializes an instance of this class.
* *
* @param uri {@link URI} to the path you wish to access
* @throws FileSystemNotFoundException if the filesystem is not supported by Java * @throws FileSystemNotFoundException if the filesystem is not supported by Java
* @throws IllegalArgumentException if the URI is improperly formatted * @throws IllegalArgumentException if the URI is improperly formatted
* @since v1-alpha8 * @since v1-alpha8
@ -179,6 +185,7 @@ public final class FileAccess {
* <p> * <p>
* Only works during early engine startup. * Only works during early engine startup.
* *
* @throws IOException on an IO error
* @since v1-alpha8 * @since v1-alpha8
*/ */
public static void initializeInstances() throws IOException { public static void initializeInstances() throws IOException {
@ -227,6 +234,8 @@ public final class FileAccess {
/** /**
* Formats the path into a {@link Path} instance. * Formats the path into a {@link Path} instance.
* *
* @param path path to format
* @return formatted {@link Path}
* @since v1-alpha8 * @since v1-alpha8
*/ */
public static @NotNull Path formatPath(@NotNull String path) { public static @NotNull Path formatPath(@NotNull String path) {
@ -240,6 +249,8 @@ public final class FileAccess {
/** /**
* Unformats the a {@link Path} instance into a string. * Unformats the a {@link Path} instance into a string.
* *
* @param path {@link Path} to unformat
* @return unformatted path
* @since v1-alpha8 * @since v1-alpha8
*/ */
public static @NotNull String unformatPath(@NotNull Path path) { public static @NotNull String unformatPath(@NotNull Path path) {
@ -393,6 +404,7 @@ public final class FileAccess {
* POSIX {@code rwxrwxrwx} format. * POSIX {@code rwxrwxrwx} format.
* *
* @return POSIX permissions format * @return POSIX permissions format
* @throws IOException on an IO error
* @since v1-alpha8 * @since v1-alpha8
*/ */
public @NotNull String getPosixPermissions() throws IOException { public @NotNull String getPosixPermissions() throws IOException {
@ -626,6 +638,7 @@ public final class FileAccess {
* If it already exists, nothing will be done. * If it already exists, nothing will be done.
* *
* @param hard creates a hard link if {@code true} or a symbolic link if {@code false} * @param hard creates a hard link if {@code true} or a symbolic link if {@code false}
* @param destination destination of the new link
* @return this instance * @return this instance
* @throws IOException on an IO error * @throws IOException on an IO error
* @since v1-alpha8 * @since v1-alpha8