https://github.com/infumia/agones4j

Java wrapper for Agones client SDK.
https://github.com/infumia/agones4j

agones grpc java

Last synced: 7 days ago
JSON representation

Java wrapper for Agones client SDK.

• Host: GitHub
• URL: https://github.com/infumia/agones4j
• Owner: Infumia
• License: mit
• Created: 2022-07-05T05:47:32.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-12-18T16:49:32.000Z (10 days ago)
• Last Synced: 2024-12-18T17:41:58.989Z (10 days ago)
• Topics: agones, grpc, java
• Language: Java
• Homepage:
• Size: 486 KB
• Stars: 18
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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 {

  mavenCentral()

}

dependencies {

    // 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:6.0.53"

}

```

```java

  void agones() {

    final ExecutorService gameServerWatcherExecutor =

      Executors.newSingleThreadExecutor();

    final ScheduledExecutorService healthCheckExecutor =

      Executors.newSingleThreadScheduledExecutor();

    final Agones agones = Agones.builder()

      // Address specification.

      // If not specified, localhost:9357 will be used.

      // All the following methods are creating a ManagedChannel with 'usePlaintext'

      // If you need to use SSL, you can use 'withChannel(ManagedChannel)' method.

      .withAddress("localhost", 9357)

      .withAddress("localhost") // 9357 

      .withAddress(9357) // localhost

      .withAddress() // localhost 9357

      .withTarget("localhost:9357")

      .withTarget() // localhost:9357

      .withChannel(ManagedChannelBuilder

        .forAddress("localhost", 9357)

        .usePlaintext()

        .build())

      .withChannel() // localhost:9357

      // Game server watcher executor specification.

      .withGameServerWatcherExecutor(gameServerWatcherExecutor)

      // Health checker executor specification.

      // Check you game server's health check threshold and

      // set the executor's delay and period accordingly.

      .withHealthCheck(

        /* delay */Duration.ofSeconds(1L),

        /* period */Duration.ofSeconds(2L)

      )

      .withHealthCheckerExecutor(healthCheckExecutor)

      .build();

  // Health checking.

  // Checks if the executor, delay and period are specified.

  if (agones.canHealthCheck()) {

    // Automatic health checking.

    // Uses the health checker executor and the specified delay and period.

    agones.startHealthChecking();

  }

  // Manual health checking.

  final StreamObserver requester = agones.healthCheck();

  // onNext needs to be called continuously to keep the game server healthy.

  requester.onNext(Empty.getDefaultInstance());

  // Stopping the health checking.

  agones.stopHealthChecking();

  // Game server watching.

  // Checks if the executor is specified.

  if (agones.canWatchGameServer()) {

    agones.addGameServerWatcher(gameServer ->

      // This will be called when the game server is updated.

      System.out.println("Game server updated: " + gameServer));

  }

  agones.allocate();

  agones.shutdown();

}

```