Power to the developers!

Spincast is an highly flexible and open source Java web framework, based on Guice.

Why Spincast framework?

We live in a crazy world where the New Best Thing™ is always changing. Javascript, that sucky language, is everywhere. Everybody thinks they are Netflix and that they need reactive not blocking serverless functional GraphQL web scaled microservices on Kubernetes.

In reality, what most of us need are tools made for the real world. Tools that don't try to look cool, but that work well and provide control and flexibility. Spincast aims to be that production ready framework that won't get you nerd points during a discussion, but that actually gets the job done very well.

Do you share our philosophy?
Look at the plugins as they show our main concerns.
Experiment, make your own mind.

A simple but fully working application:

public class App {

    public static void main(String[] args) {
        Spincast.init(args);
    }

    @Inject
    protected void init(DefaultRouter router, Server server) {
        router.GET("/").handle(context -> context.response().sendHtml("<h1>Hello World!</h1>"));
        server.start();
    }
}

When needed, you have access to a lot of power and flexibility...

public class App {

    public static void main(String[] args) {
        Spincast.configure()
                .module(new AppGuiceModule())
                .plugin(new SpincastHttpClientPlugin())
                .plugin(new SpincastJdbcPlugin())
                .plugin(new SpincastFormsProtectionPlugin())
                .plugin(new SpincastScheduledTasksPlugin())
                .plugin(new SpincastSessionPlugin())
                .requestContextImplementationClass(AppRequestContextDefault.class)
                .init(args);
    }

    @Inject
    protected void init(AppRouter router, AppServer server) {
    
        router.methods(HttpMethod.POST, HttpMethod.PUT)
              .path("/users/${userId:<N>}")
              .accept(ContentTypeDefaults.JSON)
              .handle(context -> {
        
            context.response().setCacheSeconds(3600);
            context.response().setCookie1year("myCookie", context.customMethodYouDefined());
            context.response().setHeader("x-powered-by", "Robert'); DROP TABLE Students;--");

            JsonObject userObj = context.json().create();
            userObj.set("user.id", context.request().getPathParam("userId"));
            userObj.set("user.timeZone", context.getTimeZoneToUse());
            userObj.set("user.locale", context.getLocaleToUse());
            
            System.out.println(userObj.toJsonString(true));
            // {
            //     "user" : {
            //         "id" : "42",
            //         "timeZone" : "America/New_York",
            //         "locale" : "en_US"
            //     }
            // }

            context.response().sendXml(userObj);
        });
        
        server.start();
    }
}

Web applications and APIs

Spincast is a framework to serve as a backend for Single Page Applications (SPA), to develop old-school HTML generated websites or to be a REST API services platform.

Flexible...

Spincast is based on Guice from the ground up. It is very flexible: each part can be tweaked/overridden, even the core classes. There are no static methods and no private methods.

.... very flexible!

Spincast aims to feel more like a library than like a framework. It is not opinionated and favors configuration over convention. Its main goal is to give power to the developers.

Modular

Spincast is composed of a small core and a big plugins ecosystem. You choose what your application needs.

HTTP/2
and WebSockets

HTTP/2 and WebSockets are fully supported!

Embedded server

The embedded server makes everything easy to develop, test and deploy... When deployed, the application is fully contained, in a single executable .jar file.

Powerful router

Spincast's powerful router is injectable and dynamic. That means you can add and remove routes from anywhere in your application, at any time.

Well tested

Spincast is fully tested and even provides it own Testing utilities.