Java Client v0.0.6

Orisun Java Client v0.0.6

• build: make project version configurable via gradle property (b8a6f4a)

Installation

Download the orisun-java-client-0.0.6.jar file from the assets below.

Maven

Option 1: System dependency

Place the JAR in your project's lib/ directory and add to pom.xml:

<dependency>
    <groupId>com.orisunlabs</groupId>
    <artifactId>orisun-java-client</artifactId>
    <version>0.0.6</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/orisun-java-client-0.0.6.jar</systemPath>
</dependency>

Option 2: Install to local Maven repository

mvn install:install-file \
  -Dfile=orisun-java-client-0.0.6.jar \
  -DgroupId=com.orisunlabs \
  -DartifactId=orisun-java-client \
  -Dversion=0.0.6 \
  -Dpackaging=jar

Then add as a regular dependency in pom.xml:

<dependency>
    <groupId>com.orisunlabs</groupId>
    <artifactId>orisun-java-client</artifactId>
    <version>0.0.6</version>
</dependency>

Gradle

Option 1: Direct file dependency

Place the JAR in your project's libs/ directory and add to build.gradle:

dependencies {
    implementation files("libs/orisun-java-client-0.0.6.jar")
}

Option 2: Flat directory repository

repositories {
    flatDir { dirs 'libs' }
}

dependencies {
    implementation "com.orisunlabs:orisun-java-client:0.0.6"
}

Option 3: Build from source

git clone https://github.com/oexza/orisun-client-java.git
cd orisun-client-java
git submodule update --init --recursive
./gradlew build

The JAR will be at: build/libs/orisun-client-0.0.6.jar

Usage

See the README for detailed usage instructions.

Quick Start - OrisunClient (Event Operations)

import com.orisunlabs.orisun.client.OrisunClient;
import com.orisun.eventstore.Eventstore;

try (OrisunClient client = OrisunClient.newBuilder()
    .withServer("localhost", 5005)
    .withBasicAuth("admin", "changeit")
    .build()) {

    // Save events
    Eventstore.SaveEventsRequest request = Eventstore.SaveEventsRequest.newBuilder()
        .setBoundary("users")
        .addEvents(Eventstore.EventToSave.newBuilder()
            .setEventId(java.util.UUID.randomUUID().toString())
            .setEventType("UserCreated")
            .setData("{\"userId\":\"user-123\"}")
            .build())
        .build();

    client.saveEvents(request);
}

Quick Start - AdminClient (User Management)

import com.orisunlabs.orisun.client.AdminClient;
import com.orisun.admin.AdminOuterClass.*;

try (AdminClient adminClient = AdminClient.newBuilder()
    .withServer("localhost", 5005)
    .withBasicAuth("admin", "changeit")
    .build()) {

    // Create a user
    CreateUserRequest request = CreateUserRequest.newBuilder()
        .setName("John Doe")
        .setUsername("johndoe")
        .setPassword("securePassword123")
        .addRoles("user")
        .build();

    AdminUser user = adminClient.createUser(request);
}

Java Client v0.0.5

Orisun Java Client v0.0.5

• fix gradle release (3de7718)

Installation

Download the orisun-java-client-0.0.5.jar file from the assets below.

Maven

Option 1: System dependency

Place the JAR in your project's lib/ directory and add to pom.xml:

<dependency>
    <groupId>com.orisunlabs</groupId>
    <artifactId>orisun-java-client</artifactId>
    <version>0.0.5</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/orisun-java-client-0.0.5.jar</systemPath>
</dependency>

Option 2: Install to local Maven repository

mvn install:install-file \
  -Dfile=orisun-java-client-0.0.5.jar \
  -DgroupId=com.orisunlabs \
  -DartifactId=orisun-java-client \
  -Dversion=0.0.5 \
  -Dpackaging=jar

Then add as a regular dependency in pom.xml:

<dependency>
    <groupId>com.orisunlabs</groupId>
    <artifactId>orisun-java-client</artifactId>
    <version>0.0.5</version>
</dependency>

Gradle

Option 1: Direct file dependency

Place the JAR in your project's libs/ directory and add to build.gradle:

dependencies {
    implementation files("libs/orisun-java-client-0.0.5.jar")
}

Option 2: Flat directory repository

repositories {
    flatDir { dirs 'libs' }
}

dependencies {
    implementation "com.orisunlabs:orisun-java-client:0.0.5"
}

Option 3: Build from source

git clone https://github.com/oexza/orisun-client-java.git
cd orisun-client-java
git submodule update --init --recursive
./gradlew build

The JAR will be at: build/libs/orisun-client-0.0.5.jar

Usage

See the README for detailed usage instructions.

Quick Start - OrisunClient (Event Operations)

import com.orisunlabs.orisun.client.OrisunClient;
import com.orisun.eventstore.Eventstore;

try (OrisunClient client = OrisunClient.newBuilder()
    .withServer("localhost", 5005)
    .withBasicAuth("admin", "changeit")
    .build()) {

    // Save events
    Eventstore.SaveEventsRequest request = Eventstore.SaveEventsRequest.newBuilder()
        .setBoundary("users")
        .addEvents(Eventstore.EventToSave.newBuilder()
            .setEventId(java.util.UUID.randomUUID().toString())
            .setEventType("UserCreated")
            .setData("{\"userId\":\"user-123\"}")
            .build())
        .build();

    client.saveEvents(request);
}

