JarCastingCOMSAT
Scalable, Concurrent Web Apps
Getting started
Add the following Maven/Gradle dependencies:
| Feature | Artifact |
|---|---|
| Servlet integration for defining fiber-per-request servlets. | co.paralleluniverse:comsat-servlet:0.7.0 |
| A fiber-blocking Clojure Ring adapter based on Jetty 9.3. | co.paralleluniverse:comsat-ring-jetty9:0.7.0 |
| HTTP Kit-based fiber-blocking HTTP client. | co.paralleluniverse:comsat-httpkit:0.7.0 |
| Jersey server integration for defining REST services. | co.paralleluniverse:comsat-jersey-server:0.7.0 |
| Dropwizard integration including Jersey, ApacheHttpClient and JDBI. | co.paralleluniverse:comsat-dropwizard:0.7.0 |
| Spring Framework Web MVC fiber-blocking controller methods integration. | co.paralleluniverse:comsat-spring-webmvc:0.7.0 |
| Spring Boot auto-configuration support for Web MVC controllers. | co.paralleluniverse:comsat-spring-boot:0.7.0 |
| Spring Security configuration support for fibers. | co.paralleluniverse:comsat-spring-security:0.7.0 |
| JAX-RS client integration for HTTP calls with fibers. | co.paralleluniverse:comsat-jax-rs-client:0.7.0 |
| ApacheHttpClient integration for HTTP calls with fibers. | co.paralleluniverse:comsat-httpclient:0.7.0 |
| Retrofit integration with fibers. | co.paralleluniverse:comsat-retrofit:0.7.0 |
| JDBI integration with fibers. | co.paralleluniverse:comsat-jdbi:0.7.0 |
| JDBC integration with fibers. | co.paralleluniverse:comsat-jdbc:0.7.0 |
| jOOQ integration with fibers. | co.paralleluniverse:comsat-jooq:0.7.0 |
| MongoDB fiber-blocking integration for the Allanbank API. | co.paralleluniverse:comsat-mongodb-allanbank:0.7.0 |
| OkHttp HTTP+SPDY client integration. | co.paralleluniverse:comsat-okhttp:0.7.0 |
| The Web Actors API. | co.paralleluniverse:comsat-actors-api:0.7.0 |
| Deploy HTTP, SSE and WebSocket Web Actors as Undertow handlers. | co.paralleluniverse:comsat-actors-undertow:0.7.0 |
| Deploy HTTP, SSE and WebSocket Web Actors as Netty handlers. | co.paralleluniverse:comsat-actors-netty:0.7.0 |
| Deploy HTTP, SSE and WebSocket Web Actors in J2EE 7 Servlet and WebSocket (JSR-356) embedded and standalone containers. | co.paralleluniverse:comsat-actors-servlet:0.7.0 |
| Use Comsat in the Tomcat servlet container without the java agent. | co.paralleluniverse:comsat-tomcat-loader:0.7.0[:jdk8] (for JDK 8 optionally add the jdk8 classifier) |
| Use Comsat in the Jetty servlet container without the java agent. | co.paralleluniverse:comsat-jetty-loader:0.7.0[:jdk8] (for JDK 8 optionally add the jdk8 classifier) |
| Spring Framework Web integration allows using fiber-blocking controllers. | co.paralleluniverse:comsat-spring-web:0.7.0 |
| Apache Kafka producer integration module. | co.paralleluniverse:comsat-kafka:0.7.0 |
| Apache Shiro realms integration module. | co.paralleluniverse:comsat-shiro:0.7.0 |
Or, build and install from sources (after installing Gradle locally) in your local maven repository with:
gradle install
The full testsuite can be run with gradle build.
Usage
A Gradle template project and a Maven archetype using various integration modules and featuring setup with both Dropwizard and standalone Tomcat are also available for jumpstart and study. Both have a without-comsat branch which is useful to clearly see the (minimal, if any) porting effort required (branches comparison works very well for this purporse).
There's a Comsat-Ring Clojure Leiningen template as well which includes an auto-instrument branch that doesn't need any explicit suspendable-marking code (suspendable!, defsfn, sfn etc.) thanks to Pulsar's new auto-instrumentation feature.
You can also have a look at additional examples.
Finally there are several regularly updated third-party bootstrap projects: Comsat + Dropwizard + jOOQ, Comsat Web Actors Stock Quotes (ported from Akka), Spring MVC + Tomcat standalone servlet container.
Getting help
Questions and suggestions are welcome at this forum/mailing list.
Contributions (including Pull Requests)
Please have a look at some brief information for contributors.
License
COMSAT is free software published under the following license:
Copyright (c) 2013-2016, Parallel Universe Software Co. All rights reserved.
This program and the accompanying materials are dual-licensed under
either the terms of the Eclipse Public License v1.0 as published by
the Eclipse Foundation
or (per the licensee's choosing)
under the terms of the GNU Lesser General Public License version 3.0
as published by the Free Software Foundation.
