Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/codingchili/chili-core
Reactive framework for creating transport & storage-transparent microservices with Vert.x
https://github.com/codingchili/chili-core
cqengine elasticsearch framework hazelcast java microservice mongodb reactive vertx
Last synced: 11 days ago
JSON representation
Reactive framework for creating transport & storage-transparent microservices with Vert.x
- Host: GitHub
- URL: https://github.com/codingchili/chili-core
- Owner: codingchili
- License: mit
- Created: 2016-04-07T15:44:00.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-02-10T19:09:48.000Z (9 months ago)
- Last Synced: 2024-10-10T20:54:04.657Z (28 days ago)
- Topics: cqengine, elasticsearch, framework, hazelcast, java, microservice, mongodb, reactive, vertx
- Language: Java
- Homepage: https://codingchili.github.io/chili-core/
- Size: 157 MB
- Stars: 14
- Watchers: 6
- Forks: 5
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Security: docs/security.md
Awesome Lists containing this project
README
# chili-core [](https://travis-ci.com/codingchili/chili-core) [](https://jitpack.io/#codingchili/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](https://codingchili.github.io/chili-core/).
## Quickstart
Using gradle
```groovy
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
compile "com.github.codingchili.chili-core:core:"
}
```
Creating a new handler
```java
@Role(PUBLIC)
@Address("api")
public class MyHandler implements CoreHandler {
private Protocol 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).
```java
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
```console
curl -v http://localhost:8080/api/list
```
## Building
To build chili-core clone this repository with **git**,
```console
git clone https://github.com/codingchili/chili-core.git
```
Builds project jars and run tests
```console
gradlew build
```
Note: when targeting java 9+ the following hacks are needed for Netty/Vert.x
```console
--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](https://github.com/eclipse/vert.x) - reactive: eventbus, clustering and networking
* [EsotericSoftware/kryo](https://github.com/EsotericSoftware/kryo) - serialization library
Optional dependencies
* [hazelcast/hazelcast](https://github.com/hazelcast/hazelcast) - cluster management, data store
* [npgall/cqengine](https://github.com/npgall/cqengine) - in-vm indexed collections with query support
* [elastic/elasticsearch](https://github.com/elastic/elasticsearch) - distributed data indexing
* [mongodb/mongo](https://github.com/mongodb/mongo) - document database
Read the documentation to learn more about optional dependencies.
Applications currently using chili-core
|application|description|
|---|---|
|[mutable-bunnies](https://github.com/codingchili/mutable-bunnies-server)|2D MMORPG game in development.|
|[zapperfly-asm](https://github.com/codingchili/zapperfly-asm)|Extra simple clustered build servers.|
|[ethereum-ingest](https://github.com/codingchili/ethereum-ingest)|Ethereum block/transaction import utility.|
|[flashcards](https://github.com/codingchili/flashcards-webapp)|Progressive web app for studying with flashcards.|
## Contributing
Issues and PR's are welcome with :blue_heart:.
## License
The MIT License (MIT)
Copyright (c) 2019 Robin Duda
See: [License](./LICENSE.md)