Quick Start - AdminClient (User Management)

import com.orisunlabs.orisun.client.AdminClient;
import com.orisun.admin.AdminOuterClass.*;

try (AdminClient adminClient = AdminClient.newBuilder()
    .withServer("localhost", 5005)
    .withBasicAuth("admin", "changeit")
    .build()) {

    // Create a user
    CreateUserRequest request = CreateUserRequest.newBuilder()
        .setName("John Doe")
        .setUsername("johndoe")
        .setPassword("securePassword123")
        .addRoles("user")
        .build();

    AdminUser user = adminClient.createUser(request);
}

Java Client v0.1.5

Orisun Java Client v0.1.5

Installation

Download the orisun-java-client-0.1.5.jar file from the assets below.

Maven

Option 1: System dependency

Place the JAR in your project's lib/ directory and add to pom.xml:

<dependency>
    <groupId>com.orisunlabs</groupId>
    <artifactId>orisun-java-client</artifactId>
    <version>0.1.5</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/orisun-java-client-0.1.5.jar</systemPath>
</dependency>

Option 2: Install to local Maven repository

mvn install:install-file \
  -Dfile=orisun-java-client-0.1.5.jar \
  -DgroupId=com.orisunlabs \
  -DartifactId=orisun-java-client \
  -Dversion=0.1.5 \
  -Dpackaging=jar

Then add as a regular dependency in pom.xml:

<dependency>
    <groupId>com.orisunlabs</groupId>
    <artifactId>orisun-java-client</artifactId>
    <version>0.1.5</version>
</dependency>

Gradle

Option 1: Direct file dependency

Place the JAR in your project's libs/ directory and add to build.gradle:

dependencies {
    implementation files("libs/orisun-java-client-0.1.5.jar")
}

Option 2: Flat directory repository

repositories {
    flatDir { dirs 'libs' }
}

dependencies {
    implementation "com.orisunlabs:orisun-java-client:0.1.5"
}

Option 3: Build from source

git clone https://github.com/oexza/orisun-client-java.git
cd orisun-client-java
git submodule update --init --recursive
./gradlew build

The JAR will be at: build/libs/orisun-client-0.1.5.jar

Usage

See the README for detailed usage instructions.

Quick Start - OrisunClient (Event Operations)

import com.orisunlabs.orisun.client.OrisunClient;
import com.orisun.eventstore.Eventstore;

try (OrisunClient client = OrisunClient.newBuilder()
    .withServer("localhost", 5005)
    .withBasicAuth("admin", "changeit")
    .build()) {

    // Save events
    Eventstore.SaveEventsRequest request = Eventstore.SaveEventsRequest.newBuilder()
        .setBoundary("users")
        .addEvents(Eventstore.EventToSave.newBuilder()
            .setEventId(java.util.UUID.randomUUID().toString())
            .setEventType("UserCreated")
            .setData("{\"userId\":\"user-123\"}")
            .build())
        .build();

    client.saveEvents(request);
}

Quick Start - AdminClient (User Management)

import com.orisunlabs.orisun.client.AdminClient;
import com.orisun.admin.AdminOuterClass.*;

try (AdminClient adminClient = AdminClient.newBuilder()
    .withServer("localhost", 5005)
    .withBasicAuth("admin", "changeit")
    .build()) {

    // Create a user
    CreateUserRequest request = CreateUserRequest.newBuilder()
        .setName("John Doe")
        .setUsername("johndoe")
        .setPassword("securePassword123")
        .addRoles("user")
        .build();

    AdminUser user = adminClient.createUser(request);
}

Java Client v0.0.4

Orisun Java Client v0.0.4

• docs: update installation and usage documentation (713cd2a)
• fix: remove null checks that cause NPE in admin validator (c075a82)
• Merge remote-tracking branch 'origin/main' (c477da4)
• feat(client): enhance admin client functionality and examples (e435dda)

Installation

Download the orisun-java-client-0.0.4.jar file from the assets below.

Maven

Option 1: System dependency

Place the JAR in your project's lib/ directory and add to pom.xml:

<dependency>
    <groupId>com.orisunlabs</groupId>
    <artifactId>orisun-java-client</artifactId>
    <version>0.0.4</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/orisun-java-client-0.0.4.jar</systemPath>
</dependency>

Option 2: Install to local Maven repository

mvn install:install-file \
  -Dfile=orisun-java-client-0.0.4.jar \
  -DgroupId=com.orisunlabs \
  -DartifactId=orisun-java-client \
  -Dversion=0.0.4 \
  -Dpackaging=jar

Then add as a regular dependency in pom.xml:

<dependency>
    <groupId>com.orisunlabs</groupId>
    <artifactId>orisun-java-client</artifactId>
    <version>0.0.4</version>
</dependency>

Gradle

Option 1: Direct file dependency

