From 16d3985313dcf9d78dfcad397ac35d20d31693f9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Hasan=20Demirta=C5=9F?= Date: Sun, 23 Jun 2024 23:26:11 +0300 Subject: [PATCH] migrate to maven central. (#121) --- .github/release-drafter.yml | 47 +- .github/workflows/build.yml | 60 +- .github/workflows/changelog.yml | 24 +- .github/workflows/release.yml | 32 + .run/build.run.xml | 24 - README.md | 16 +- build.gradle.kts | 124 +-- buildSrc/build.gradle.kts | 18 + buildSrc/settings.gradle.kts | 3 + .../main/kotlin/net/infumia/gradle/common.kt | 41 + .../kotlin/net/infumia/gradle/protobuf.kt | 43 + .../main/kotlin/net/infumia/gradle/publish.kt | 52 ++ .../kotlin/net/infumia/gradle/spotless.kt | 87 ++ example/.gitignore | 1 - example/build.gradle.kts | 73 -- example/gradle/wrapper/gradle-wrapper.jar | Bin 43453 -> 0 bytes .../gradle/wrapper/gradle-wrapper.properties | 7 - example/gradlew | 249 ----- example/gradlew.bat | 92 -- example/settings.gradle.kts | 1 - .../src/main/java/tr/com/infumia/Main.java | 29 - example/tilt/Tiltfile | 2 - example/tilt/agones/Tiltfile | 27 - example/tilt/agones/values.yaml | 58 -- example/tilt/example/Tiltfile | 13 - example/tilt/example/charts/Chart.yaml | 4 - .../tilt/example/charts/templates/server.yaml | 23 - example/tilt/example/docker/Dockerfile | 7 - gradle.properties | 2 +- gradle/libs.versions.toml | 5 +- renovate.json | 26 +- settings.gradle.kts | 2 + .../java/net/infumia/agones4j/Agones.java | 870 ++++++++++++++++++ .../net/infumia/agones4j/AgonesCounter.java | 77 ++ .../java/net/infumia/agones4j/AgonesImpl.java | 431 +++++++++ .../java/net/infumia/agones4j/AgonesList.java | 79 ++ .../java/net/infumia/agones4j/Internal.java | 181 ++++ .../java/tr/com/infumia/agones4j/Agones.java | 854 ----------------- .../com/infumia/agones4j/AgonesCounter.java | 77 -- .../tr/com/infumia/agones4j/AgonesImpl.java | 382 -------- .../tr/com/infumia/agones4j/AgonesList.java | 79 -- .../tr/com/infumia/agones4j/Internal.java | 173 ---- src/main/proto/allocation/allocation.proto | 33 +- src/main/proto/sdk/alpha/alpha.proto | 172 ---- src/main/proto/sdk/beta/beta.proto | 179 +++- src/main/proto/sdk/sdk.proto | 8 +- 46 files changed, 2222 insertions(+), 2565 deletions(-) create mode 100644 .github/workflows/release.yml delete mode 100644 .run/build.run.xml create mode 100644 buildSrc/build.gradle.kts create mode 100644 buildSrc/settings.gradle.kts create mode 100644 buildSrc/src/main/kotlin/net/infumia/gradle/common.kt create mode 100644 buildSrc/src/main/kotlin/net/infumia/gradle/protobuf.kt create mode 100644 buildSrc/src/main/kotlin/net/infumia/gradle/publish.kt create mode 100644 buildSrc/src/main/kotlin/net/infumia/gradle/spotless.kt delete mode 100644 example/.gitignore delete mode 100644 example/build.gradle.kts delete mode 100644 example/gradle/wrapper/gradle-wrapper.jar delete mode 100644 example/gradle/wrapper/gradle-wrapper.properties delete mode 100644 example/gradlew delete mode 100644 example/gradlew.bat delete mode 100644 example/settings.gradle.kts delete mode 100644 example/src/main/java/tr/com/infumia/Main.java delete mode 100644 example/tilt/Tiltfile delete mode 100644 example/tilt/agones/Tiltfile delete mode 100644 example/tilt/agones/values.yaml delete mode 100644 example/tilt/example/Tiltfile delete mode 100644 example/tilt/example/charts/Chart.yaml delete mode 100644 example/tilt/example/charts/templates/server.yaml delete mode 100644 example/tilt/example/docker/Dockerfile create mode 100644 src/main/java/net/infumia/agones4j/Agones.java create mode 100644 src/main/java/net/infumia/agones4j/AgonesCounter.java create mode 100644 src/main/java/net/infumia/agones4j/AgonesImpl.java create mode 100644 src/main/java/net/infumia/agones4j/AgonesList.java create mode 100644 src/main/java/net/infumia/agones4j/Internal.java delete mode 100644 src/main/java/tr/com/infumia/agones4j/Agones.java delete mode 100644 src/main/java/tr/com/infumia/agones4j/AgonesCounter.java delete mode 100644 src/main/java/tr/com/infumia/agones4j/AgonesImpl.java delete mode 100644 src/main/java/tr/com/infumia/agones4j/AgonesList.java delete mode 100644 src/main/java/tr/com/infumia/agones4j/Internal.java diff --git a/.github/release-drafter.yml b/.github/release-drafter.yml index 14700a2..cda804b 100644 --- a/.github/release-drafter.yml +++ b/.github/release-drafter.yml @@ -1,38 +1,37 @@ -name-template: '$RESOLVED_VERSION' -tag-template: '$RESOLVED_VERSION' +--- +name-template: "$RESOLVED_VERSION" +tag-template: "$RESOLVED_VERSION" prerelease: true template: | # What's Changed $CHANGES categories: - - title: Breaking - label: breaking - - title: New - label: enhancement - - title: Bug Fixes - label: bug - - title: Maintenance - label: maintenance - - title: Documentation - label: documentation - - title: Dependency Updates - label: dependencies - +- title: "Breaking" + label: "breaking" +- title: "New" + label: "enhancement" +- title: "Bug Fixes" + label: "bug" +- title: "Maintenance" + label: "maintenance" +- title: "Documentation" + label: "documentation" +- title: "Dependency Updates" + label: "dependencies" version-resolver: major: labels: - - breaking + - "breaking" minor: labels: - - enhancement + - "enhancement" patch: labels: - - bug - - maintenance - - documentation - - dependencies - - security - + - "bug" + - "maintenance" + - "documentation" + - "dependencies" + - "security" exclude-labels: - - skip-changelog +- "skip-changelog" diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 4411561..1a7bcea 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -1,37 +1,31 @@ -name: Build - -on: +--- +name: "Build" +"on": pull_request: - branches: [ master ] - + branches: + - "master" jobs: build: - name: Build - runs-on: ubuntu-latest + name: "Build" + runs-on: "ubuntu-latest" steps: - - uses: actions/checkout@v4 - - - uses: actions/setup-java@v4 - with: - distribution: 'adopt' - java-version: '8' - - - uses: arduino/setup-protoc@v1 - - - uses: actions/cache@v4 - with: - path: ~/.gradle/caches - key: ${{ runner.os }}-gradle-cache-${{ hashFiles('**/*.gradle.kts') }} - restore-keys: | - ${{ runner.os }}-gradle- - - - uses: actions/cache@v4 - with: - path: ~/.gradle/wrapper - key: ${{ runner.os }}-gradle-wrapper-${{ hashFiles('**/gradle-wrapper.properties') }} - restore-keys: | - ${{ runner.os }}-gradlew- - - - run: | - chmod +x gradlew - ./gradlew build + - uses: "actions/checkout@v4" + - uses: "actions/setup-java@v4" + with: + distribution: "adopt" + java-version: "11" + - uses: "actions/cache@v4" + with: + path: "~/.gradle/caches" + key: "${{ runner.os }}-gradle-cache-${{ hashFiles('**/*.gradle.kts') }}" + restore-keys: | + ${{ runner.os }}-gradle- + - uses: "actions/cache@v4" + with: + path: "~/.gradle/wrapper" + key: "${{ runner.os }}-gradle-wrapper-${{ hashFiles('**/gradle-wrapper.properties') }}" + restore-keys: | + ${{ runner.os }}-gradlew- + - run: | + chmod +x gradlew + ./gradlew build diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml index fef8afa..1e80163 100644 --- a/.github/workflows/changelog.yml +++ b/.github/workflows/changelog.yml @@ -1,16 +1,16 @@ -name: Update Changelog - -on: +--- +name: "Update Changelog" +"on": push: - branches: [ master ] - + branches: + - "master" jobs: changelog: - name: Update Changelog - runs-on: ubuntu-latest - if: ${{ !contains(github.event.head_commit.message, 'skip-snapshot') }} + name: "Update Changelog" + runs-on: "ubuntu-latest" + if: "${{ !contains(github.event.head_commit.message, 'skip-snapshot') }}" steps: - - uses: release-drafter/release-drafter@master - id: release - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + - uses: "release-drafter/release-drafter@master" + id: "release" + env: + GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}" diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml new file mode 100644 index 0000000..0e5a0f7 --- /dev/null +++ b/.github/workflows/release.yml @@ -0,0 +1,32 @@ +--- +name: "Release" +"on": + release: + types: + - "released" +jobs: + build: + name: "Release" + runs-on: "ubuntu-latest" + steps: + - uses: "actions/checkout@v4" + - uses: "actions/setup-java@v4" + with: + distribution: "adopt" + java-version: "11" + - uses: "actions/cache@v4" + with: + path: "~/.gradle/caches" + key: "${{ runner.os }}-gradle-cache-${{ hashFiles('**/*.gradle.kts') }}" + restore-keys: | + ${{ runner.os }}-gradle- + - uses: "actions/cache@v4" + with: + path: "~/.gradle/wrapper" + key: "${{ runner.os }}-gradle-wrapper-${{ hashFiles('**/gradle-wrapper.properties') }}" + restore-keys: | + ${{ runner.os }}-gradlew- + - run: | + [[ "${{ github.event.release.tag_name }}" =~ ^[0-9]+(\.[0-9]+)*$ ]] || exit -1 + chmod +x gradlew + ./gradlew -Psign-required=true publish -Pversion="${{ github.event.release.tag_name }}" -PmavenCentralUsername="${{ secrets.MAVEN_CENTRAL_USERNAME }}" -PmavenCentralPassword="${{ secrets.MAVEN_CENTRAL_PASSWORD }}" -PsigningInMemoryKey="${{ secrets.GPG_PRIVATE_KEY_ARMORED }}" -PsigningInMemoryKeyPassword="${{ secrets.GPG_PASSPHRASE }}" diff --git a/.run/build.run.xml b/.run/build.run.xml deleted file mode 100644 index 87e14e1..0000000 --- a/.run/build.run.xml +++ /dev/null @@ -1,24 +0,0 @@ - - - - - - - true - true - false - false - - - \ No newline at end of file diff --git a/README.md b/README.md index 1d040bd..9c9ef01 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,20 @@ # agones4j -[![](https://jitpack.io/v/infumia/agones4j.svg)](https://jitpack.io/#infumia/agones4j) +[![Maven Central Version](https://img.shields.io/maven-central/v/net.infumia/agones4j)](https://central.sonatype.com/artifact/net.infumia/agones4j/) ## How to Use (Developers) ### Code ```groovy repositories { - maven("https://jitpack.io/") + mavenCentral() } dependencies { - // https://mvnrepository.com/artifact/io.grpc/grpc-stub/latest - implementation "io.grpc:grpc-stub:1.47.0" - implementation "io.grpc:grpc-protobuf:1.47.0" - implementation "io.grpc:grpc-netty:1.47.0" - implementation "com.github.infumia:agones4j:VERSION" + // Base module + implementation "net.infumia:agones4j:VERSION" + // Required, https://mvnrepository.com/artifact/io.grpc/grpc-stub/ + implementation "io.grpc:grpc-stub:1.64.0" + implementation "io.grpc:grpc-protobuf:1.64.0" + // Required, https://github.com/grpc/grpc-java/blob/master/gradle/libs.versions.toml#L46/ + implementation "org.apache.tomcat:annotations-api:1.64.0" } ``` ```java diff --git a/build.gradle.kts b/build.gradle.kts index 5996525..11afccd 100644 --- a/build.gradle.kts +++ b/build.gradle.kts @@ -1,118 +1,18 @@ -import com.google.protobuf.gradle.id +import net.infumia.gradle.applyProtobuf +import net.infumia.gradle.publish +import net.infumia.gradle.spotless -plugins { - java - `java-library` - `maven-publish` - alias(libs.plugins.protobuf) -} - -repositories { - mavenCentral() -} - -dependencies { - compileOnlyApi(libs.protobuf) - compileOnlyApi(libs.grpc.protobuf) - compileOnlyApi(libs.grpc.stub) - compileOnlyApi(libs.annotationsapi) -} - -sourceSets { - main { - java { - srcDirs("build/generated/source/proto/main/java") - } - resources { - srcDir("src/main/proto") - } - } -} +plugins { java } -protobuf { - protoc { artifact = libs.protoc.get().toString() } +publish() - plugins { - id("grpc") { - artifact = "io.grpc:protoc-gen-grpc-java:${libs.versions.grpc.get()}" - } - } +applyProtobuf() - generateProtoTasks { - all().forEach { - it.plugins { - id("grpc") { - outputSubDir = "java" - } - } - } - } -} - -tasks { - compileJava { - options.encoding = Charsets.UTF_8.name() - } - - javadoc { - options.encoding = Charsets.UTF_8.name() - (options as StandardJavadocDocletOptions).tags("todo") - exclude("**/allocation/**") - exclude("**/agones/**") - exclude("**/com/google/api/**") - exclude("**/grpc/**") - } - - val javadocJar by creating(Jar::class) { - dependsOn("javadoc") - archiveClassifier.set("javadoc") - from(javadoc) - } +spotless() - val sourcesJar by creating(Jar::class) { - dependsOn("classes") - archiveClassifier.set("sources") - duplicatesStrategy = DuplicatesStrategy.INCLUDE - from(sourceSets["main"].allSource) - } - - processResources { - duplicatesStrategy = DuplicatesStrategy.EXCLUDE - } -} - -publishing { - publications { - create("mavenJava") { - groupId = project.group.toString() - artifactId = "agones4j" - version = project.version.toString() - from(components["java"]) - artifact(tasks["sourcesJar"]) - artifact(tasks["javadocJar"]) - pom { - name.set("Agones4J") - description.set("Java wrapper for Agones client SDK.") - url.set("https://infumia.com.tr/") - licenses { - license { - name.set("MIT License") - url.set("https://mit-license.org/license.txt") - } - } - developers { - developer { - id.set("portlek") - name.set("Hasan Demirtaş") - email.set("utsukushihito@outlook.com") - } - } - scm { - connection.set("scm:git:git://github.com/infumia/agones4j.git") - developerConnection.set("scm:git:ssh://github.com/infumia/agones4j.git") - url.set("https://github.com/infumia/agones4j") - } - } - } - } +dependencies { + compileOnly(libs.protobuf) + compileOnly(libs.grpc.protobuf) + compileOnly(libs.grpc.stub) + compileOnly(libs.annotationsapi) } diff --git a/buildSrc/build.gradle.kts b/buildSrc/build.gradle.kts new file mode 100644 index 0000000..0467ad8 --- /dev/null +++ b/buildSrc/build.gradle.kts @@ -0,0 +1,18 @@ +plugins { `kotlin-dsl` } + +repositories { + mavenCentral() + gradlePluginPortal() +} + +dependencies { + // TODO: portlek, remove once + // https://github.com/gradle/gradle/issues/15383#issuecomment-779893192 is fixed + implementation(files(libs.javaClass.superclass.protectionDomain.codeSource.location)) + + implementation(libs.nexus.plugin) + implementation(libs.spotless.plugin) + implementation(libs.protobuf.plugin) +} + +kotlin { jvmToolchain(11) } diff --git a/buildSrc/settings.gradle.kts b/buildSrc/settings.gradle.kts new file mode 100644 index 0000000..65a9695 --- /dev/null +++ b/buildSrc/settings.gradle.kts @@ -0,0 +1,3 @@ +dependencyResolutionManagement { + versionCatalogs { create("libs") { from(files("../gradle/libs.versions.toml")) } } +} diff --git a/buildSrc/src/main/kotlin/net/infumia/gradle/common.kt b/buildSrc/src/main/kotlin/net/infumia/gradle/common.kt new file mode 100644 index 0000000..7aff6b9 --- /dev/null +++ b/buildSrc/src/main/kotlin/net/infumia/gradle/common.kt @@ -0,0 +1,41 @@ +package net.infumia.gradle + +import org.gradle.api.Project +import org.gradle.api.file.DuplicatesStrategy +import org.gradle.api.plugins.JavaPlugin +import org.gradle.api.plugins.JavaPluginExtension +import org.gradle.api.tasks.bundling.Jar +import org.gradle.jvm.toolchain.JavaLanguageVersion +import org.gradle.kotlin.dsl.* +import org.gradle.language.jvm.tasks.ProcessResources + +fun Project.applyCommon(javaVersion: Int = 8, sources: Boolean = true, javadoc: Boolean = true) { + apply() + + repositories.mavenCentral() + + extensions.configure { + toolchain { languageVersion = JavaLanguageVersion.of(javaVersion) } + } + + if (javadoc) { + val javadocJar by + tasks.creating(Jar::class) { + dependsOn("javadoc") + archiveClassifier.set("javadoc") + from(javadoc) + } + } + + if (sources) { + val sourceSets = extensions.getByType().sourceSets + val sourcesJar by + tasks.creating(Jar::class) { + dependsOn("classes") + archiveClassifier.set("sources") + from(sourceSets["main"].allSource) + } + } + + tasks { withType { duplicatesStrategy = DuplicatesStrategy.EXCLUDE } } +} diff --git a/buildSrc/src/main/kotlin/net/infumia/gradle/protobuf.kt b/buildSrc/src/main/kotlin/net/infumia/gradle/protobuf.kt new file mode 100644 index 0000000..958e4cb --- /dev/null +++ b/buildSrc/src/main/kotlin/net/infumia/gradle/protobuf.kt @@ -0,0 +1,43 @@ +package net.infumia.gradle + +import com.google.protobuf.gradle.ProtobufExtension +import com.google.protobuf.gradle.ProtobufPlugin +import com.google.protobuf.gradle.id +import org.gradle.accessors.dm.LibrariesForLibs +import org.gradle.api.Project +import org.gradle.api.plugins.JavaPluginExtension +import org.gradle.api.tasks.javadoc.Javadoc +import org.gradle.kotlin.dsl.* + +fun Project.applyProtobuf() { + val libs = project.rootProject.the() + + apply() + + extensions.getByType().sourceSets { + named("main") { + java { srcDirs("build/generated/source/proto/main/java") } + + resources { srcDir("src/main/proto") } + } + } + + extensions.configure { + protoc { artifact = libs.protoc.get().toString() } + + plugins { + id("grpc") { artifact = "io.grpc:protoc-gen-grpc-java:${libs.versions.grpc.get()}" } + } + + generateProtoTasks { all().forEach { it.plugins { id("grpc") { outputSubDir = "java" } } } } + } + + tasks { + withType { + exclude("**/allocation/**") + exclude("**/agones/**") + exclude("**/com/google/api/**") + exclude("**/grpc/**") + } + } +} diff --git a/buildSrc/src/main/kotlin/net/infumia/gradle/publish.kt b/buildSrc/src/main/kotlin/net/infumia/gradle/publish.kt new file mode 100644 index 0000000..d0241a8 --- /dev/null +++ b/buildSrc/src/main/kotlin/net/infumia/gradle/publish.kt @@ -0,0 +1,52 @@ +package net.infumia.gradle + +import com.vanniktech.maven.publish.MavenPublishBaseExtension +import com.vanniktech.maven.publish.MavenPublishPlugin +import com.vanniktech.maven.publish.SonatypeHost +import org.gradle.api.Project +import org.gradle.kotlin.dsl.* + +fun Project.publish( + moduleName: String? = null, + javaVersion: Int = 8, + sources: Boolean = true, + javadoc: Boolean = true +) { + applyCommon(javaVersion, sources, javadoc) + apply() + + val projectName = "agones4j${if (moduleName == null) "" else "-$moduleName"}" + val signRequired = project.hasProperty("sign-required") + + extensions.configure { + coordinates(project.group.toString(), projectName, project.version.toString()) + publishToMavenCentral(SonatypeHost.CENTRAL_PORTAL, true) + if (signRequired) { + signAllPublications() + } + + pom { + name.set("Agones4J") + description.set("Java wrapper for Agones client SDK.") + url.set("https://infumia.com.tr/") + licenses { + license { + name.set("MIT License") + url.set("https://mit-license.org/license.txt") + } + } + developers { + developer { + id.set("portlek") + name.set("Hasan Demirtaş") + email.set("utsukushihito@outlook.com") + } + } + scm { + connection.set("scm:git:git://github.com/infumia/agones4j.git") + developerConnection.set("scm:git:ssh://github.com/infumia/agones4j.git") + url.set("https://github.com/infumia/agones4j") + } + } + } +} diff --git a/buildSrc/src/main/kotlin/net/infumia/gradle/spotless.kt b/buildSrc/src/main/kotlin/net/infumia/gradle/spotless.kt new file mode 100644 index 0000000..cdb2e16 --- /dev/null +++ b/buildSrc/src/main/kotlin/net/infumia/gradle/spotless.kt @@ -0,0 +1,87 @@ +package net.infumia.gradle + +import com.diffplug.gradle.spotless.SpotlessExtension +import com.diffplug.gradle.spotless.SpotlessPlugin +import org.gradle.api.Project +import org.gradle.kotlin.dsl.* + +fun Project.spotless() { + repositories.mavenCentral() + + apply() + + extensions.configure { + isEnforceCheck = false + lineEndings = com.diffplug.spotless.LineEnding.UNIX + + val prettierConfig = + mapOf( + "prettier" to "3.3.2", + "prettier-plugin-java" to "2.6.0", + "prettier-plugin-toml" to "2.0.1", + ) + + yaml { + target(".github/**/*.yml") + endWithNewline() + trimTrailingWhitespace() + jackson().yamlFeature("LITERAL_BLOCK_STYLE", true).yamlFeature("SPLIT_LINES", false) + } + + json { + target("renovate.json") + endWithNewline() + trimTrailingWhitespace() + jackson() + } + + format("toml") { + target("gradle/libs.versions.toml") + endWithNewline() + trimTrailingWhitespace() + prettier(prettierConfig) + .config( + mapOf( + "parser" to "toml", + "plugins" to listOf("prettier-plugin-toml"), + ), + ) + } + + kotlin { + target( + "buildSrc/src/main/kotlin/**/*.kt", + "buildSrc/**/*.gradle.kts", + "*.gradle.kts", + ) + endWithNewline() + trimTrailingWhitespace() + ktfmt().kotlinlangStyle().configure { + it.setMaxWidth(100) + it.setBlockIndent(4) + it.setContinuationIndent(4) + it.setRemoveUnusedImport(true) + } + } + + java { + target( + "src/main/java/**/*.java", + ) + importOrder() + removeUnusedImports() + endWithNewline() + trimTrailingWhitespace() + prettier(prettierConfig) + .config( + mapOf( + "parser" to "java", + "tabWidth" to 4, + "useTabs" to false, + "printWidth" to 100, + "plugins" to listOf("prettier-plugin-java"), + ), + ) + } + } +} diff --git a/example/.gitignore b/example/.gitignore deleted file mode 100644 index a9763ce..0000000 --- a/example/.gitignore +++ /dev/null @@ -1 +0,0 @@ -tilt/example/docker/example.jar diff --git a/example/build.gradle.kts b/example/build.gradle.kts deleted file mode 100644 index c186209..0000000 --- a/example/build.gradle.kts +++ /dev/null @@ -1,73 +0,0 @@ -import java.nio.file.Path - -plugins { - java - id("io.github.goooler.shadow") version "8.1.7" -} - -group = "tr.com.infumia" -version = "1.0.0-SNAPSHOT" - -val tiltFolder: Path = rootProject.layout.projectDirectory.asFile.toPath().resolve("tilt") - -java { - toolchain { - languageVersion = JavaLanguageVersion.of(17) - } -} - -tasks { - jar { - archiveVersion = "" - } - - shadowJar { - archiveClassifier = "" - archiveVersion = "" - - mergeServiceFiles() - - manifest { - attributes( - "Main-Class" to "tr.com.infumia.Main" - ) - } - } - - val outputTask = shadowJar.get() - - register("copyJar") { - val inputJar = outputTask.outputs.files.singleFile - val outputFile = tiltFolder - .resolve("example") - .resolve("docker") - .resolve("example.jar") - .toFile() - - inputs.files(inputJar) - outputs.files(outputFile) - - doLast { - inputJar.copyTo(outputFile, true) - } - - dependsOn(shadowJar) - } - - build { - dependsOn(shadowJar) - finalizedBy("copyJar") - } -} - -repositories { - mavenCentral() - maven("https://jitpack.io/") -} - -dependencies { - implementation("io.grpc:grpc-stub:1.63.0") - implementation("io.grpc:grpc-protobuf:1.63.0") - implementation("io.grpc:grpc-netty:1.63.0") - implementation("com.github.infumia:agones4j:1.0.3") -} diff --git a/example/gradle/wrapper/gradle-wrapper.jar b/example/gradle/wrapper/gradle-wrapper.jar deleted file mode 100644 index e6441136f3d4ba8a0da8d277868979cfbc8ad796..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 43453 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 yu?e%!_ptzGB|8GrCfu%p?(_ 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
NnX)EH+Nua)3Y(c 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 '} - 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/example/gradlew.bat b/example/gradlew.bat deleted file mode 100644 index 25da30d..0000000 --- a/example/gradlew.bat +++ /dev/null @@ -1,92 +0,0 @@ -@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. 1>&2 -echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2 -echo. 1>&2 -echo Please set the JAVA_HOME variable in your environment to match the 1>&2 -echo location of your Java installation. 1>&2 - -goto fail - -:findJavaFromJavaHome -set JAVA_HOME=%JAVA_HOME:"=% -set JAVA_EXE=%JAVA_HOME%/bin/java.exe - -if exist "%JAVA_EXE%" goto execute - -echo. 1>&2 -echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2 -echo. 1>&2 -echo Please set the JAVA_HOME variable in your environment to match the 1>&2 -echo location of your Java installation. 1>&2 - -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/example/settings.gradle.kts b/example/settings.gradle.kts deleted file mode 100644 index a6260e8..0000000 --- a/example/settings.gradle.kts +++ /dev/null @@ -1 +0,0 @@ -rootProject.name = "example" diff --git a/example/src/main/java/tr/com/infumia/Main.java b/example/src/main/java/tr/com/infumia/Main.java deleted file mode 100644 index 9077635..0000000 --- a/example/src/main/java/tr/com/infumia/Main.java +++ /dev/null @@ -1,29 +0,0 @@ -package tr.com.infumia; - -import java.time.Duration; -import java.util.concurrent.Executors; -import java.util.concurrent.ScheduledExecutorService; -import java.util.concurrent.TimeUnit; -import tr.com.infumia.agones4j.Agones; - -public final class Main { - public static void main(final String[] args) throws InterruptedException { - final var agones = Agones.builder() - .withChannel() - .withHealthCheck(Duration.ofSeconds(1L), Duration.ofSeconds(1L)) - .withGameServerWatcherExecutor(Executors.newSingleThreadExecutor()) - .build(); - - agones.addGameServerWatcher(server -> System.out.println("Game server update: " + server)); - agones.ready(); - agones.startHealthChecking(); - - sleep(); - } - - private static void sleep() throws InterruptedException { - while (true) { - Thread.sleep(5L); - } - } -} diff --git a/example/tilt/Tiltfile b/example/tilt/Tiltfile deleted file mode 100644 index 36fc110..0000000 --- a/example/tilt/Tiltfile +++ /dev/null @@ -1,2 +0,0 @@ -include('agones/Tiltfile') -include('example/Tiltfile') diff --git a/example/tilt/agones/Tiltfile b/example/tilt/agones/Tiltfile deleted file mode 100644 index ddfc34b..0000000 --- a/example/tilt/agones/Tiltfile +++ /dev/null @@ -1,27 +0,0 @@ -load('ext://helm_remote', 'helm_remote') -load('ext://namespace', 'namespace_create') - -namespace_create('example') - -helm_remote( - 'agones', - namespace='agones-system', - create_namespace=True, - repo_url='https://agones.dev/chart/stable', - values=['./values.yaml'] -) - -k8s_kind('Fleet', image_json_path='{.spec.template.spec.template.spec.containers.*.image}') - -agones_resources = [ - 'agones-controller', - 'agones-extensions', - 'agones-ping', - 'agones-allocator', - 'agones-delete-agones-resources' -] - -for resource in agones_resources: - k8s_resource(resource, labels=['agones']) - -local_resource('agones', cmd='echo ready', resource_deps=agones_resources) diff --git a/example/tilt/agones/values.yaml b/example/tilt/agones/values.yaml deleted file mode 100644 index 6e554c9..0000000 --- a/example/tilt/agones/values.yaml +++ /dev/null @@ -1,58 +0,0 @@ -gameservers: - namespaces: - - example -agones: - image: - tag: 1.40.0 - generateTLS: false - tlsCert: | - -----BEGIN CERTIFICATE----- - MIIDlDCCAnygAwIBAgIRAKv3UYPE/9CMPyCyCwZXVEMwDQYJKoZIhvcNAQELBQAw - IjEgMB4GA1UEAxMXYWRtaXNzaW9uLWNvbnRyb2xsZXItY2EwHhcNMjQwNDI4MjEw - OTIxWhcNMzQwNDI2MjEwOTIxWjAkMSIwIAYDVQQDExlhZ29uZXMtY29udHJvbGxl - ci1zZXJ2aWNlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1cfb9jlb - f2pHH2VBRHqg3R3yI3x/WPTW27bg/tN0iZssr/aPKqHD9nYEG+QFwVfvuPwiD81r - DpNAXcN2LYNW3eBrSpplbB1bZZewOvvs8M+3MvusntbgwybnABD9a3yiVL5UHbjM - peaDWR/Im388PrrdRLFLkSUcxTYOoa+86+G3mrSWXhgapdjOqmQFZ6NIE6eqq2AG - poUEKQsu5/rrvJo04Brw+YlPvLloUNcLSSVoMtrE2dFKKjOTCETXy6QL9x/zW7zI - owT2mliF63cfS4HJ+PuKJWhfUuohAPK8q/MUWnLQ5W8ahnnuOpKiYrln82p+GUKD - Ro9kXHEo/EgjVQIDAQABo4HCMIG/MA4GA1UdDwEB/wQEAwIFoDAdBgNVHSUEFjAU - BggrBgEFBQcDAQYIKwYBBQUHAwIwDAYDVR0TAQH/BAIwADAfBgNVHSMEGDAWgBTM - gXTu8kAsr5GKkDUM5b1i7w69/TBfBgNVHREEWDBWgidhZ29uZXMtY29udHJvbGxl - ci1zZXJ2aWNlLmFnb25lcy1zeXN0ZW2CK2Fnb25lcy1jb250cm9sbGVyLXNlcnZp - Y2UuYWdvbmVzLXN5c3RlbS5zdmMwDQYJKoZIhvcNAQELBQADggEBAGVycraRDMAg - Ra9NTEgKrpXWcyMJlBnR/ikO4rpNMfjEWITUMEyRf7hNfp8+OLGMvv/R9Q8+edRl - gXtkCMuf853lKovgS7coTvRL4EYunaACmPixHXrGxYwnHRG/WV0o6NMZ2w5rZE0h - PRE5uGQmePiszyQjb+rnCIHtyhhP8QZIJtu87RTuqf4hYKJuBNty51HlnWYcpYK3 - g3XwCzMXI+yl+ZDlrG/RWj+4/Tk8KWRUUS8p3f33dqnIFQiupbylXmkfhc8/7tS0 - 4ciEHdSzH1ada1g+6KSLEr6pEqiXCR+/0n98EKjYcgNtUCrt8zYmnK2WXLbpugXQ - GZOtYHtORCQ= - -----END CERTIFICATE----- - tlsKey: | - -----BEGIN RSA PRIVATE KEY----- - MIIEogIBAAKCAQEA1cfb9jlbf2pHH2VBRHqg3R3yI3x/WPTW27bg/tN0iZssr/aP - KqHD9nYEG+QFwVfvuPwiD81rDpNAXcN2LYNW3eBrSpplbB1bZZewOvvs8M+3Mvus - ntbgwybnABD9a3yiVL5UHbjMpeaDWR/Im388PrrdRLFLkSUcxTYOoa+86+G3mrSW - XhgapdjOqmQFZ6NIE6eqq2AGpoUEKQsu5/rrvJo04Brw+YlPvLloUNcLSSVoMtrE - 2dFKKjOTCETXy6QL9x/zW7zIowT2mliF63cfS4HJ+PuKJWhfUuohAPK8q/MUWnLQ - 5W8ahnnuOpKiYrln82p+GUKDRo9kXHEo/EgjVQIDAQABAoIBAFIGn3V4SI05ABUh - yss1qidtaA0JpetB9nbTUr0z8VEjQyA5IHGhJAma+rSg5zxqO0blJ0Sc8ujiwx22 - 888+x8PWahRz7VpwYTM34pyfMSis6oQbYP6JQDBg6t1xp2ropXiSlr/Yul0ld1xo - /5X6WelP1bqXtID6lnFs7mxHe9udSkcyoidvOL2Dfqrs/yxFhFd5ESZuSi3t43yE - Uk5XFTra//XfR/A3eIxJHurEKbHqA+Cw0tGOMKFBproUZDcNQtGYeiNT4BvK6YaB - ojoytrYOTY0OOREY3IPm82OyKXo4FEwSv7lKoyTZZ4w/S09SM326WpSfTDXCur0C - pYbXHYECgYEA7DIRgx0cib72PdCbhLsjc1LUrbHL0kpwKqIr2pS9sDFqzXx2ehh1 - ISs98sbjeIz3LKfbgWA+0ALPQ/jR+svLt0+lC7duVKUscsQljsKIYOvaszeSay1z - 8Bw9BI6sk1hWVOmcuTr2HYCVuIoP19T6fmPSgRdUioaNp7D0uXJVI6UCgYEA57Sn - 8rdT5AIlaNEIBzo0nGdstUStJAHr/a8bnDajWQwrm7/DhFfPdJeyHc3YPnB7I3gN - 3hKi978pGVSFwWAEDBlTfQ2yARO0A7XVYOBbKD5U5SmUjMhpk2Mw5TM9nkGoiBkH - U9+M4HD2/7x0THOBWj1q/LZpWfalec6DbzfjMfECgYBfjnoLQ3HSQJG6vHTOpC9Z - br9gbjf5oefzN5zqV5bOe4+sBpigGNj6TFZJrDFHCjDNvjNOCjQfT6Ou6jF5d425 - Yd1x+goG8LQk0jonoYgvPfxC2U7BUahAEgyVlWs4SVrUC5c+UR5VHTp1aFW0ihO1 - ooj9dQTc7kbM+whnJlxPiQKBgFu0ImxrpmYte0TaxkSmAsCMJngvsB76K76BmXng - HhJWQMQpx2YPounQSAyHtbgwqGvHTiXAVoObQtblnvKD39YyB9sMmpDWjX6Sbtsi - sLFiyhLQvBxkDXTp4yYze4WxEtSao03MwmLqErfwjE7dwCpI+JkAUP3sIl3tIBPa - mK7hAoGAVGVYp+4oyjuj2UBYGV17ztVCbyvlUIe1sU8lrBlVV5kPSymeNFXqmQHw - LAzcqP+kdHu0mqYwh0TlcZPz34dVkVTtc1m6FkyWDVD5r6QuC5qARHt1EaVny7xT - ZEi5AuqxCOurvTLAgUizTLYz/rUes3/rDkKMSVYf0KbJX7pN6uU= - -----END RSA PRIVATE KEY----- diff --git a/example/tilt/example/Tiltfile b/example/tilt/example/Tiltfile deleted file mode 100644 index 0121bcf..0000000 --- a/example/tilt/example/Tiltfile +++ /dev/null @@ -1,13 +0,0 @@ -docker_build( - ref='local/infumia/agones4j-example', - context='./docker/', - dockerfile='./docker/Dockerfile' -) - -k8s_yaml(helm( - './charts/', - name='agones4j-example', - namespace='example' -)) - -k8s_resource('example-fleet', resource_deps=['agones']) diff --git a/example/tilt/example/charts/Chart.yaml b/example/tilt/example/charts/Chart.yaml deleted file mode 100644 index f03b727..0000000 --- a/example/tilt/example/charts/Chart.yaml +++ /dev/null @@ -1,4 +0,0 @@ -apiVersion: v2 -version: 1.0.0 -name: agones4j-example -type: application diff --git a/example/tilt/example/charts/templates/server.yaml b/example/tilt/example/charts/templates/server.yaml deleted file mode 100644 index d9ed5a5..0000000 --- a/example/tilt/example/charts/templates/server.yaml +++ /dev/null @@ -1,23 +0,0 @@ ---- -apiVersion: agones.dev/v1 -kind: Fleet -metadata: - name: example-fleet - namespace: {{ .Release.Namespace }} -spec: - replicas: 1 - scheduling: Distributed - template: - spec: - health: - initialDelaySeconds: 5 - periodSeconds: 3 - template: - metadata: - labels: - app: example-game-server - spec: - containers: - - name: minecraft - imagePullPolicy: Never - image: local/infumia/agones4j-example:latest diff --git a/example/tilt/example/docker/Dockerfile b/example/tilt/example/docker/Dockerfile deleted file mode 100644 index a0941ce..0000000 --- a/example/tilt/example/docker/Dockerfile +++ /dev/null @@ -1,7 +0,0 @@ -FROM eclipse-temurin:17-jre - -WORKDIR /app - -COPY example.jar example.jar - -CMD ["java", "-jar", "example.jar"] diff --git a/gradle.properties b/gradle.properties index 368c19e..4418a7d 100644 --- a/gradle.properties +++ b/gradle.properties @@ -1,5 +1,5 @@ name=agones4j -group=tr.com.infumia +group=net.infumia version=1.0.0-SNAPSHOT org.gradle.parallel=true diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml index c193644..847ddef 100644 --- a/gradle/libs.versions.toml +++ b/gradle/libs.versions.toml @@ -9,5 +9,6 @@ grpc-stub = { module = "io.grpc:grpc-stub", version.ref = "grpc" } grpc-protobuf = { module = "io.grpc:grpc-protobuf", version.ref = "grpc" } annotationsapi = { module = "org.apache.tomcat:annotations-api", version = "6.0.53" } -[plugins] -protobuf = { id = "com.google.protobuf", version = "0.9.4" } +nexus-plugin = { module = "com.vanniktech:gradle-maven-publish-plugin", version = "0.29.0" } +spotless-plugin = { module = "com.diffplug.spotless:spotless-plugin-gradle", version = "6.25.0" } +protobuf-plugin = { module = "com.google.protobuf:protobuf-gradle-plugin", version = "0.9.4" } diff --git a/renovate.json b/renovate.json index 8f82b0a..2e0f7b2 100644 --- a/renovate.json +++ b/renovate.json @@ -1,18 +1,10 @@ { - "extends": [ - "config:base" - ], - "labels": ["dependencies"], - "schedule": [ - "after 9am" - ], - "packageRules": [ - { - "matchUpdateTypes": ["major", "minor", "patch", "pin", "digest", "lockFileMaintenance", "rollback", "bump"], - "automerge": true - } - ], - "ignorePaths": [ - "example" - ] -} + "extends": [ "config:base" ], + "labels": [ "dependencies" ], + "schedule": [ "after 9am" ], + "packageRules": [ { + "matchUpdateTypes": [ "major", "minor", "patch", "pin", "digest", "lockFileMaintenance", "rollback", "bump" ], + "automerge": true + } ], + "ignorePaths": [ "example" ] +} \ No newline at end of file diff --git a/settings.gradle.kts b/settings.gradle.kts index b68873d..7c44e84 100644 --- a/settings.gradle.kts +++ b/settings.gradle.kts @@ -1 +1,3 @@ +plugins { id("org.gradle.toolchains.foojay-resolver-convention") version "0.8.0" } + rootProject.name = "agones4j" diff --git a/src/main/java/net/infumia/agones4j/Agones.java b/src/main/java/net/infumia/agones4j/Agones.java new file mode 100644 index 0000000..ea58357 --- /dev/null +++ b/src/main/java/net/infumia/agones4j/Agones.java @@ -0,0 +1,870 @@ +package net.infumia.agones4j; + +import agones.dev.sdk.Sdk; +import agones.dev.sdk.alpha.Alpha; +import io.grpc.ManagedChannel; +import io.grpc.ManagedChannelBuilder; +import io.grpc.stub.StreamObserver; +import java.time.Duration; +import java.util.List; +import java.util.Objects; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.function.Consumer; + +/** + * The interface provides methods to interact with Agones. + */ +public interface Agones extends AutoCloseable { + /** + * Retrieves a new instance of the Agones builder. + * + * @return A new instance of the Agones builder. + */ + static Agones.Builder builder() { + return new AgonesImpl.Builder(); + } + + /** + * Checks if it can watch game server. + *

+ * To enable game server watcher, use {@link Builder#withGameServerWatcherExecutor(ExecutorService)}. + * + * @return {@code true} if it can watch game server, {@code false} otherwise. + */ + boolean canWatchGameServer(); + + /** + * Adds a game server watcher. + *

+ * Game server watchers are called whenever a game server event occurs. + * + * @param watcher A consumer that represents the game server watcher. + * + * @see #canWatchGameServer() + */ + void addGameServerWatcher(Consumer watcher); + + /** + * Checks if it can use health check system of Agones. + *

+ * To enable health check, use {@link Builder#withHealthCheck(Duration, Duration)}. + * + * @return {@code true} if it can use health check system of Agones, {@code false} otherwise. + */ + boolean canHealthCheck(); + + /** + * Starts the health checking. + * + * @throws IllegalStateException if the health check interval not specified. + * @see #canHealthCheck() + */ + void startHealthChecking(); + + /** + * Stops the health checking. + */ + void stopHealthChecking(); + + /** + * Creates a new health check stream. + * + * @param response the response from server. + * + * @return a stream observer to send health check requests. + * + * @see #canHealthCheck() + */ + StreamObserver healthCheckStream(StreamObserver response); + + /** + * Creates a new health check stream. + * + * @return a stream observer to send health check requests. + * + * @see #canHealthCheck() + */ + default StreamObserver healthCheckStream() { + return this.healthCheckStream(Internal.observerEmpty()); + } + + /** + * Call to self Allocation the GameServer. + * + * @param response the response from server. + */ + void allocate(StreamObserver response); + + /** + * Call to self Allocation the GameServer. + */ + default void allocate() { + this.allocate(Internal.observerEmpty()); + } + + /** + * Call to self Allocation the GameServer. + * + * @return A future that represents the result of the allocation operation. + */ + default CompletableFuture allocateFuture() { + return Internal.observerToFuture(this::allocate); + } + + /** + * Retrieves the current GameServer data. + * + * @param response the response from server. + */ + void getGameServer(StreamObserver response); + + /** + * Retrieves the current GameServer data. + * + * @return A future that represents the current game server. + */ + default CompletableFuture getGameServerFuture() { + return Internal.observerToFuture(this::getGameServer); + } + + /** + * Call when the GameServer is ready. + * + * @param response the response from server. + */ + void ready(StreamObserver response); + + /** + * Call when the GameServer is ready. + */ + default void ready() { + this.ready(Internal.observerEmpty()); + } + + /** + * Call when the @link Sdk.GameServer is ready. + * + * @return A future that represents the result of the ready operation. + */ + default CompletableFuture readyFuture() { + return Internal.observerToFuture(this::ready); + } + + /** + * Marks the @link Sdk.GameServer as the Reserved state for Duration. + * + * @param duration the duration to mark. + * @param response the response from server. + */ + void reserve(Duration duration, StreamObserver response); + + /** + * Marks the @link Sdk.GameServer as the Reserved state for Duration. + * + * @param duration the duration to mark. + */ + default void reserve(final Duration duration) { + this.reserve(duration, Internal.observerEmpty()); + } + + /** + * Marks the @link Sdk.GameServer as the Reserved state for Duration. + * + * @param duration the duration to mark. + * + * @return A future that represents the result of the reserve operation. + */ + default CompletableFuture reserveFuture(final Duration duration) { + return Internal.observerToFuture(response -> this.reserve(duration, response)); + } + + /** + * Call when the @link Sdk.GameServer is shutting down. + * + * @param response the response from server. + */ + void shutdown(StreamObserver response); + + /** + * Call when the @link Sdk.GameServer is shutting down. + */ + default void shutdown() { + this.shutdown(Internal.observerEmpty()); + } + + /** + * Call when the @link Sdk.GameServer is shutting down. + * + * @return A future that represents the result of the shutdown operation. + */ + default CompletableFuture shutdownFuture() { + return Internal.observerToFuture(this::shutdown); + } + + /** + * Apply an Annotation to the backing @link Sdk.GameServer metadata. + * + * @param key the key to apply. + * @param value the value to apply. + * @param observer the observer to apply. + */ + void setAnnotation(String key, String value, StreamObserver observer); + + /** + * Apply an Annotation to the backing @link Sdk.GameServer metadata. + * + * @param key the key to apply. + * @param value the value to apply. + */ + default void setAnnotation(final String key, final String value) { + this.setAnnotation(key, value, Internal.observerEmpty()); + } + + /** + * Apply an Annotation to the backing @link Sdk.GameServer metadata. + * + * @param key the key to apply. + * @param value the value to apply. + * + * @return A future that represents the result of the set annotation operation. + */ + default CompletableFuture setAnnotationFuture(final String key, final String value) { + return Internal.observerToFuture(response -> this.setAnnotation(key, value, response)); + } + + /** + * Apply a Label to the backing @link Sdk.GameServer metadata. + * + * @param key the key to apply. + * @param value the value to apply. + * @param response the response from server. + */ + void setLabel(String key, String value, StreamObserver response); + + /** + * Apply a Label to the backing @link Sdk.GameServer metadata. + * + * @param key the key to apply. + * @param value the value to apply. + */ + default void setLabel(final String key, final String value) { + this.setLabel(key, value, Internal.observerEmpty()); + } + + /** + * Apply a Label to the backing @link Sdk.GameServer metadata. + * + * @param key the key to apply. + * @param value the value to apply. + * + * @return A future that represents the result of the set label operation. + */ + default CompletableFuture setLabelFuture(final String key, final String value) { + return Internal.observerToFuture(response -> this.setLabel(key, value, response)); + } + + /** + * Returns the list of the currently connected player ids. + *

+ * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the + * @link Sdk.GameServer status resource. + *

+ * If GameServer#Status#PlayerStatus#getIdsList is set manually through the Kubernetes API, use + * {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to view this value. + * + * @param response the response from server. + */ + void getConnectedPlayersFuture(StreamObserver> response); + + /** + * Returns the list of the currently connected player ids. + *

+ * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the + * @link Sdk.GameServer status resource. + *

+ * If GameServer#Status#PlayerStatus#getIdsList is set manually through the Kubernetes API, use + * {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to view this value. + * + * @return A future that represents the list of the currently connected player ids. + */ + default CompletableFuture> getConnectedPlayersFuture() { + return Internal.observerToFuture(this::getConnectedPlayersFuture); + } + + /** + * Increases the SDK’s stored player count by one, and appends this playerID to GameServer#Status#PlayerStatus#getIdsList. + *

+ * GameServer#Status#PlayerStatus#getCount and GameServer#Status#PlayerStatus#getIdsList are then set to update the player count and id list a second from now, unless there is already an update pending, in which case the update joins that batch operation. + *

+ * The response returns true and adds the playerID to the list of playerIDs if this playerID was not already in the list of connected playerIDs. + *

+ * If the playerID exists within the list of connected playerIDs, will return false, and the list of connected playerIDs will be left unchanged. + *

+ * An error will be returned if the playerID was not already in the list of connected playerIDs but the player capacity for the server has been reached. + * The playerID will not be added to the list of playerIDs. + *

+ * WARNING: Do not use this method if you are manually managing GameServer#Status#PlayerStatus#getIdsList and GameServer#Status#PlayerStatus#getCount through the Kubernetes API, as indeterminate results will occur. + * + * @param playerId the player id to connect. + * @param response the response from server. + */ + void playerConnect(String playerId, StreamObserver response); + + /** + * Increases the SDK’s stored player count by one, and appends this playerID to GameServer#Status#PlayerStatus#getIdsList. + * GameServer#Status#PlayerStatus#getCount and GameServer#Status#PlayerStatus#getIdsList are then set to update the player count and id list a second from now, unless there is already an update pending, in which case the update joins that batch operation. + *

+ * If the playerID exists within the list of connected playerIDs, will return false, and the list of connected playerIDs will be left unchanged. + *

+ * An error will be returned if the playerID was not already in the list of connected playerIDs but the player capacity for the server has been reached. + * The playerID will not be added to the list of playerIDs. + *

+ * WARNING: Do not use this method if you are manually managing GameServer#Status#PlayerStatus#getIdsList and GameServer#Status#PlayerStatus#getCount through the Kubernetes API, as indeterminate results will occur. + * + * @param playerId the player id to connect. + * + * @return A future that represents the result of the player connect operation. + */ + default CompletableFuture playerConnectFuture(final String playerId) { + return Internal.observerToFuture(response -> this.playerConnect(playerId, response)); + } + + /** + * Decreases the SDK’s stored player count by one, and removes the playerID from GameServer#Status#PlayerStatus#getIdsList + * GameServer#Status#PlayerStatus#getCount and GameServer#Status#PlayerStatus#getIdsList are then set to update the player count and id list a second from now, unless there is already an update pending, in which case the update joins that batch operation. + *

+ * The response returns true and removes the playerID from the list of connected playerIDs if the playerID value exists within the list. + *

+ * If the playerID was not in the list of connected playerIDs, the call will return false, and the connected playerID list will be left unchanged. + *

+ * WARNING: Do not use this method if you are manually managing GameServer#Status#PlayerStatus#getIdsList and GameServer#Status#PlayerStatus#getCount through the Kubernetes API, as indeterminate results will occur. + * + * @param playerId the player id to disconnect. + * @param response the response from server. + */ + void playerDisconnect(String playerId, StreamObserver response); + + /** + * Decreases the SDK’s stored player count by one, and removes the playerID from GameServer#Status#PlayerStatus#getIdsList + * GameServer#Status#PlayerStatus#getCount and GameServer#Status#PlayerStatus#getIdsList are then set to update the player count and id list a second from now, unless there is already an update pending, in which case the update joins that batch operation. + *

+ * If the playerID was not in the list of connected playerIDs, the call will return false, and the connected playerID list will be left unchanged. + *

+ * WARNING: Do not use this method if you are manually managing GameServer#Status#PlayerStatus#getIdsList and GameServer#Status#PlayerStatus#getCount through the Kubernetes API, as indeterminate results will occur. + * + * @param playerId the player id to disconnect. + * + * @return A future that represents the result of the player disconnect operation. + */ + default CompletableFuture playerDisconnectFuture(final String playerId) { + return Internal.observerToFuture(response -> this.playerDisconnect(playerId, response)); + } + + /** + * Returns if the playerID is currently connected to the @link Sdk.GameServer. + *

+ * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the @link Sdk.GameServer status resource. + *

+ * If GameServer#Status#PlayerStatus#getIdsList is set manually through the Kubernetes API, use {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to determine connected status. + * + * @param playerId the player id to return. + * @param response the response from server. + */ + void isPlayerConnected(String playerId, StreamObserver response); + + /** + * Returns if the playerID is currently connected to the @link Sdk.GameServer. + *

+ * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the @link Sdk.GameServer status resource. + *

+ * If GameServer#Status#PlayerStatus#getIdsList is set manually through the Kubernetes API, use {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to determine connected status. + * + * @param playerId the player id to return. + * + * @return A future that represents the result of the is player connected operation. + */ + default CompletableFuture isPlayerConnected(final String playerId) { + return Internal.observerToFuture(response -> this.isPlayerConnected(playerId, response)); + } + + /** + * Update the GameServer#Status#PlayerStatus#getCapacity value with a new capacity. + * + * @param capacity the capacity to update. + * @param response the response from server. + */ + void setPlayerCapacity(long capacity, StreamObserver response); + + /** + * Update the GameServer#Status#PlayerStatus#getCapacity value with a new capacity. + * + * @param capacity the capacity to update. + * + * @return A future that represents the result of the set player capacity operation. + */ + default CompletableFuture setPlayerCapacityFuture(final long capacity) { + return Internal.observerToFuture(response -> this.setPlayerCapacity(capacity, response)); + } + + /** + * Retrieves the current player capacity. + *

+ * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the @link Sdk.GameServer status resource. + *

+ * If GameServer#Status#PlayerStatus#getCapacity is set manually through the Kubernetes API, use {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to view this value. + * + * @param response the response from server. + */ + void getPlayerCapacity(StreamObserver response); + + /** + * Retrieves the current player capacity. + *

+ * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the @link Sdk.GameServer status resource. + *

+ * If GameServer#Status#PlayerStatus#getCapacity is set manually through the Kubernetes API, use {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to view this value. + * + * @return A future that represents the current player capacity. + */ + default CompletableFuture getPlayerCapacityFuture() { + return Internal.observerToFuture(this::getPlayerCapacity); + } + + /** + * Retrieves the current player count. + *

+ * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the @link Sdk.GameServer status resource. + *

+ * If GameServer#Status#PlayerStatus#getCount is set manually through the Kubernetes API, use {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to view this value. + * + * @param response the response from server. + */ + void getPlayerCount(StreamObserver response); + + /** + * Retrieves the current player count. + *

+ * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the @link Sdk.GameServer status resource. + *

+ * If GameServer#Status#PlayerStatus#getCount is set manually through the Kubernetes API, use {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to view this value. + * + * @return A future that represents the current player count. + */ + default CompletableFuture getPlayerCountFuture() { + return Internal.observerToFuture(this::getPlayerCount); + } + + /** + * gets a list. + *

+ * returns NOT_FOUND if the List does not exist. + * + * @param name the name to get. + * @param response the response from server. + */ + void getList(String name, StreamObserver response); + + /** + * gets a list. + *

+ * Returns NOT_FOUND if the List does not exist. + * + * @param name the name to get. + * + * @return the list. + */ + default CompletableFuture getList(final String name) { + return Internal.observerToFuture(response -> this.getList(name, response)); + } + + /** + * Adds a value to a list and returns updated list. + *

+ * Returns NOT_FOUND if the list does not exist. + *

+ * Returns ALREADY_EXISTS if the value is already in the list. + *

+ * Returns OUT_OF_RANGE if the list is already at Capacity. + * + * @param name the name to add. + * @param value the value to add. + * @param response the response from server. + */ + void addList(String name, String value, StreamObserver response); + + /** + * Adds a value to a list and returns updated list. + *

+ * Returns NOT_FOUND if the list does not exist. + *

+ * Returns ALREADY_EXISTS if the value is already in the list. + *

+ * Returns OUT_OF_RANGE if the list is already at Capacity. + * + * @param name the name to add. + * @param value the value to add. + * + * @return the updated list. + */ + default CompletableFuture addListFuture(final String name, final String value) { + return Internal.observerToFuture(response -> this.addList(name, value, response)); + } + + /** + * Removes a value from a list and returns updated list. + *

+ * Returns NOT_FOUND if the list does not exist. + *

+ * Returns NOT_FOUND if the value is not in the list. + * + * @param name the name to remove. + * @param value the value to remove. + * @param response the response from server. + */ + void removeList(String name, String value, StreamObserver response); + + /** + * Removes a value from a list and returns updated list. + *

+ * Returns NOT_FOUND if the list does not exist. + *

+ * Returns NOT_FOUND if the value is not in the list. + * + * @param name the name to remove. + * @param value the value to remove. + * + * @return the updated list. + */ + default CompletableFuture removeListFuture(final String name, final String value) { + return Internal.observerToFuture(response -> this.removeList(name, value, response)); + } + + /** + * Returns the updated list. + *

+ * Returns NOT_FOUND if the list does not exist (name cannot be updated). + *

+ * THIS WILL OVERWRITE ALL EXISTING LIST.VALUES WITH ANY REQUEST LIST.VALUES. + *

+ * Use {@link #addListFuture(String, String)} or {@link #removeListFuture(String, String)} for modifying the + * List.Values field. + *

+ * Returns INVALID_ARGUMENT if the field mask path(s) are not field(s) of the list. + * + * @param list the list to update. + * @param updateMask the update mask to update. + * @param response the response from server. + */ + void updateList(AgonesList list, List updateMask, StreamObserver response); + + /** + * Returns the updated list. + *

+ * Returns NOT_FOUND if the list does not exist (name cannot be updated). + *

+ * THIS WILL OVERWRITE ALL EXISTING LIST.VALUES WITH ANY REQUEST LIST.VALUES. + *

+ * Use {@link #addListFuture(String, String)} or {@link #removeListFuture(String, String)} for modifying the + * List.Values field. + *

+ * Returns INVALID_ARGUMENT if the field mask path(s) are not field(s) of the list. + * + * @param list the list to update. + * @param updateMask the update mask to update. + * + * @return the updated list. + */ + default CompletableFuture updateList( + final AgonesList list, + final List updateMask + ) { + return Internal.observerToFuture(response -> this.updateList(list, updateMask, response)); + } + + /** + * gets a counter. + *

+ * Returns NOT_FOUND if the counter does not exist. + * + * @param name the name of the counter. + * @param response the response from server. + */ + void getCounter(String name, StreamObserver response); + + /** + * gets a counter. + *

+ * Returns NOT_FOUND if the counter does not exist. + * + * @param name the name of the counter. + * + * @return the counter. + */ + default CompletableFuture getCounterFuture(final String name) { + return Internal.observerToFuture(response -> this.getCounter(name, response)); + } + + /** + * Increases the count of the Counter by the specified amount. + *

+ * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). + *

+ * Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. + * + * @param name the name of the counter. + * @param amount the amount to increase. + * @param response the response from server. + */ + void increaseCounter(String name, long amount, StreamObserver response); + + /** + * Increases the count of the Counter by the specified amount. + *

+ * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). + *

+ * Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. + * + * @param name the name of the counter. + * @param amount the amount to increase. + * + * @return the counter. + */ + default CompletableFuture increaseCounterFuture( + final String name, + final long amount + ) { + return Internal.observerToFuture(response -> this.increaseCounter(name, amount, response)); + } + + /** + * Decreases the count of the Counter by the specified amount. + *

+ * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). + *

+ * Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. + * + * @param name the name of the counter. + * @param amount the amount to decrease. + * @param response the response from server. + */ + void decreaseCounter(String name, long amount, StreamObserver response); + + /** + * Decreases the count of the Counter by the specified amount. + *

+ * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). + *

+ * Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. + * + * @param name the name of the counter. + * @param amount the amount to decrease. + * + * @return the counter. + */ + default CompletableFuture decreaseCounter(final String name, final long amount) { + return Internal.observerToFuture(response -> this.decreaseCounter(name, amount, response)); + } + + /** + * Sets the count of the Counter by the specified amount. + *

+ * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). + *

+ * Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. + * + * @param name the name of the counter. + * @param amount the amount to set. + * @param response the response from server. + */ + void setCounterCount(String name, long amount, StreamObserver response); + + /** + * Sets the count of the Counter by the specified amount. + *

+ * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). + *

+ * Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. + * + * @param name the name of the counter. + * @param amount the amount to set. + * + * @return the counter. + */ + default CompletableFuture setCounterCountFuture(String name, long amount) { + return Internal.observerToFuture(response -> this.setCounterCount(name, amount, response)); + } + + /** + * Sets the capacity of the Counter by the specified amount. + *

+ * 0 is no limit. + *

+ * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). + * + * @param name the name of the counter. + * @param amount the amount to set. + * @param response the response from server. + */ + void setCounterCapacity(String name, long amount, StreamObserver response); + + /** + * Sets the capacity of the Counter by the specified amount. + *

+ * 0 is no limit. + *

+ * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). + * + * @param name the name of the counter. + * @param amount the amount to set. + * + * @return the counter. + */ + default CompletableFuture setCounterCapacityFuture( + final String name, + final long amount + ) { + return Internal.observerToFuture( + response -> this.setCounterCapacity(name, amount, response) + ); + } + + /** + * A builder for creating instances of Agones with specified configurations. + */ + interface Builder { + /** + * Builds an instance of Agones using the specified configuration. + * + * @return An instance of Agones. + */ + Agones build(); + + /** + * Sets the address for the Agones Builder. + * + * @param host The host address to be set. + * @param port The port number to be set. + * + * @return The Agones Builder instance. + * + * @see ManagedChannelBuilder#forAddress(String, int) + * @see ManagedChannelBuilder#usePlaintext() + */ + default Builder withAddress(final String host, final int port) { + return this.withChannel( + ManagedChannelBuilder.forAddress(host, port).usePlaintext().build() + ); + } + + /** + * Sets the address for the Agones Builder. + * + * @param host The host address to be set. + * + * @return The Agones Builder instance. + */ + default Builder withAddress(final String host) { + return this.withAddress(host, Internal.GRPC_PORT); + } + + /** + * Sets the address for the Agones Builder. + * + * @param port The port number to be set. + * + * @return The Agones Builder instance. + */ + default Builder withAddress(final int port) { + return this.withAddress(Internal.GRPC_HOST, port); + } + + /** + * Sets the address for the Agones Builder. + * + * @return The Agones Builder instance. + */ + default Builder withAddress() { + return this.withAddress(Internal.GRPC_HOST); + } + + /** + * Sets the target for the Agones Builder. + * + * @param target The target to be set. + * + * @return The Agones Builder instance. + * + * @see ManagedChannelBuilder#forTarget(String) + * @see ManagedChannelBuilder#usePlaintext() + */ + default Builder withTarget(final String target) { + return this.withChannel(ManagedChannelBuilder.forTarget(target).usePlaintext().build()); + } + + /** + * Sets the target for the Agones Builder. + * + * @return The Agones Builder instance. + */ + default Builder withTarget() { + Objects.requireNonNull( + Internal.GRPC_ADDRESS, + "Environment variable 'AGONES_SDK_GRPC_ADDRESS' is not set!" + ); + return this.withTarget(Internal.GRPC_ADDRESS); + } + + /** + * Sets the channel from environment variables for the Agones Builder. + * + * @return The Agones Builder instance. + */ + default Builder withChannel() { + if (Internal.GRPC_ADDRESS == null) { + return this.withAddress(); + } else { + return this.withTarget(); + } + } + + /** + * Sets the ManagedChannel for the Agones Builder. + * + * @param channel The ManagedChannel to be set. + * + * @return The Agones Builder instance. + */ + Builder withChannel(ManagedChannel channel); + + /** + * Sets the executor for the game server watcher. + * + * @param executor The executor service to be used by the game server watcher. {@code null} to disable it. Disabled by default. + * + * @return The Agones Builder instance. + */ + Builder withGameServerWatcherExecutor(ExecutorService executor); + + /** + * Sets the health check interval for the Agones Builder. + * + * @param delay The delay duration for health checks. {@code null} to disable it. Disabled by default. + * @param period The interval duration for health checks. + * + * @return The Agones Builder instance. + */ + Builder withHealthCheck(Duration delay, Duration period); + + /** + * Sets the health check executor for the builder. + * + * @param executor the scheduled executor service to be used for health checks. {@code null} to disable it. Default is {@link Executors#newSingleThreadScheduledExecutor()} + * + * @return The Agones Builder instance. + */ + Builder withHealthCheckExecutor(ScheduledExecutorService executor); + } +} diff --git a/src/main/java/net/infumia/agones4j/AgonesCounter.java b/src/main/java/net/infumia/agones4j/AgonesCounter.java new file mode 100644 index 0000000..e5b7d57 --- /dev/null +++ b/src/main/java/net/infumia/agones4j/AgonesCounter.java @@ -0,0 +1,77 @@ +package net.infumia.agones4j; + +import java.util.Objects; +import java.util.StringJoiner; + +/** + * Represents a counter in the Agones system. + */ +public final class AgonesCounter { + + private final String name; + private final long capacity; + private final long count; + + AgonesCounter(final String name, final long capacity, final long count) { + this.name = name; + this.capacity = capacity; + this.count = count; + } + + /** + * Retrieves the counter name. + * + * @return the name. + */ + public String getName() { + return this.name; + } + + /** + * Retrieves the counter capacity. + * + * @return the capacity. + */ + public long getCapacity() { + return this.capacity; + } + + /** + * Returns the counter count. + * + * @return the count. + */ + public long getCount() { + return this.count; + } + + @Override + public boolean equals(final Object obj) { + if (this == obj) { + return true; + } + if (obj == null || this.getClass() != obj.getClass()) { + return false; + } + final AgonesCounter that = (AgonesCounter) obj; + return ( + Objects.equals(this.capacity, that.capacity) && + Objects.equals(this.name, that.name) && + Objects.equals(this.count, that.count) + ); + } + + @Override + public int hashCode() { + return Objects.hash(this.name, this.capacity, this.count); + } + + @Override + public String toString() { + return new StringJoiner(", ", AgonesCounter.class.getSimpleName() + "[", "]") + .add("name='" + this.name + "'") + .add("capacity=" + this.capacity) + .add("count=" + this.count) + .toString(); + } +} diff --git a/src/main/java/net/infumia/agones4j/AgonesImpl.java b/src/main/java/net/infumia/agones4j/AgonesImpl.java new file mode 100644 index 0000000..06401aa --- /dev/null +++ b/src/main/java/net/infumia/agones4j/AgonesImpl.java @@ -0,0 +1,431 @@ +package net.infumia.agones4j; + +import agones.dev.sdk.Sdk; +import agones.dev.sdk.alpha.Alpha; +import agones.dev.sdk.beta.Beta; +import com.google.protobuf.FieldMask; +import com.google.protobuf.Int64Value; +import io.grpc.ManagedChannel; +import io.grpc.stub.StreamObserver; +import java.time.Duration; +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.Objects; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.ScheduledFuture; +import java.util.concurrent.TimeUnit; +import java.util.function.Consumer; + +final class AgonesImpl implements Agones { + + private final ManagedChannel channel; + + private final agones.dev.sdk.SDKGrpc.SDKStub sdk; + private final agones.dev.sdk.beta.SDKGrpc.SDKStub beta; + private final agones.dev.sdk.alpha.SDKGrpc.SDKStub alpha; + + private final ExecutorService gameServerWatcherExecutor; + private List> gameServerWatchers; + + private final Duration healthCheckDelay; + private final ScheduledExecutorService healthCheckExecutor; + private final Duration healthCheckPeriod; + private ScheduledFuture healthCheckTask; + + private AgonesImpl(final Builder builder) { + this.channel = builder.channel; + this.gameServerWatcherExecutor = builder.gameServerWatcherExecutor; + this.healthCheckExecutor = builder.healthCheckExecutor(); + this.healthCheckDelay = builder.healthCheckDelay; + this.healthCheckPeriod = builder.healthCheckPeriod; + this.sdk = agones.dev.sdk.SDKGrpc.newStub(builder.channel); + this.beta = agones.dev.sdk.beta.SDKGrpc.newStub(builder.channel); + this.alpha = agones.dev.sdk.alpha.SDKGrpc.newStub(builder.channel); + } + + @Override + public boolean canWatchGameServer() { + return this.gameServerWatcherExecutor != null; + } + + @Override + public void addGameServerWatcher(final Consumer watcher) { + Objects.requireNonNull( + this.gameServerWatcherExecutor, + "Game server watcher is not enabled!" + ); + if (this.gameServerWatchers == null) { + this.gameServerWatchers = Collections.synchronizedList(new ArrayList<>()); + final StreamObserver response = Internal.observerOnNext( + this.gameServerWatcherExecutor, + this.gameServerWatchers + ); + this.sdk.watchGameServer(Sdk.Empty.getDefaultInstance(), response); + } + this.gameServerWatchers.add(watcher); + } + + @Override + public boolean canHealthCheck() { + return ( + this.healthCheckExecutor != null && + this.healthCheckDelay != null && + this.healthCheckPeriod != null + ); + } + + @Override + public void startHealthChecking() { + if ( + this.healthCheckExecutor == null || + this.healthCheckDelay == null || + this.healthCheckPeriod == null + ) { + throw new IllegalStateException("Health check is not enabled!"); + } + if (this.healthCheckTask != null) { + this.healthCheckTask.cancel(true); + } + final StreamObserver request = this.healthCheckStream(Internal.observerEmpty()); + this.healthCheckTask = this.healthCheckExecutor.scheduleAtFixedRate( + () -> { + if (this.healthCheckTask != null && !this.healthCheckTask.isDone()) { + request.onNext(Sdk.Empty.getDefaultInstance()); + } + }, + this.healthCheckDelay.toMillis(), + this.healthCheckPeriod.toMillis(), + TimeUnit.MILLISECONDS + ); + } + + @Override + public void stopHealthChecking() { + if (this.healthCheckTask != null) { + this.healthCheckTask.cancel(true); + this.healthCheckTask = null; + } + } + + @Override + public StreamObserver healthCheckStream(final StreamObserver response) { + return this.sdk.health(response); + } + + @Override + public void allocate(final StreamObserver response) { + this.sdk.allocate(Sdk.Empty.getDefaultInstance(), response); + } + + @Override + public void getGameServer(final StreamObserver response) { + this.sdk.getGameServer(Sdk.Empty.getDefaultInstance(), response); + } + + @Override + public void ready(final StreamObserver response) { + this.sdk.ready(Sdk.Empty.getDefaultInstance(), response); + } + + @Override + public void reserve(final Duration duration, final StreamObserver response) { + this.sdk.reserve( + Sdk.Duration.newBuilder().setSeconds(duration.getSeconds()).build(), + response + ); + } + + @Override + public void shutdown(final StreamObserver response) { + this.sdk.shutdown(Sdk.Empty.getDefaultInstance(), response); + } + + @Override + public void setAnnotation( + final String key, + final String value, + final StreamObserver observer + ) { + this.sdk.setAnnotation( + Sdk.KeyValue.newBuilder().setKey(key).setValue(value).build(), + observer + ); + } + + @Override + public void setLabel( + final String key, + final String value, + final StreamObserver response + ) { + this.sdk.setLabel(Sdk.KeyValue.newBuilder().setKey(key).setValue(value).build(), response); + } + + @Override + public void getConnectedPlayersFuture(final StreamObserver> response) { + this.alpha.getConnectedPlayers( + Alpha.Empty.getDefaultInstance(), + Internal.observerMap(response, Alpha.PlayerIDList::getListList) + ); + } + + @Override + public void playerConnect(final String playerId, final StreamObserver response) { + this.alpha.playerConnect( + Alpha.PlayerID.newBuilder().setPlayerID(playerId).build(), + Internal.observerMap(response, Alpha.Bool::getBool) + ); + } + + @Override + public void playerDisconnect(final String playerId, final StreamObserver response) { + this.alpha.playerDisconnect( + Alpha.PlayerID.newBuilder().setPlayerID(playerId).build(), + Internal.observerMap(response, Alpha.Bool::getBool) + ); + } + + @Override + public void isPlayerConnected(final String playerId, final StreamObserver response) { + this.alpha.isPlayerConnected( + Alpha.PlayerID.newBuilder().setPlayerID(playerId).build(), + Internal.observerMap(response, Alpha.Bool::getBool) + ); + } + + @Override + public void setPlayerCapacity(final long capacity, final StreamObserver response) { + this.alpha.setPlayerCapacity(Alpha.Count.newBuilder().setCount(capacity).build(), response); + } + + @Override + public void getPlayerCapacity(final StreamObserver response) { + this.alpha.getPlayerCapacity( + Alpha.Empty.getDefaultInstance(), + Internal.observerMap(response, Alpha.Count::getCount) + ); + } + + @Override + public void getPlayerCount(final StreamObserver response) { + this.alpha.getPlayerCount( + Alpha.Empty.getDefaultInstance(), + Internal.observerMap(response, Alpha.Count::getCount) + ); + } + + @Override + public void getList(final String name, final StreamObserver response) { + final Beta.GetListRequest request = Beta.GetListRequest.newBuilder().setName(name).build(); + this.beta.getList(request, Internal.observerMap(response, Internal::toList)); + } + + @Override + public void addList( + final String name, + final String value, + final StreamObserver response + ) { + final Beta.AddListValueRequest request = Beta.AddListValueRequest.newBuilder() + .setName(name) + .setValue(value) + .build(); + this.beta.addListValue(request, Internal.observerMap(response, Internal::toList)); + } + + @Override + public void removeList( + final String name, + final String value, + final StreamObserver response + ) { + final Beta.RemoveListValueRequest request = Beta.RemoveListValueRequest.newBuilder() + .setName(name) + .setValue(value) + .build(); + this.beta.removeListValue(request, Internal.observerMap(response, Internal::toList)); + } + + @Override + public void updateList( + final AgonesList list, + final List updateMask, + final StreamObserver response + ) { + final FieldMask mask = FieldMask.newBuilder().addAllPaths(updateMask).build(); + final Beta.UpdateListRequest request = Beta.UpdateListRequest.newBuilder() + .setList(Internal.toAgonesList(list)) + .setUpdateMask(mask) + .build(); + this.beta.updateList(request, Internal.observerMap(response, Internal::toList)); + } + + @Override + public void getCounter(final String name, final StreamObserver response) { + final Beta.GetCounterRequest request = Beta.GetCounterRequest.newBuilder() + .setName(name) + .build(); + this.beta.getCounter(request, Internal.observerMap(response, Internal::toCounter)); + } + + @Override + public void increaseCounter( + final String name, + final long amount, + final StreamObserver response + ) { + final Beta.CounterUpdateRequest update = Beta.CounterUpdateRequest.newBuilder() + .setName(name) + .setCountDiff(amount >= 0 ? amount : Math.abs(amount)) + .build(); + final Beta.UpdateCounterRequest request = Beta.UpdateCounterRequest.newBuilder() + .setCounterUpdateRequest(update) + .build(); + this.beta.updateCounter(request, Internal.observerMap(response, Internal::toCounter)); + } + + @Override + public void decreaseCounter( + final String name, + final long amount, + final StreamObserver response + ) { + final Beta.CounterUpdateRequest update = Beta.CounterUpdateRequest.newBuilder() + .setName(name) + .setCountDiff(amount >= 0 ? -amount : amount) + .build(); + final Beta.UpdateCounterRequest request = Beta.UpdateCounterRequest.newBuilder() + .setCounterUpdateRequest(update) + .build(); + this.beta.updateCounter(request, Internal.observerMap(response, Internal::toCounter)); + } + + @Override + public void setCounterCount( + final String name, + final long amount, + final StreamObserver response + ) { + final Beta.CounterUpdateRequest update = Beta.CounterUpdateRequest.newBuilder() + .setName(name) + .setCount(Int64Value.newBuilder().setValue(amount).build()) + .build(); + final Beta.UpdateCounterRequest request = Beta.UpdateCounterRequest.newBuilder() + .setCounterUpdateRequest(update) + .build(); + this.beta.updateCounter(request, Internal.observerMap(response, Internal::toCounter)); + } + + @Override + public void setCounterCapacity( + final String name, + final long amount, + final StreamObserver response + ) { + final Beta.CounterUpdateRequest update = Beta.CounterUpdateRequest.newBuilder() + .setName(name) + .setCapacity(Int64Value.newBuilder().setValue(amount).build()) + .build(); + final Beta.UpdateCounterRequest request = Beta.UpdateCounterRequest.newBuilder() + .setCounterUpdateRequest(update) + .build(); + this.beta.updateCounter(request, Internal.observerMap(response, Internal::toCounter)); + } + + @Override + public void close() throws Exception { + this.channel.shutdown().awaitTermination(5L, TimeUnit.SECONDS); + } + + static final class Builder implements Agones.Builder { + + private final ManagedChannel channel; + private final ExecutorService gameServerWatcherExecutor; + private final ScheduledExecutorService healthCheckExecutor; + private final Duration healthCheckDelay; + private final Duration healthCheckPeriod; + + private Builder( + final ManagedChannel channel, + final ExecutorService gameServerWatcherExecutor, + final ScheduledExecutorService healthCheckExecutor, + final Duration healthCheckDelay, + final Duration healthCheckPeriod + ) { + this.channel = channel; + this.gameServerWatcherExecutor = gameServerWatcherExecutor; + this.healthCheckExecutor = healthCheckExecutor; + this.healthCheckDelay = healthCheckDelay; + this.healthCheckPeriod = healthCheckPeriod; + } + + Builder() { + this(null, null, null, null, null); + } + + @Override + public Agones build() { + if (this.channel == null) { + return this.withChannel().build(); + } + return new AgonesImpl(this); + } + + @Override + public Agones.Builder withChannel(final ManagedChannel channel) { + return new Builder( + channel, + this.gameServerWatcherExecutor, + this.healthCheckExecutor, + this.healthCheckDelay, + this.healthCheckPeriod + ); + } + + @Override + public Agones.Builder withGameServerWatcherExecutor(final ExecutorService executor) { + return new Builder( + this.channel, + executor, + this.healthCheckExecutor, + this.healthCheckDelay, + this.healthCheckPeriod + ); + } + + @Override + public Agones.Builder withHealthCheck(final Duration delay, final Duration period) { + return new Builder( + this.channel, + this.gameServerWatcherExecutor, + this.healthCheckExecutor, + delay, + period + ); + } + + @Override + public Agones.Builder withHealthCheckExecutor(final ScheduledExecutorService executor) { + return new Builder( + this.channel, + this.gameServerWatcherExecutor, + executor, + this.healthCheckDelay, + this.healthCheckPeriod + ); + } + + private ScheduledExecutorService healthCheckExecutor() { + if (this.healthCheckExecutor != null) { + return this.healthCheckExecutor; + } + if (this.healthCheckDelay != null) { + return Executors.newSingleThreadScheduledExecutor(); + } + return null; + } + } +} diff --git a/src/main/java/net/infumia/agones4j/AgonesList.java b/src/main/java/net/infumia/agones4j/AgonesList.java new file mode 100644 index 0000000..ec491d9 --- /dev/null +++ b/src/main/java/net/infumia/agones4j/AgonesList.java @@ -0,0 +1,79 @@ +package net.infumia.agones4j; + +import java.util.Collections; +import java.util.List; +import java.util.Objects; +import java.util.StringJoiner; + +/** + * Represents a list in the Agones system. + */ +public final class AgonesList { + + private final String name; + private final long capacity; + private final List values; + + AgonesList(final String name, final long capacity, final List values) { + this.name = name; + this.capacity = capacity; + this.values = Collections.unmodifiableList(values); + } + + /** + * Retrieves the name of the list. + * + * @return The name. + */ + public String getName() { + return this.name; + } + + /** + * Retrieves the capacity of the list. + * + * @return The capacity. + */ + public long getCapacity() { + return this.capacity; + } + + /** + * Returns the values of the list. + * + * @return the values. + */ + public List getValues() { + return this.values; + } + + @Override + public boolean equals(final Object obj) { + if (this == obj) { + return true; + } + if (obj == null || this.getClass() != obj.getClass()) { + return false; + } + final AgonesList that = (AgonesList) obj; + return ( + Objects.equals(this.capacity, that.capacity) && + Objects.equals(this.name, that.name) && + Objects.equals(this.values, that.values) + ); + } + + @Override + public int hashCode() { + return Objects.hash(this.name, this.capacity, this.values); + } + + @Override + public String toString() { + return new StringJoiner(", ", AgonesList.class.getSimpleName() + "[", "]") + .add("name='" + this.name + "'") + .add("capacity=" + this.capacity) + .add("values=" + this.values) + .toString(); + } +} diff --git a/src/main/java/net/infumia/agones4j/Internal.java b/src/main/java/net/infumia/agones4j/Internal.java new file mode 100644 index 0000000..cc2af9e --- /dev/null +++ b/src/main/java/net/infumia/agones4j/Internal.java @@ -0,0 +1,181 @@ +package net.infumia.agones4j; + +import agones.dev.sdk.Sdk; +import agones.dev.sdk.beta.Beta; +import io.grpc.stub.StreamObserver; +import java.util.List; +import java.util.Objects; +import java.util.Optional; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.Executor; +import java.util.concurrent.atomic.AtomicReference; +import java.util.function.Consumer; +import java.util.function.Function; + +final class Internal { + + private static final int DEFAULT_GRPC_PORT = 9357; + private static final String DEFAULT_GRPC_HOST = "localhost"; + + private static final String ENV_GRPC_HOST = "AGONES_SDK_GRPC_HOST"; + private static final String ENV_GRPC_PORT = "AGONES_SDK_GRPC_PORT"; + private static final String ENV_GRPC_ADDRESS = "AGONES_SDK_GRPC_ADDRESS"; + + static final String GRPC_HOST = Internal.getEnv( + Internal.ENV_GRPC_HOST, + Internal.DEFAULT_GRPC_HOST + ); + static final int GRPC_PORT = Internal.getEnvAsInt( + Internal.ENV_GRPC_PORT, + Internal.DEFAULT_GRPC_PORT + ); + static final String GRPC_ADDRESS = Internal.getEnv(Internal.ENV_GRPC_ADDRESS, null); + + private static final StreamObserver EMPTY = new Adapter<>(); + + private Internal() { + throw new UnsupportedOperationException( + "This is a utility class and cannot be instantiated" + ); + } + + static AgonesCounter toCounter(final Beta.Counter counter) { + return new AgonesCounter(counter.getName(), counter.getCapacity(), counter.getCount()); + } + + static AgonesList toList(final Beta.List list) { + return new AgonesList(list.getName(), list.getCapacity(), list.getValuesList()); + } + + static Beta.List toAgonesList(final AgonesList list) { + return Beta.List.newBuilder() + .setName(list.getName()) + .setCapacity(list.getCapacity()) + .addAllValues(list.getValues()) + .build(); + } + + private static String getEnv(final String key, final String def) { + Objects.requireNonNull(key, "key"); + return Internal.getEnvOptional(key).orElse(def); + } + + private static int getEnvAsInt(final String key, final int def) { + Objects.requireNonNull(key, "key"); + return Internal.getEnvOptional(key).flatMap(Internal::parseInt).orElse(def); + } + + private static Optional getEnvOptional(final String key) { + Objects.requireNonNull(key, "key"); + return Optional.ofNullable(Internal.getEnv(key)); + } + + private static String getEnv(final String key) { + Objects.requireNonNull(key, "key"); + return System.getenv(key); + } + + private static Optional parseInt(final String text) { + Objects.requireNonNull(text, "text"); + try { + return Optional.of(Integer.parseInt(text)); + } catch (final Exception ignored) {} + return Optional.empty(); + } + + static StreamObserver observerEmpty() { + return Internal.EMPTY; + } + + static CompletableFuture observerToFuture(final Consumer> response) { + final CompletableFuture future = new CompletableFuture<>(); + response.accept(new Future<>(future)); + return future; + } + + static StreamObserver observerOnNext( + final Executor executor, + final List> consumers + ) { + return new Adapter() { + @Override + public void onNext(final T value) { + executor.execute(() -> { + for (final Consumer consumer : consumers) { + consumer.accept(value); + } + }); + } + }; + } + + static StreamObserver observerMap( + final StreamObserver observer, + final Function mapper + ) { + return new Mapped<>(observer, mapper); + } + + private static final class Mapped implements StreamObserver { + + private final StreamObserver observer; + private final Function mapper; + + private Mapped(final StreamObserver observer, final Function mapper) { + this.observer = observer; + this.mapper = mapper; + } + + @Override + public void onNext(final R value) { + this.observer.onNext(this.mapper.apply(value)); + } + + @Override + public void onError(final Throwable t) { + this.observer.onError(t); + } + + @Override + public void onCompleted() { + this.observer.onCompleted(); + } + } + + private static final class Future implements StreamObserver { + + private final AtomicReference value = new AtomicReference<>(); + private final CompletableFuture future; + + private Future(final CompletableFuture future) { + this.future = future; + } + + @Override + public void onNext(final T value) { + this.value.set(value); + } + + @Override + public void onError(final Throwable t) { + this.future.completeExceptionally(t); + } + + @Override + public void onCompleted() { + this.future.complete(this.value.get()); + } + } + + private static class Adapter implements StreamObserver { + + @Override + public void onNext(final T value) {} + + @Override + public void onError(final Throwable t) {} + + @Override + public void onCompleted() {} + } +} diff --git a/src/main/java/tr/com/infumia/agones4j/Agones.java b/src/main/java/tr/com/infumia/agones4j/Agones.java deleted file mode 100644 index 6441fcc..0000000 --- a/src/main/java/tr/com/infumia/agones4j/Agones.java +++ /dev/null @@ -1,854 +0,0 @@ -package tr.com.infumia.agones4j; - -import agones.dev.sdk.Sdk; -import agones.dev.sdk.alpha.Alpha; -import io.grpc.ManagedChannel; -import io.grpc.ManagedChannelBuilder; -import io.grpc.stub.StreamObserver; -import java.time.Duration; -import java.util.List; -import java.util.Objects; -import java.util.concurrent.CompletableFuture; -import java.util.concurrent.ExecutorService; -import java.util.concurrent.Executors; -import java.util.concurrent.ScheduledExecutorService; -import java.util.function.Consumer; - -/** - * The interface provides methods to interact with Agones. - */ -public interface Agones extends AutoCloseable { - /** - * Retrieves a new instance of the Agones builder. - * - * @return A new instance of the Agones builder. - */ - static Agones.Builder builder() { - return new AgonesImpl.Builder(); - } - - /** - * Checks if it can watch game server. - *

- * To enable game server watcher, use {@link Builder#withGameServerWatcherExecutor(ExecutorService)}. - * - * @return {@code true} if it can watch game server, {@code false} otherwise. - */ - boolean canWatchGameServer(); - - /** - * Adds a game server watcher. - *

- * Game server watchers are called whenever a game server event occurs. - * - * @param watcher A consumer that represents the game server watcher. - * - * @see #canWatchGameServer() - */ - void addGameServerWatcher(Consumer watcher); - - /** - * Checks if it can use health check system of Agones. - *

- * To enable health check, use {@link Builder#withHealthCheck(Duration, Duration)}. - * - * @return {@code true} if it can use health check system of Agones, {@code false} otherwise. - */ - boolean canHealthCheck(); - - /** - * Starts the health checking. - * - * @throws IllegalStateException if the health check interval not specified. - * @see #canHealthCheck() - */ - void startHealthChecking(); - - /** - * Stops the health checking. - */ - void stopHealthChecking(); - - /** - * Creates a new health check stream. - * - * @param response the response from server. - * - * @return a stream observer to send health check requests. - * - * @see #canHealthCheck() - */ - StreamObserver healthCheckStream(StreamObserver response); - - /** - * Creates a new health check stream. - * - * @return a stream observer to send health check requests. - * - * @see #canHealthCheck() - */ - default StreamObserver healthCheckStream() { - return this.healthCheckStream(Internal.observerEmpty()); - } - - /** - * Call to self Allocation the GameServer. - * - * @param response the response from server. - */ - void allocate(StreamObserver response); - - /** - * Call to self Allocation the GameServer. - */ - default void allocate() { - this.allocate(Internal.observerEmpty()); - } - - /** - * Call to self Allocation the GameServer. - * - * @return A future that represents the result of the allocation operation. - */ - default CompletableFuture allocateFuture() { - return Internal.observerToFuture(this::allocate); - } - - /** - * Retrieves the current GameServer data. - * - * @param response the response from server. - */ - void getGameServer(StreamObserver response); - - /** - * Retrieves the current GameServer data. - * - * @return A future that represents the current game server. - */ - default CompletableFuture getGameServerFuture() { - return Internal.observerToFuture(this::getGameServer); - } - - /** - * Call when the GameServer is ready. - * - * @param response the response from server. - */ - void ready(StreamObserver response); - - /** - * Call when the GameServer is ready. - */ - default void ready() { - this.ready(Internal.observerEmpty()); - } - - /** - * Call when the @link Sdk.GameServer is ready. - * - * @return A future that represents the result of the ready operation. - */ - default CompletableFuture readyFuture() { - return Internal.observerToFuture(this::ready); - } - - /** - * Marks the @link Sdk.GameServer as the Reserved state for Duration. - * - * @param duration the duration to mark. - * @param response the response from server. - */ - void reserve(Duration duration, StreamObserver response); - - /** - * Marks the @link Sdk.GameServer as the Reserved state for Duration. - * - * @param duration the duration to mark. - */ - default void reserve(final Duration duration) { - this.reserve(duration, Internal.observerEmpty()); - } - - /** - * Marks the @link Sdk.GameServer as the Reserved state for Duration. - * - * @param duration the duration to mark. - * - * @return A future that represents the result of the reserve operation. - */ - default CompletableFuture reserveFuture(final Duration duration) { - return Internal.observerToFuture(response -> this.reserve(duration, response)); - } - - /** - * Call when the @link Sdk.GameServer is shutting down. - * - * @param response the response from server. - */ - void shutdown(StreamObserver response); - - /** - * Call when the @link Sdk.GameServer is shutting down. - */ - default void shutdown() { - this.shutdown(Internal.observerEmpty()); - } - - /** - * Call when the @link Sdk.GameServer is shutting down. - * - * @return A future that represents the result of the shutdown operation. - */ - default CompletableFuture shutdownFuture() { - return Internal.observerToFuture(this::shutdown); - } - - /** - * Apply an Annotation to the backing @link Sdk.GameServer metadata. - * - * @param key the key to apply. - * @param value the value to apply. - * @param observer the observer to apply. - */ - void setAnnotation(String key, String value, StreamObserver observer); - - /** - * Apply an Annotation to the backing @link Sdk.GameServer metadata. - * - * @param key the key to apply. - * @param value the value to apply. - */ - default void setAnnotation(final String key, final String value) { - this.setAnnotation(key, value, Internal.observerEmpty()); - } - - /** - * Apply an Annotation to the backing @link Sdk.GameServer metadata. - * - * @param key the key to apply. - * @param value the value to apply. - * - * @return A future that represents the result of the set annotation operation. - */ - default CompletableFuture setAnnotationFuture(final String key, final String value) { - return Internal.observerToFuture(response -> this.setAnnotation(key, value, response)); - } - - /** - * Apply a Label to the backing @link Sdk.GameServer metadata. - * - * @param key the key to apply. - * @param value the value to apply. - * @param response the response from server. - */ - void setLabel(String key, String value, StreamObserver response); - - /** - * Apply a Label to the backing @link Sdk.GameServer metadata. - * - * @param key the key to apply. - * @param value the value to apply. - */ - default void setLabel(final String key, final String value) { - this.setLabel(key, value, Internal.observerEmpty()); - } - - /** - * Apply a Label to the backing @link Sdk.GameServer metadata. - * - * @param key the key to apply. - * @param value the value to apply. - * - * @return A future that represents the result of the set label operation. - */ - default CompletableFuture setLabelFuture(final String key, final String value) { - return Internal.observerToFuture(response -> this.setLabel(key, value, response)); - } - - /** - * Returns the list of the currently connected player ids. - *

- * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the - * @link Sdk.GameServer status resource. - *

- * If GameServer#Status#PlayerStatus#getIdsList is set manually through the Kubernetes API, use - * {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to view this value. - * - * @param response the response from server. - */ - void getConnectedPlayersFuture(StreamObserver> response); - - /** - * Returns the list of the currently connected player ids. - *

- * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the - * @link Sdk.GameServer status resource. - *

- * If GameServer#Status#PlayerStatus#getIdsList is set manually through the Kubernetes API, use - * {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to view this value. - * - * @return A future that represents the list of the currently connected player ids. - */ - default CompletableFuture> getConnectedPlayersFuture() { - return Internal.observerToFuture(this::getConnectedPlayersFuture); - } - - /** - * Increases the SDK’s stored player count by one, and appends this playerID to GameServer#Status#PlayerStatus#getIdsList. - *

- * GameServer#Status#PlayerStatus#getCount and GameServer#Status#PlayerStatus#getIdsList are then set to update the player count and id list a second from now, unless there is already an update pending, in which case the update joins that batch operation. - *

- * The response returns true and adds the playerID to the list of playerIDs if this playerID was not already in the list of connected playerIDs. - *

- * If the playerID exists within the list of connected playerIDs, will return false, and the list of connected playerIDs will be left unchanged. - *

- * An error will be returned if the playerID was not already in the list of connected playerIDs but the player capacity for the server has been reached. - * The playerID will not be added to the list of playerIDs. - *

- * WARNING: Do not use this method if you are manually managing GameServer#Status#PlayerStatus#getIdsList and GameServer#Status#PlayerStatus#getCount through the Kubernetes API, as indeterminate results will occur. - * - * @param playerId the player id to connect. - * @param response the response from server. - */ - void playerConnect(String playerId, StreamObserver response); - - /** - * Increases the SDK’s stored player count by one, and appends this playerID to GameServer#Status#PlayerStatus#getIdsList. - * GameServer#Status#PlayerStatus#getCount and GameServer#Status#PlayerStatus#getIdsList are then set to update the player count and id list a second from now, unless there is already an update pending, in which case the update joins that batch operation. - *

- * If the playerID exists within the list of connected playerIDs, will return false, and the list of connected playerIDs will be left unchanged. - *

- * An error will be returned if the playerID was not already in the list of connected playerIDs but the player capacity for the server has been reached. - * The playerID will not be added to the list of playerIDs. - *

- * WARNING: Do not use this method if you are manually managing GameServer#Status#PlayerStatus#getIdsList and GameServer#Status#PlayerStatus#getCount through the Kubernetes API, as indeterminate results will occur. - * - * @param playerId the player id to connect. - * - * @return A future that represents the result of the player connect operation. - */ - default CompletableFuture playerConnectFuture(final String playerId) { - return Internal.observerToFuture(response -> this.playerConnect(playerId, response)); - } - - /** - * Decreases the SDK’s stored player count by one, and removes the playerID from GameServer#Status#PlayerStatus#getIdsList - * GameServer#Status#PlayerStatus#getCount and GameServer#Status#PlayerStatus#getIdsList are then set to update the player count and id list a second from now, unless there is already an update pending, in which case the update joins that batch operation. - *

- * The response returns true and removes the playerID from the list of connected playerIDs if the playerID value exists within the list. - *

- * If the playerID was not in the list of connected playerIDs, the call will return false, and the connected playerID list will be left unchanged. - *

- * WARNING: Do not use this method if you are manually managing GameServer#Status#PlayerStatus#getIdsList and GameServer#Status#PlayerStatus#getCount through the Kubernetes API, as indeterminate results will occur. - * - * @param playerId the player id to disconnect. - * @param response the response from server. - */ - void playerDisconnect(String playerId, StreamObserver response); - - /** - * Decreases the SDK’s stored player count by one, and removes the playerID from GameServer#Status#PlayerStatus#getIdsList - * GameServer#Status#PlayerStatus#getCount and GameServer#Status#PlayerStatus#getIdsList are then set to update the player count and id list a second from now, unless there is already an update pending, in which case the update joins that batch operation. - *

- * If the playerID was not in the list of connected playerIDs, the call will return false, and the connected playerID list will be left unchanged. - *

- * WARNING: Do not use this method if you are manually managing GameServer#Status#PlayerStatus#getIdsList and GameServer#Status#PlayerStatus#getCount through the Kubernetes API, as indeterminate results will occur. - * - * @param playerId the player id to disconnect. - * - * @return A future that represents the result of the player disconnect operation. - */ - default CompletableFuture playerDisconnectFuture(final String playerId) { - return Internal.observerToFuture(response -> this.playerDisconnect(playerId, response)); - } - - /** - * Returns if the playerID is currently connected to the @link Sdk.GameServer. - *

- * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the @link Sdk.GameServer status resource. - *

- * If GameServer#Status#PlayerStatus#getIdsList is set manually through the Kubernetes API, use {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to determine connected status. - * - * @param playerId the player id to return. - * @param response the response from server. - */ - void isPlayerConnected(String playerId, StreamObserver response); - - /** - * Returns if the playerID is currently connected to the @link Sdk.GameServer. - *

- * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the @link Sdk.GameServer status resource. - *

- * If GameServer#Status#PlayerStatus#getIdsList is set manually through the Kubernetes API, use {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to determine connected status. - * - * @param playerId the player id to return. - * - * @return A future that represents the result of the is player connected operation. - */ - default CompletableFuture isPlayerConnected(final String playerId) { - return Internal.observerToFuture(response -> this.isPlayerConnected(playerId, response)); - } - - /** - * Update the GameServer#Status#PlayerStatus#getCapacity value with a new capacity. - * - * @param capacity the capacity to update. - * @param response the response from server. - */ - void setPlayerCapacity(long capacity, StreamObserver response); - - /** - * Update the GameServer#Status#PlayerStatus#getCapacity value with a new capacity. - * - * @param capacity the capacity to update. - * - * @return A future that represents the result of the set player capacity operation. - */ - default CompletableFuture setPlayerCapacityFuture(final long capacity) { - return Internal.observerToFuture(response -> this.setPlayerCapacity(capacity, response)); - } - - /** - * Retrieves the current player capacity. - *

- * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the @link Sdk.GameServer status resource. - *

- * If GameServer#Status#PlayerStatus#getCapacity is set manually through the Kubernetes API, use {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to view this value. - * - * @param response the response from server. - */ - void getPlayerCapacity(StreamObserver response); - - /** - * Retrieves the current player capacity. - *

- * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the @link Sdk.GameServer status resource. - *

- * If GameServer#Status#PlayerStatus#getCapacity is set manually through the Kubernetes API, use {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to view this value. - * - * @return A future that represents the current player capacity. - */ - default CompletableFuture getPlayerCapacityFuture() { - return Internal.observerToFuture(this::getPlayerCapacity); - } - - /** - * Retrieves the current player count. - *

- * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the @link Sdk.GameServer status resource. - *

- * If GameServer#Status#PlayerStatus#getCount is set manually through the Kubernetes API, use {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to view this value. - * - * @param response the response from server. - */ - void getPlayerCount(StreamObserver response); - - /** - * Retrieves the current player count. - *

- * This is always accurate from what has been set through this SDK, even if the value has yet to be updated on the @link Sdk.GameServer status resource. - *

- * If GameServer#Status#PlayerStatus#getCount is set manually through the Kubernetes API, use {@link Agones#getGameServerFuture()} or {@link Agones#addGameServerWatcher(Consumer)} instead to view this value. - * - * @return A future that represents the current player count. - */ - default CompletableFuture getPlayerCountFuture() { - return Internal.observerToFuture(this::getPlayerCount); - } - - /** - * gets a list. - *

- * returns NOT_FOUND if the List does not exist. - * - * @param name the name to get. - * @param response the response from server. - */ - void getList(String name, StreamObserver response); - - /** - * gets a list. - *

- * Returns NOT_FOUND if the List does not exist. - * - * @param name the name to get. - * - * @return the list. - */ - default CompletableFuture getList(final String name) { - return Internal.observerToFuture(response -> this.getList(name, response)); - } - - /** - * Adds a value to a list and returns updated list. - *

- * Returns NOT_FOUND if the list does not exist. - *

- * Returns ALREADY_EXISTS if the value is already in the list. - *

- * Returns OUT_OF_RANGE if the list is already at Capacity. - * - * @param name the name to add. - * @param value the value to add. - * @param response the response from server. - */ - void addList(String name, String value, StreamObserver response); - - /** - * Adds a value to a list and returns updated list. - *

- * Returns NOT_FOUND if the list does not exist. - *

- * Returns ALREADY_EXISTS if the value is already in the list. - *

- * Returns OUT_OF_RANGE if the list is already at Capacity. - * - * @param name the name to add. - * @param value the value to add. - * - * @return the updated list. - */ - default CompletableFuture addListFuture(final String name, final String value) { - return Internal.observerToFuture(response -> this.addList(name, value, response)); - } - - /** - * Removes a value from a list and returns updated list. - *

- * Returns NOT_FOUND if the list does not exist. - *

- * Returns NOT_FOUND if the value is not in the list. - * - * @param name the name to remove. - * @param value the value to remove. - * @param response the response from server. - */ - void removeList(String name, String value, StreamObserver response); - - /** - * Removes a value from a list and returns updated list. - *

- * Returns NOT_FOUND if the list does not exist. - *

- * Returns NOT_FOUND if the value is not in the list. - * - * @param name the name to remove. - * @param value the value to remove. - * - * @return the updated list. - */ - default CompletableFuture removeListFuture(final String name, final String value) { - return Internal.observerToFuture(response -> this.removeList(name, value, response)); - } - - /** - * Returns the updated list. - *

- * Returns NOT_FOUND if the list does not exist (name cannot be updated). - *

- * THIS WILL OVERWRITE ALL EXISTING LIST.VALUES WITH ANY REQUEST LIST.VALUES. - *

- * Use {@link #addListFuture(String, String)} or {@link #removeListFuture(String, String)} for modifying the - * List.Values field. - *

- * Returns INVALID_ARGUMENT if the field mask path(s) are not field(s) of the list. - * - * @param list the list to update. - * @param updateMask the update mask to update. - * @param response the response from server. - */ - void updateList(AgonesList list, List updateMask, StreamObserver response); - - /** - * Returns the updated list. - *

- * Returns NOT_FOUND if the list does not exist (name cannot be updated). - *

- * THIS WILL OVERWRITE ALL EXISTING LIST.VALUES WITH ANY REQUEST LIST.VALUES. - *

- * Use {@link #addListFuture(String, String)} or {@link #removeListFuture(String, String)} for modifying the - * List.Values field. - *

- * Returns INVALID_ARGUMENT if the field mask path(s) are not field(s) of the list. - * - * @param list the list to update. - * @param updateMask the update mask to update. - * - * @return the updated list. - */ - default CompletableFuture updateList(final AgonesList list, final List updateMask) { - return Internal.observerToFuture(response -> this.updateList(list, updateMask, response)); - } - - /** - * gets a counter. - *

- * Returns NOT_FOUND if the counter does not exist. - * - * @param name the name of the counter. - * @param response the response from server. - */ - void getCounter(String name, StreamObserver response); - - /** - * gets a counter. - *

- * Returns NOT_FOUND if the counter does not exist. - * - * @param name the name of the counter. - * - * @return the counter. - */ - default CompletableFuture getCounterFuture(final String name) { - return Internal.observerToFuture(response -> this.getCounter(name, response)); - } - - /** - * Increases the count of the Counter by the specified amount. - *

- * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). - *

- * Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. - * - * @param name the name of the counter. - * @param amount the amount to increase. - * @param response the response from server. - */ - void increaseCounter(String name, long amount, StreamObserver response); - - /** - * Increases the count of the Counter by the specified amount. - *

- * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). - *

- * Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. - * - * @param name the name of the counter. - * @param amount the amount to increase. - * - * @return the counter. - */ - default CompletableFuture increaseCounterFuture(final String name, final long amount) { - return Internal.observerToFuture(response -> this.increaseCounter(name, amount, response)); - } - - /** - * Decreases the count of the Counter by the specified amount. - *

- * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). - *

- * Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. - * - * @param name the name of the counter. - * @param amount the amount to decrease. - * @param response the response from server. - */ - void decreaseCounter(String name, long amount, StreamObserver response); - - /** - * Decreases the count of the Counter by the specified amount. - *

- * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). - *

- * Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. - * - * @param name the name of the counter. - * @param amount the amount to decrease. - * - * @return the counter. - */ - default CompletableFuture decreaseCounter(final String name, final long amount) { - return Internal.observerToFuture(response -> this.decreaseCounter(name, amount, response)); - } - - /** - * Sets the count of the Counter by the specified amount. - *

- * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). - *

- * Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. - * - * @param name the name of the counter. - * @param amount the amount to set. - * @param response the response from server. - */ - void setCounterCount(String name, long amount, StreamObserver response); - - /** - * Sets the count of the Counter by the specified amount. - *

- * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). - *

- * Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. - * - * @param name the name of the counter. - * @param amount the amount to set. - * - * @return the counter. - */ - default CompletableFuture setCounterCountFuture(String name, long amount) { - return Internal.observerToFuture(response -> this.setCounterCount(name, amount, response)); - } - - /** - * Sets the capacity of the Counter by the specified amount. - *

- * 0 is no limit. - *

- * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). - * - * @param name the name of the counter. - * @param amount the amount to set. - * @param response the response from server. - */ - void setCounterCapacity(String name, long amount, StreamObserver response); - - /** - * Sets the capacity of the Counter by the specified amount. - *

- * 0 is no limit. - *

- * Returns NOT_FOUND if the Counter does not exist (name cannot be updated). - * - * @param name the name of the counter. - * @param amount the amount to set. - * - * @return the counter. - */ - default CompletableFuture setCounterCapacityFuture(final String name, final long amount) { - return Internal.observerToFuture(response -> this.setCounterCapacity(name, amount, response)); - } - - /** - * A builder for creating instances of Agones with specified configurations. - */ - interface Builder { - /** - * Builds an instance of Agones using the specified configuration. - * - * @return An instance of Agones. - */ - Agones build(); - - /** - * Sets the address for the Agones Builder. - * - * @param host The host address to be set. - * @param port The port number to be set. - * - * @return The Agones Builder instance. - * - * @see ManagedChannelBuilder#forAddress(String, int) - * @see ManagedChannelBuilder#usePlaintext() - */ - default Builder withAddress(final String host, final int port) { - return this.withChannel(ManagedChannelBuilder.forAddress(host, port).usePlaintext().build()); - } - - /** - * Sets the address for the Agones Builder. - * - * @param host The host address to be set. - * - * @return The Agones Builder instance. - */ - default Builder withAddress(final String host) { - return this.withAddress(host, Internal.GRPC_PORT); - } - - /** - * Sets the address for the Agones Builder. - * - * @param port The port number to be set. - * - * @return The Agones Builder instance. - */ - default Builder withAddress(final int port) { - return this.withAddress(Internal.GRPC_HOST, port); - } - - /** - * Sets the address for the Agones Builder. - * - * @return The Agones Builder instance. - */ - default Builder withAddress() { - return this.withAddress(Internal.GRPC_HOST); - } - - /** - * Sets the target for the Agones Builder. - * - * @param target The target to be set. - * - * @return The Agones Builder instance. - * - * @see ManagedChannelBuilder#forTarget(String) - * @see ManagedChannelBuilder#usePlaintext() - */ - default Builder withTarget(final String target) { - return this.withChannel(ManagedChannelBuilder.forTarget(target).usePlaintext().build()); - } - - /** - * Sets the target for the Agones Builder. - * - * @return The Agones Builder instance. - */ - default Builder withTarget() { - Objects.requireNonNull(Internal.GRPC_ADDRESS, "Environment variable 'AGONES_SDK_GRPC_ADDRESS' is not set!"); - return this.withTarget(Internal.GRPC_ADDRESS); - } - - /** - * Sets the channel from environment variables for the Agones Builder. - * - * @return The Agones Builder instance. - */ - default Builder withChannel() { - if (Internal.GRPC_ADDRESS == null) { - return this.withAddress(); - } else { - return this.withTarget(); - } - } - - /** - * Sets the ManagedChannel for the Agones Builder. - * - * @param channel The ManagedChannel to be set. - * - * @return The Agones Builder instance. - */ - Builder withChannel(ManagedChannel channel); - - /** - * Sets the executor for the game server watcher. - * - * @param executor The executor service to be used by the game server watcher. {@code null} to disable it. Disabled by default. - * - * @return The Agones Builder instance. - */ - Builder withGameServerWatcherExecutor(ExecutorService executor); - - /** - * Sets the health check interval for the Agones Builder. - * - * @param delay The delay duration for health checks. {@code null} to disable it. Disabled by default. - * @param period The interval duration for health checks. - * - * @return The Agones Builder instance. - */ - Builder withHealthCheck(Duration delay, Duration period); - - /** - * Sets the health check executor for the builder. - * - * @param executor the scheduled executor service to be used for health checks. {@code null} to disable it. Default is {@link Executors#newSingleThreadScheduledExecutor()} - * - * @return The Agones Builder instance. - */ - Builder withHealthCheckExecutor(ScheduledExecutorService executor); - } -} diff --git a/src/main/java/tr/com/infumia/agones4j/AgonesCounter.java b/src/main/java/tr/com/infumia/agones4j/AgonesCounter.java deleted file mode 100644 index 275af7f..0000000 --- a/src/main/java/tr/com/infumia/agones4j/AgonesCounter.java +++ /dev/null @@ -1,77 +0,0 @@ -package tr.com.infumia.agones4j; - -import java.util.Objects; -import java.util.StringJoiner; - -/** - * Represents a counter in the Agones system. - */ -public final class AgonesCounter { - - private final String name; - private final long capacity; - private final long count; - - AgonesCounter(final String name, final long capacity, final long count) { - this.name = name; - this.capacity = capacity; - this.count = count; - } - - /** - * Retrieves the counter name. - * - * @return the name. - */ - public String getName() { - return this.name; - } - - /** - * Retrieves the counter capacity. - * - * @return the capacity. - */ - public long getCapacity() { - return this.capacity; - } - - /** - * Returns the counter count. - * - * @return the count. - */ - public long getCount() { - return this.count; - } - - @Override - public boolean equals(final Object obj) { - if (this == obj) { - return true; - } - if (obj == null || this.getClass() != obj.getClass()) { - return false; - } - final AgonesCounter that = (AgonesCounter) obj; - return ( - Objects.equals(this.capacity, that.capacity) && - Objects.equals(this.name, that.name) && - Objects.equals(this.count, that.count) - ); - } - - @Override - public int hashCode() { - return Objects.hash(this.name, this.capacity, this.count); - } - - @Override - public String toString() { - return new StringJoiner(", ", AgonesCounter.class.getSimpleName() + "[", "]") - .add("name='" + this.name + "'") - .add("capacity=" + this.capacity) - .add("count=" + this.count) - .toString(); - } -} diff --git a/src/main/java/tr/com/infumia/agones4j/AgonesImpl.java b/src/main/java/tr/com/infumia/agones4j/AgonesImpl.java deleted file mode 100644 index d6414df..0000000 --- a/src/main/java/tr/com/infumia/agones4j/AgonesImpl.java +++ /dev/null @@ -1,382 +0,0 @@ -package tr.com.infumia.agones4j; - -import agones.dev.sdk.Sdk; -import agones.dev.sdk.alpha.Alpha; -import com.google.protobuf.FieldMask; -import com.google.protobuf.Int64Value; -import io.grpc.ManagedChannel; -import io.grpc.stub.StreamObserver; -import java.time.Duration; -import java.util.ArrayList; -import java.util.Collections; -import java.util.List; -import java.util.Objects; -import java.util.concurrent.ExecutorService; -import java.util.concurrent.Executors; -import java.util.concurrent.ScheduledExecutorService; -import java.util.concurrent.ScheduledFuture; -import java.util.concurrent.TimeUnit; -import java.util.function.Consumer; - -final class AgonesImpl implements Agones { - - private final ManagedChannel channel; - - private final agones.dev.sdk.SDKGrpc.SDKStub sdk; - private final agones.dev.sdk.beta.SDKGrpc.SDKStub beta; - private final agones.dev.sdk.alpha.SDKGrpc.SDKStub alpha; - - private final ExecutorService gameServerWatcherExecutor; - private List> gameServerWatchers; - - private final Duration healthCheckDelay; - private final ScheduledExecutorService healthCheckExecutor; - private final Duration healthCheckPeriod; - private ScheduledFuture healthCheckTask; - - private AgonesImpl(final Builder builder) { - this.channel = builder.channel; - this.gameServerWatcherExecutor = builder.gameServerWatcherExecutor; - this.healthCheckExecutor = builder.healthCheckExecutor(); - this.healthCheckDelay = builder.healthCheckDelay; - this.healthCheckPeriod = builder.healthCheckPeriod; - this.sdk = agones.dev.sdk.SDKGrpc.newStub(builder.channel); - this.beta = agones.dev.sdk.beta.SDKGrpc.newStub(builder.channel); - this.alpha = agones.dev.sdk.alpha.SDKGrpc.newStub(builder.channel); - } - - @Override - public boolean canWatchGameServer() { - return this.gameServerWatcherExecutor != null; - } - - @Override - public void addGameServerWatcher(final Consumer watcher) { - Objects.requireNonNull(this.gameServerWatcherExecutor, "Game server watcher is not enabled!"); - if (this.gameServerWatchers == null) { - this.gameServerWatchers = Collections.synchronizedList(new ArrayList<>()); - final StreamObserver response = Internal.observerOnNext( - this.gameServerWatcherExecutor, - this.gameServerWatchers - ); - this.sdk.watchGameServer(Sdk.Empty.getDefaultInstance(), response); - } - this.gameServerWatchers.add(watcher); - } - - @Override - public boolean canHealthCheck() { - return this.healthCheckExecutor != null && this.healthCheckDelay != null && this.healthCheckPeriod != null; - } - - @Override - public void startHealthChecking() { - if (this.healthCheckExecutor == null || this.healthCheckDelay == null || this.healthCheckPeriod == null) { - throw new IllegalStateException("Health check is not enabled!"); - } - if (this.healthCheckTask != null) { - this.healthCheckTask.cancel(true); - } - final StreamObserver request = this.healthCheckStream(Internal.observerEmpty()); - this.healthCheckTask = - this.healthCheckExecutor.scheduleAtFixedRate( - () -> { - if (this.healthCheckTask != null && !this.healthCheckTask.isDone()) { - request.onNext(Sdk.Empty.getDefaultInstance()); - } - }, - this.healthCheckDelay.toMillis(), - this.healthCheckPeriod.toMillis(), - TimeUnit.MILLISECONDS - ); - } - - @Override - public void stopHealthChecking() { - if (this.healthCheckTask != null) { - this.healthCheckTask.cancel(true); - this.healthCheckTask = null; - } - } - - @Override - public StreamObserver healthCheckStream(final StreamObserver response) { - return this.sdk.health(response); - } - - @Override - public void allocate(final StreamObserver response) { - this.sdk.allocate(Sdk.Empty.getDefaultInstance(), response); - } - - @Override - public void getGameServer(final StreamObserver response) { - this.sdk.getGameServer(Sdk.Empty.getDefaultInstance(), response); - } - - @Override - public void ready(final StreamObserver response) { - this.sdk.ready(Sdk.Empty.getDefaultInstance(), response); - } - - @Override - public void reserve(final Duration duration, final StreamObserver response) { - this.sdk.reserve(Sdk.Duration.newBuilder().setSeconds(duration.getSeconds()).build(), response); - } - - @Override - public void shutdown(final StreamObserver response) { - this.sdk.shutdown(Sdk.Empty.getDefaultInstance(), response); - } - - @Override - public void setAnnotation(final String key, final String value, final StreamObserver observer) { - this.sdk.setAnnotation(Sdk.KeyValue.newBuilder().setKey(key).setValue(value).build(), observer); - } - - @Override - public void setLabel(final String key, final String value, final StreamObserver response) { - this.sdk.setLabel(Sdk.KeyValue.newBuilder().setKey(key).setValue(value).build(), response); - } - - @Override - public void getConnectedPlayersFuture(final StreamObserver> response) { - this.alpha.getConnectedPlayers( - Alpha.Empty.getDefaultInstance(), - Internal.observerMap(response, Alpha.PlayerIDList::getListList) - ); - } - - @Override - public void playerConnect(final String playerId, final StreamObserver response) { - this.alpha.playerConnect( - Alpha.PlayerID.newBuilder().setPlayerID(playerId).build(), - Internal.observerMap(response, Alpha.Bool::getBool) - ); - } - - @Override - public void playerDisconnect(final String playerId, final StreamObserver response) { - this.alpha.playerDisconnect( - Alpha.PlayerID.newBuilder().setPlayerID(playerId).build(), - Internal.observerMap(response, Alpha.Bool::getBool) - ); - } - - @Override - public void isPlayerConnected(final String playerId, final StreamObserver response) { - this.alpha.isPlayerConnected( - Alpha.PlayerID.newBuilder().setPlayerID(playerId).build(), - Internal.observerMap(response, Alpha.Bool::getBool) - ); - } - - @Override - public void setPlayerCapacity(final long capacity, final StreamObserver response) { - this.alpha.setPlayerCapacity(Alpha.Count.newBuilder().setCount(capacity).build(), Internal.observerEmptyAlpha()); - } - - @Override - public void getPlayerCapacity(final StreamObserver response) { - this.alpha.getPlayerCapacity( - Alpha.Empty.getDefaultInstance(), - Internal.observerMap(response, Alpha.Count::getCount) - ); - } - - @Override - public void getPlayerCount(final StreamObserver response) { - this.alpha.getPlayerCount(Alpha.Empty.getDefaultInstance(), Internal.observerMap(response, Alpha.Count::getCount)); - } - - @Override - public void getList(final String name, final StreamObserver response) { - final Alpha.GetListRequest request = Alpha.GetListRequest.newBuilder().setName(name).build(); - this.alpha.getList(request, Internal.observerMap(response, Internal::toList)); - } - - @Override - public void addList(final String name, final String value, final StreamObserver response) { - final Alpha.AddListValueRequest request = Alpha.AddListValueRequest - .newBuilder() - .setName(name) - .setValue(value) - .build(); - this.alpha.addListValue(request, Internal.observerMap(response, Internal::toList)); - } - - @Override - public void removeList(final String name, final String value, final StreamObserver response) { - final Alpha.RemoveListValueRequest request = Alpha.RemoveListValueRequest - .newBuilder() - .setName(name) - .setValue(value) - .build(); - this.alpha.removeListValue(request, Internal.observerMap(response, Internal::toList)); - } - - @Override - public void updateList( - final AgonesList list, - final List updateMask, - final StreamObserver response - ) { - final FieldMask mask = FieldMask.newBuilder().addAllPaths(updateMask).build(); - final Alpha.UpdateListRequest request = Alpha.UpdateListRequest - .newBuilder() - .setList(Internal.toAgonesList(list)) - .setUpdateMask(mask) - .build(); - this.alpha.updateList(request, Internal.observerMap(response, Internal::toList)); - } - - @Override - public void getCounter(final String name, final StreamObserver response) { - final Alpha.GetCounterRequest request = Alpha.GetCounterRequest.newBuilder().setName(name).build(); - this.alpha.getCounter(request, Internal.observerMap(response, Internal::toCounter)); - } - - @Override - public void increaseCounter(final String name, final long amount, final StreamObserver response) { - final Alpha.CounterUpdateRequest update = Alpha.CounterUpdateRequest - .newBuilder() - .setName(name) - .setCountDiff(amount >= 0 ? amount : Math.abs(amount)) - .build(); - final Alpha.UpdateCounterRequest request = Alpha.UpdateCounterRequest - .newBuilder() - .setCounterUpdateRequest(update) - .build(); - this.alpha.updateCounter(request, Internal.observerMap(response, Internal::toCounter)); - } - - @Override - public void decreaseCounter(final String name, final long amount, final StreamObserver response) { - final Alpha.CounterUpdateRequest update = Alpha.CounterUpdateRequest - .newBuilder() - .setName(name) - .setCountDiff(amount >= 0 ? -amount : amount) - .build(); - final Alpha.UpdateCounterRequest request = Alpha.UpdateCounterRequest - .newBuilder() - .setCounterUpdateRequest(update) - .build(); - this.alpha.updateCounter(request, Internal.observerMap(response, Internal::toCounter)); - } - - @Override - public void setCounterCount(final String name, final long amount, final StreamObserver response) { - final Alpha.CounterUpdateRequest update = Alpha.CounterUpdateRequest - .newBuilder() - .setName(name) - .setCount(Int64Value.newBuilder().setValue(amount).build()) - .build(); - final Alpha.UpdateCounterRequest request = Alpha.UpdateCounterRequest - .newBuilder() - .setCounterUpdateRequest(update) - .build(); - this.alpha.updateCounter(request, Internal.observerMap(response, Internal::toCounter)); - } - - @Override - public void setCounterCapacity(final String name, final long amount, final StreamObserver response) { - final Alpha.CounterUpdateRequest update = Alpha.CounterUpdateRequest - .newBuilder() - .setName(name) - .setCapacity(Int64Value.newBuilder().setValue(amount).build()) - .build(); - final Alpha.UpdateCounterRequest request = Alpha.UpdateCounterRequest - .newBuilder() - .setCounterUpdateRequest(update) - .build(); - this.alpha.updateCounter(request, Internal.observerMap(response, Internal::toCounter)); - } - - @Override - public void close() throws Exception { - this.channel.shutdown().awaitTermination(5L, TimeUnit.SECONDS); - } - - static final class Builder implements Agones.Builder { - - private final ManagedChannel channel; - private final ExecutorService gameServerWatcherExecutor; - private final ScheduledExecutorService healthCheckExecutor; - private final Duration healthCheckDelay; - private final Duration healthCheckPeriod; - - private Builder( - final ManagedChannel channel, - final ExecutorService gameServerWatcherExecutor, - final ScheduledExecutorService healthCheckExecutor, - final Duration healthCheckDelay, - final Duration healthCheckPeriod - ) { - this.channel = channel; - this.gameServerWatcherExecutor = gameServerWatcherExecutor; - this.healthCheckExecutor = healthCheckExecutor; - this.healthCheckDelay = healthCheckDelay; - this.healthCheckPeriod = healthCheckPeriod; - } - - Builder() { - this(null, null, null, null, null); - } - - @Override - public Agones build() { - if (this.channel == null) { - return this.withChannel().build(); - } - return new AgonesImpl(this); - } - - @Override - public Agones.Builder withChannel(final ManagedChannel channel) { - return new Builder( - channel, - this.gameServerWatcherExecutor, - this.healthCheckExecutor, - this.healthCheckDelay, - this.healthCheckPeriod - ); - } - - @Override - public Agones.Builder withGameServerWatcherExecutor(final ExecutorService executor) { - return new Builder( - this.channel, - executor, - this.healthCheckExecutor, - this.healthCheckDelay, - this.healthCheckPeriod - ); - } - - @Override - public Agones.Builder withHealthCheck(final Duration delay, final Duration period) { - return new Builder(this.channel, this.gameServerWatcherExecutor, this.healthCheckExecutor, delay, period); - } - - @Override - public Agones.Builder withHealthCheckExecutor(final ScheduledExecutorService executor) { - return new Builder( - this.channel, - this.gameServerWatcherExecutor, - executor, - this.healthCheckDelay, - this.healthCheckPeriod - ); - } - - private ScheduledExecutorService healthCheckExecutor() { - if (this.healthCheckExecutor != null) { - return this.healthCheckExecutor; - } - if (this.healthCheckDelay != null) { - return Executors.newSingleThreadScheduledExecutor(); - } - return null; - } - } -} diff --git a/src/main/java/tr/com/infumia/agones4j/AgonesList.java b/src/main/java/tr/com/infumia/agones4j/AgonesList.java deleted file mode 100644 index 5cc7667..0000000 --- a/src/main/java/tr/com/infumia/agones4j/AgonesList.java +++ /dev/null @@ -1,79 +0,0 @@ -package tr.com.infumia.agones4j; - -import java.util.Collections; -import java.util.List; -import java.util.Objects; -import java.util.StringJoiner; - -/** - * Represents a list in the Agones system. - */ -public final class AgonesList { - - private final String name; - private final long capacity; - private final List values; - - AgonesList(final String name, final long capacity, final List values) { - this.name = name; - this.capacity = capacity; - this.values = Collections.unmodifiableList(values); - } - - /** - * Retrieves the name of the list. - * - * @return The name. - */ - public String getName() { - return this.name; - } - - /** - * Retrieves the capacity of the list. - * - * @return The capacity. - */ - public long getCapacity() { - return this.capacity; - } - - /** - * Returns the values of the list. - * - * @return the values. - */ - public List getValues() { - return this.values; - } - - @Override - public boolean equals(final Object obj) { - if (this == obj) { - return true; - } - if (obj == null || this.getClass() != obj.getClass()) { - return false; - } - final AgonesList that = (AgonesList) obj; - return ( - Objects.equals(this.capacity, that.capacity) && - Objects.equals(this.name, that.name) && - Objects.equals(this.values, that.values) - ); - } - - @Override - public int hashCode() { - return Objects.hash(this.name, this.capacity, this.values); - } - - @Override - public String toString() { - return new StringJoiner(", ", AgonesList.class.getSimpleName() + "[", "]") - .add("name='" + this.name + "'") - .add("capacity=" + this.capacity) - .add("values=" + this.values) - .toString(); - } -} diff --git a/src/main/java/tr/com/infumia/agones4j/Internal.java b/src/main/java/tr/com/infumia/agones4j/Internal.java deleted file mode 100644 index 0950825..0000000 --- a/src/main/java/tr/com/infumia/agones4j/Internal.java +++ /dev/null @@ -1,173 +0,0 @@ -package tr.com.infumia.agones4j; - -import agones.dev.sdk.Sdk; -import agones.dev.sdk.alpha.Alpha; -import io.grpc.stub.StreamObserver; -import java.util.List; -import java.util.Objects; -import java.util.Optional; -import java.util.concurrent.CompletableFuture; -import java.util.concurrent.Executor; -import java.util.concurrent.atomic.AtomicReference; -import java.util.function.Consumer; -import java.util.function.Function; - -final class Internal { - - private static final int DEFAULT_GRPC_PORT = 9357; - private static final String DEFAULT_GRPC_HOST = "localhost"; - - private static final String ENV_GRPC_HOST = "AGONES_SDK_GRPC_HOST"; - private static final String ENV_GRPC_PORT = "AGONES_SDK_GRPC_PORT"; - private static final String ENV_GRPC_ADDRESS = "AGONES_SDK_GRPC_ADDRESS"; - - static final String GRPC_HOST = Internal.getEnv(Internal.ENV_GRPC_HOST, Internal.DEFAULT_GRPC_HOST); - static final int GRPC_PORT = Internal.getEnvAsInt(Internal.ENV_GRPC_PORT, Internal.DEFAULT_GRPC_PORT); - static final String GRPC_ADDRESS = Internal.getEnv(Internal.ENV_GRPC_ADDRESS, null); - - private static final StreamObserver EMPTY = new Adapter<>(); - private static final StreamObserver EMPTY_ALPHA = new Adapter<>(); - - private Internal() { - throw new UnsupportedOperationException("This is a utility class and cannot be instantiated"); - } - - static AgonesCounter toCounter(final Alpha.Counter counter) { - return new AgonesCounter(counter.getName(), counter.getCapacity(), counter.getCount()); - } - - static AgonesList toList(final Alpha.List list) { - return new AgonesList(list.getName(), list.getCapacity(), list.getValuesList()); - } - - static Alpha.List toAgonesList(final AgonesList list) { - return Alpha.List - .newBuilder() - .setName(list.getName()) - .setCapacity(list.getCapacity()) - .addAllValues(list.getValues()) - .build(); - } - - private static String getEnv(final String key, final String def) { - Objects.requireNonNull(key, "key"); - return Internal.getEnvOptional(key).orElse(def); - } - - private static int getEnvAsInt(final String key, final int def) { - Objects.requireNonNull(key, "key"); - return Internal.getEnvOptional(key).flatMap(Internal::parseInt).orElse(def); - } - - private static Optional getEnvOptional(final String key) { - Objects.requireNonNull(key, "key"); - return Optional.ofNullable(Internal.getEnv(key)); - } - - private static String getEnv(final String key) { - Objects.requireNonNull(key, "key"); - return System.getenv(key); - } - - private static Optional parseInt(final String text) { - Objects.requireNonNull(text, "text"); - try { - return Optional.of(Integer.parseInt(text)); - } catch (final Exception ignored) {} - return Optional.empty(); - } - - static StreamObserver observerEmpty() { - return Internal.EMPTY; - } - - static StreamObserver observerEmptyAlpha() { - return Internal.EMPTY_ALPHA; - } - - static CompletableFuture observerToFuture(final Consumer> response) { - final CompletableFuture future = new CompletableFuture<>(); - response.accept(new Future<>(future)); - return future; - } - - static StreamObserver observerOnNext(final Executor executor, final List> consumers) { - return new Adapter() { - @Override - public void onNext(final T value) { - executor.execute(() -> { - for (final Consumer consumer : consumers) { - consumer.accept(value); - } - }); - } - }; - } - - static StreamObserver observerMap(final StreamObserver observer, final Function mapper) { - return new Mapped<>(observer, mapper); - } - - private static final class Mapped implements StreamObserver { - - private final StreamObserver observer; - private final Function mapper; - - private Mapped(final StreamObserver observer, final Function mapper) { - this.observer = observer; - this.mapper = mapper; - } - - @Override - public void onNext(final R value) { - this.observer.onNext(this.mapper.apply(value)); - } - - @Override - public void onError(final Throwable t) { - this.observer.onError(t); - } - - @Override - public void onCompleted() { - this.observer.onCompleted(); - } - } - - private static final class Future implements StreamObserver { - - private final AtomicReference value = new AtomicReference<>(); - private final CompletableFuture future; - - private Future(final CompletableFuture future) { - this.future = future; - } - - @Override - public void onNext(final T value) { - this.value.set(value); - } - - @Override - public void onError(final Throwable t) { - this.future.completeExceptionally(t); - } - - @Override - public void onCompleted() { - this.future.complete(this.value.get()); - } - } - - private static class Adapter implements StreamObserver { - - @Override - public void onNext(final T value) {} - - @Override - public void onError(final Throwable t) {} - - @Override - public void onCompleted() {} - } -} diff --git a/src/main/proto/allocation/allocation.proto b/src/main/proto/allocation/allocation.proto index b180296..6e4ff0b 100644 --- a/src/main/proto/allocation/allocation.proto +++ b/src/main/proto/allocation/allocation.proto @@ -79,13 +79,22 @@ message AllocationRequest { // Note: This field can only be set if neither Required or Preferred is set. repeated GameServerSelector gameServerSelectors = 8; - // (Alpha, CountsAndLists feature flag) The first Priority on the array of Priorities is the most - // important for sorting. The allocator will use the first priority for sorting GameServers in the - // Selector set, and will only use any following priority for tie-breaking during sort. - // Impacts which GameServer is checked first. + // [Stage: Beta] + // [FeatureFlag:CountsAndLists] + // `Priorities` configuration alters the order in which `GameServers` are searched for matches to the configured `selectors`. + // + // Priority of sorting is in descending importance. I.e. The position 0 `priority` entry is checked first. + // + // For `Packed` strategy sorting, this priority list will be the tie-breaker within the least utilised infrastructure, to ensure optimal + // infrastructure usage while also allowing some custom prioritisation of `GameServers`. + // + // For `Distributed` strategy sorting, the entire selection of `GameServers` will be sorted by this priority list to provide the + // order that `GameServers` will be allocated by. repeated Priority priorities = 9; - // (Alpha, CountsAndLists feature flag) Counters and Lists provide a set of actions to perform + // [Stage: Beta] + // [FeatureFlag:CountsAndLists] + // Counters and Lists provide a set of actions to perform // on Counters and Lists during allocation. map counters = 10; map lists = 11; @@ -105,6 +114,10 @@ message AllocationResponse { string source = 6; optional GameServerMetadata metadata = 7; + // (Beta, CountsAndLists feature flag) Status of Counters and Lists on allocation. + map counters = 9; + map lists = 10; + // The gameserver port info that is allocated. message GameServerStatusPort { string name = 1; @@ -121,6 +134,16 @@ message AllocationResponse { map labels = 1; map annotations = 2; } + + message CounterStatus { + google.protobuf.Int64Value count = 1; + google.protobuf.Int64Value capacity = 2; + } + + message ListStatus { + repeated string values = 1; + google.protobuf.Int64Value capacity = 2; + } } // Specifies settings for multi-cluster allocation. diff --git a/src/main/proto/sdk/alpha/alpha.proto b/src/main/proto/sdk/alpha/alpha.proto index 1f4cc33..37cc475 100644 --- a/src/main/proto/sdk/alpha/alpha.proto +++ b/src/main/proto/sdk/alpha/alpha.proto @@ -18,11 +18,6 @@ package agones.dev.sdk.alpha; option go_package = "./alpha"; import "google/api/annotations.proto"; -import "google/api/client.proto"; -import "google/api/field_behavior.proto"; -import "google/api/resource.proto"; -import "google/protobuf/empty.proto"; -import "google/protobuf/field_mask.proto"; import "google/protobuf/wrappers.proto"; import "grpc-gateway/protoc-gen-openapiv2/options/annotations.proto"; @@ -128,65 +123,6 @@ service SDK { get: "/alpha/player/connected" }; } - - // Gets a Counter. Returns NOT_FOUND if the Counter does not exist. - rpc GetCounter(GetCounterRequest) returns (Counter) { - option (google.api.http) = { - get: "/v1alpha1/counters/{name}" - }; - option (google.api.method_signature) = "name"; - } - - // UpdateCounter returns the updated Counter. Returns NOT_FOUND if the Counter does not exist (name cannot be updated). - // Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. - rpc UpdateCounter(UpdateCounterRequest) returns (Counter) { - option (google.api.http) = { - patch: "/v1alpha1/counters/{counterUpdateRequest.name}" - body: "counterUpdateRequest" - }; - option (google.api.method_signature) = "counterUpdateRequest"; - } - - // Gets a List. Returns NOT_FOUND if the List does not exist. - rpc GetList(GetListRequest) returns (List) { - option (google.api.http) = { - get: "/v1alpha1/lists/{name}" - }; - option (google.api.method_signature) = "name"; - } - - // UpdateList returns the updated List. Returns NOT_FOUND if the List does not exist (name cannot be updated). - // **THIS WILL OVERWRITE ALL EXISTING LIST.VALUES WITH ANY REQUEST LIST.VALUES** - // Use AddListValue() or RemoveListValue() for modifying the List.Values field. - // Returns INVALID_ARGUMENT if the field mask path(s) are not field(s) of the List. - // If a field mask path(s) is specified, but the value is not set in the request List object, - // then the default value for the variable will be set (i.e. 0 for "capacity", empty list for "values"). - rpc UpdateList(UpdateListRequest) returns (List) { - option (google.api.http) = { - patch: "/v1alpha1/lists/{list.name}" - body: "list" - }; - option (google.api.method_signature) = "list,update_mask"; - } - - // Adds a value to a List and returns updated List. Returns NOT_FOUND if the List does not exist. - // Returns ALREADY_EXISTS if the value is already in the List. - // Returns OUT_OF_RANGE if the List is already at Capacity. - rpc AddListValue(AddListValueRequest) returns (List) { - option (google.api.http) = { - post: "/v1alpha1/lists/{name}:addValue" - body: "*" - }; - } - - // Removes a value from a List and returns updated List. Returns NOT_FOUND if the List does not exist. - // Returns NOT_FOUND if the value is not in the List. - rpc RemoveListValue(RemoveListValueRequest) returns (List) { - option (google.api.http) = { - post: "/v1alpha1/lists/{name}:removeValue" - body: "*" - }; - } } // I am Empty @@ -212,111 +148,3 @@ message PlayerID { message PlayerIDList { repeated string list = 1; } - -// A representation of a Counter. -message Counter { - option (google.api.resource) = { - type: "agones.dev/Counter" - pattern: "counters/{counter}" - }; - // The name of the Counter - string name = 1; - // The current count of the Counter - int64 count = 2; - // The maximum capacity of the Counter - int64 capacity = 3; -} - -// A representation of a Counter Update Request. -message CounterUpdateRequest { - option (google.api.resource) = { - type: "agones.dev/CounterUpdateRequest" - pattern: "counterUpdateRequests/{counterUpdateRequest}" - }; - // The name of the Counter to update - string name = 1; - // The value to set the Counter Count - google.protobuf.Int64Value count = 2; - // The value to set the Counter Capacity - google.protobuf.Int64Value capacity = 3; - // countDiff tracks if a Counter Update Request is CountIncrement (positive), CountDecrement - // (negative), 0 if a CountSet or CapacitySet request - int64 countDiff = 4; -} - -message GetCounterRequest { - // The name of the Counter to get - string name = 1 [ - (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { - type: "agones.dev/Counter" - }]; -} - -message UpdateCounterRequest { - // The requested update to make to the Counter - CounterUpdateRequest counterUpdateRequest = 1 [ - (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { - type: "agones.dev/CounterUpdateRequest" - }]; -} - -// A representation of a List. -message List { - option (google.api.resource) = { - type: "agones.dev/List" - pattern: "lists/{list}" - }; - // The name of the List - string name = 1; - // The maximum capacity of the List - int64 capacity = 2; - // The array of items in the List ["v1", "v2", …] - repeated string values = 3; -} - -message GetListRequest { - // The name of the List to get - string name = 1 [ - (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { - type: "agones.dev/List" - }]; -} - -message UpdateListRequest { - // The List to update - List list = 1 [ - (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { - type: "agones.dev/List" - }]; - - // Required. Mask (list) of fields to update. - // Fields are specified relative to the List - // (e.g. `capacity`, `values`; *not* `List.capacity` or `List.values`). - google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED]; -} - -message AddListValueRequest { - // The name of the List to add a value to. - string name = 1 [ - (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { - type: "agones.dev/List" - }]; - - string value = 2 [(google.api.field_behavior) = REQUIRED]; -} - -message RemoveListValueRequest { - // The name of the List to remove a value from. - string name = 1 [ - (google.api.field_behavior) = REQUIRED, - (google.api.resource_reference) = { - type: "agones.dev/List" - }]; - - string value = 2 [(google.api.field_behavior) = REQUIRED]; -} diff --git a/src/main/proto/sdk/beta/beta.proto b/src/main/proto/sdk/beta/beta.proto index 02ec501..30b3bf8 100644 --- a/src/main/proto/sdk/beta/beta.proto +++ b/src/main/proto/sdk/beta/beta.proto @@ -18,6 +18,12 @@ package agones.dev.sdk.beta; option go_package = "./beta"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; +import "google/protobuf/wrappers.proto"; import "grpc-gateway/protoc-gen-openapiv2/options/annotations.proto"; option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_swagger) = { @@ -31,4 +37,175 @@ option (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_swagger) = { }; // SDK service to be used in the GameServer SDK to the Pod Sidecar -service SDK {} +service SDK { + // Gets a Counter. Returns NOT_FOUND if the Counter does not exist. + rpc GetCounter(GetCounterRequest) returns (Counter) { + option (google.api.http) = { + get: "/v1beta1/counters/{name}" + }; + option (google.api.method_signature) = "name"; + } + + // UpdateCounter returns the updated Counter. Returns NOT_FOUND if the Counter does not exist (name cannot be updated). + // Returns OUT_OF_RANGE if the Count is out of range [0,Capacity]. + rpc UpdateCounter(UpdateCounterRequest) returns (Counter) { + option (google.api.http) = { + patch: "/v1beta1/counters/{counterUpdateRequest.name}" + body: "counterUpdateRequest" + }; + option (google.api.method_signature) = "counterUpdateRequest"; + } + + // Gets a List. Returns NOT_FOUND if the List does not exist. + rpc GetList(GetListRequest) returns (List) { + option (google.api.http) = { + get: "/v1beta1/lists/{name}" + }; + option (google.api.method_signature) = "name"; + } + + // UpdateList returns the updated List. Returns NOT_FOUND if the List does not exist (name cannot be updated). + // **THIS WILL OVERWRITE ALL EXISTING LIST.VALUES WITH ANY REQUEST LIST.VALUES** + // Use AddListValue() or RemoveListValue() for modifying the List.Values field. + // Returns INVALID_ARGUMENT if the field mask path(s) are not field(s) of the List. + // If a field mask path(s) is specified, but the value is not set in the request List object, + // then the default value for the variable will be set (i.e. 0 for "capacity", empty list for "values"). + rpc UpdateList(UpdateListRequest) returns (List) { + option (google.api.http) = { + patch: "/v1beta1/lists/{list.name}" + body: "list" + }; + option (google.api.method_signature) = "list,update_mask"; + } + + // Adds a value to a List and returns updated List. Returns NOT_FOUND if the List does not exist. + // Returns ALREADY_EXISTS if the value is already in the List. + // Returns OUT_OF_RANGE if the List is already at Capacity. + rpc AddListValue(AddListValueRequest) returns (List) { + option (google.api.http) = { + post: "/v1beta1/lists/{name}:addValue" + body: "*" + }; + } + + // Removes a value from a List and returns updated List. Returns NOT_FOUND if the List does not exist. + // Returns NOT_FOUND if the value is not in the List. + rpc RemoveListValue(RemoveListValueRequest) returns (List) { + option (google.api.http) = { + post: "/v1beta1/lists/{name}:removeValue" + body: "*" + }; + } +} + +// I am Empty +message Empty { +} + +// A representation of a Counter. +message Counter { + option (google.api.resource) = { + type: "agones.dev/Counter" + pattern: "counters/{counter}" + }; + // The name of the Counter + string name = 1; + // The current count of the Counter + int64 count = 2; + // The maximum capacity of the Counter + int64 capacity = 3; +} + +// A representation of a Counter Update Request. +message CounterUpdateRequest { + option (google.api.resource) = { + type: "agones.dev/CounterUpdateRequest" + pattern: "counterUpdateRequests/{counterUpdateRequest}" + }; + // The name of the Counter to update + string name = 1; + // The value to set the Counter Count + google.protobuf.Int64Value count = 2; + // The value to set the Counter Capacity + google.protobuf.Int64Value capacity = 3; + // countDiff tracks if a Counter Update Request is CountIncrement (positive), CountDecrement + // (negative), 0 if a CountSet or CapacitySet request + int64 countDiff = 4; +} + +message GetCounterRequest { + // The name of the Counter to get + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "agones.dev/Counter" + }]; +} + +message UpdateCounterRequest { + // The requested update to make to the Counter + CounterUpdateRequest counterUpdateRequest = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "agones.dev/CounterUpdateRequest" + }]; +} + +// A representation of a List. +message List { + option (google.api.resource) = { + type: "agones.dev/List" + pattern: "lists/{list}" + }; + // The name of the List + string name = 1; + // The maximum capacity of the List + int64 capacity = 2; + // The array of items in the List ["v1", "v2", …] + repeated string values = 3; +} + +message GetListRequest { + // The name of the List to get + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "agones.dev/List" + }]; +} + +message UpdateListRequest { + // The List to update + List list = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "agones.dev/List" + }]; + + // Required. Mask (list) of fields to update. + // Fields are specified relative to the List + // (e.g. `capacity`, `values`; *not* `List.capacity` or `List.values`). + google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED]; +} + +message AddListValueRequest { + // The name of the List to add a value to. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "agones.dev/List" + }]; + + string value = 2 [(google.api.field_behavior) = REQUIRED]; +} + +message RemoveListValueRequest { + // The name of the List to remove a value from. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "agones.dev/List" + }]; + + string value = 2 [(google.api.field_behavior) = REQUIRED]; +} \ No newline at end of file diff --git a/src/main/proto/sdk/sdk.proto b/src/main/proto/sdk/sdk.proto index 9f5ff68..50c9335 100644 --- a/src/main/proto/sdk/sdk.proto +++ b/src/main/proto/sdk/sdk.proto @@ -167,14 +167,14 @@ message GameServer { repeated string ids = 3; } - // [Stage:Alpha] + // [Stage:Beta] // [FeatureFlag:CountsAndLists] message CounterStatus { int64 count = 1; int64 capacity = 2; } - // [Stage:Alpha] + // [Stage:Beta] // [FeatureFlag:CountsAndLists] message ListStatus { int64 capacity = 1; @@ -190,11 +190,11 @@ message GameServer { // [FeatureFlag:PlayerTracking] PlayerStatus players = 4; - // [Stage:Alpha] + // [Stage:Beta] // [FeatureFlag:CountsAndLists] map counters = 5; - // [Stage:Alpha] + // [Stage:Beta] // [FeatureFlag:CountsAndLists] map lists = 6; }