Spring Roo is a next-generation rapid application development tool for Java developers. It focuses on higher productivity, stock-standard Java APIs, high usability, avoiding engineering trade-offs and facilitating easy Roo removal.
Java CSS FreeMarker JavaScript Shell HTML Other
Permalink
Failed to load latest commit information.
.mvn/wrapper Fixes ROO-3858. Added maven wrapper with maven 3.3.9, the last availa… Dec 9, 2016
addon-backup ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-cache ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-cloud ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-configurable ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-creator Fixed 'addon create wrapper' command Dec 1, 2016
addon-dbre ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-dto Remove unnecesary boot starter, added when creating entity projection… Feb 20, 2017
addon-email ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-field Added validation to check if embeddable class exists when using it in… Feb 9, 2017
addon-javabean Added new 'equals' and 'hashCode' implementations for JPA entities Feb 13, 2017
addon-jdbc ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-jms ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-jpa * Added 'module' option to 'test integration' command. Feb 20, 2017
addon-layers-repository-jpa Add test-jar dependency between modules to dependencyManagement Feb 21, 2017
addon-layers-service Improve the integration of the readOnly entities with other layers Feb 15, 2017
addon-logging ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-oscommands ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-plural ROO-3853: Solving problems with Metadatas Dec 1, 2016
addon-propfiles ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-push-in Try to fix push-in by method regexp, which sometimes fail when metada… Feb 22, 2017
addon-security Using CollectionValidator and ValidationAdvice classes instead of inc… Feb 9, 2017
addon-tailor ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-test * Added 'module' option to 'test integration' command. Feb 20, 2017
addon-web-mvc-controller Changing the view location if the requestMapping of a controller is c… Feb 23, 2017
addon-web-mvc-embedded ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-web-mvc-exceptions ROO-3853: Solving problems with Metadatas Dec 1, 2016
addon-web-mvc-i18n Improved buttons. Feb 16, 2017
addon-web-mvc-jsp ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-web-mvc-thymeleaf Updating dataTables.advanced.js extension Feb 23, 2017
addon-web-mvc-views Including necessary methods to generate show inline feature Feb 22, 2017
addon-web-selenium ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-webflow ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
addon-ws Updated JavaDoc generation from ThymeleafMetadata and fixed error in … Jan 26, 2017
annotations Removing unused test annotations dependencies Feb 15, 2017
devel-resources Set use_on_off_tags to true Nov 18, 2016
runtime Add test-jar dependency between modules to dependencyManagement Feb 21, 2017
web-ui ROO-3818: Updating Spring Roo to the next development version Nov 30, 2016
.gitignore ROO-2291: roo git addon is too verbose May 18, 2011
CODE_OF_CONDUCT.adoc Add Code of Conduct Feb 18, 2016
CONTRIBUTING.adoc Minor fixes Dec 10, 2016
LICENSE.TXT ROO-2253: Change Spring Roo to Apache Software License version 2.0 (A… Jul 30, 2011
README.adoc Minor fixes Dec 10, 2016
RELEASING.adoc Improve developer doc for easier contribution Dec 9, 2016
mvnw Fixes ROO-3858. Added maven wrapper with maven 3.3.9, the last availa… Dec 9, 2016
mvnw.cmd Fixes ROO-3858. Added maven wrapper with maven 3.3.9, the last availa… Dec 9, 2016
pom.xml Removing unused test annotations dependencies Feb 15, 2017
rwc.sh ROO-4: Initial import of Spring Roo code. May 15, 2009

README.adoc

Spring Roo Build Status

Spring Roo is an easy-to-use development tool for quickly building Spring-powered applications.

Our primary goals are:

  • Build Spring-powered applications in a best-practice manner within minutes.

    To develop Spring projects requires incredibly long cycle times yet, yes Spring Boot provide a radically faster and widely accessible getting started experience plus non-functional features for all Spring development and due that Spring Roo generates Spring Boot applications, but even so for midsize applications you need functional features, patterns and best-practices that Spring Roo provides you automatically.

  • Incremental approach to add technologies as needed to your project.

    This means when you first start a new project Roo will only assume you want to build a simple Spring Boot application. As such it will have next to no dependencies. Only when you ask to add a persistence provider will JPA be installed, and only when you add a field using JavaBean Validation annotations will that library be installed. The same holds true for Spring Security, Spring Data and the other technologies Roo supports.

  • Use Roo over the full lifespan of a project.

    This is particularly important given the long-term maintenance costs of a project far outweigh the initial development costs. While you can use Roo just for an initial jump-start if you so wish, your return on investment is exponential as you continue using it throughout a project lifespan.

Code of Conduct

This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to spring-code-of-conduct@pivotal.io.

Installation and Getting Started

The reference documentation includes detailed descriptions of all the features, detailed installation instructions as well as an extensive user guide for main use cases.

Getting Support

If you have any trouble using Spring Roo:

  • Check the reference documentation.

  • Spring Roo creates web applications based on Spring projects, take a look at the related Spring project reference documentation. In the Spring web-site you will find a lot of excellent reference documentation and getting started guides of the Spring projects.

  • Ask a question in stackoverflow tagged with spring-roo.

Commercial support is available too.

Contribute

Here are some ways for you to get involved in the community:

  • Get involved with the Spring community by helping out on stackoverflow. Join to debates and respond to questions.

  • Report bugs and request new features via the Spring Roo JIRA. Comment and vote on the ones that you are interested in.

  • If you want to write code, you are welcome. Commit your pull requests from forks of this repository.

See the contributor guidelines for details.

Building from Source

The Spring Roo project uses a Maven-based build system.

Spring Roo can be easily built with the maven wrapper from the root of the source tree and serves as a cross-platform, self-contained bootstrap mechanism for the build:

$ ./mvnw clean install

See the contributor guidelines for details.

Staying in Touch

Follow @SpringRoo and its team members on Twitter. In-depth articles can be found at The DISID Blog, and releases are announced via The Spring Blog.

Acknowledgments

The Spring Roo project uses and depends on a lot of Spring related projects, as well as other ones. We would like to thank all those projects and the people working on them, not only for the effort made to provide such excellent libraries and utilities, but also for the guidance and examples given on how to manage an open source Java project.

Also, this README.adoc file has been written based on the ones included in several Spring projects like Spring Boot project and Spring Data JPA.

License

Spring Roo is Open Source software released under the Apache 2.0 license.