Spring Lemon

When developing real-world Spring REST services for JavaScript web applications, mobile clients or any consumer, you face many challenges, such as

1. How to make the API truly stateless, using token authentication, session sliding etc.
2. How to configure Spring Security to suit API development, e.g. returning 200 or 401 responses on login, configuring CORS, JSON vulnerability protection, etc.
3. How to handle validations and exceptions in a cross functional manner and send precise errors to the client.
4. How exactly to support multiple social sign up/in, using OpenID Connect or OAuth2 providers such as Google and Facebook.
5. How to code a robust user module (with features like sign up, sign in, verify email, social sign up/in, update profile, forgot password, change password, change email, token authentication etc.) and share it across all your applications.
6. What would be good ways to test your API.
7. How to do Captcha validation.
8. How to properly organize application properties.
9. How to use PATCH and JsonPatch to handle partial updates correctly.

Coding all the above effectively needs in-depth knowledge of Spring. It also takes a lot of development time and effort, and needs to be properly maintained as new versions of Spring modules come out.

To relieve you of this non-trivial job, we thought to bring out Spring Lemon, a tiny open source library holding all these common configuration and components, and a production grade user module with all the abovementioned features.

Even if you don't plan to use Spring Lemon, it's a good example application to learn from, because it showcases the essential best practices for developing elegant web services using Spring.

Most Spring Boot applications can use Spring Lemon straight away, with some simple configurations. But, if you don't find it suitable for your application, feel free to fork it, or just roll out your own library by learning its patterns and practices. Better yet, be a contributor!

Watch this video tutorial or read this quick starter guide for getting started.

Documentation and Resources

Part I of our Mastering Spring RESTful Web Services Development — the ultimate course to master REST API development using Spring whether you use Spring Lemon or not — is now available for FREE.

1. Feature demo: https://youtu.be/6mNg-Feq8CY
2. Getting started guide
   1. Book
   2. Video Tutorial
3. Example application — A sample application using Spring Lemon. Quite similar to the one developed in the above getting started guide, but additionally has automated tests.
4. API documentation of the above application.
5. Spring Lemon JavaDoc
6. Example Angular 1.x front-end application — A sample AngularJS 1.x front-end. It'll work both for the application developed in the above getting started guide as well as the Lemon Demo application.
7. Mastering Spring RESTful Web Services Development — Ultimate course to master REST API development using Spring. Also covers Spring Lemon in depth. A must guide if you want to become an expert Spring developer, whether you use Spring Lemon or not. Click here to get part I now for FREE!

Help and Support

1. Community help is available at stackoverflow.com, under the spring-lemon tag. Do not miss to tag the questions with spring-lemon!
2. Submit an issue for any bug or enhancement. Please check first that the issue isn't already reported earlier.
3. Mentoring, training and professional help is provided by naturalprogrammer.com.

Donate

Like Spring Lemon? We have been putting continuous efforts to develop and maintain it. If it's being useful to you, why not donate a little amount — it’ll help us give more time to the project!

Click here to donate.

Releases

1. See here.