https://github.com/smoketurner/dropwizard-atomix

Dropwizard Atomix Bundle
https://github.com/smoketurner/dropwizard-atomix

atomix distributed-systems dropwizard dropwizard-atomix java jvm raft

Last synced: about 2 months ago
JSON representation

Dropwizard Atomix Bundle

• Host: GitHub
• URL: https://github.com/smoketurner/dropwizard-atomix
• Owner: smoketurner
• License: apache-2.0
• Archived: true
• Created: 2017-12-17T15:56:37.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2020-12-02T15:53:49.000Z (about 4 years ago)
• Last Synced: 2024-08-04T01:06:00.097Z (5 months ago)
• Topics: atomix, distributed-systems, dropwizard, dropwizard-atomix, java, jvm, raft
• Language: Java
• Homepage:
• Size: 842 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-dropwizard - dropwizard-atomix - Integration with [Atomix](http://atomix.io/) (Open Source / Data Stores)

README

        
Dropwizard Atomix

=================

[![Build Status](https://travis-ci.org/smoketurner/dropwizard-atomix.svg?branch=master)](https://travis-ci.org/smoketurner/dropwizard-atomix)

[![Maven Central](https://img.shields.io/maven-central/v/com.smoketurner.dropwizard/dropwizard-atomix.svg?style=flat-square)](https://maven-badges.herokuapp.com/maven-central/com.smoketurner.dropwizard/dropwizard-atomix/)

[![GitHub license](https://img.shields.io/github/license/smoketurner/dropwizard-atomix.svg?style=flat-square)](https://github.com/smoketurner/dropwizard-atomix/tree/master)

[![Become a Patron](https://img.shields.io/badge/Patron-Patreon-red.svg)](https://www.patreon.com/bePatron?u=9567343)

A bundle for integrating [Atomix](http://atomix.io/atomix/) in Dropwizard applications.

Usage

-----

Within your `Configuration` class, add the following:

```java

@Valid

@NotNull

private final AtomixFactory atomix = new AtomixFactory();

@JsonProperty

public AtomixFactory getAtomixFactory() {

    return atomix;

}

```

Then with your `Application` class, you can access an `Atomix` by doing the following:

```java

@Override

public void initialize(Bootstrap bootstrap) {

    bootstrap.addBundle(new AtomixBundle() {

        @Override

        public AtomixFactory getAtomixFactory(MyConfiguration configuration) {

            return configuration.getAtomixFactory();

        }

    });

}

@Override

public void run(MyConfiguration configuration, Environment environment) throws Exception {

    Atomix atomix = configuration.getAtomixFactory().build();

}

```

Maven Artifacts

---------------

This project is available on Maven Central. To add it to your project simply add the following dependencies to your `pom.xml`:

```xml

    com.smoketurner.dropwizard

    atomix-core

    1.3.7-1

```

Example Application

-------------------

To try the example application, checkout the code from Github then build the example hello world application.

```

git clone https://github.com/smoketurner/dropwizard-atomix.git

cd dropwizard-atomix

./mvnw compile package

cd atomix-example

```

You then need to open 3 separate terminal windows to launch 3 instances of the application:

```

java -jar target/atomix-example-1.3.7-2-SNAPSHOT.jar server config1.yml

java -jar target/atomix-example-1.3.7-2-SNAPSHOT.jar server config2.yml

java -jar target/atomix-example-1.3.7-2-SNAPSHOT.jar server config3.yml

```

Once a quorum has been reached, Jetty will start up as normal on a random port which you'll be able to see in the logs.

```

INFO  [2018-01-07 15:29:43,489] org.eclipse.jetty.server.handler.ContextHandler: Started i.d.j.MutableServletContextHandler@2ad99cf3{/admin,null,AVAILABLE}

INFO  [2018-01-07 15:29:43,494] org.eclipse.jetty.server.AbstractConnector: Started hello-world@554f0dfb{HTTP/1.1,[http/1.1]}{0.0.0.0:55419}

INFO  [2018-01-07 15:29:43,494] org.eclipse.jetty.server.Server: Started @13775ms

```

You can then visit `http://localhost:55419/hello-world` to see the Dropwizard [Getting Started](https://www.dropwizard.io/1.3.5/docs/getting-started.html) example, but using a distributed counter across the cluster.

Support

-------

Please file bug reports and feature requests in [GitHub issues](https://github.com/smoketurner/dropwizard-atomix/issues).

License

-------

Copyright (c) 2018 Smoke Turner, LLC

This library is licensed under the Apache License, Version 2.0.

See http://www.apache.org/licenses/LICENSE-2.0.html or the LICENSE file in this repository for the full license text.