Add more Immutable* types

This commit is contained in:
JeremyStar™ 2024-07-08 13:46:30 +02:00
parent ab46a25911
commit 3f7edd0968
Signed by: JeremyStarTM
GPG key ID: E366BAEF67E4704D
11 changed files with 649 additions and 39 deletions

View file

@ -33,8 +33,8 @@ import de.staropensource.sosengine.base.logging.CrashHandler;
import de.staropensource.sosengine.base.logging.Logger; import de.staropensource.sosengine.base.logging.Logger;
import de.staropensource.sosengine.base.logging.LoggerInstance; import de.staropensource.sosengine.base.logging.LoggerInstance;
import de.staropensource.sosengine.base.types.CodePart; import de.staropensource.sosengine.base.types.CodePart;
import de.staropensource.sosengine.base.types.ImmutableMap;
import de.staropensource.sosengine.base.types.dependency.DependencyVector; import de.staropensource.sosengine.base.types.dependency.DependencyVector;
import de.staropensource.sosengine.base.types.immutable.ImmutableHashMap;
import de.staropensource.sosengine.base.utility.DependencyResolver; import de.staropensource.sosengine.base.utility.DependencyResolver;
import de.staropensource.sosengine.base.utility.Miscellaneous; import de.staropensource.sosengine.base.utility.Miscellaneous;
import de.staropensource.sosengine.base.utility.PlaceholderEngine; import de.staropensource.sosengine.base.utility.PlaceholderEngine;
@ -94,7 +94,7 @@ public final class Engine implements SubsystemMainClass {
*/ */
@NotNull @NotNull
@Getter @Getter
private ImmutableMap<@NotNull SubsystemMainClass, @NotNull DependencyVector> subsystems = new ImmutableMap<>(); private ImmutableHashMap<@NotNull SubsystemMainClass, @NotNull DependencyVector> subsystems = new ImmutableHashMap<>();
/** /**
* Indicates if the engine is shutting down. * Indicates if the engine is shutting down.
@ -282,7 +282,7 @@ public final class Engine implements SubsystemMainClass {
if (subsystemsMap.get(subsystem) == null) if (subsystemsMap.get(subsystem) == null)
subsystemsMap.remove(subsystem); subsystemsMap.remove(subsystem);
subsystems = new ImmutableMap<>(subsystemsMap); subsystems = new ImmutableHashMap<>(subsystemsMap);
} }
/** /**

View file

@ -0,0 +1,211 @@
/*
* STAROPENSOURCE ENGINE SOURCE FILE
* Copyright (c) 2024 The StarOpenSource Engine Contributors
* Licensed under the GNU Affero General Public License v3
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
package de.staropensource.sosengine.base.types.immutable;
import org.jetbrains.annotations.NotNull;
import java.util.*;
import java.util.function.UnaryOperator;
/**
* An unmodifiable {@link ArrayList}.
* {@inheritDoc}
*
* @since 1-alpha1
*/
@SuppressWarnings({ "unused" })
public class ImmutableArrayList<E> extends ArrayList<E> {
/**
* Creates a new immutable array list.
*
* @since 1-alpha1
*/
public ImmutableArrayList() {}
/**
* Converts a {@link LinkedList} into a {@link ImmutableArrayList}.
*
* @param list {@link List} to convert
* @since 1-alpha1
*/
public ImmutableArrayList(@NotNull List<E> list) {
super.addAll(list);
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public boolean add(E e) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public boolean remove(Object o) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public boolean addAll(@NotNull Collection<? extends E> c) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public boolean addAll(int index, @NotNull Collection<? extends E> c) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public boolean removeAll(@NotNull Collection<?> c) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public boolean retainAll(@NotNull Collection<?> c) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public void replaceAll(UnaryOperator<E> operator) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public void sort(Comparator<? super E> c) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public void clear() {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public E set(int index, E element) throws UnsupportedOperationException {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public void add(int index, E element) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public E remove(int index) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public void addFirst(E e) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public void addLast(E e) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public E removeFirst() {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, array list is immutable
*/
@Override
public E removeLast() {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableArrayList");
}
}

View file

@ -17,7 +17,7 @@
* along with this program. If not, see <https://www.gnu.org/licenses/>. * along with this program. If not, see <https://www.gnu.org/licenses/>.
*/ */
package de.staropensource.sosengine.base.types; package de.staropensource.sosengine.base.types.immutable;
import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable; import org.jetbrains.annotations.Nullable;
@ -33,131 +33,128 @@ import java.util.function.BiFunction;
* @since 1-alpha1 * @since 1-alpha1
*/ */
@SuppressWarnings({ "unused" }) @SuppressWarnings({ "unused" })
public class ImmutableMap<K, V> extends HashMap<K, V> { public class ImmutableHashMap<K, V> extends HashMap<K, V> {
/** /**
* Creates a new immutable map. * Creates a new immutable hash map.
* *
* @since 1-alpha1 * @since 1-alpha1
*/ */
public ImmutableMap() {} public ImmutableHashMap() {}
/** /**
* Converts a {@link Map} into a {@link ImmutableMap}. * Converts a {@link Map} into a {@link ImmutableHashMap}.
* *
* @param map {@link Map} to convert * @param map {@link Map} to convert
* @since 1-alpha1 * @since 1-alpha1
*/ */
public ImmutableMap(@NotNull Map<K, V> map) { public ImmutableHashMap(@NotNull Map<K, V> map) {
for (K key : map.keySet()) for (K key : map.keySet())
super.put(key, map.get(key)); super.put(key, map.get(key));
} }
/** /**
* Note: This method is a stub.<br/>
* {@inheritDoc} * {@inheritDoc}
* *
* @since 1-alpha1 * @throws UnsupportedOperationException always, hash map is immutable
*/ */
@Nullable @Nullable
@Override @Override
public V put(K key, V value) { public V put(K key, V value) {
return null; throw new UnsupportedOperationException("This method cannot be executed on an ImmutableHashMap");
} }
/** /**
* Note: This method is a stub.<br/>
* {@inheritDoc} * {@inheritDoc}
* *
* @since 1-alpha1 * @throws UnsupportedOperationException always, hash map is immutable
*/ */
@Nullable @Nullable
@Override @Override
public V remove(Object key) { public V remove(Object key) {
return null; throw new UnsupportedOperationException("This method cannot be executed on an ImmutableHashMap");
} }
/** /**
* Note: This method is a stub.<br/>
* {@inheritDoc} * {@inheritDoc}
* *
* @since 1-alpha1 * @throws UnsupportedOperationException always, hash map is immutable
*/ */
@Override @Override
public void putAll(@NotNull Map<? extends K, ? extends V> m) {} public void putAll(@NotNull Map<? extends K, ? extends V> m) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableHashMap");
}
/** /**
* Note: This method is a stub.<br/>
* {@inheritDoc} * {@inheritDoc}
* *
* @since 1-alpha1 * @throws UnsupportedOperationException always, hash map is immutable
*/ */
@Override @Override
public void clear() {} public void clear() {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableHashMap");
}
/** /**
* Note: This method is a stub.<br/>
* {@inheritDoc} * {@inheritDoc}
* *
* @since 1-alpha1 * @throws UnsupportedOperationException always, hash map is immutable
*/ */
@Override @Override
public void replaceAll(BiFunction<? super K, ? super V, ? extends V> function) {} public void replaceAll(BiFunction<? super K, ? super V, ? extends V> function) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableHashMap");
}
/** /**
* Note: This method is a stub.<br/>
* {@inheritDoc} * {@inheritDoc}
* *
* @since 1-alpha1 * @throws UnsupportedOperationException always, hash map is immutable
*/ */
@Nullable @Nullable
@Override @Override
public V putIfAbsent(K key, V value) { public V putIfAbsent(K key, V value) {
return null; throw new UnsupportedOperationException("This method cannot be executed on an ImmutableHashMap");
} }
/** /**
* Note: This method is a stub.<br/>
* {@inheritDoc} * {@inheritDoc}
* *
* @since 1-alpha1 * @throws UnsupportedOperationException always, hash map is immutable
*/ */
@Override @Override
public boolean remove(Object key, Object value) { public boolean remove(Object key, Object value) {
return false; throw new UnsupportedOperationException("This method cannot be executed on an ImmutableHashMap");
} }
/** /**
* Note: This method is a stub.<br/>
* {@inheritDoc} * {@inheritDoc}
* *
* @since 1-alpha1 * @throws UnsupportedOperationException always, hash map is immutable
*/ */
@Override @Override
public boolean replace(K key, V oldValue, V newValue) { public boolean replace(K key, V oldValue, V newValue) {
return false; throw new UnsupportedOperationException("This method cannot be executed on an ImmutableHashMap");
} }
/** /**
* Note: This method is a stub.<br/>
* {@inheritDoc} * {@inheritDoc}
* *
* @since 1-alpha1 * @throws UnsupportedOperationException always, hash map is immutable
*/ */
@Nullable @Nullable
@Override @Override
public V replace(K key, V value) { public V replace(K key, V value) {
return null; throw new UnsupportedOperationException("This method cannot be executed on an ImmutableHashMap");
} }
/** /**
* Note: This method is a stub.<br/>
* {@inheritDoc} * {@inheritDoc}
* *
* @since 1-alpha1 * @throws UnsupportedOperationException always, hash map is immutable
*/ */
@Nullable @Nullable
@Override @Override
public V merge(K key, @NotNull V value, @NotNull BiFunction<? super V, ? super V, ? extends V> remappingFunction) { public V merge(K key, @NotNull V value, @NotNull BiFunction<? super V, ? super V, ? extends V> remappingFunction) {
return null; throw new UnsupportedOperationException("This method cannot be executed on an ImmutableHashMap");
} }
} }

View file

@ -0,0 +1,160 @@
/*
* STAROPENSOURCE ENGINE SOURCE FILE
* Copyright (c) 2024 The StarOpenSource Engine Contributors
* Licensed under the GNU Affero General Public License v3
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
package de.staropensource.sosengine.base.types.immutable;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.function.BiFunction;
/**
* An unmodifiable {@link Map}.
* {@inheritDoc}
*
* @since 1-alpha1
*/
@SuppressWarnings({ "unused" })
public class ImmutableLinkedHashMap<K, V> extends LinkedHashMap<K, V> {
/**
* Creates a new immutable linked hash map.
*
* @since 1-alpha1
*/
public ImmutableLinkedHashMap() {}
/**
* Converts a {@link Map} into a {@link ImmutableLinkedHashMap}.
*
* @param map {@link Map} to convert
* @since 1-alpha1
*/
public ImmutableLinkedHashMap(@NotNull Map<K, V> map) {
for (K key : map.keySet())
super.put(key, map.get(key));
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked hash map is immutable
*/
@Nullable
@Override
public V put(K key, V value) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedHashMap");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked hash map is immutable
*/
@Nullable
@Override
public V remove(Object key) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedHashMap");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked hash map is immutable
*/
@Override
public void putAll(@NotNull Map<? extends K, ? extends V> m) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedHashMap");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked hash map is immutable
*/
@Override
public void clear() {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedHashMap");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked hash map is immutable
*/
@Override
public void replaceAll(BiFunction<? super K, ? super V, ? extends V> function) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedHashMap");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked hash map is immutable
*/
@Nullable
@Override
public V putIfAbsent(K key, V value) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedHashMap");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked hash map is immutable
*/
@Override
public boolean remove(Object key, Object value) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedHashMap");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked hash map is immutable
*/
@Override
public boolean replace(K key, V oldValue, V newValue) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedHashMap");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked hash map is immutable
*/
@Nullable
@Override
public V replace(K key, V value) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedHashMap");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked hash map is immutable
*/
@Nullable
@Override
public V merge(K key, @NotNull V value, @NotNull BiFunction<? super V, ? super V, ? extends V> remappingFunction) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedHashMap");
}
}

View file

@ -0,0 +1,214 @@
/*
* STAROPENSOURCE ENGINE SOURCE FILE
* Copyright (c) 2024 The StarOpenSource Engine Contributors
* Licensed under the GNU Affero General Public License v3
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
package de.staropensource.sosengine.base.types.immutable;
import org.jetbrains.annotations.NotNull;
import java.util.Collection;
import java.util.Comparator;
import java.util.LinkedList;
import java.util.List;
import java.util.function.UnaryOperator;
/**
* An unmodifiable {@link LinkedList}.
* {@inheritDoc}
*
* @since 1-alpha1
*/
@SuppressWarnings({ "unused" })
public class ImmutableLinkedList<E> extends LinkedList<E> {
/**
* Creates a new immutable linked list.
*
* @since 1-alpha1
*/
public ImmutableLinkedList() {}
/**
* Converts a {@link LinkedList} into a {@link ImmutableLinkedList}.
*
* @param list {@link List} to convert
* @since 1-alpha1
*/
public ImmutableLinkedList(@NotNull List<E> list) {
super.addAll(list);
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public boolean add(E e) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public boolean remove(Object o) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public boolean addAll(@NotNull Collection<? extends E> c) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public boolean addAll(int index, @NotNull Collection<? extends E> c) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public boolean removeAll(@NotNull Collection<?> c) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public boolean retainAll(@NotNull Collection<?> c) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public void replaceAll(UnaryOperator<E> operator) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public void sort(Comparator<? super E> c) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public void clear() {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public E set(int index, E element) throws UnsupportedOperationException {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public void add(int index, E element) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public E remove(int index) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public void addFirst(E e) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public void addLast(E e) {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public E removeFirst() {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
/**
* {@inheritDoc}
*
* @throws UnsupportedOperationException always, linked list is immutable
*/
@Override
public E removeLast() {
throw new UnsupportedOperationException("This method cannot be executed on an ImmutableLinkedList");
}
}

View file

@ -26,6 +26,7 @@ module sosengine.base {
exports de.staropensource.sosengine.base.logging.implementation; exports de.staropensource.sosengine.base.logging.implementation;
exports de.staropensource.sosengine.base.types; exports de.staropensource.sosengine.base.types;
exports de.staropensource.sosengine.base.types.dependency; exports de.staropensource.sosengine.base.types.dependency;
exports de.staropensource.sosengine.base.types.immutable;
exports de.staropensource.sosengine.base.types.vectors; exports de.staropensource.sosengine.base.types.vectors;
exports de.staropensource.sosengine.base.types.versioning; exports de.staropensource.sosengine.base.types.versioning;
exports de.staropensource.sosengine.base.utility; exports de.staropensource.sosengine.base.utility;
@ -51,6 +52,7 @@ module sosengine.base {
opens de.staropensource.sosengine.base.logging.implementation; opens de.staropensource.sosengine.base.logging.implementation;
opens de.staropensource.sosengine.base.types; opens de.staropensource.sosengine.base.types;
opens de.staropensource.sosengine.base.types.dependency; opens de.staropensource.sosengine.base.types.dependency;
opens de.staropensource.sosengine.base.types.immutable;
opens de.staropensource.sosengine.base.types.vectors; opens de.staropensource.sosengine.base.types.vectors;
opens de.staropensource.sosengine.base.types.versioning; opens de.staropensource.sosengine.base.types.versioning;
opens de.staropensource.sosengine.base.utility; opens de.staropensource.sosengine.base.utility;

View file

@ -1,3 +1,8 @@
/**
* Defines the OpenGL Graphics API and {@code opengl} subsystem, which allows for communicating with the graphics card via OpenGL.
*
* @since 1-alpha1
*/
module sosengine.opengl { module sosengine.opengl {
// Dependencies // Dependencies
// -> Subsystems // -> Subsystems

View file

@ -1,3 +1,8 @@
/**
* Defines the {@code graphics} subsystem, which allows creating windows and drawing pixels onto the screen.
*
* @since 1-alpha1
*/
module sosengine.graphics { module sosengine.graphics {
// Dependencies // Dependencies
// -> Subsystems // -> Subsystems

View file

@ -1,3 +1,8 @@
/**
* Defines the Vulkan Graphics API and {@code vulkan} subsystem, which allows for communicating with the graphics card via Vulkan.
*
* @since 1-alpha1
*/
module sosengine.vulkan { module sosengine.vulkan {
// Dependencies // Dependencies
// -> Subsystems // -> Subsystems

View file

@ -1,3 +1,8 @@
/**
* Defines the {@code slf4j-compat} subsystem, which helps bridging the gap between SLF4J and the sos!engine by forwarding all SLF4J calls to the engine you love.
*
* @since 1-alpha1
*/
module sosengine.slf4j_compat { module sosengine.slf4j_compat {
// Dependencies // Dependencies
// -> Subsystems // -> Subsystems

View file

@ -1,3 +1,9 @@
/**
* Defines the sos!engine test application, used by engine developers to test their changes.
* This module is very uninteresting for non-engine developers.
*
* @since 1-alpha1
*/
open module sosengine.testapp { open module sosengine.testapp {
// Dependencies // Dependencies
// -> Subsystems // -> Subsystems