From eadf1eaf5b8110f94a294ad1b5a7e48b5f5baf00 Mon Sep 17 00:00:00 2001 From: jbb01 Date: Tue, 12 Sep 2023 19:47:07 +0200 Subject: [PATCH] initial commit --- .gitignore | 42 ++ bot-api/build.gradle.kts | 43 ++ .../jonahbauer/chat/bot/config/BotConfig.java | 464 ++++++++++++++ .../bot/config/BotConfigurationException.java | 7 + bot-api/src/config/java/module-info.java | 6 + .../java/eu/jonahbauer/chat/bot/api/Chat.java | 7 + .../eu/jonahbauer/chat/bot/api/ChatBot.java | 61 ++ .../eu/jonahbauer/chat/bot/api/Message.java | 51 ++ .../chat/bot/impl/BotCreationException.java | 7 + .../chat/bot/impl/ChatBotFactory.java | 57 ++ bot-api/src/main/java/module-info.java | 14 + .../jonahbauer/chat/bot/api/ChatBotTest.java | 53 ++ .../chat/bot/config/BotConfigTest.java | 116 ++++ .../chat/bot/impl/ChatBotFactoryAccess.java | 14 + .../chat/bot/impl/ChatBotFactoryTest.java | 29 + .../eu/jonahbauer/chat/bot/test/MockChat.java | 21 + .../jonahbauer/chat/bot/test/TestChatBot.java | 26 + bots/ping-bot/build.gradle.kts | 6 + .../eu/jonahbauer/chat/bot/ping/PingBot.java | 19 + bots/ping-bot/src/main/java/module-info.java | 10 + buildSrc/build.gradle.kts | 7 + .../chat-bot.bot-conventions.gradle.kts | 17 + .../chat-bot.java-conventions.gradle.kts | 41 ++ gradle/libs.versions.toml | 22 + gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 43462 bytes gradle/wrapper/gradle-wrapper.properties | 7 + gradlew | 249 ++++++++ gradlew.bat | 92 +++ management/build.gradle.kts | 15 + .../server/management/BotConfigSupport.java | 133 ++++ .../management/ChatBotManagerMXBean.java | 58 ++ .../management/ChatBotSupportMXBean.java | 59 ++ .../management/SocketManagerMXBean.java | 41 ++ .../chat/server/management/SocketState.java | 5 + .../management/SocketSupportMXBean.java | 59 ++ .../annotations/ManagedAttribute.java | 12 + .../management/annotations/ManagedBean.java | 12 + .../annotations/ManagedOperation.java | 28 + .../annotations/ManagedParameter.java | 13 + management/src/main/java/module-info.java | 10 + server/build.gradle.kts | 26 + .../eu/jonahbauer/chat/server/Config.java | 60 ++ .../java/eu/jonahbauer/chat/server/Main.java | 30 + .../server/bot/BotConfigDeserializer.java | 61 ++ .../chat/server/bot/ChatBotSupervisor.java | 242 ++++++++ .../server/management/impl/AdvancedMBean.java | 157 +++++ .../management/impl/ChatBotManager.java | 67 ++ .../management/impl/ChatBotSupport.java | 44 ++ .../server/management/impl/SocketManager.java | 44 ++ .../server/management/impl/SocketSupport.java | 64 ++ .../chat/server/socket/OutgoingMessage.java | 21 + .../socket/SocketCreationException.java | 7 + .../chat/server/socket/SocketSupervisor.java | 576 ++++++++++++++++++ .../server/util/UrlTemplateProcessor.java | 28 + server/src/main/java/module-info.java | 17 + server/src/main/resources/log4j2.xml | 12 + settings.gradle.kts | 18 + 57 files changed, 3407 insertions(+) create mode 100644 .gitignore create mode 100644 bot-api/build.gradle.kts create mode 100644 bot-api/src/config/java/eu/jonahbauer/chat/bot/config/BotConfig.java create mode 100644 bot-api/src/config/java/eu/jonahbauer/chat/bot/config/BotConfigurationException.java create mode 100644 bot-api/src/config/java/module-info.java create mode 100644 bot-api/src/main/java/eu/jonahbauer/chat/bot/api/Chat.java create mode 100644 bot-api/src/main/java/eu/jonahbauer/chat/bot/api/ChatBot.java create mode 100644 bot-api/src/main/java/eu/jonahbauer/chat/bot/api/Message.java create mode 100644 bot-api/src/main/java/eu/jonahbauer/chat/bot/impl/BotCreationException.java create mode 100644 bot-api/src/main/java/eu/jonahbauer/chat/bot/impl/ChatBotFactory.java create mode 100644 bot-api/src/main/java/module-info.java create mode 100644 bot-api/src/test/java/eu/jonahbauer/chat/bot/api/ChatBotTest.java create mode 100644 bot-api/src/test/java/eu/jonahbauer/chat/bot/config/BotConfigTest.java create mode 100644 bot-api/src/test/java/eu/jonahbauer/chat/bot/impl/ChatBotFactoryAccess.java create mode 100644 bot-api/src/test/java/eu/jonahbauer/chat/bot/impl/ChatBotFactoryTest.java create mode 100644 bot-api/src/test/java/eu/jonahbauer/chat/bot/test/MockChat.java create mode 100644 bot-api/src/test/java/eu/jonahbauer/chat/bot/test/TestChatBot.java create mode 100644 bots/ping-bot/build.gradle.kts create mode 100644 bots/ping-bot/src/main/java/eu/jonahbauer/chat/bot/ping/PingBot.java create mode 100644 bots/ping-bot/src/main/java/module-info.java create mode 100644 buildSrc/build.gradle.kts create mode 100644 buildSrc/src/main/kotlin/chat-bot.bot-conventions.gradle.kts create mode 100644 buildSrc/src/main/kotlin/chat-bot.java-conventions.gradle.kts create mode 100644 gradle/libs.versions.toml create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100755 gradlew create mode 100644 gradlew.bat create mode 100644 management/build.gradle.kts create mode 100644 management/src/main/java/eu/jonahbauer/chat/server/management/BotConfigSupport.java create mode 100644 management/src/main/java/eu/jonahbauer/chat/server/management/ChatBotManagerMXBean.java create mode 100644 management/src/main/java/eu/jonahbauer/chat/server/management/ChatBotSupportMXBean.java create mode 100644 management/src/main/java/eu/jonahbauer/chat/server/management/SocketManagerMXBean.java create mode 100644 management/src/main/java/eu/jonahbauer/chat/server/management/SocketState.java create mode 100644 management/src/main/java/eu/jonahbauer/chat/server/management/SocketSupportMXBean.java create mode 100644 management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedAttribute.java create mode 100644 management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedBean.java create mode 100644 management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedOperation.java create mode 100644 management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedParameter.java create mode 100644 management/src/main/java/module-info.java create mode 100644 server/build.gradle.kts create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/Config.java create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/Main.java create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/bot/BotConfigDeserializer.java create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/bot/ChatBotSupervisor.java create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/management/impl/AdvancedMBean.java create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/management/impl/ChatBotManager.java create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/management/impl/ChatBotSupport.java create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/management/impl/SocketManager.java create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/management/impl/SocketSupport.java create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/socket/OutgoingMessage.java create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/socket/SocketCreationException.java create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/socket/SocketSupervisor.java create mode 100644 server/src/main/java/eu/jonahbauer/chat/server/util/UrlTemplateProcessor.java create mode 100644 server/src/main/java/module-info.java create mode 100644 server/src/main/resources/log4j2.xml create mode 100644 settings.gradle.kts diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..b63da45 --- /dev/null +++ b/.gitignore @@ -0,0 +1,42 @@ +.gradle +build/ +!gradle/wrapper/gradle-wrapper.jar +!**/src/main/**/build/ +!**/src/test/**/build/ + +### IntelliJ IDEA ### +.idea/modules.xml +.idea/jarRepositories.xml +.idea/compiler.xml +.idea/libraries/ +*.iws +*.iml +*.ipr +out/ +!**/src/main/**/out/ +!**/src/test/**/out/ + +### Eclipse ### +.apt_generated +.classpath +.factorypath +.project +.settings +.springBeans +.sts4-cache +bin/ +!**/src/main/**/bin/ +!**/src/test/**/bin/ + +### NetBeans ### +/nbproject/private/ +/nbbuild/ +/dist/ +/nbdist/ +/.nb-gradle/ + +### VS Code ### +.vscode/ + +### Mac OS ### +.DS_Store \ No newline at end of file diff --git a/bot-api/build.gradle.kts b/bot-api/build.gradle.kts new file mode 100644 index 0000000..1a2995a --- /dev/null +++ b/bot-api/build.gradle.kts @@ -0,0 +1,43 @@ +plugins { + id("java-library") + id("chat-bot.java-conventions") +} + +group = "eu.jonahbauer.chat" +version = "0.1.0-SNAPSHOT" + +sourceSets { + create("config") { + java { + srcDir("src/config/java") + } + } +} + +java { + registerFeature("config") { + usingSourceSet(sourceSets["config"]) + } +} + +val configApi by configurations +val configCompileOnly by configurations +val configAnnotationProcessor by configurations + +dependencies { + api(libs.annotations) + api(project(path)) { + capabilities { + requireCapability("${project.group}:${project.name}-config") + } + } + implementation(libs.jackson.annotations) + + configApi(libs.annotations) + configCompileOnly(libs.lombok) + configAnnotationProcessor(libs.lombok) +} + +tasks.withType { + options.compilerArgs.add("-Xlint:-module") +} \ No newline at end of file diff --git a/bot-api/src/config/java/eu/jonahbauer/chat/bot/config/BotConfig.java b/bot-api/src/config/java/eu/jonahbauer/chat/bot/config/BotConfig.java new file mode 100644 index 0000000..a4a51a8 --- /dev/null +++ b/bot-api/src/config/java/eu/jonahbauer/chat/bot/config/BotConfig.java @@ -0,0 +1,464 @@ +package eu.jonahbauer.chat.bot.config; + +import lombok.AccessLevel; +import lombok.EqualsAndHashCode; +import lombok.RequiredArgsConstructor; +import org.jetbrains.annotations.NotNull; +import org.jetbrains.annotations.Nullable; +import org.jetbrains.annotations.Unmodifiable; + +import java.util.*; + +@SuppressWarnings("unused") +@RequiredArgsConstructor(access = AccessLevel.PRIVATE) +@EqualsAndHashCode(onlyExplicitlyIncluded = true) +public final class BotConfig { + public static final Key.OfString NAME = Key.ofString("name"); + public static final Key.OfBoolean BOT_TAG = Key.ofBoolean("bottag"); + public static final Key.OfBoolean IGNORE_BOTS = Key.ofBoolean("ignore_bots"); + public static final Key.OfBoolean PUBLIC_ID = Key.ofBoolean("public_id"); + public static final Key.OfStringArray CHANNELS = Key.ofStringArray("channels"); + public static final Key.OfString TYPE = Key.ofString("type"); + public static final BotConfig EMPTY = new BotConfig(Collections.emptyMap()); + + @EqualsAndHashCode.Include + private final @Unmodifiable @NotNull Map<@NotNull String, @NotNull Value> data; + + public static @NotNull Builder builder() { + return new Builder(); + } + + /** + * {@return a new builder initialized with this config's data} + */ + public @NotNull Builder mutate() { + return new Builder(this.data); + } + + @Override + public @NotNull String toString() { + return "BotConfig" + data; + } + + /** + * Merges the other config into this one, returning a new config container properties of both this and the provided + * config. Properties present in both this and the provided config will contain the value of the provided config. + * @param config another config + * @return a merged config + */ + public @NotNull BotConfig merge(@NotNull BotConfig config) { + var data = new HashMap<>(this.data); + data.putAll(config.data); + return new BotConfig(Map.copyOf(data)); + } + + /** + * {@return the set of all keys to this config} + */ + public @NotNull Set<@NotNull String> keySet() { + return data.keySet(); + } + + private transient @Nullable Set<@NotNull Entry> entrySet; + public @NotNull Set<@NotNull Entry> entrySet() { + if (entrySet == null) { + var entries = new HashSet>(); + data.forEach((key, v) -> entries.add(switch (v) { + case Value.OfLong(long value) -> Entry.ofLong(key, value); + case Value.OfDouble(double value) -> Entry.ofDouble(key, value); + case Value.OfString(String value) -> Entry.ofString(key, value); + case Value.OfBoolean(boolean value) -> Entry.ofBoolean(key, value); + case Value.OfStringArray(List value) -> Entry.ofStringArray(key, value); + })); + entrySet = Collections.unmodifiableSet(entries); + } + return entrySet; + } + + /* + * getters for default keys + */ + + public @NotNull String getType() { + return get(TYPE).orElseThrow(() -> new BotConfigurationException("missing property: " + TYPE)); + } + + public @NotNull String getName() { + return get(NAME).orElseThrow(() -> new BotConfigurationException("missing property: " + NAME)); + } + + public @NotNull List<@NotNull String> getChannels() { + return get(CHANNELS).orElseThrow(() -> new BotConfigurationException("missing property: " + CHANNELS)); + } + + public boolean isBotTag() { + return get(BOT_TAG).orElse(true); + } + + public boolean isIgnoreBots() { + return get(IGNORE_BOTS).orElse(true); + } + + public boolean isPublicId() { + return get(PUBLIC_ID).orElse(true); + } + + /* + * generic getters + */ + + /** + * {@return whether this config contains the given key} + */ + public boolean has(@NotNull String key) { + return data.containsKey(key); + } + + /** + * {@return whether this config contains the given key and the value associated with the key matches the key type} + */ + public boolean has(@NotNull Key key) { + return switch (key) { + case Key.OfBoolean(var k) -> getBoolean(k).isPresent(); + case Key.OfLong(var k) -> getLong(k).isPresent(); + case Key.OfDouble(var k) -> getDouble(k).isPresent(); + case Key.OfStringArray(var k) -> getStringArray(k).isPresent(); + case Key.OfString(var k) -> getString(k).isPresent(); + }; + } + + /** + * {@return the value associated with the given key} + * @throws BotConfigurationException if no value is present for the given key or the value does not match the key + * type + */ + @SuppressWarnings("unchecked") + public @NotNull T require(@NotNull Key key) { + try { + return (T) switch (key) { + case Key.OfBoolean(var k) -> getBoolean(k).orElseThrow(); + case Key.OfLong(var k) -> getLong(k).orElseThrow(); + case Key.OfDouble(var k) -> getDouble(k).orElseThrow(); + case Key.OfStringArray(var k) -> getStringArray(k).orElseThrow(); + case Key.OfString(var k) -> getString(k).orElseThrow(); + }; + } catch (NoSuchElementException ex) { + throw new BotConfigurationException("Missing property value:" + key.name(), ex); + } + } + + /** + * {@return the value associated with the given key} Returns an empty optional if no value is present for the given + * key or the value does not match the key type. + */ + @SuppressWarnings("unchecked") + public @NotNull T get(@NotNull Key key) { + return (T) switch (key) { + case Key.OfBoolean(var k) -> getBoolean(k); + case Key.OfLong(var k) -> getLong(k); + case Key.OfDouble(var k) -> getDouble(k); + case Key.OfStringArray(var k) -> getStringArray(k); + case Key.OfString(var k) -> getString(k); + }; + } + + /** + * {@return the value associated with the given key} If not empty, then the returned {@link Optional} will + * contain an object of type {@link String}, {@link Long}, {@link Double}, {@link Boolean} or {@link List List<String>}. + */ + public @NotNull Optional get(@NotNull String key) { + var value = data.get(key); + return value == null ? Optional.empty() : Optional.of(value.asObject()); + } + + /** + * {@return the value associated with the given key} Returns an {@linkplain Optional#empty() empty optional} if no + * value is present for the given key or the value is not of type {@link String}. + */ + public @NotNull Optional getString(@NotNull String key) { + var value = data.get(key); + return value == null ? Optional.empty() : Optional.of(value.asString(key)); + } + + /** + * {@return the value associated with the given key} Returns an {@linkplain OptionalLong#empty() empty optional} if + * no value is present for the given key or the value is not of type {@link Long}. + */ + public @NotNull OptionalLong getLong(@NotNull String key) { + var value = data.get(key); + return value == null ? OptionalLong.empty() : OptionalLong.of(value.asLong(key)); + } + + /** + * {@return the value associated with the given key} Returns an {@linkplain OptionalDouble#empty() empty optional} + * if no value is present for the given key or the value is not of type {@link Double}. + */ + public @NotNull OptionalDouble getDouble(@NotNull String key) { + var value = data.get(key); + return value == null ? OptionalDouble.empty() : OptionalDouble.of(value.asDouble(key)); + } + + /** + * {@return the value associated with the given key} Returns an {@linkplain Optional#empty() empty optional} if no + * value is present for the given key or the value is not of type {@link Boolean}. + */ + public @NotNull Optional getBoolean(@NotNull String key) { + var value = data.get(key); + return value == null ? Optional.empty() : Optional.of(value.asBoolean(key)); + } + + /** + * {@return the value associated with the given key} Returns an {@linkplain Optional#empty() empty optional} if no + * value is present for the given key or the value is not of type {@link List List<String>}. + */ + public @NotNull Optional> getStringArray(@NotNull String key) { + var value = data.get(key); + return value == null ? Optional.empty() : Optional.of(value.asArray(key)); + } + + private static BotConfigurationException wrongType(@NotNull String key, @NotNull String expected, @NotNull String actual) { + return new BotConfigurationException("Wrong property type for " + key + " (expected " + expected + ", got " + actual + ")"); + } + + public static class Builder { + private final Map data; + + private Builder() { + this(Collections.emptyMap()); + } + + private Builder(Map data) { + this.data = new HashMap<>(data); + } + + public Builder type(@NotNull String type) { + return value(TYPE, type); + } + + public Builder name(@NotNull String name) { + return value(NAME, name); + } + + public Builder channels(@NotNull String @NotNull... channels) { + return value(CHANNELS, List.of(channels)); + } + + public Builder channels(@NotNull List<@NotNull String> channels) { + return value(CHANNELS, List.copyOf(channels)); + } + + public Builder noPublicId() { + return value(PUBLIC_ID, false); + } + + public Builder noBotTag() { + return value(BOT_TAG, false); + } + + public Builder noIgnoreBots() { + return value(IGNORE_BOTS, false); + } + + public Builder value(@NotNull String key, long value) { + data.put(key, new Value.OfLong(value)); + return this; + } + + public Builder value(@NotNull String key, double value) { + data.put(key, new Value.OfDouble(value)); + return this; + } + + public Builder value(@NotNull String key, @NotNull String value) { + data.put(key, new Value.OfString(value)); + return this; + } + + public Builder value(@NotNull String key, boolean value) { + data.put(key, new Value.OfBoolean(value)); + return this; + } + + public Builder value(@NotNull String key, @NotNull List<@NotNull String> value) { + data.put(key, new Value.OfStringArray(value)); + return this; + } + + public Builder value(@NotNull Key key, S value) { + data.put(key.name(), Value.forKey(key, value)); + return this; + } + + public BotConfig build() { + return new BotConfig(Map.copyOf(data)); + } + } + + /** + * A typed key to a {@link BotConfig}. + * @param the raw value type + * @param the optional value type + */ + public sealed interface Key { + @NotNull String name(); + + static @NotNull Key.OfLong ofLong(@NotNull String key) { + return new OfLong(key); + } + + static @NotNull Key.OfDouble ofDouble(@NotNull String key) { + return new OfDouble(key); + } + + static @NotNull Key.OfString ofString(@NotNull String key) { + return new OfString(key); + } + + static @NotNull Key.OfBoolean ofBoolean(@NotNull String key) { + return new OfBoolean(key); + } + + static @NotNull Key.OfStringArray ofStringArray(@NotNull String key) { + return new OfStringArray(key); + } + + record OfLong(@NotNull String name) implements Key {} + record OfDouble(@NotNull String name) implements Key {} + record OfString(@NotNull String name) implements Key> {} + record OfBoolean(@NotNull String name) implements Key> {} + record OfStringArray(@NotNull String name) implements Key, Optional>> {} + } + + public sealed interface Entry extends Map.Entry { + @NotNull String key(); + @NotNull T value(); + + @Override + default @NotNull String getKey() { + return key(); + } + + @Override + default @NotNull T getValue() { + return value(); + } + + @Override + default T setValue(T value) { + throw new UnsupportedOperationException(); + } + + static @NotNull Entry.OfLong ofLong(@NotNull String key, long value) { + return new Entry.OfLong(key, value); + } + + static @NotNull Entry.OfDouble ofDouble(@NotNull String key, double value) { + return new Entry.OfDouble(key, value); + } + + static @NotNull Entry.OfString ofString(@NotNull String key, @NotNull String value) { + return new Entry.OfString(key, value); + } + + static @NotNull Entry.OfBoolean ofBoolean(@NotNull String key, boolean value) { + return new Entry.OfBoolean(key, value); + } + + static @NotNull Entry.OfStringArray ofStringArray(@NotNull String key, @NotNull List<@NotNull String> value) { + return new Entry.OfStringArray(key, value); + } + + + record OfLong(@NotNull String key, long valueAsLong) implements Entry { + @Override + public @NotNull Long value() { + return valueAsLong; + } + } + record OfDouble(@NotNull String key, double valueAsDouble) implements Entry { + @Override + public @NotNull Double value() { + return valueAsDouble; + } + } + record OfString(@NotNull String key, @NotNull String value) implements Entry {} + record OfBoolean(@NotNull String key, boolean valueAsBoolean) implements Entry { + @Override + public @NotNull Boolean value() { + return valueAsBoolean; + } + } + record OfStringArray(@NotNull String key, @NotNull List<@NotNull String> value) implements Entry> {} + } + + private sealed interface Value { + String name(); + + default long asLong(@NotNull String key) { throw wrongType(key, "integer", name()); } + default double asDouble(@NotNull String key) { throw wrongType(key, "float", name()); } + default String asString(@NotNull String key) { throw wrongType(key, "string", name()); } + default boolean asBoolean(@NotNull String key) { throw wrongType(key, "boolean", name()); } + default List asArray(@NotNull String key) { throw wrongType(key, "array", name()); } + Object asObject(); + + @SuppressWarnings("unchecked") + static Value forKey(Key key, S value) { + return switch (key) { + case Key.OfString _ -> new Value.OfString((String) value); + case Key.OfDouble _ -> new Value.OfDouble((double) value); + case Key.OfLong _ -> new Value.OfLong((long) value); + case Key.OfBoolean _ -> new Value.OfBoolean((boolean) value); + case Key.OfStringArray _ -> new Value.OfStringArray((List) value); + }; + } + + record OfLong(long value) implements Value { + public String name() { return "integer"; } + + @Override + public long asLong(@NotNull String key) { return value; } + + @Override + public Object asObject() { return value; } + } + record OfDouble(double value) implements Value { + public String name() { return "float"; } + + @Override + public double asDouble(@NotNull String key) { return value; } + + @Override + public Object asObject() { return value; } + } + record OfString(@NotNull String value) implements Value { + public OfString { Objects.requireNonNull(value); } + + public String name() { return "string"; } + + @Override + public String asString(@NotNull String key) { return value; } + + @Override + public Object asObject() { return value; } + } + record OfBoolean(boolean value) implements Value { + public String name() { return "boolean"; } + + @Override + public boolean asBoolean(@NotNull String key) { return value; } + + @Override + public Object asObject() { return value; } + } + record OfStringArray(@NotNull List<@NotNull String> value) implements Value { + public OfStringArray { value = List.copyOf(value); } + public String name() { return "array"; } + + @Override + public List asArray(@NotNull String key) { return value; } + + @Override + public Object asObject() { return value; } + } + } +} diff --git a/bot-api/src/config/java/eu/jonahbauer/chat/bot/config/BotConfigurationException.java b/bot-api/src/config/java/eu/jonahbauer/chat/bot/config/BotConfigurationException.java new file mode 100644 index 0000000..71df0cf --- /dev/null +++ b/bot-api/src/config/java/eu/jonahbauer/chat/bot/config/BotConfigurationException.java @@ -0,0 +1,7 @@ +package eu.jonahbauer.chat.bot.config; + +import lombok.experimental.StandardException; + +@StandardException +public class BotConfigurationException extends RuntimeException { +} diff --git a/bot-api/src/config/java/module-info.java b/bot-api/src/config/java/module-info.java new file mode 100644 index 0000000..80b0c33 --- /dev/null +++ b/bot-api/src/config/java/module-info.java @@ -0,0 +1,6 @@ +module eu.jonahbauer.chat.bot.config { + exports eu.jonahbauer.chat.bot.config; + + requires static lombok; + requires static transitive org.jetbrains.annotations; +} \ No newline at end of file diff --git a/bot-api/src/main/java/eu/jonahbauer/chat/bot/api/Chat.java b/bot-api/src/main/java/eu/jonahbauer/chat/bot/api/Chat.java new file mode 100644 index 0000000..e2fcfbe --- /dev/null +++ b/bot-api/src/main/java/eu/jonahbauer/chat/bot/api/Chat.java @@ -0,0 +1,7 @@ +package eu.jonahbauer.chat.bot.api; + +import org.jetbrains.annotations.NotNull; + +public interface Chat { + boolean send(@NotNull String channel, @NotNull String name, @NotNull String message, boolean bottag, boolean publicId); +} diff --git a/bot-api/src/main/java/eu/jonahbauer/chat/bot/api/ChatBot.java b/bot-api/src/main/java/eu/jonahbauer/chat/bot/api/ChatBot.java new file mode 100644 index 0000000..694f66d --- /dev/null +++ b/bot-api/src/main/java/eu/jonahbauer/chat/bot/api/ChatBot.java @@ -0,0 +1,61 @@ +package eu.jonahbauer.chat.bot.api; + +import eu.jonahbauer.chat.bot.config.BotConfig; +import eu.jonahbauer.chat.bot.impl.ChatBotFactory; +import lombok.Getter; +import lombok.experimental.Accessors; +import org.jetbrains.annotations.ApiStatus; +import org.jetbrains.annotations.NotNull; +import org.jetbrains.annotations.Nullable; + +import java.util.Objects; + +@Getter +@Accessors(makeFinal = true) +public abstract class ChatBot { + private static final ScopedValue CHANNEL = ScopedValue.newInstance(); + private static final ScopedValue CHAT = ScopedValue.newInstance(); + + protected final @NotNull BotConfig config; + + protected ChatBot(@NotNull String name) { + this(BotConfig.builder().name(name).build()); + } + + protected ChatBot(@NotNull BotConfig defaultConfig) { + var config = ChatBotFactory.BOT_CONFIG + .orElseThrow(() -> new IllegalCallerException("ChatBot may only be instantiated via ChatBotFactory.")); + this.config = defaultConfig.merge(config); + } + + public final void onMessage(@NotNull Chat chat, @NotNull Message.Post message) { + ScopedValue + .where(CHANNEL, message.channel()) + .where(CHAT, chat) + .run(() -> onMessage(message)); + } + + @ApiStatus.OverrideOnly + protected abstract void onMessage(@NotNull Message.Post message); + + /** + * Called during the normal shutdown process for a bot. + */ + @ApiStatus.OverrideOnly + public void onStop() {} + + protected void post(@NotNull String message) { + post(message, null, null, null); + } + + protected void post(@NotNull String message, @Nullable String name, @Nullable Boolean bottag, @Nullable Boolean publicId) { + Objects.requireNonNull(message, "message"); + name = Objects.requireNonNullElse(name, this.config.getName()); + bottag = Objects.requireNonNullElse(bottag, this.config.isBotTag()); + publicId = Objects.requireNonNullElse(publicId, this.config.isPublicId()); + + var chat = CHAT.orElseThrow(() -> new IllegalStateException("post() may only be called from inside onMessage(Post)")); + var channel = CHANNEL.orElseThrow(() -> new IllegalStateException("post() may only be called from inside onMessage(Post)")); + chat.send(channel, name, message, bottag, publicId); + } +} diff --git a/bot-api/src/main/java/eu/jonahbauer/chat/bot/api/Message.java b/bot-api/src/main/java/eu/jonahbauer/chat/bot/api/Message.java new file mode 100644 index 0000000..fc0e284 --- /dev/null +++ b/bot-api/src/main/java/eu/jonahbauer/chat/bot/api/Message.java @@ -0,0 +1,51 @@ +package eu.jonahbauer.chat.bot.api; + +import com.fasterxml.jackson.annotation.JsonFormat; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonSubTypes; +import com.fasterxml.jackson.annotation.JsonTypeInfo; +import org.jetbrains.annotations.NotNull; +import org.jetbrains.annotations.Nullable; + +import java.time.LocalDateTime; + + +@JsonTypeInfo( + use = JsonTypeInfo.Id.NAME, + property = "type" +) +@JsonSubTypes({ + @JsonSubTypes.Type(value = Message.Ping.class, name = "ping"), + @JsonSubTypes.Type(value = Message.Pong.class, name = "pong"), + @JsonSubTypes.Type(value = Message.Ack.class, name = "ack"), + @JsonSubTypes.Type(value = Message.Post.class, name = "post") +}) +public sealed interface Message { + Ping PING = new Ping(); + + record Ping() implements Message { } + + record Pong() implements Message { } + + record Ack() implements Message { } + + record Post( + long id, + @NotNull String name, + @NotNull String message, + @NotNull String channel, + @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss") + @NotNull LocalDateTime date, + @Nullable Long delay, + @JsonProperty("user_id") + @Nullable Long userId, + @JsonProperty("username") + @Nullable String userName, + @NotNull String color, + int bottag + ) implements Message { + public boolean bot() { + return bottag != 0; + } + } +} diff --git a/bot-api/src/main/java/eu/jonahbauer/chat/bot/impl/BotCreationException.java b/bot-api/src/main/java/eu/jonahbauer/chat/bot/impl/BotCreationException.java new file mode 100644 index 0000000..860e2b0 --- /dev/null +++ b/bot-api/src/main/java/eu/jonahbauer/chat/bot/impl/BotCreationException.java @@ -0,0 +1,7 @@ +package eu.jonahbauer.chat.bot.impl; + +import lombok.experimental.StandardException; + +@StandardException +public class BotCreationException extends RuntimeException { +} diff --git a/bot-api/src/main/java/eu/jonahbauer/chat/bot/impl/ChatBotFactory.java b/bot-api/src/main/java/eu/jonahbauer/chat/bot/impl/ChatBotFactory.java new file mode 100644 index 0000000..1d6c0db --- /dev/null +++ b/bot-api/src/main/java/eu/jonahbauer/chat/bot/impl/ChatBotFactory.java @@ -0,0 +1,57 @@ +package eu.jonahbauer.chat.bot.impl; + +import eu.jonahbauer.chat.bot.api.ChatBot; +import eu.jonahbauer.chat.bot.config.BotConfig; +import org.jetbrains.annotations.NotNull; +import org.jetbrains.annotations.TestOnly; + +import java.util.Objects; +import java.util.ServiceLoader; +import java.util.Set; +import java.util.function.Supplier; +import java.util.stream.Collectors; + +public final class ChatBotFactory { + public static final ScopedValue BOT_CONFIG = ScopedValue.newInstance(); + private static final ServiceLoader SERVICE_LOADER = ServiceLoader.load(ChatBot.class); + + private final @NotNull Class type; + private final @NotNull Supplier delegate; + + public static @NotNull Set<@NotNull Class> implementations() { + return SERVICE_LOADER.stream().map(ServiceLoader.Provider::type).collect(Collectors.toUnmodifiableSet()); + } + + @SuppressWarnings("unchecked") + public ChatBotFactory(@NotNull Class type) { + if (!ChatBot.class.isAssignableFrom(type)) throw new IllegalArgumentException(); + + this.type = type; + this.delegate = (Supplier) SERVICE_LOADER.stream() + .filter(p -> p.type().equals(type)).findFirst() + .orElseThrow(() -> new BotCreationException("No suitable provider found: " + type.getName())); + } + + @TestOnly + ChatBotFactory(@NotNull Class type, @NotNull Supplier supplier) { + if (!ChatBot.class.isAssignableFrom(type)) throw new IllegalArgumentException(); + this.type = type; + this.delegate = Objects.requireNonNull(supplier, "supplier"); + } + + public @NotNull Class type() { + return type; + } + + public @NotNull T create() { + return create(BotConfig.EMPTY); + } + + public @NotNull T create(@NotNull BotConfig config) { + try { + return ScopedValue.where(BOT_CONFIG, config).get(delegate); + } catch (Throwable t) { + throw new BotCreationException("Exception in constructor: " + type.getName(), t); + } + } +} diff --git a/bot-api/src/main/java/module-info.java b/bot-api/src/main/java/module-info.java new file mode 100644 index 0000000..c04c146 --- /dev/null +++ b/bot-api/src/main/java/module-info.java @@ -0,0 +1,14 @@ +import eu.jonahbauer.chat.bot.api.ChatBot; + +module eu.jonahbauer.chat.bot.api { + exports eu.jonahbauer.chat.bot.api; + exports eu.jonahbauer.chat.bot.impl to eu.jonahbauer.chat.server; + + requires transitive eu.jonahbauer.chat.bot.config; + requires static transitive org.jetbrains.annotations; + + requires static com.fasterxml.jackson.annotation; + requires static lombok; + + uses ChatBot; +} \ No newline at end of file diff --git a/bot-api/src/test/java/eu/jonahbauer/chat/bot/api/ChatBotTest.java b/bot-api/src/test/java/eu/jonahbauer/chat/bot/api/ChatBotTest.java new file mode 100644 index 0000000..2f02774 --- /dev/null +++ b/bot-api/src/test/java/eu/jonahbauer/chat/bot/api/ChatBotTest.java @@ -0,0 +1,53 @@ +package eu.jonahbauer.chat.bot.api; + +import eu.jonahbauer.chat.bot.config.BotConfig; +import eu.jonahbauer.chat.bot.impl.ChatBotFactory; +import eu.jonahbauer.chat.bot.impl.ChatBotFactoryAccess; +import eu.jonahbauer.chat.bot.test.MockChat; +import eu.jonahbauer.chat.bot.test.TestChatBot; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import java.time.LocalDateTime; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; + +public class ChatBotTest { + private static ChatBotFactory factory; + + @BeforeAll + static void init() { + factory = ChatBotFactoryAccess.newInstance(TestChatBot.class, TestChatBot::new); + } + + @Test + void postUsesDefaultValuesFromBotConfig() { + var chat = new MockChat(); + var post = new Message.Post(0, "Test", "Hello World!", "", LocalDateTime.MIN, 0L, null, null, "ffffff", 0); + var post2 = new Message.Post(0, "Test", "Hello World!", "test", LocalDateTime.MIN, 0L, null, null, "ffffff", 0); + + var bot = factory.create(BotConfig.EMPTY); + bot.setMessage("Hello, TestChatBot#1"); + bot.onMessage(chat, post); + bot.onMessage(chat, post2); + + var bot2 = factory.create(BotConfig.builder().name("TestChatBot#2").noBotTag().noPublicId().build()); + bot2.setMessage("Hello, TestChatBot#2"); + bot2.onMessage(chat, post); + bot2.onMessage(chat, post2); + + var messages = chat.getMessages(); + assertEquals(4, messages.size()); + assertEquals(new MockChat.Message("", "TestBot", "Hello, TestChatBot#1", true, true), messages.get(0)); + assertEquals(new MockChat.Message("test", "TestBot", "Hello, TestChatBot#1", true, true), messages.get(1)); + assertEquals(new MockChat.Message("", "TestChatBot#2", "Hello, TestChatBot#2", false, false), messages.get(2)); + assertEquals(new MockChat.Message("test", "TestChatBot#2", "Hello, TestChatBot#2", false, false), messages.get(3)); + } + + @Test + void postMayNotBeInvokedOutsideOfOnMessage() { + var bot = factory.create(BotConfig.EMPTY); + assertThrows(IllegalStateException.class, () -> bot.post("Hello, World!")); + } +} diff --git a/bot-api/src/test/java/eu/jonahbauer/chat/bot/config/BotConfigTest.java b/bot-api/src/test/java/eu/jonahbauer/chat/bot/config/BotConfigTest.java new file mode 100644 index 0000000..8a55431 --- /dev/null +++ b/bot-api/src/test/java/eu/jonahbauer/chat/bot/config/BotConfigTest.java @@ -0,0 +1,116 @@ +package eu.jonahbauer.chat.bot.config; + +import org.junit.jupiter.api.Test; + +import java.util.List; +import java.util.Optional; +import java.util.OptionalDouble; +import java.util.OptionalLong; + +import static org.junit.jupiter.api.Assertions.*; + +public class BotConfigTest { + + @Test + void buildAndAccessWithStringKeys() { + BotConfig config = BotConfig.builder() + .value("string", "value") + .value("long", Long.MAX_VALUE) + .value("double", Double.MAX_VALUE) + .value("boolean", true) + .value("array", List.of("foo", "bar")) + .build(); + + assertEquals(Optional.of("value"), config.getString("string")); + assertEquals(OptionalLong.of(Long.MAX_VALUE), config.getLong("long")); + assertEquals(OptionalDouble.of(Double.MAX_VALUE), config.getDouble("double")); + assertEquals(Optional.of(true), config.getBoolean("boolean")); + assertEquals(Optional.of(List.of("foo", "bar")), config.getStringArray("array")); + + assertThrows(BotConfigurationException.class, () -> config.getLong("string")); + assertThrows(BotConfigurationException.class, () -> config.getDouble("string")); + assertThrows(BotConfigurationException.class, () -> config.getBoolean("string")); + assertThrows(BotConfigurationException.class, () -> config.getStringArray("string")); + } + + @Test + void accessUninitializedProperty() { + var unset = BotConfig.Key.ofString("unset"); + var config = BotConfig.EMPTY; + + assertEquals(Optional.empty(), config.get(unset)); + assertEquals(Optional.empty(), config.getString("unset")); + assertEquals(OptionalLong.empty(), config.getLong("unset")); + assertEquals(OptionalDouble.empty(), config.getDouble("unset")); + assertEquals(Optional.empty(), config.getBoolean("unset")); + assertEquals(Optional.empty(), config.getStringArray("unset")); + + assertThrows(BotConfigurationException.class, () -> config.require(unset)); + } + + @Test + void buildAndAccessWithTypedKeys() { + var string = BotConfig.Key.ofString("string"); + var long_ = BotConfig.Key.ofLong("long"); + var double_ = BotConfig.Key.ofDouble("double"); + var boolean_ = BotConfig.Key.ofBoolean("boolean"); + var array = BotConfig.Key.ofStringArray("array"); + + var config = BotConfig.builder() + .value(string, "value") + .value(long_, Long.MAX_VALUE) + .value(double_, Double.MAX_VALUE) + .value(boolean_, true) + .value(array, List.of("foo", "bar")) + .build(); + + assertEquals(Optional.of("value"), config.getString("string")); + assertEquals(OptionalLong.of(Long.MAX_VALUE), config.getLong("long")); + assertEquals(OptionalDouble.of(Double.MAX_VALUE), config.getDouble("double")); + assertEquals(Optional.of(true), config.getBoolean("boolean")); + assertEquals(Optional.of(List.of("foo", "bar")), config.getStringArray("array")); + + assertEquals(Optional.of("value"), config.get(string)); + assertEquals(OptionalLong.of(Long.MAX_VALUE), config.get(long_)); + assertEquals(OptionalDouble.of(Double.MAX_VALUE), config.get(double_)); + assertEquals(Optional.of(true), config.get(boolean_)); + assertEquals(Optional.of(List.of("foo", "bar")), config.get(array)); + + assertEquals("value", config.require(string)); + assertEquals(Long.MAX_VALUE, config.require(long_)); + assertEquals(Double.MAX_VALUE, config.require(double_)); + assertEquals(true, config.require(boolean_)); + assertEquals(List.of("foo", "bar"), config.require(array)); + } + + @Test + void merge() { + var a = BotConfig.builder() + .value("a", "a") + .value("c", "a") + .build(); + + var b = BotConfig.builder() + .value("b", "b") + .value("c", "b") + .build(); + + var c = a.merge(b); + + // a remains unchanged + assertEquals(Optional.of("a"), a.getString("a")); + assertEquals(Optional.of("a"), a.getString("c")); + assertFalse(a.has("b")); + + // b remains unchanged + assertEquals(Optional.of("b"), b.getString("b")); + assertEquals(Optional.of("b"), b.getString("c")); + assertFalse(b.has("a")); + + // c contains a's and b's values + assertEquals(Optional.of("a"), c.getString("a")); + assertEquals(Optional.of("b"), c.getString("b")); + assertEquals(Optional.of("b"), c.getString("c")); + } + +} diff --git a/bot-api/src/test/java/eu/jonahbauer/chat/bot/impl/ChatBotFactoryAccess.java b/bot-api/src/test/java/eu/jonahbauer/chat/bot/impl/ChatBotFactoryAccess.java new file mode 100644 index 0000000..0887f04 --- /dev/null +++ b/bot-api/src/test/java/eu/jonahbauer/chat/bot/impl/ChatBotFactoryAccess.java @@ -0,0 +1,14 @@ +package eu.jonahbauer.chat.bot.impl; + +import eu.jonahbauer.chat.bot.api.ChatBot; +import lombok.experimental.UtilityClass; +import org.jetbrains.annotations.NotNull; + +import java.util.function.Supplier; + +@UtilityClass +public class ChatBotFactoryAccess { + public static @NotNull ChatBotFactory newInstance(@NotNull Class type, @NotNull Supplier supplier) { + return new ChatBotFactory<>(type, supplier); + } +} diff --git a/bot-api/src/test/java/eu/jonahbauer/chat/bot/impl/ChatBotFactoryTest.java b/bot-api/src/test/java/eu/jonahbauer/chat/bot/impl/ChatBotFactoryTest.java new file mode 100644 index 0000000..9f1325e --- /dev/null +++ b/bot-api/src/test/java/eu/jonahbauer/chat/bot/impl/ChatBotFactoryTest.java @@ -0,0 +1,29 @@ +package eu.jonahbauer.chat.bot.impl; + +import eu.jonahbauer.chat.bot.test.TestChatBot; +import eu.jonahbauer.chat.bot.config.BotConfig; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +public class ChatBotFactoryTest { + + @Test + void botsCanOnlyBeInstantiatedUsingChatBotFactory() { + assertThrows(IllegalCallerException.class, TestChatBot::new); + assertNotNull(new ChatBotFactory<>(TestChatBot.class, TestChatBot::new).create(BotConfig.EMPTY)); + } + + @Test + void suppliedConfigOverridesDefaultConfig() { + var factory = new ChatBotFactory<>(TestChatBot.class, TestChatBot::new); + + var bot = factory.create(BotConfig.EMPTY); + assertEquals(TestChatBot.DEFAULT_CONFIG, bot.getConfig()); + + var overridden = factory.create(BotConfig.builder().name("Overridden").value(TestChatBot.TEST, "overridden").build()); + assertEquals("Overridden", overridden.getConfig().require(BotConfig.NAME)); + assertEquals("overridden", overridden.getConfig().require(TestChatBot.TEST)); + } + +} diff --git a/bot-api/src/test/java/eu/jonahbauer/chat/bot/test/MockChat.java b/bot-api/src/test/java/eu/jonahbauer/chat/bot/test/MockChat.java new file mode 100644 index 0000000..1ac5982 --- /dev/null +++ b/bot-api/src/test/java/eu/jonahbauer/chat/bot/test/MockChat.java @@ -0,0 +1,21 @@ +package eu.jonahbauer.chat.bot.test; + +import eu.jonahbauer.chat.bot.api.Chat; +import lombok.Getter; +import org.jetbrains.annotations.NotNull; + +import java.util.ArrayList; +import java.util.List; + +@Getter +public class MockChat implements Chat { + private final List messages = new ArrayList<>(); + + @Override + public boolean send(@NotNull String channel, @NotNull String name, @NotNull String message, boolean bottag, boolean publicId) { + messages.add(new Message(channel, name, message, bottag, publicId)); + return true; + } + + public record Message(String channel, String name, String message, boolean bottag, boolean publicId) {} +} diff --git a/bot-api/src/test/java/eu/jonahbauer/chat/bot/test/TestChatBot.java b/bot-api/src/test/java/eu/jonahbauer/chat/bot/test/TestChatBot.java new file mode 100644 index 0000000..0ea5595 --- /dev/null +++ b/bot-api/src/test/java/eu/jonahbauer/chat/bot/test/TestChatBot.java @@ -0,0 +1,26 @@ +package eu.jonahbauer.chat.bot.test; + +import eu.jonahbauer.chat.bot.api.ChatBot; +import eu.jonahbauer.chat.bot.api.Message; +import eu.jonahbauer.chat.bot.config.BotConfig; +import lombok.Setter; +import org.jetbrains.annotations.NotNull; + +@Setter +public class TestChatBot extends ChatBot { + public static final BotConfig.Key.OfString TEST = BotConfig.Key.ofString("test"); + public static final BotConfig DEFAULT_CONFIG = BotConfig.builder() + .name("TestBot").value(TEST, "test") + .build(); + + private String message; + + public TestChatBot() { + super(DEFAULT_CONFIG); + } + + @Override + protected void onMessage(Message.@NotNull Post message) { + post(this.message); + } +} \ No newline at end of file diff --git a/bots/ping-bot/build.gradle.kts b/bots/ping-bot/build.gradle.kts new file mode 100644 index 0000000..89e7fbd --- /dev/null +++ b/bots/ping-bot/build.gradle.kts @@ -0,0 +1,6 @@ +plugins { + id("chat-bot.bot-conventions") +} + +group = "eu.jonahbauer.chat.bots" +version = "0.1.0-SNAPSHOT" \ No newline at end of file diff --git a/bots/ping-bot/src/main/java/eu/jonahbauer/chat/bot/ping/PingBot.java b/bots/ping-bot/src/main/java/eu/jonahbauer/chat/bot/ping/PingBot.java new file mode 100644 index 0000000..72d1041 --- /dev/null +++ b/bots/ping-bot/src/main/java/eu/jonahbauer/chat/bot/ping/PingBot.java @@ -0,0 +1,19 @@ +package eu.jonahbauer.chat.bot.ping; + +import eu.jonahbauer.chat.bot.api.ChatBot; +import eu.jonahbauer.chat.bot.api.Message; +import org.jetbrains.annotations.NotNull; + +public class PingBot extends ChatBot { + + public PingBot() { + super("Ping"); + } + + @Override + protected void onMessage(Message.@NotNull Post message) { + if (message.message().equals("!ping")) { + post("pong"); + } + } +} diff --git a/bots/ping-bot/src/main/java/module-info.java b/bots/ping-bot/src/main/java/module-info.java new file mode 100644 index 0000000..59fc4dc --- /dev/null +++ b/bots/ping-bot/src/main/java/module-info.java @@ -0,0 +1,10 @@ +import eu.jonahbauer.chat.bot.api.ChatBot; +import eu.jonahbauer.chat.bot.ping.PingBot; + +module eu.jonahbauer.chat.bot.ping { + requires eu.jonahbauer.chat.bot.api; + requires org.apache.logging.log4j; + requires static lombok; + + provides ChatBot with PingBot; +} \ No newline at end of file diff --git a/buildSrc/build.gradle.kts b/buildSrc/build.gradle.kts new file mode 100644 index 0000000..b22ed73 --- /dev/null +++ b/buildSrc/build.gradle.kts @@ -0,0 +1,7 @@ +plugins { + `kotlin-dsl` +} + +repositories { + mavenCentral() +} \ No newline at end of file diff --git a/buildSrc/src/main/kotlin/chat-bot.bot-conventions.gradle.kts b/buildSrc/src/main/kotlin/chat-bot.bot-conventions.gradle.kts new file mode 100644 index 0000000..55cfc6a --- /dev/null +++ b/buildSrc/src/main/kotlin/chat-bot.bot-conventions.gradle.kts @@ -0,0 +1,17 @@ +import org.gradle.api.tasks.compile.JavaCompile + +plugins { + java + id("chat-bot.java-conventions") +} + +val libs = versionCatalogs.named("libs") + +dependencies { + implementation(project(":bot-api")) + implementation(libs.findLibrary("log4j2-api").get()) +} + +tasks.withType { + options.compilerArgs.add("-parameters") +} \ No newline at end of file diff --git a/buildSrc/src/main/kotlin/chat-bot.java-conventions.gradle.kts b/buildSrc/src/main/kotlin/chat-bot.java-conventions.gradle.kts new file mode 100644 index 0000000..22ead73 --- /dev/null +++ b/buildSrc/src/main/kotlin/chat-bot.java-conventions.gradle.kts @@ -0,0 +1,41 @@ +plugins { + java +} + +java { + toolchain { + languageVersion.set(JavaLanguageVersion.of(21)) + } +} + +repositories { + mavenLocal() + mavenCentral() +} + +val libs = versionCatalogs.named("libs") + +dependencies { + compileOnly(libs.findLibrary("lombok").get()) + annotationProcessor(libs.findLibrary("lombok").get()) + + testImplementation(platform(libs.findLibrary("junit-bom").get())) + testImplementation(libs.findLibrary("junit-jupiter").get()) + + testCompileOnly(libs.findLibrary("lombok").get()) + testAnnotationProcessor(libs.findLibrary("lombok").get()) +} + +tasks.withType { + options.compilerArgs.add("--enable-preview") +} + +tasks.withType { + useJUnitPlatform() + jvmArgs("--enable-preview") +} + +val application = extensions.findByType() +application?.apply { + applicationDefaultJvmArgs = listOf("--enable-preview") +} \ No newline at end of file diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml new file mode 100644 index 0000000..0390bda --- /dev/null +++ b/gradle/libs.versions.toml @@ -0,0 +1,22 @@ +[versions] +annotations = "24.1.0" +jackson = "2.16.1" +junit = "5.10.2" +log4j2 = "2.22.1" +lombok = "1.18.30" + +[libraries] +annotations = { module = "org.jetbrains:annotations", version.ref = "annotations" } +jackson-annotations = { module = "com.fasterxml.jackson.core:jackson-annotations", version.ref = "jackson"} +jackson-databind = { module = "com.fasterxml.jackson.core:jackson-databind", version.ref = "jackson"} +jackson-datatype-jsr310 = { module = "com.fasterxml.jackson.datatype:jackson-datatype-jsr310", version.ref = "jackson"} +junit-bom = { module = "org.junit:junit-bom", version.ref = "junit" } +junit-jupiter = { module = "org.junit.jupiter:junit-jupiter" } +log4j2-api = { module = "org.apache.logging.log4j:log4j-api", version.ref = "log4j2"} +log4j2-core = { module = "org.apache.logging.log4j:log4j-core", version.ref = "log4j2"} +log4j2-slf4j = { module = "org.apache.logging.log4j:log4j-slf4j2-impl", version.ref = "log4j2"} +lombok = { module = "org.projectlombok:lombok", version.ref = "lombok" } + +[bundles] +jackson = ["jackson-databind", "jackson-annotations", "jackson-datatype-jsr310"] +log4j2 = ["log4j2-api", "log4j2-core", "log4j2-slf4j"] diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..d64cd4917707c1f8861d8cb53dd15194d4248596 GIT binary patch literal 43462 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 literal 0 HcmV?d00001 diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..f20ff05 --- /dev/null +++ b/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,7 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-rc-4-bin.zip +networkTimeout=10000 +validateDistributionUrl=true +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists diff --git a/gradlew b/gradlew new file mode 100755 index 0000000..1aa94a4 --- /dev/null +++ b/gradlew @@ -0,0 +1,249 @@ +#!/bin/sh + +# +# Copyright © 2015-2021 the original authors. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + +############################################################################## +# +# Gradle start up script for POSIX generated by Gradle. +# +# Important for running: +# +# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is +# noncompliant, but you have some other compliant shell such as ksh or +# bash, then to run this script, type that shell name before the whole +# command line, like: +# +# ksh Gradle +# +# Busybox and similar reduced shells will NOT work, because this script +# requires all of these POSIX shell features: +# * functions; +# * expansions «$var», «${var}», «${var:-default}», «${var+SET}», +# «${var#prefix}», «${var%suffix}», and «$( cmd )»; +# * compound commands having a testable exit status, especially «case»; +# * various built-in commands including «command», «set», and «ulimit». +# +# Important for patching: +# +# (2) This script targets any POSIX shell, so it avoids extensions provided +# by Bash, Ksh, etc; in particular arrays are avoided. +# +# The "traditional" practice of packing multiple parameters into a +# space-separated string is a well documented source of bugs and security +# problems, so this is (mostly) avoided, by progressively accumulating +# options in "$@", and eventually passing that to Java. +# +# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS, +# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly; +# see the in-line comments for details. +# +# There are tweaks for specific operating systems such as AIX, CygWin, +# Darwin, MinGW, and NonStop. +# +# (3) This script is generated from the Groovy template +# https://github.com/gradle/gradle/blob/HEAD/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt +# within the Gradle project. +# +# You can find Gradle at https://github.com/gradle/gradle/. +# +############################################################################## + +# Attempt to set APP_HOME + +# Resolve links: $0 may be a link +app_path=$0 + +# Need this for daisy-chained symlinks. +while + APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path + [ -h "$app_path" ] +do + ls=$( ls -ld "$app_path" ) + link=${ls#*' -> '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +# This is normally unused +# shellcheck disable=SC2034 +APP_BASE_NAME=${0##*/} +# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036) +APP_HOME=$( cd "${APP_HOME:-./}" > /dev/null && pwd -P ) || exit + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + if ! command -v java >/dev/null 2>&1 + then + die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC2039,SC3045 + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC2039,SC3045 + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Collect all arguments for the java command: +# * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments, +# and any embedded shellness will be escaped. +# * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be +# treated as '${Hostname}' itself on the command line. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -classpath "$CLASSPATH" \ + org.gradle.wrapper.GradleWrapperMain \ + "$@" + +# Stop when "xargs" is not available. +if ! command -v xargs >/dev/null 2>&1 +then + die "xargs is not available" +fi + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..6689b85 --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,92 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem + +@if "%DEBUG%"=="" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%"=="" set DIRNAME=. +@rem This is normally unused +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if %ERRORLEVEL% equ 0 goto execute + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if %ERRORLEVEL% equ 0 goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +set EXIT_CODE=%ERRORLEVEL% +if %EXIT_CODE% equ 0 set EXIT_CODE=1 +if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE% +exit /b %EXIT_CODE% + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/management/build.gradle.kts b/management/build.gradle.kts new file mode 100644 index 0000000..56afbc0 --- /dev/null +++ b/management/build.gradle.kts @@ -0,0 +1,15 @@ +plugins { + id("chat-bot.java-conventions") + id("java-library") +} + +group = "eu.jonahbauer.chat" +version = "0.1.0-SNAPSHOT" + +dependencies { + api(project(":bot-api")) { + capabilities { + requireCapability("eu.jonahbauer.chat:bot-api-config") + } + } +} \ No newline at end of file diff --git a/management/src/main/java/eu/jonahbauer/chat/server/management/BotConfigSupport.java b/management/src/main/java/eu/jonahbauer/chat/server/management/BotConfigSupport.java new file mode 100644 index 0000000..92ea0b2 --- /dev/null +++ b/management/src/main/java/eu/jonahbauer/chat/server/management/BotConfigSupport.java @@ -0,0 +1,133 @@ +package eu.jonahbauer.chat.server.management; + +import eu.jonahbauer.chat.bot.config.BotConfig; +import lombok.*; +import org.jetbrains.annotations.NotNull; + +import javax.management.openmbean.*; +import java.util.ArrayList; +import java.util.List; +import java.util.Objects; + +/** + * Makes {@link BotConfig} accessible as JMX open data. + */ +@SuppressWarnings("unused") +@EqualsAndHashCode +public class BotConfigSupport implements CompositeDataView { + private static final OpenType STRING_ARRAY_TYPE; + + static { + try { + STRING_ARRAY_TYPE = ArrayType.getArrayType(SimpleType.STRING); + } catch (OpenDataException e) { + throw Lombok.sneakyThrow(e); + } + } + + private final @NotNull BotConfig config; + + public BotConfigSupport(@NotNull BotConfig config) { + this.config = Objects.requireNonNull(config); + } + + public @NotNull BotConfig unwrap() { + return config; + } + + + // at least one getter is required for this class to be a valid open data type + public String getType() { + return config.getType(); + } + + // detected by java.management + @SneakyThrows + public static @NotNull BotConfigSupport from(@NotNull CompositeData composite) { + var type = composite.getCompositeType(); + var keys = type.keySet(); + + var out = BotConfig.builder(); + for (var key : keys) { + var fieldType = type.getType(key); + var value = composite.get(key); + + if (SimpleType.LONG.equals(fieldType)) { + out.value(key, (Long) value); + } else if (SimpleType.INTEGER.equals(fieldType)) { + out.value(key, (Integer) value); + } else if (SimpleType.SHORT.equals(fieldType)) { + out.value(key, (Short) value); + } else if (SimpleType.CHARACTER.equals(fieldType)) { + out.value(key, (Character) value); + } else if (SimpleType.BYTE.equals(fieldType)) { + out.value(key, (Byte) value); + } else if (SimpleType.DOUBLE.equals(fieldType)) { + out.value(key, (Double) value); + } else if (SimpleType.FLOAT.equals(fieldType)) { + out.value(key, (Float) value); + } else if (SimpleType.BOOLEAN.equals(fieldType)) { + out.value(key, (Boolean) value); + } else if (SimpleType.STRING.equals(fieldType)) { + out.value(key, (String) value); + } else if (STRING_ARRAY_TYPE.equals(fieldType)) { + out.value(key, List.of((String[]) composite.get(key))); + } else { + throw new IllegalArgumentException("Unsupported field type: " + fieldType.getDescription()); + } + } + return new BotConfigSupport(out.build()); + } + + @Override + public @NotNull CompositeData toCompositeData(@NotNull CompositeType ct) { + try { + var itemNames = new ArrayList(); + var itemTypes = new ArrayList>(); + var values = new ArrayList<>(); + + var keys = config.keySet(); + for (var key : keys) { + var value = getOpenData(config.get(key).orElseThrow()); + var type = getOpenType(value); + + itemNames.add(key); + itemTypes.add(type); + values.add(value); + } + + var xct = new CompositeType( + ct.getTypeName(), + ct.getDescription(), + itemNames.toArray(new String[0]), + itemNames.toArray(new String[0]), + itemTypes.toArray(new OpenType[0]) + ); + + return new CompositeDataSupport(xct, itemNames.toArray(new String[0]), values.toArray()); + } catch (Exception e) { + throw new RuntimeException(e); + } + } + + private static @NotNull OpenType getOpenType(@NotNull Object value) { + return switch (value) { + case Long _ -> SimpleType.LONG; + case Double _ -> SimpleType.DOUBLE; + case Boolean _ -> SimpleType.BOOLEAN; + case String _ -> SimpleType.STRING; + case String[] _ -> STRING_ARRAY_TYPE; + default -> throw new IllegalArgumentException(); + }; + } + + @SuppressWarnings("SuspiciousToArrayCall") + private static Object getOpenData(Object value) { + return value instanceof List list ? list.toArray(new String[0]) : value; + } + + @Override + public String toString() { + return config.toString(); + } +} diff --git a/management/src/main/java/eu/jonahbauer/chat/server/management/ChatBotManagerMXBean.java b/management/src/main/java/eu/jonahbauer/chat/server/management/ChatBotManagerMXBean.java new file mode 100644 index 0000000..66c22c7 --- /dev/null +++ b/management/src/main/java/eu/jonahbauer/chat/server/management/ChatBotManagerMXBean.java @@ -0,0 +1,58 @@ +package eu.jonahbauer.chat.server.management; + +import eu.jonahbauer.chat.server.management.annotations.ManagedAttribute; +import eu.jonahbauer.chat.server.management.annotations.ManagedOperation; +import eu.jonahbauer.chat.server.management.annotations.ManagedParameter; +import lombok.SneakyThrows; +import org.jetbrains.annotations.NotNull; + +import javax.management.MXBean; +import javax.management.ObjectName; +import java.util.List; +import java.util.Map; +import java.util.SortedSet; + +@SuppressWarnings("unused") +@MXBean +public interface ChatBotManagerMXBean { + @NotNull ObjectName NAME = getObjectName(); + + @SneakyThrows + private static @NotNull ObjectName getObjectName() { + return ObjectName.getInstance("eu.jonahbauer.chat.bot.server", "component", "ChatBots"); + } + + @ManagedOperation(description = "starts a bot with the given name and type", impact = ManagedOperation.Impact.ACTION) + default void start( + @ManagedParameter(name = "name", description = "the name of the bot (must be unique)") @NotNull String name, + @ManagedParameter(name = "type", description = "the fully qualified class name of the bot") @NotNull String type, + @ManagedParameter(name = "channel", description = "the channel the bot will be active in") @NotNull String channel + ) { + start(name, type, List.of(channel)); + } + + @ManagedOperation(description = "starts a bot with the given name and type", impact = ManagedOperation.Impact.ACTION) + void start( + @ManagedParameter(name = "name", description = "the name of the bot (must be unique)") @NotNull String name, + @ManagedParameter(name = "type", description = "the fully qualified class name of the bot") @NotNull String type, + @ManagedParameter(name = "channels", description = "the channels the bot will be active in") @NotNull List<@NotNull String> channels + ); + + @ManagedOperation(description = "starts a bot with the given config under the specified name", impact = ManagedOperation.Impact.ACTION) + void start( + @ManagedParameter(name = "name", description = "the name of the bot (must be unique)") @NotNull String name, + @ManagedParameter(name = "config", description = "the bot configuration") @NotNull BotConfigSupport config + ); + + @ManagedOperation(description = "stops the bot with the given name and waits for it to finish", impact = ManagedOperation.Impact.ACTION) + void stop(@ManagedParameter(name = "name", description = "the name of the bot") @NotNull String name) throws InterruptedException; + + @ManagedOperation(description = "stops all currently running bots and waits for them to finish", impact = ManagedOperation.Impact.ACTION) + void stop() throws InterruptedException; + + @ManagedAttribute(description = "the list of all currently running bots.") + @NotNull Map<@NotNull String, @NotNull BotConfigSupport> getBots(); + + @ManagedAttribute(description = "the list of all known bot implementations") + @NotNull SortedSet<@NotNull String> getBotImplementations(); +} diff --git a/management/src/main/java/eu/jonahbauer/chat/server/management/ChatBotSupportMXBean.java b/management/src/main/java/eu/jonahbauer/chat/server/management/ChatBotSupportMXBean.java new file mode 100644 index 0000000..96067b5 --- /dev/null +++ b/management/src/main/java/eu/jonahbauer/chat/server/management/ChatBotSupportMXBean.java @@ -0,0 +1,59 @@ +package eu.jonahbauer.chat.server.management; + +import eu.jonahbauer.chat.server.management.annotations.ManagedAttribute; +import eu.jonahbauer.chat.server.management.annotations.ManagedOperation; +import lombok.SneakyThrows; +import org.jetbrains.annotations.NotNull; + +import javax.management.MXBean; +import javax.management.ObjectName; +import java.util.List; + +@SuppressWarnings("unused") +@MXBean +public interface ChatBotSupportMXBean { + + @SneakyThrows + static @NotNull ObjectName getObjectName(String name) { + return ObjectName.getInstance(STR."eu.jonahbauer.chat.bot.server:component=ChatBots,name=\{quote(name)}"); + } + + private static @NotNull String quote(@NotNull String name) { + var needsQuoting = name.chars().anyMatch(chr -> chr == ',' || chr == '=' || chr == ':' || chr == '"' || chr == '*' || chr == '?'); + return needsQuoting ? ObjectName.quote(name) : name; + } + + @ManagedAttribute(description = "the bot's name") + @NotNull String getName(); + + @ManagedAttribute(description = "the bot's type") + default @NotNull String getType() { + return getConfig().getType(); + } + + @ManagedAttribute(description = "the channels the bot is active in") + default @NotNull List<@NotNull String> getChannels() { + return getConfig().unwrap().getChannels(); + } + + @ManagedAttribute(description = "whether the bot sets the bottag for its messages") + default boolean isBotTag() { + return getConfig().unwrap().isBotTag(); + } + + @ManagedAttribute(description = "whether the bot reacts to messages from other bots") + default boolean isIgnoreBots() { + return getConfig().unwrap().isIgnoreBots(); + } + + @ManagedAttribute(description = "whether the bot sends messages with public id") + default boolean isPublicId() { + return getConfig().unwrap().isPublicId(); + } + + @ManagedAttribute(description = "the bot's config") + @NotNull BotConfigSupport getConfig(); + + @ManagedOperation(description = "stops this bot", impact = ManagedOperation.Impact.ACTION) + void stop() throws InterruptedException; +} diff --git a/management/src/main/java/eu/jonahbauer/chat/server/management/SocketManagerMXBean.java b/management/src/main/java/eu/jonahbauer/chat/server/management/SocketManagerMXBean.java new file mode 100644 index 0000000..d927870 --- /dev/null +++ b/management/src/main/java/eu/jonahbauer/chat/server/management/SocketManagerMXBean.java @@ -0,0 +1,41 @@ +package eu.jonahbauer.chat.server.management; + +import eu.jonahbauer.chat.server.management.annotations.ManagedAttribute; +import eu.jonahbauer.chat.server.management.annotations.ManagedOperation; +import eu.jonahbauer.chat.server.management.annotations.ManagedOperation.Impact; +import eu.jonahbauer.chat.server.management.annotations.ManagedParameter; +import lombok.SneakyThrows; +import org.jetbrains.annotations.NotNull; + +import javax.management.MXBean; +import javax.management.ObjectName; +import java.util.SortedSet; + +@SuppressWarnings("unused") +@MXBean +public interface SocketManagerMXBean { + @NotNull ObjectName NAME = getObjectName(); + + @SneakyThrows + private static @NotNull ObjectName getObjectName() { + return ObjectName.getInstance("eu.jonahbauer.chat.bot.server", "component", "Sockets"); + } + + @ManagedOperation(description = "updates the credentials used to authenticate to the chat", impact = Impact.ACTION) + void setCredentials( + @ManagedParameter(name = "username") @NotNull String username, + @ManagedParameter(name = "password") @NotNull String password + ); + + @ManagedOperation(description = "starts a socket for the given channel", impact = Impact.ACTION) + void start(@ManagedParameter(name = "channel") @NotNull String channel); + + @ManagedOperation(description = "stops the socket for the given channel and waits for it to finish", impact = Impact.ACTION) + void stop(@ManagedParameter(name = "channel") @NotNull String channel) throws InterruptedException; + + @ManagedOperation(description = "stops all sockets and waits for them to finish", impact = Impact.ACTION) + void stop() throws InterruptedException; + + @ManagedAttribute(description = "the list of currently connected channels") + @NotNull SortedSet<@NotNull String> getChannels(); +} diff --git a/management/src/main/java/eu/jonahbauer/chat/server/management/SocketState.java b/management/src/main/java/eu/jonahbauer/chat/server/management/SocketState.java new file mode 100644 index 0000000..187ff3c --- /dev/null +++ b/management/src/main/java/eu/jonahbauer/chat/server/management/SocketState.java @@ -0,0 +1,5 @@ +package eu.jonahbauer.chat.server.management; + +public enum SocketState { + CREATED, CONNECTING, CONNECTED, COOLDOWN, STOPPING, STOPPED +} \ No newline at end of file diff --git a/management/src/main/java/eu/jonahbauer/chat/server/management/SocketSupportMXBean.java b/management/src/main/java/eu/jonahbauer/chat/server/management/SocketSupportMXBean.java new file mode 100644 index 0000000..e097449 --- /dev/null +++ b/management/src/main/java/eu/jonahbauer/chat/server/management/SocketSupportMXBean.java @@ -0,0 +1,59 @@ +package eu.jonahbauer.chat.server.management; + +import eu.jonahbauer.chat.server.management.annotations.ManagedAttribute; +import eu.jonahbauer.chat.server.management.annotations.ManagedOperation; +import eu.jonahbauer.chat.server.management.annotations.ManagedParameter; +import lombok.SneakyThrows; +import org.jetbrains.annotations.NotNull; + +import javax.management.MXBean; +import javax.management.ObjectName; +import java.util.Date; + +@SuppressWarnings("unused") +@MXBean +public interface SocketSupportMXBean { + + @SneakyThrows + static @NotNull ObjectName getObjectName(@NotNull String channel) { + return ObjectName.getInstance(STR."eu.jonahbauer.chat.bot.server:component=Sockets,name=\{quote(channel)}"); + } + + private static @NotNull String quote(@NotNull String channel) { + var needsQuoting = channel.chars().anyMatch(chr -> chr == ',' || chr == '=' || chr == ':' || chr == '"' || chr == '*' || chr == '?'); + return needsQuoting ? ObjectName.quote(channel) : channel; + } + + @ManagedAttribute(description = "the socket's state") + SocketState getState(); + + @ManagedAttribute(description = "the channel this socket is connected to") + String getChannel(); + + @ManagedAttribute(description = "the time when the current cooldown will end") + Date getCooldownUntil(); + + + @ManagedOperation(description = "stops this socket", impact = ManagedOperation.Impact.ACTION) + void stop() throws InterruptedException; + + @ManagedOperation(description = "forcefully restarts the socket when its currently on cooldown", impact = ManagedOperation.Impact.ACTION) + void restart(); + + @ManagedOperation(description = "sends a message via this socket", impact = ManagedOperation.Impact.ACTION) + default void send( + @ManagedParameter(name = "name") String name, + @ManagedParameter(name = "message") String message + ) { + send(name, message, true, true); + } + + @ManagedOperation(description = "sends a message via this socket", impact = ManagedOperation.Impact.ACTION) + void send( + @ManagedParameter(name = "name") String name, + @ManagedParameter(name = "message") String message, + @ManagedParameter(name = "bottag") boolean bottag, + @ManagedParameter(name = "publicic") boolean publicid + ); + +} diff --git a/management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedAttribute.java b/management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedAttribute.java new file mode 100644 index 0000000..309e3c1 --- /dev/null +++ b/management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedAttribute.java @@ -0,0 +1,12 @@ +package eu.jonahbauer.chat.server.management.annotations; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.METHOD) +public @interface ManagedAttribute { + String description() default ""; +} diff --git a/management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedBean.java b/management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedBean.java new file mode 100644 index 0000000..689b7da --- /dev/null +++ b/management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedBean.java @@ -0,0 +1,12 @@ +package eu.jonahbauer.chat.server.management.annotations; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.TYPE) +public @interface ManagedBean { + String description(); +} diff --git a/management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedOperation.java b/management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedOperation.java new file mode 100644 index 0000000..714cb47 --- /dev/null +++ b/management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedOperation.java @@ -0,0 +1,28 @@ +package eu.jonahbauer.chat.server.management.annotations; + +import lombok.Getter; +import lombok.RequiredArgsConstructor; + +import javax.management.MBeanOperationInfo; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.METHOD) +public @interface ManagedOperation { + String description() default ""; + Impact impact() default Impact.UNKNOWN; + + @Getter + @RequiredArgsConstructor + enum Impact { + INFO(MBeanOperationInfo.INFO), + ACTION(MBeanOperationInfo.ACTION), + ACTION_INFO(MBeanOperationInfo.ACTION_INFO), + UNKNOWN(MBeanOperationInfo.UNKNOWN); + + private final int code; + } +} diff --git a/management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedParameter.java b/management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedParameter.java new file mode 100644 index 0000000..ac0db47 --- /dev/null +++ b/management/src/main/java/eu/jonahbauer/chat/server/management/annotations/ManagedParameter.java @@ -0,0 +1,13 @@ +package eu.jonahbauer.chat.server.management.annotations; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.PARAMETER) +public @interface ManagedParameter { + String name() default ""; + String description() default ""; +} diff --git a/management/src/main/java/module-info.java b/management/src/main/java/module-info.java new file mode 100644 index 0000000..f360574 --- /dev/null +++ b/management/src/main/java/module-info.java @@ -0,0 +1,10 @@ +module eu.jonahbauer.chat.server.management { + exports eu.jonahbauer.chat.server.management; + exports eu.jonahbauer.chat.server.management.annotations; + + requires transitive java.management; + requires transitive eu.jonahbauer.chat.bot.config; + requires static transitive org.jetbrains.annotations; + + requires static lombok; +} \ No newline at end of file diff --git a/server/build.gradle.kts b/server/build.gradle.kts new file mode 100644 index 0000000..2e878ca --- /dev/null +++ b/server/build.gradle.kts @@ -0,0 +1,26 @@ +plugins { + id("chat-bot.java-conventions") + application +} + +group = "eu.jonahbauer.chat" +version = "0.1.0-SNAPSHOT" + +val bots = project(":bots").subprojects + +dependencies { + implementation(project(":bot-api")) + implementation(project(":management")) + implementation(libs.bundles.log4j2) + implementation(libs.bundles.jackson) + + bots.forEach { + implementation(project(it.path)) + } +} + +application { + mainClass.set("eu.jonahbauer.chat.server.Main") + mainModule.set("eu.jonahbauer.chat.server") + applicationDefaultJvmArgs = listOf("--enable-preview") +} \ No newline at end of file diff --git a/server/src/main/java/eu/jonahbauer/chat/server/Config.java b/server/src/main/java/eu/jonahbauer/chat/server/Config.java new file mode 100644 index 0000000..8ebfa4c --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/Config.java @@ -0,0 +1,60 @@ +package eu.jonahbauer.chat.server; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.annotation.JsonDeserialize; +import eu.jonahbauer.chat.bot.config.BotConfig; +import eu.jonahbauer.chat.server.bot.BotConfigDeserializer; +import org.jetbrains.annotations.NotNull; + +import java.io.IOException; +import java.net.URI; +import java.net.URL; +import java.util.Map; +import java.util.Objects; +import java.util.Set; + +public record Config( + @NotNull Account account, + @NotNull Set<@NotNull String> channels, + @JsonDeserialize(contentUsing = BotConfigDeserializer.class) + @NotNull Map<@NotNull String, @NotNull BotConfig> bots +) { + private static final String CONFIGURATION_FILE_ENV = "CHAT_BOT_CONFIG"; + private static final String CONFIGURATION_FILE_PROPERTY = "chatbot.configurationFile"; + private static final String DEFAULT_CONFIGURATION_FILE = "file:./config.json"; + + public static @NotNull Config load() throws IOException { + var env = System.getenv(CONFIGURATION_FILE_ENV); + if (env != null) return read(env); + + var prop = System.getProperty(CONFIGURATION_FILE_PROPERTY); + if (prop != null) return read(prop); + + return read(DEFAULT_CONFIGURATION_FILE); + } + + public static @NotNull Config read(@NotNull String url) throws IOException { + return read(URI.create(url).toURL()); + } + + public static @NotNull Config read(@NotNull URL url) throws IOException { + var mapper = new ObjectMapper(); + return mapper.readValue(url, Config.class); + } + + public Config { + Objects.requireNonNull(account, "account"); + channels = Set.copyOf(channels); // implicit null check + bots = Map.copyOf(bots); // implicit null check + } + + public record Account( + @NotNull String username, + @NotNull String password + ) { + public Account { + Objects.requireNonNull(username, "username"); + Objects.requireNonNull(password, "password"); + } + } +} diff --git a/server/src/main/java/eu/jonahbauer/chat/server/Main.java b/server/src/main/java/eu/jonahbauer/chat/server/Main.java new file mode 100644 index 0000000..5f54c76 --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/Main.java @@ -0,0 +1,30 @@ +package eu.jonahbauer.chat.server; + +import eu.jonahbauer.chat.server.bot.ChatBotSupervisor; +import eu.jonahbauer.chat.server.management.impl.ChatBotManager; +import eu.jonahbauer.chat.server.management.impl.SocketManager; +import eu.jonahbauer.chat.server.socket.SocketSupervisor; + +import java.io.IOException; +import java.util.concurrent.CountDownLatch; + +public class Main { + + public static void main(String[] args) throws IOException, InterruptedException { + // initialize ChatBotManager and SocketManager + var _ = ChatBotManager.INSTANCE; + var _ = SocketManager.INSTANCE; + + var config = Config.load(); + ChatBotSupervisor.INSTANCE.start(config); + SocketSupervisor.INSTANCE.start(config); + + try { + // keep main thread running + new CountDownLatch(1).await(); + } catch (InterruptedException e) { + SocketSupervisor.INSTANCE.stop(); + ChatBotSupervisor.INSTANCE.stop(); + } + } +} \ No newline at end of file diff --git a/server/src/main/java/eu/jonahbauer/chat/server/bot/BotConfigDeserializer.java b/server/src/main/java/eu/jonahbauer/chat/server/bot/BotConfigDeserializer.java new file mode 100644 index 0000000..9b6bda7 --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/bot/BotConfigDeserializer.java @@ -0,0 +1,61 @@ +package eu.jonahbauer.chat.server.bot; + +import com.fasterxml.jackson.core.JsonParseException; +import com.fasterxml.jackson.core.JsonParser; +import com.fasterxml.jackson.core.JsonToken; +import com.fasterxml.jackson.databind.DeserializationContext; +import com.fasterxml.jackson.databind.deser.std.StdDeserializer; +import eu.jonahbauer.chat.bot.config.BotConfig; +import eu.jonahbauer.chat.bot.config.BotConfigurationException; + +import java.io.IOException; +import java.util.ArrayList; + +public class BotConfigDeserializer extends StdDeserializer { + + protected BotConfigDeserializer() { + super(BotConfig.class); + } + + @Override + public BotConfig deserialize(JsonParser p, DeserializationContext ctxt) throws IOException { + if (p.currentToken() == JsonToken.START_OBJECT) { + p.nextToken(); + } + + var builder = BotConfig.builder(); + while (p.currentToken() == JsonToken.FIELD_NAME) { + var key = p.currentName(); + + switch (p.nextToken()) { + case VALUE_STRING -> builder.value(key, p.getValueAsString()); + case VALUE_FALSE -> builder.value(key, false); + case VALUE_TRUE -> builder.value(key, true); + case VALUE_NULL -> {} + case VALUE_NUMBER_FLOAT -> builder.value(key, p.getDoubleValue()); + case VALUE_NUMBER_INT -> builder.value(key, p.getLongValue()); + case START_ARRAY -> { + var list = new ArrayList(); + while (p.nextToken() != JsonToken.END_ARRAY) { + if (p.currentToken() == JsonToken.VALUE_STRING) { + list.add(p.getValueAsString()); + } else { + throw new BotConfigurationException("Unsupported property type in array."); + } + } + builder.value(key, list); + } + case START_OBJECT -> throw new BotConfigurationException("Unsupported property type: object"); + default -> throw new BotConfigurationException("Unsupported property property type."); + } + + p.nextToken(); + } + + if (p.currentToken() == JsonToken.END_OBJECT) { + return builder.build(); + } + + throw new JsonParseException(p, "Unexpected token: " + p.currentToken(), p.currentLocation()); + } +} diff --git a/server/src/main/java/eu/jonahbauer/chat/server/bot/ChatBotSupervisor.java b/server/src/main/java/eu/jonahbauer/chat/server/bot/ChatBotSupervisor.java new file mode 100644 index 0000000..0bae7e6 --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/bot/ChatBotSupervisor.java @@ -0,0 +1,242 @@ +package eu.jonahbauer.chat.server.bot; + +import eu.jonahbauer.chat.bot.api.ChatBot; +import eu.jonahbauer.chat.bot.api.Message; +import eu.jonahbauer.chat.bot.config.BotConfig; +import eu.jonahbauer.chat.bot.impl.BotCreationException; +import eu.jonahbauer.chat.bot.impl.ChatBotFactory; +import eu.jonahbauer.chat.server.Config; +import eu.jonahbauer.chat.server.management.impl.ChatBotSupport; +import eu.jonahbauer.chat.server.socket.SocketSupervisor; +import lombok.extern.log4j.Log4j2; +import org.jetbrains.annotations.Blocking; +import org.jetbrains.annotations.Contract; +import org.jetbrains.annotations.NonBlocking; +import org.jetbrains.annotations.NotNull; + +import java.time.Duration; +import java.time.Instant; +import java.util.*; +import java.util.concurrent.ArrayBlockingQueue; +import java.util.concurrent.BlockingQueue; +import java.util.concurrent.atomic.AtomicBoolean; + +@Log4j2 +public enum ChatBotSupervisor { + INSTANCE; + + private static final Duration POST_EXPIRATION = Duration.ofSeconds(2); + private static final int MESSAGE_QUEUE_SIZE = 10; + + /** + * Map of running bots indexed by their name. + */ + private final @NotNull Map<@NotNull String, @NotNull RunningBot> bots = new HashMap<>(); + + /** + * Dispatches the message to all running bots. If a bot has too many messages queued up, the message may not be + * delivered to that bot. + * @param message the message + */ + public void onMessage(@NotNull Message.Post message) { + log.debug("Dispatching message: {}", message); + var expiration = Instant.now().plus(POST_EXPIRATION); + for (var entry : bots.entrySet()) { + var result = entry.getValue().offer(message, expiration); + if (!result) log.warn("A message was dropped because bot {} is busy.", entry.getKey()); + } + } + + /** + * Starts all bots defined in the given config. + * @param config a configuration + * @throws IllegalStateException if any bots are running already + */ + public synchronized void start(@NotNull Config config) { + if (!bots.isEmpty()) throw new IllegalStateException("start(Config) may not be used when any bots are running already"); + config.bots().forEach(this::start); + } + + /** + * Starts a bot with the given name and type. + * @param name the name of the bot (must be unique) + * @param type the fully qualified name of a class extending {@link ChatBot} + * @param channels the channels the bot will be active in + * @throws BotCreationException if the bot could not be created + */ + public synchronized void start(@NotNull String name, @NotNull String type, @NotNull List channels) { + start(name, BotConfig.builder().type(type).channels(channels).build()); + } + + /** + * Starts a bot with the given config under the specified name. + * @param name the name of the bot (must be unique) + * @param config the bot configuration + * @throws BotCreationException if the bot could not be created + */ + public synchronized void start(@NotNull String name, @NotNull BotConfig config) { + if (bots.containsKey(name)) throw new BotCreationException("Duplicate bot name: " + name); + bots.put(name, new RunningBot(name, config)); + } + + /** + * Stops the bot with the given name and waits for it to finish. Does nothing if no bot with that name exists. + * @param name the name of the bot + * @throws InterruptedException if any thread has interrupted the current thread. + */ + public void stop(@NotNull String name) throws InterruptedException { + RunningBot bot; + + synchronized (this) { + bot = bots.remove(name); + if (bot == null) return; + bot.stop(); + } + + bot.join(); + } + + /** + * Stops all currently running bots and waits for them to finish. + * @throws InterruptedException if any thread has interrupted the current thread. + */ + public void stop() throws InterruptedException { + var stopped = new ArrayList(); + + synchronized (this) { + for (RunningBot bot : bots.values()) { + stopped.add(bot); + bot.stop(); + } + bots.clear(); + } + + for (var bot : stopped) { + bot.join(); + } + } + + /** + * {@return a map of all currently running bots and their effective config} + */ + public @NotNull Map<@NotNull String, @NotNull BotConfig> getBots() { + var out = new TreeMap(); + for (var entry : bots.entrySet()) { + out.put(entry.getKey(), entry.getValue().getConfig()); + } + return Collections.unmodifiableMap(out); + } + + @Contract("_ -> new") + @SuppressWarnings("unchecked") + private static @NotNull ChatBotFactory getChatBotFactory(@NotNull String type) { + try { + var clazz = Class.forName(type); + if (!ChatBot.class.isAssignableFrom(clazz)) { + throw new BotCreationException("Not a chat bot type: " + type); + } + + return new ChatBotFactory<>((Class) clazz); + } catch (ClassNotFoundException ex) { + throw new BotCreationException("Unknown chat bot of type: " + type, ex); + } + } + + /** + * Manages a {@link ChatBot} instance running on its own thread. Takes care of recreating the bot after it threw + * an exception. {@linkplain ChatBotSupport#register(String, BotConfig) Registers} the bot during construction + * and {@linkplain ChatBotSupport#unregister(String) unregisters} it during {@link #stop()}. + */ + private static class RunningBot implements Runnable { + private final @NotNull String name; + private final @NotNull BotConfig config; + private final @NotNull ChatBotFactory factory; + + private final @NotNull Thread thread; + private final @NotNull BlockingQueue<@NotNull PendingPost> queue = new ArrayBlockingQueue<>(MESSAGE_QUEUE_SIZE); + private final AtomicBoolean stopped = new AtomicBoolean(); + private volatile ChatBot bot; + + public RunningBot(@NotNull String name, @NotNull BotConfig config) { + this.name = name; + this.config = config; + this.factory = getChatBotFactory(config.getType()); + + log.info("starting bot {}...", name); + ChatBotSupport.register(name, config); + this.thread = Thread.ofVirtual().name("ChatBot[" + name + "]").start(this); + } + + @Override + public void run() { + log.info("started bot {}", name); + while (!stopped.get()) { + var bot = factory.create(config); + this.bot = bot; + try { + loop(bot); + } catch (Exception ex) { + log.warn("bot {} threw an exception and will be recreated", name, ex); + continue; + } + + try { + bot.onStop(); + } catch (Exception ex) { + log.warn("bot {} threw an exception during shutdown", name, ex); + } + } + log.info("stopped bot {}", name); + } + + private void loop(@NotNull ChatBot bot) { + while (!stopped.get()) { + try { + var post = queue.take(); + if (Instant.now().isAfter(post.expiration())) { + log.warn("A message was dropped because it expired: {}", post); + } else if (bot.getConfig().isIgnoreBots() && post.post().bot()) { + log.debug("Ignoring message {} because bottag is set.", post.post()); + } else if (!bot.getConfig().getChannels().contains(post.post().channel())) { + log.debug("Ignoring message {} because channel is not listened to.", post.post()); + } else { + bot.onMessage(SocketSupervisor.INSTANCE, post.post()); + } + } catch (InterruptedException _) { + } + } + } + + @NonBlocking + public boolean offer(@NotNull Message.Post post, @NotNull Instant expiration) { + if (stopped.get()) return false; + return queue.offer(new PendingPost(post, expiration)); + } + + /** + * Stops the bot, unregistering it from the MBean server and preventing it from receiving any new messages. + */ + @NonBlocking + public void stop() { + if (stopped.getAndSet(true)) return; + log.info("stopping bot {}", name); + ChatBotSupport.unregister(name); + thread.interrupt(); + } + + /** + * Waits for the bot to finish execution. + */ + @Blocking + public void join() throws InterruptedException { + thread.join(); + } + + public @NotNull BotConfig getConfig() { + var bot = this.bot; + return bot != null ? bot.getConfig() : config; + } + + private record PendingPost(@NotNull Message.Post post, @NotNull Instant expiration) {} + } +} diff --git a/server/src/main/java/eu/jonahbauer/chat/server/management/impl/AdvancedMBean.java b/server/src/main/java/eu/jonahbauer/chat/server/management/impl/AdvancedMBean.java new file mode 100644 index 0000000..c23790d --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/management/impl/AdvancedMBean.java @@ -0,0 +1,157 @@ +package eu.jonahbauer.chat.server.management.impl; + +import eu.jonahbauer.chat.server.management.annotations.ManagedAttribute; +import eu.jonahbauer.chat.server.management.annotations.ManagedBean; +import eu.jonahbauer.chat.server.management.annotations.ManagedOperation; +import eu.jonahbauer.chat.server.management.annotations.ManagedParameter; +import lombok.extern.log4j.Log4j2; + +import javax.management.*; +import java.lang.reflect.Method; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; +import java.util.Locale; +import java.util.function.Function; + +@Log4j2 +public class AdvancedMBean extends StandardMBean { + public AdvancedMBean(T implementation) { + super(implementation, null, true); + } + + @Override + protected String getDescription(MBeanInfo info) { + var clazz = getMBeanInterface(); + var annotation = clazz.getAnnotation(ManagedBean.class); + if (annotation != null && !"".equals(annotation.description())) { + return annotation.description(); + } else { + return super.getDescription(info); + } + } + + @Override + protected int getImpact(MBeanOperationInfo info) { + if (info == null) return MBeanOperationInfo.UNKNOWN; + + var method = findOperation(info); + var annotation = method != null ? method.getAnnotation(ManagedOperation.class) : null; + if (annotation != null) { + return annotation.impact().getCode(); + } else { + return super.getImpact(info); + } + } + + @Override + protected String getDescription(MBeanOperationInfo info) { + if (info == null) return null; + + var method = findOperation(info); + var annotation = method != null ? method.getAnnotation(ManagedOperation.class) : null; + if (annotation != null && !"".equals(annotation.description())) { + return annotation.description(); + } else { + return super.getDescription(info); + } + } + + @Override + protected String getParameterName(MBeanOperationInfo op, MBeanParameterInfo param, int sequence) { + if (op == null) return super.getParameterName(op, param, sequence); + + var method = findOperation(op); + if (method == null) return super.getParameterName(op, param, sequence); + + var annotation = method.getParameters()[sequence].getAnnotation(ManagedParameter.class); + if (annotation != null && !"".equals(annotation.name())) { + return annotation.name(); + } else { + return super.getParameterName(op, param, sequence); + } + } + + @Override + protected String getDescription(MBeanOperationInfo op, MBeanParameterInfo param, int sequence) { + if (op == null) return super.getParameterName(op, param, sequence); + + var method = findOperation(op); + if (method == null) return super.getParameterName(op, param, sequence); + + var annotation = method.getParameters()[sequence].getAnnotation(ManagedParameter.class); + if (annotation != null && !"".equals(annotation.description())) { + return annotation.description(); + } else { + return super.getParameterName(op, param, sequence); + } + } + + @Override + protected String getDescription(MBeanAttributeInfo info) { + var name = info.getName(); + var type = getType(info, MBeanAttributeInfo::getType); + + var getter = findMethod(("boolean".equals(type) ? "is" : "get") + capitalize(name)); + if (getter != null) { + var annotation = getter.getAnnotation(ManagedAttribute.class); + if (annotation != null && !"".equals(annotation.description())) return annotation.description(); + } + + var setter = findMethod("set" + capitalize(name), type); + if (setter != null) { + var annotation = setter.getAnnotation(ManagedAttribute.class); + if (annotation != null && !"".equals(annotation.description())) return annotation.description(); + } + + return super.getDescription(info); + } + + private String getType(T info, Function getType) { + var descriptor = info.getDescriptor(); + if (descriptor == null) return getType.apply(info); + + try { + var originalType = (String) descriptor.getFieldValue(JMX.ORIGINAL_TYPE_FIELD); + return originalType.contains("<") ? originalType.substring(0, originalType.indexOf("<")) : originalType; + } catch (ClassCastException | RuntimeOperationsException ignored) { + return getType.apply(info); + } + } + + private Method findOperation(MBeanOperationInfo info) { + var name = info.getName(); + var params = new ArrayList(); + + for (var parameter : info.getSignature()) { + params.add(getType(parameter, MBeanParameterInfo::getType)); + } + + return findMethod(name, params); + } + + private Method findMethod(String name, String...parameters) { + return findMethod(name, Arrays.asList(parameters)); + } + + private Method findMethod(String name, List parameters) { + var clazz = getMBeanInterface(); + methods: for (var method : clazz.getMethods()) { + if (!method.getName().equals(name)) continue; + if (method.getParameterCount() != parameters.size()) continue; + + var parameterTypes = method.getParameterTypes(); + for (int i = 0; i < parameters.size(); i++) { + if (!parameters.get(i).equals(parameterTypes[i].getName())) continue methods; + } + + return method; + } + return null; + } + + private static String capitalize(String name) { + if (name.isEmpty()) return name; + return name.substring(0, 1).toUpperCase(Locale.ROOT) + name.substring(1); + } +} diff --git a/server/src/main/java/eu/jonahbauer/chat/server/management/impl/ChatBotManager.java b/server/src/main/java/eu/jonahbauer/chat/server/management/impl/ChatBotManager.java new file mode 100644 index 0000000..7cd5421 --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/management/impl/ChatBotManager.java @@ -0,0 +1,67 @@ +package eu.jonahbauer.chat.server.management.impl; + +import eu.jonahbauer.chat.bot.impl.BotCreationException; +import eu.jonahbauer.chat.bot.impl.ChatBotFactory; +import eu.jonahbauer.chat.server.bot.ChatBotSupervisor; +import eu.jonahbauer.chat.server.management.BotConfigSupport; +import eu.jonahbauer.chat.server.management.ChatBotManagerMXBean; +import lombok.SneakyThrows; +import org.jetbrains.annotations.NotNull; + +import java.lang.management.ManagementFactory; +import java.util.*; +import java.util.stream.Collectors; + +public enum ChatBotManager implements ChatBotManagerMXBean { + INSTANCE; + + @SneakyThrows + ChatBotManager() { + var server = ManagementFactory.getPlatformMBeanServer(); + server.registerMBean(new AdvancedMBean(this), ChatBotManagerMXBean.NAME); + } + + @Override + public void start(@NotNull String name, @NotNull String type, @NotNull List<@NotNull String> channels) { + try { + ChatBotSupervisor.INSTANCE.start(name, type, channels); + } catch (BotCreationException ex) { + throw new IllegalArgumentException(ex.getMessage(), ex.getCause()); + } + } + + @Override + public void start(@NotNull String name, @NotNull BotConfigSupport config) { + try { + ChatBotSupervisor.INSTANCE.start(name, config.unwrap()); + } catch (BotCreationException ex) { + throw new IllegalArgumentException(ex.getMessage(), ex.getCause()); + } + } + + @Override + public void stop(@NotNull String name) throws InterruptedException { + ChatBotSupervisor.INSTANCE.stop(name); + } + + @Override + public void stop() throws InterruptedException { + ChatBotSupervisor.INSTANCE.stop(); + } + + @Override + public @NotNull Map<@NotNull String, @NotNull BotConfigSupport> getBots() { + var out = new TreeMap(); + ChatBotSupervisor.INSTANCE.getBots().forEach((key, value) -> out.put(key, new BotConfigSupport(value))); + return Collections.unmodifiableMap(out); + } + + @Override + public @NotNull SortedSet<@NotNull String> getBotImplementations() { + return Collections.unmodifiableSortedSet( + ChatBotFactory.implementations().stream() + .map(Class::getCanonicalName) + .collect(Collectors.toCollection(TreeSet::new)) + ); + } +} diff --git a/server/src/main/java/eu/jonahbauer/chat/server/management/impl/ChatBotSupport.java b/server/src/main/java/eu/jonahbauer/chat/server/management/impl/ChatBotSupport.java new file mode 100644 index 0000000..19b67ed --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/management/impl/ChatBotSupport.java @@ -0,0 +1,44 @@ +package eu.jonahbauer.chat.server.management.impl; + +import eu.jonahbauer.chat.bot.config.BotConfig; +import eu.jonahbauer.chat.server.bot.ChatBotSupervisor; +import eu.jonahbauer.chat.server.management.BotConfigSupport; +import eu.jonahbauer.chat.server.management.ChatBotSupportMXBean; +import lombok.Getter; +import lombok.extern.log4j.Log4j2; + +import java.lang.management.ManagementFactory; + +@Getter +@Log4j2 +public class ChatBotSupport implements ChatBotSupportMXBean { + private final String name; + private final BotConfigSupport config; + + public static void register(String name, BotConfig config) { + try { + var server = ManagementFactory.getPlatformMBeanServer(); + server.registerMBean(new AdvancedMBean(new ChatBotSupport(name, config)), ChatBotSupportMXBean.getObjectName(name)); + } catch (Exception ex) { + log.error("Could not register bot as an MBean.", ex); + } + } + + public static void unregister(String name) { + try { + var server = ManagementFactory.getPlatformMBeanServer(); + server.unregisterMBean(ChatBotSupportMXBean.getObjectName(name)); + } catch (Exception ex) { + log.error("Could not unregister bot as an MBean.", ex); + } + } + + private ChatBotSupport(String name, BotConfig config) { + this.name = name; + this.config = new BotConfigSupport(config); + } + + public void stop() throws InterruptedException { + ChatBotSupervisor.INSTANCE.stop(name); + } +} diff --git a/server/src/main/java/eu/jonahbauer/chat/server/management/impl/SocketManager.java b/server/src/main/java/eu/jonahbauer/chat/server/management/impl/SocketManager.java new file mode 100644 index 0000000..38ed05f --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/management/impl/SocketManager.java @@ -0,0 +1,44 @@ +package eu.jonahbauer.chat.server.management.impl; + +import eu.jonahbauer.chat.server.management.SocketManagerMXBean; +import eu.jonahbauer.chat.server.socket.SocketSupervisor; +import lombok.SneakyThrows; +import org.jetbrains.annotations.NotNull; + +import java.lang.management.ManagementFactory; +import java.util.SortedSet; + +public enum SocketManager implements SocketManagerMXBean { + INSTANCE; + + @SneakyThrows + SocketManager() { + var server = ManagementFactory.getPlatformMBeanServer(); + server.registerMBean(new AdvancedMBean(this), SocketManagerMXBean.NAME); + } + + @Override + public void setCredentials(@NotNull String username, @NotNull String password) { + SocketSupervisor.INSTANCE.setAccount(username, password); + } + + @Override + public void start(@NotNull String channel) { + SocketSupervisor.INSTANCE.start(channel); + } + + @Override + public void stop(@NotNull String channel) throws InterruptedException { + SocketSupervisor.INSTANCE.stop(channel); + } + + @Override + public void stop() throws InterruptedException { + SocketSupervisor.INSTANCE.stop(); + } + + @Override + public @NotNull SortedSet<@NotNull String> getChannels() { + return SocketSupervisor.INSTANCE.getChannels(); + } +} diff --git a/server/src/main/java/eu/jonahbauer/chat/server/management/impl/SocketSupport.java b/server/src/main/java/eu/jonahbauer/chat/server/management/impl/SocketSupport.java new file mode 100644 index 0000000..1103b0c --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/management/impl/SocketSupport.java @@ -0,0 +1,64 @@ +package eu.jonahbauer.chat.server.management.impl; + +import eu.jonahbauer.chat.server.management.SocketState; +import eu.jonahbauer.chat.server.management.SocketSupportMXBean; +import eu.jonahbauer.chat.server.socket.SocketSupervisor; +import lombok.AccessLevel; +import lombok.Getter; +import lombok.RequiredArgsConstructor; +import lombok.extern.log4j.Log4j2; + +import java.lang.management.ManagementFactory; +import java.util.Date; + +@Log4j2 +@Getter +@RequiredArgsConstructor(access = AccessLevel.PRIVATE) +public class SocketSupport implements SocketSupportMXBean { + private final String channel; + + public static void register(String channel) { + try { + var server = ManagementFactory.getPlatformMBeanServer(); + server.registerMBean(new AdvancedMBean(new SocketSupport(channel)), SocketSupportMXBean.getObjectName(channel)); + } catch (Exception ex) { + log.error("Could not register socket as an MBean.", ex); + } + } + + public static void unregister(String name) { + try { + var server = ManagementFactory.getPlatformMBeanServer(); + server.unregisterMBean(SocketSupportMXBean.getObjectName(name)); + } catch (Exception ex) { + log.error("Could not unregister socket as an MBean.", ex); + } + } + + @Override + public Date getCooldownUntil() { + var cooldown = SocketSupervisor.INSTANCE.getCooldownUntil(channel); + return cooldown != null ? Date.from(cooldown) : null; + } + + @Override + public SocketState getState() { + return SocketSupervisor.INSTANCE.getState(channel); + } + + + @Override + public void stop() throws InterruptedException { + SocketSupervisor.INSTANCE.stop(channel); + } + + @Override + public void restart() { + SocketSupervisor.INSTANCE.restart(channel); + } + + @Override + public void send(String name, String message, boolean bottag, boolean publicid) { + SocketSupervisor.INSTANCE.send(channel, name, message, bottag, publicid); + } +} diff --git a/server/src/main/java/eu/jonahbauer/chat/server/socket/OutgoingMessage.java b/server/src/main/java/eu/jonahbauer/chat/server/socket/OutgoingMessage.java new file mode 100644 index 0000000..04c134f --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/socket/OutgoingMessage.java @@ -0,0 +1,21 @@ +package eu.jonahbauer.chat.server.socket; + +import com.fasterxml.jackson.annotation.JsonFormat; +import org.jetbrains.annotations.NotNull; + +import java.util.Objects; + +public record OutgoingMessage( + @NotNull String name, + @NotNull String message, + @NotNull String channel, + long delay, + @JsonFormat(shape = JsonFormat.Shape.NUMBER) boolean publicid, + @JsonFormat(shape = JsonFormat.Shape.NUMBER) boolean bottag +) { + public OutgoingMessage { + Objects.requireNonNull(channel, "channel"); + Objects.requireNonNull(name, "name"); + Objects.requireNonNull(message, "message"); + } +} diff --git a/server/src/main/java/eu/jonahbauer/chat/server/socket/SocketCreationException.java b/server/src/main/java/eu/jonahbauer/chat/server/socket/SocketCreationException.java new file mode 100644 index 0000000..544dca6 --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/socket/SocketCreationException.java @@ -0,0 +1,7 @@ +package eu.jonahbauer.chat.server.socket; + +import lombok.experimental.StandardException; + +@StandardException +public class SocketCreationException extends RuntimeException { +} diff --git a/server/src/main/java/eu/jonahbauer/chat/server/socket/SocketSupervisor.java b/server/src/main/java/eu/jonahbauer/chat/server/socket/SocketSupervisor.java new file mode 100644 index 0000000..aa6c489 --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/socket/SocketSupervisor.java @@ -0,0 +1,576 @@ +package eu.jonahbauer.chat.server.socket; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule; +import eu.jonahbauer.chat.bot.api.Chat; +import eu.jonahbauer.chat.bot.api.Message; +import eu.jonahbauer.chat.server.Config; +import eu.jonahbauer.chat.server.bot.ChatBotSupervisor; +import eu.jonahbauer.chat.server.management.SocketState; +import eu.jonahbauer.chat.server.management.impl.SocketSupport; +import lombok.SneakyThrows; +import lombok.extern.log4j.Log4j2; +import org.apache.logging.log4j.Level; +import org.jetbrains.annotations.NotNull; +import org.jetbrains.annotations.Nullable; + +import java.io.IOException; +import java.net.CookieManager; +import java.net.URI; +import java.net.http.HttpClient; +import java.net.http.HttpRequest; +import java.net.http.HttpRequest.BodyPublishers; +import java.net.http.HttpResponse; +import java.net.http.WebSocket; +import java.nio.ByteBuffer; +import java.time.Instant; +import java.util.*; +import java.util.concurrent.*; +import java.util.concurrent.locks.ReentrantLock; + +import static eu.jonahbauer.chat.server.util.UrlTemplateProcessor.URL; + +@Log4j2 +public enum SocketSupervisor implements Chat { + INSTANCE; + + private static final URI AUTH_SERVER = URI.create("https://chat.qed-verein.de/rubychat/account"); + private static final String ORIGIN = "https://chat.qed-verein.de"; + private static final String SERVER = "wss://chat.qed-verein.de/websocket?position=0&version=2&channel="; + private static final int PING_INTERVAL = 30; + + private static final ScheduledExecutorService SCHEDULER = Executors.newScheduledThreadPool(1, Thread.ofVirtual().name("SocketSupervisor").factory()); + private static final ObjectMapper MAPPER = new ObjectMapper().registerModule(new JavaTimeModule()); + + private volatile @Nullable Config.Account account; + private volatile @Nullable Credentials credentials; + + private final @NotNull CookieManager cookie = new CookieManager(); + private final @NotNull HttpClient client = HttpClient.newBuilder().cookieHandler(cookie).build(); + private final @NotNull ConcurrentMap<@NotNull String, @NotNull ChatClient> sockets = new ConcurrentHashMap<>(); + + public void setAccount(@NotNull Config.Account account) { + this.account = Objects.requireNonNull(account, "account"); + } + + public void setAccount(@NotNull String username, @NotNull String password) { + this.account = new Config.Account(username, password); + } + + @Override + public boolean send(@NotNull String channel, @NotNull String name, @NotNull String message, boolean bottag, boolean publicId) { + var socket = sockets.get(channel); + if (socket == null || !socket.isOpen()) { + log.error("Cannot deliver message to {}: not connected", channel); + return false; + } else { + var out = new OutgoingMessage(name, message, channel, socket.delay, publicId, bottag); + try { + socket.send(MAPPER.writeValueAsString(out)); + log.info("Sending message: {}", out); + return true; + } catch (JsonProcessingException e) { + log.error("Could not serialize message: {}", out, e); + return false; + } + } + } + + /** + * Starts all sockets defined in the given config. + * @param config a configuration + * @throws IllegalStateException if any sockets are already running + */ + public synchronized void start(@NotNull Config config) { + if (!this.sockets.isEmpty()) throw new IllegalStateException("start(Config) may not be used when any sockets are running already"); + + setAccount(config.account()); + config.channels().forEach(this::start); + } + + /** + * Starts a socket for the given channel. + * @param channel the channel + * @throws IllegalStateException if a socket is already connected to that channel + */ + public synchronized void start(@NotNull String channel) { + if (sockets.containsKey(channel)) throw new SocketCreationException("Duplicate channel: " + channel); + + var socket = new ChatClient(channel); + this.sockets.put(channel, socket); + } + + /** + * Forcefully restarts the socket for the given channel when it is on cooldown. + * @param channel the channel + * @throws IllegalStateException if the socket is not on cooldown + */ + public void restart(@NotNull String channel) { + var socket = sockets.get(channel); + if (socket != null) socket.restart(); + } + + public @Nullable SocketState getState(@NotNull String channel) { + var socket = sockets.get(channel); + return socket == null ? null : socket.getState(); + + } + + public @Nullable Instant getCooldownUntil(@NotNull String channel) { + var socket = sockets.get(channel); + return socket == null ? null : socket.getCooldownUntil(); + } + + /** + * Stops the socket for the given channel and waits for it to finish. + * @param channel the channel + * @throws InterruptedException if any thread has interrupted the current thread. + */ + public void stop(@NotNull String channel) throws InterruptedException { + var socket = sockets.get(channel); + if (socket == null) return; + + socket.stop(); + socket.join(); + } + + /** + * Stops all currently running sockets and waits for them to finish. + * @throws InterruptedException if any thread has interrupted the current thread. + */ + public void stop() throws InterruptedException { + var sockets = new ArrayList<>(this.sockets.values()); + + for (var socket : sockets) { + socket.stop(); + } + + for (var socket : sockets) { + socket.join(); + } + } + + public @NotNull SortedSet<@NotNull String> getChannels() { + return Collections.unmodifiableSortedSet(new TreeSet<>(sockets.keySet())); + } + + @SneakyThrows + private @NotNull Credentials login() { + var account = this.account; + if (account == null) throw new IllegalStateException("Account not initialized."); + + var credentials = this.credentials; + if (credentials != null) return credentials; + + var request = HttpRequest.newBuilder().uri(AUTH_SERVER) + .POST(BodyPublishers.ofString( + URL."username=\{account.username()}&password=\{account.password()}&version=20171030131648" + )) + .build(); + var response = client.send(request, HttpResponse.BodyHandlers.ofString()); + + if (response.statusCode() != 200) { + throw new IllegalArgumentException(STR."invalid credentials (status code: \{response.statusCode()})"); + } + + var body = response.body(); + if (!body.contains("success")) { + throw new IllegalArgumentException(STR."invalid credentials (\{body})"); + } + + var cookies = cookie.getCookieStore().get(AUTH_SERVER); + var userid = cookies.stream().filter(cookie -> cookie.getName().equals("userid")).findFirst(); + var pwhash = cookies.stream().filter(cookie -> cookie.getName().equals("pwhash")).findFirst(); + + if (userid.isEmpty() || pwhash.isEmpty()) { + throw new IllegalArgumentException(STR."invalid credentials (status code: \{response.statusCode()})"); + } + + this.credentials = credentials = new Credentials(userid.get().getValue(), pwhash.get().getValue()); + return credentials; + } + + private record Credentials(String userid, String pwhash) {} + + + private sealed interface ChatClientState { + + default void onEnter() {} + + default void send(@NotNull String message) { + throw new IllegalStateException(); + } + + default void restart() { + throw new IllegalStateException(); + } + + default void stop() { + abort(); + } + + default void abort() { + throw new IllegalStateException(); + } + + @NotNull SocketState getState(); + } + + private final class ChatClient implements WebSocket.Listener, ChatClientState { + private final String channel; + private final @NotNull ReentrantLock lock = new ReentrantLock(); + private final @NotNull CountDownLatch stopped = new CountDownLatch(1); + + private @NotNull ChatClientState state = new Created(); + private volatile long delay = -1; + + public ChatClient(@NotNull String channel) { + this.channel = channel; + SocketSupport.register(channel); + this.state.onEnter(); + } + + private void transition(@NotNull ChatClientState from, @NotNull ChatClientState to) { + lock.lock(); + try { + if (state == from) { + state = to; + state.onEnter(); + } + } finally { + lock.unlock(); + } + } + + public boolean isOpen() { + return getState() == SocketState.CONNECTED; + } + + public @Nullable Instant getCooldownUntil() { + return state instanceof Cooldown cooldown ? cooldown.until : null; + } + + @Override + public void send(@NotNull String message) { + lock.lock(); + try { + state.send(message); + } finally { + lock.unlock(); + } + } + + @Override + public void restart() { + lock.lock(); + try { + state.restart(); + } finally { + lock.unlock(); + } + } + + @Override + public void stop() { + lock.lock(); + try { + state.stop(); + } finally { + lock.unlock(); + } + } + + @Override + public void abort() { + lock.lock(); + try { + state.abort(); + } finally { + lock.unlock(); + } + } + + @Override + public @NotNull SocketState getState() { + return state.getState(); + } + + public void join() throws InterruptedException { + stopped.await(); + } + + private void withNamedThread(@NotNull ThrowingRunnable runnable) throws T { + var name = Thread.currentThread().getName(); + try { + Thread.currentThread().setName(STR."Socket[\{channel}]"); + runnable.run(); + } finally { + Thread.currentThread().setName(name); + } + } + + private R withNamedThread(@NotNull ThrowingSupplier supplier) throws T { + var name = Thread.currentThread().getName(); + try { + Thread.currentThread().setName(STR."Socket[\{channel}]"); + return supplier.get(); + } finally { + Thread.currentThread().setName(name); + } + } + + private interface ThrowingRunnable { + void run() throws T; + } + + private interface ThrowingSupplier { + R get() throws T; + } + + public final class Created implements ChatClientState { + @Override + public void onEnter() { + transition(this, new Connecting()); + } + + @Override + public @NotNull SocketState getState() { + return SocketState.CREATED; + } + } + + public final class Connecting implements ChatClientState { + private final int cooldown; + + public Connecting() { + this(1); + } + + public Connecting(int cooldown) { + this.cooldown = cooldown; + } + + @Override + public void onEnter() { + log.info("starting socket {}", channel); + try { + var connected = new Connected(); + transition(this, connected); + } catch (Exception ex) { + log.warn("socket {} failed with an exception.", channel, ex); + transition(this, new Cooldown(cooldown)); + } + } + + @Override + public @NotNull SocketState getState() { + return SocketState.CONNECTING; + } + } + + public final class Connected implements ChatClientState, WebSocket.Listener { + private final @NotNull WebSocket socket; + private @Nullable ScheduledFuture ping; + + private volatile boolean stopped; + + private final @NotNull List<@NotNull CharSequence> parts = new ArrayList<>(); + private volatile CompletableFuture message = new CompletableFuture<>(); + + public Connected() throws ExecutionException, InterruptedException { + var credentials = SocketSupervisor.this.login(); + this.socket = SocketSupervisor.this.client.newWebSocketBuilder() + .header("Origin", ORIGIN) + .header("Cookie", URL."userid=\{credentials.userid()}; pwhash=\{credentials.pwhash()}") + .buildAsync(URI.create(SERVER + URL."\{channel}"), this) + .get(); + } + + @Override + public void onOpen(@NotNull WebSocket webSocket) { + withNamedThread(() -> { + log.info("started socket {}", channel); + ping = SCHEDULER.scheduleAtFixedRate(this::ping, PING_INTERVAL, PING_INTERVAL, TimeUnit.SECONDS); + + WebSocket.Listener.super.onOpen(webSocket); + }); + } + + @Override + public @Nullable CompletionStage onText(@NotNull WebSocket webSocket, @NotNull CharSequence message, boolean last) { + return withNamedThread(() -> { + this.parts.add(message); + webSocket.request(1); + + if (last) { + onMessage(this.parts); + this.parts.clear(); + this.message.complete(null); + + CompletionStage out = this.message; + this.message = new CompletableFuture<>(); + return out; + } + + return this.message; + }); + } + + private void onMessage(@NotNull List<@NotNull CharSequence> parts) { + var text = String.join("", parts); + try { + var message = MAPPER.readValue(text, Message.class); + + var level = message instanceof Message.Post || message instanceof Message.Ack ? Level.INFO : Level.DEBUG; + log.log(level, "Received message: {}", message); + + if (message instanceof Message.Post post) { + delay = post.id() + 1; + ChatBotSupervisor.INSTANCE.onMessage(post); + } + } catch (JsonProcessingException e) { + log.warn("Could not parse as message: {}", text, e); + } + } + + @Override + public @Nullable CompletionStage onBinary(WebSocket webSocket, ByteBuffer data, boolean last) { + return withNamedThread(() -> { + log.warn("Socket {} received binary data.", channel); + return WebSocket.Listener.super.onBinary(webSocket, data, last); + }); + } + + @Override + public @Nullable CompletionStage onClose(@NotNull WebSocket webSocket, int statusCode, @NotNull String reason) { + return withNamedThread(() -> { + log.info("socket {} closed (code={}, reason={})", channel, statusCode, reason); + + lock.lock(); + try { + if (stopped) { + transition(this, new Stopped()); + } else { + transition(this, new Cooldown(1)); + } + } finally { + lock.unlock(); + } + return null; + }); + } + + @Override + public void onError(WebSocket webSocket, Throwable error) { + withNamedThread(() -> { + log.warn("Socket {} failed with an exception.", channel, error); + + lock.lock(); + try { + if (stopped) { + transition(this, new Stopped()); + } else { + transition(this, new Cooldown(1)); + } + } finally { + lock.unlock(); + } + }); + } + + @Override + public void send(@NotNull String message) { + if (stopped) throw new IllegalStateException(); + socket.sendText(message, true); + } + + @Override + public void abort() { + if (ping != null) ping.cancel(true); + socket.abort(); + transition(this, new Stopped()); + } + + @Override + public void stop() { + if (stopped) throw new IllegalStateException(); + log.info("stopping socket {}", channel); + if (ping != null) ping.cancel(true); + stopped = true; + socket.sendClose(WebSocket.NORMAL_CLOSURE, "ok"); + } + + private void ping() { + try { + socket.sendText(MAPPER.writeValueAsString(Message.PING), true); + log.debug("Sending message: {}", Message.PING); + } catch (IOException ex) { + log.error("Failed to send ping", ex); + } + } + + @Override + public @NotNull SocketState getState() { + return stopped ? SocketState.STOPPING : SocketState.CONNECTED; + } + } + + public final class Cooldown implements ChatClientState { + private final int cooldown; + + private Instant until; + private ScheduledFuture future; + + public Cooldown(int cooldown) { + this.cooldown = cooldown; + } + + @Override + public void onEnter() { + log.info("restarting socket {} in {} seconds", channel, cooldown); + + var nextCooldown = Math.min(3600, cooldown * 2); + this.until = Instant.now().plusSeconds(cooldown); + this.future = SCHEDULER.schedule(() -> transition(this, new Connecting(nextCooldown)), cooldown, TimeUnit.SECONDS); + } + + @Override + public void abort() { + log.info("stopping socket {}", channel); + future.cancel(true); + transition(this, new Stopped()); + } + + @Override + public void restart() { + future.cancel(true); + transition(this, new Connecting()); + } + + @Override + public @NotNull SocketState getState() { + return SocketState.COOLDOWN; + } + } + + public final class Stopped implements ChatClientState { + + @Override + public void onEnter() { + log.info("stopped socket {}", channel); + stopped.countDown(); + sockets.remove(channel, ChatClient.this); + SocketSupport.unregister(channel); + } + + @Override + public void abort() {} + + @Override + public @NotNull SocketState getState() { + return SocketState.STOPPED; + } + } + } +} diff --git a/server/src/main/java/eu/jonahbauer/chat/server/util/UrlTemplateProcessor.java b/server/src/main/java/eu/jonahbauer/chat/server/util/UrlTemplateProcessor.java new file mode 100644 index 0000000..b2a7170 --- /dev/null +++ b/server/src/main/java/eu/jonahbauer/chat/server/util/UrlTemplateProcessor.java @@ -0,0 +1,28 @@ +package eu.jonahbauer.chat.server.util; + +import java.net.URLEncoder; +import java.nio.charset.StandardCharsets; + +public enum UrlTemplateProcessor implements StringTemplate.Processor { + URL; + + @Override + public String process(StringTemplate template) throws RuntimeException { + var out = new StringBuilder(); + + var fragments = template.fragments(); + var values = template.values(); + + for (int i = 0, length = values.size(); i < length; i++) { + out.append(fragments.get(i)); + + var value = values.get(i); + if (value != null) { + out.append(URLEncoder.encode(value.toString(), StandardCharsets.UTF_8)); + } + } + out.append(fragments.getLast()); + + return out.toString(); + } +} diff --git a/server/src/main/java/module-info.java b/server/src/main/java/module-info.java new file mode 100644 index 0000000..b2f120d --- /dev/null +++ b/server/src/main/java/module-info.java @@ -0,0 +1,17 @@ +module eu.jonahbauer.chat.server { + exports eu.jonahbauer.chat.server; + opens eu.jonahbauer.chat.server.bot to com.fasterxml.jackson.databind; + opens eu.jonahbauer.chat.server.socket to com.fasterxml.jackson.databind; + + requires com.fasterxml.jackson.core; + requires com.fasterxml.jackson.databind; + requires com.fasterxml.jackson.datatype.jsr310; + requires eu.jonahbauer.chat.bot.api; + requires eu.jonahbauer.chat.server.management; + requires java.management; + requires java.net.http; + requires org.apache.logging.log4j; + requires org.jetbrains.annotations; + + requires static lombok; +} \ No newline at end of file diff --git a/server/src/main/resources/log4j2.xml b/server/src/main/resources/log4j2.xml new file mode 100644 index 0000000..8bb1efe --- /dev/null +++ b/server/src/main/resources/log4j2.xml @@ -0,0 +1,12 @@ + + + + + + + + + + + + \ No newline at end of file diff --git a/settings.gradle.kts b/settings.gradle.kts new file mode 100644 index 0000000..61319e6 --- /dev/null +++ b/settings.gradle.kts @@ -0,0 +1,18 @@ +@file:Suppress("UnstableApiUsage") + +rootProject.name = "ChatBot" + +include("server") +include("bot-api") +include("bots") +include("management") + +// Bots +include("bots:ping-bot") +project(":bots:ping-bot").name = "ping-bot" + +dependencyResolutionManagement { + repositories { + mavenCentral() + } +}