Place the JAR in your project's libs/ directory and add to build.gradle:

dependencies {
    implementation files("libs/orisun-java-client-0.0.4.jar")
}

Option 2: Flat directory repository

repositories {
    flatDir { dirs 'libs' }
}

dependencies {
    implementation "com.orisunlabs:orisun-java-client:0.0.4"
}

Option 3: Build from source

git clone https://github.com/oexza/orisun-client-java.git
cd orisun-client-java
git submodule update --init --recursive
./gradlew build

The JAR will be at: build/libs/orisun-client-0.0.4.jar

Usage

See the README for detailed usage instructions.

Quick Start - OrisunClient (Event Operations)

import com.orisunlabs.orisun.client.OrisunClient;
import com.orisun.eventstore.Eventstore;

try (OrisunClient client = OrisunClient.newBuilder()
    .withServer("localhost", 5005)
    .withBasicAuth("admin", "changeit")
    .build()) {

    // Save events
    Eventstore.SaveEventsRequest request = Eventstore.SaveEventsRequest.newBuilder()
        .setBoundary("users")
        .addEvents(Eventstore.EventToSave.newBuilder()
            .setEventId(java.util.UUID.randomUUID().toString())
            .setEventType("UserCreated")
            .setData("{\"userId\":\"user-123\"}")
            .build())
        .build();

    client.saveEvents(request);
}

Quick Start - AdminClient (User Management)

import com.orisunlabs.orisun.client.AdminClient;
import com.orisun.admin.AdminOuterClass.*;

try (AdminClient adminClient = AdminClient.newBuilder()
    .withServer("localhost", 5005)
    .withBasicAuth("admin", "changeit")
    .build()) {

    // Create a user
    CreateUserRequest request = CreateUserRequest.newBuilder()
        .setName("John Doe")
        .setUsername("johndoe")
        .setPassword("securePassword123")
        .addRoles("user")
        .build();

    AdminUser user = adminClient.createUser(request);
}

Java Client v0.0.1

Orisun Java Client v0.0.1

• docs: update installation and usage documentation (713cd2a)
• fix: remove null checks that cause NPE in admin validator (c075a82)
• Merge remote-tracking branch 'origin/main' (c477da4)
• feat(client): enhance admin client functionality and examples (e435dda)

Installation

Download the orisun-java-client-0.0.1.jar file from the assets below.

Maven

Option 1: System dependency

Place the JAR in your project's lib/ directory and add to pom.xml:

<dependency>
    <groupId>com.orisunlabs</groupId>
    <artifactId>orisun-java-client</artifactId>
    <version>0.0.1</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/orisun-java-client-0.0.1.jar</systemPath>
</dependency>

Option 2: Install to local Maven repository

mvn install:install-file \
  -Dfile=orisun-java-client-0.0.1.jar \
  -DgroupId=com.orisunlabs \
  -DartifactId=orisun-java-client \
  -Dversion=0.0.1 \
  -Dpackaging=jar

Then add as a regular dependency in pom.xml:

<dependency>
    <groupId>com.orisunlabs</groupId>
    <artifactId>orisun-java-client</artifactId>
    <version>0.0.1</version>
</dependency>

Gradle

Option 1: Direct file dependency

Place the JAR in your project's libs/ directory and add to build.gradle:

dependencies {
    implementation files("libs/orisun-java-client-0.0.1.jar")
}

Option 2: Flat directory repository

repositories {
    flatDir { dirs 'libs' }
}

dependencies {
    implementation "com.orisunlabs:orisun-java-client:0.0.1"
}

Option 3: Build from source

git clone https://github.com/oexza/orisun-client-java.git
cd orisun-client-java
git submodule update --init --recursive
./gradlew build

The JAR will be at: build/libs/orisun-client-0.0.1.jar

Usage

See the README for detailed usage instructions.

Quick Start - OrisunClient (Event Operations)

import com.orisunlabs.orisun.client.OrisunClient;
import com.orisun.eventstore.Eventstore;

try (OrisunClient client = OrisunClient.newBuilder()
    .withServer("localhost", 5005)
    .withBasicAuth("admin", "changeit")
    .build()) {

    // Save events
    Eventstore.SaveEventsRequest request = Eventstore.SaveEventsRequest.newBuilder()
        .setBoundary("users")
        .addEvents(Eventstore.EventToSave.newBuilder()
            .setEventId(java.util.UUID.randomUUID().toString())
            .setEventType("UserCreated")
            .setData("{\"userId\":\"user-123\"}")
            .build())
        .build();

    client.saveEvents(request);
}

Quick Start - AdminClient (User Management)

import com.orisunlabs.orisun.client.AdminClient;
import com.orisun.admin.AdminOuterClass.*;

try (AdminClient adminClient = AdminClient.newBuilder()
    .withServer("localhost", 5005)
    .withBasicAuth("admin", "changeit")
    .build()) {

    // Create a user
    CreateUserRequest request = CreateUserRequest.newBuilder()
        .setName("John Doe")
        .setUsername("johndoe")
        .setPassword("securePassword123")
        .addRoles("user")
        .build();

    AdminUser user = adminClient.createUser(request);
}