Skip to content

Latest commit

 

History

History
75 lines (48 loc) · 2.18 KB

README.md

File metadata and controls

75 lines (48 loc) · 2.18 KB
Raw

Cruzeira

Cruzeira brings Netty.io to Spring Framework implementing a subset of the Servlet API.

How to test:

  • Clone cruzeira repo

      git clone https://github.com/fabiofalci/cruzeira.git
  cd cruzeira

  • Install cruzeira locally with maven

      cd cruzeira
  mvn install

  • Install cruzeira maven plugin

      cd cruzeira-plugin
  mvn install

  • Execute some of the samples projects

      cd cruzeira-samples/spring-mvc-showcase
  mvn compile exec:exec
  // try http://localhost:8080

  // or
  cd cruzeira-samples/cruzeira-sample
  mvn compile exec:exec
  // try http://localhost:8080/async or http://localhost:8080/controller

It will run an instance of Netty and will dispatch any HttpRequest to SpringMVC.

Maven Archetype

You can use a maven archetype to create a ready to run project.

    cd cruzeira-samples/cruzeira-simple
    mvn archetype:create-from-project
    cd target/generated-sources/archetype/
    mvn install

This will install a very simple cruzeira maven archetype into your local maven directory (~/.m2). Now you just need to tell maven to create a project looking for your local maven archetypes:

    mvn archetype:generate -DarchetypeCatalog=local

It will present all available archetype. Just choose the cruzeira-simple-archetype and then continue with the project informations. Assuming the project name is test, just execute it:

    cd test
    mvn compile exec:exec

And then try http://localhost:8080/hello

Heroku

The repository Cruzeira Sample has an example that runs on Heroku. Click Here to see it in action.

Attention

This is a work in progress. Even if Netty and Spring appears to be handling requests nicely, it should not be used seriously before a release.

License

The Cruzeira is released under version 2.0 of the Apache License.