kontraktor 4

What is kontraktor ?

• A boilerplate free and consistent abstraction for asynchronous remote communication powered by a distributed actor-model
• A SPA WebApp platform supporting a Java backend for modern SPA javascript client frameworks like Polymer.js, vue.js and React.js (transpilation, packaging, optimization). Different to webpack/browserify etc. kontraktor does this on the fly (when running in prod mode) without an extra build step using pure java. see IntrinsicReact example
• eases polyglot (java, javascript nodejs + browser) (micro-)service oriented distributed systems
• separates network transport (TCP, WebSockets, Http) and message encoding (fast-serialization, json, ..) from application code.
• Async REST services
• asynchronous, non-blocking
• high performance
• production proven

Documentation

Code Examples, Related Blogpost's

What can I use it for ?

• build modern microservice systems (java (JVM), nodejs) beyond the Limits of REST. Asynchronous, event sourced, encoding (fast binary, json for interop) and network transport independent (choose from TCP, WebSockets, Http-(Long Poll)).
• power modern SPA apps with a java based webserver

Credits: kontraktor makes use of many awesome open source libraries such as * undertow, (io.undertow) see undertow.io * jsoup (org.jsoup) - real world html parser * httpasyncclient (org.apache.httpcomponents) * npm-semver, (com.github.yuchi) * fast-classpath-scanner (io.github.lukehutch) * org.apache.commons, slf4j-api, minimal-json (com.eclipsesource.minimal-json), junit

Modules

Kontraktor consists of several modules. For sake of simplicity all module versions are kept in sync with kontraktor core.

Kontraktor Core

Actors + TCP Remoting

• transform regular java code (satisfying some conventions) into remoteable actors.
• no boilerplate required
• TCP remoting included (2 implementations: SyncIO and AsyncIO)
• general messaging optimizations: batching, binary queues (reduce GC load + save heap by queuing raw bytes instead of object's).

Core Documentation [in progress]

<dependency>
    <groupId>de.ruedigermoeller</groupId>
    <artifactId>kontraktor</artifactId>
    <version>4.19</version>
</dependency>

Kontraktor Http

Adds WebSockets, Http LongPoll for actor-remoting, JavaScript interop. Uses Undertow as underlying webserver

• npm modules to (a) implement a kontraktor actor (=service) using nodejs and (b) to connect a kontraktor service from nodejs
• server push via adaptive longpolling (polling automatically turns off if no pending callback / promise is present)
• support for websockets
• advanced bundling and inlining of resources (js, css, html) webpack style. Instead of introducing a build step, kontraktor bundles and caches your stuff dynamically upon first request (production mode).
• session handling fundamentals

JavaScript, Http-Documentation [in progress]

Instrinsic React/JSX Documentation [in progress]

<dependency>
    <groupId>de.ruedigermoeller</groupId>
    <artifactId>kontraktor-http</artifactId>
    <version>4.19</version>
</dependency>

kontraktor-http 4 javascript nodejs. npm modules

kontraktor-common

defines fundamentals: remote actor refs, en/decoding of Java-serialized objects, KPromise

kontraktor-client

Can be used from a browser (attention then: needs to be added using a