Cricket Microservices Framework

You do not need to download a half of the Internet to have your job done
Cricket Microservices Framework

Lightweight

360 kB size
9.1 k LOC
Java 9 ready
Runs on 1 MB RAM*

Free

Apache 2.0 licensed.
Hosted on GitHub.

Minimalistic

Plain Old Java
Configuration over convention
No hidden magic

Cloud Ready

Services build with Cricket can run on different cloud implementations. Dockerization of services is also an easy task, although not always necessary.

Clear architecture

Implements the "ports and adapters" (hexagonal) architecture pattern. The service is event driven with the smallest necessary dose of dependency injection.

HTTP server

HTTP/S requests handled internally to serve both REST and HTML page calls.

Key-Value database

In-memory, no SQL database can be used for fast prototyping.

Data to JSON serializer

Automatic JSON serialization/deserialization thanks to the json-io project.

Scheduler

One-time or repetitive tasks based on configuration or defined in code.

Logging

The StandardLogger (using Java Logger) can be replaced with other adapter of your choice, eg. centralized logging system.

Monitoring

Your service can monitor it's sensitive parameters or external services. Example adapters to monitor memory and disk space are included.

Quick start

Running your static web page in 1 minute
  1. Open terminal window in the newly created directory
  2. Download Cricket MSF library from the GitHub repository
  3. Create web page file
  4. Start the service
  5. Display your page in web browser at http://localhost:8080
  6. Stop the service by pressing Ctrl-C in the terminal window
wget https://github.com/gskorupa/Cricket/releases/download/1.2.31/cricket-1.2.31.jar
mkdir data
mkdir log
mkdir www
echo "Hello world">www/index.html
java -jar cricket-1.2.31.jar -r

Resources

In recent months, Cricket has undergone a lot of changes and gained some interesting features. For this reason, the documentation that has already been created is outdated in many parts.
I will consistently post new articles on the Signocom's blog or in the GitHub repository.
Stay tuned.

Sponsors