chili-core

The chili core is an opinionated framework for creating microservices with focus on speed of development and time to market. It's based on the Vert.x toolkit for maximum power and uses Hazelcast for plug-and-play clustering. This project is small with only 22k LOC.

Find the official documentation here.

Quickstart

Using gradle

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    compile "com.github.codingchili.chili-core:core:<version>"
}

Creating a new handler

@Role(PUBLIC)
@Address("api")
public class MyHandler implements CoreHandler {
    private Protocol<Request> protocol = new Protocol<>(this);
    
    @Api
    public void list(Request request) {
        request.write(new ArrayList<>(Arrays.asList("hello", "world")));
    } 
    
    @Override
    public void handle(Request request) {
        protocol.process(request);
    }
    
}

Deploying a handler with the REST listener on port 8080 (default).

public static void main(String[] args) {
    ListenerSettings settings = new ListenerSettings()
            .setPort(8080)
            .setSecure(false);

    CoreContext core = new SystemContext();

    core.listener(() -> new RestListener()
            .settings(settings)
            .handler(new MyHandler()));
}

Start it up and check the service with

curl -v http://localhost:8080/api/list

Building

To build chili-core clone this repository with git,

git clone https://github.com/codingchili/chili-core.git

Builds project jars and run tests

gradlew build

Note: when targeting java 9+ the following hacks are needed for Netty/Vert.x

--add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/java.io=ALL-UNNAMED --add-opens=java.base/java.util=ALL-UNNAMED --add-opens=java.base/sun.net.dns=ALL-UNNAMED --add-opens=java.base/java.lang.reflect=ALL-UNNAMED --add-opens=java.base/java.nio=ALL-UNNAMED --add-opens=java.base/sun.nio.ch=ALL-UNNAMED

Background

The purpose of wrapping vertx in a framework is to increase productivity. This is done by providing common functionality that can be used to build microservices on as a framework. With all the logic packed into core, it is possible to create distributed microservices capable of handling authentication, request routing and storage in 66 lines of code. If you are interested in vertx, I recommend using it directly instead. This framework is intended to improve productivity for a single developer, aka the author. In order to achieve this it is much more invasive than the vertx toolkit.

Summary

• Built on the high-performance reactive toolkit vertx
• Uses clustering to improve scalability
• Support for a variety of storage options, query API's and a DSL.
• A distributed logging system and logging aggregator
• Highly adaptable and flexible with a configuration system
• High availability with support for multiple transports
• Text based protocols with JSON
• Adopts the microservice pattern

Features

The complete feature list may change during development.

Core

• Transport & storage independent implementations
• Logging system for data analysis and real time monitoring
• Authentication based on signed tokens.
• A router for routing external connections into the clustered event bus.
• Statistics API that builds on top of the logging system
• Interchangeable storage options with indexing and query support

Audience

• Programmers seeking to create microservices productively in a very specific use case.
• Game, web-app or mobile-app developers with an interest in backend development.

Makes use of

The core uses some great software, such as

• eclipse/vert.x - reactive: eventbus, clustering and networking
• EsotericSoftware/kryo - serialization library

Optional dependencies

• hazelcast/hazelcast - cluster management, data store
• npgall/cqengine - in-vm indexed collections with query support
• elastic/elasticsearch - distributed data indexing
• mongodb/mongo - document database

Read the documentation to learn more about optional dependencies.

Applications currently using chili-core

application	description
mutable-bunnies	2D MMORPG game in development.
zapperfly-asm	Extra simple clustered build servers.
ethereum-ingest	Ethereum block/transaction import utility.
flashcards	Progressive web app for studying with flashcards.

Contributing

Issues and PR's are welcome with 💙.

License

The MIT License (MIT) Copyright (c) 2019 Robin Duda

See: License