About three weeks ago I was giving a workshop titled ‘Spring Boot and RESTful web services’ at the Bristech 2016 conference. To prepare for the workshop I created a small GitHub project called recognitions-boot. What I wanted to do is to have a simple web service that would allow saving and reading some data from the database. This would have to be simple enough to code and explain in a 45 minutes workshop. During that exercise and during the actual workshop, the thing that stood out the most was- how simple it is to work with the database. MongoDB with Spring Boot is a truly amazing combination!
Configuration with Spring Boot
The philosophy behind Spring Boot is the ability to auto-configure most things. It is a very opinionated, but flexible
framework. This auto-configuration shines when working with MongoDB- if you are going to use the default configuration
and locally running MongoDB, the whole configuration boils down to adding the following to your
This concept in Spring Boot is known as a starter dependency. Adding these dependencies to your project is how you configure it. The process of auto-configuration looks for these dependencies and configures the application as required. You can find many more starter dependencies in the Spring Initializr. I really recommend exploring what is there as it may make your next Java project much easier and fun. And remember- you don’t need to use Spring Boot as an application server- it is perfectly fine to use it for standalone Java projects.
If you have installed MongoDB on your machine and did not change any settings, you can already see it being connect
as you start your application! Assuming that you are using a non default settings for your MongoDB, you will need to
application.properties file, where you can supply the following properties:
You only have to change the values that are not set to their defaults. You may end up with completely empty
application.properties! Under the hood, the Spring Data MongoDB
project is used. That means that if you need a more detailed information about any of the parameters, you should have a
look at the Spring Data MongoDB documentation.
There is one more trick that I want to share with you. Assuming that you do not want to install MongoDB anywhere, but you would rather have it start as a part of your application- you can go for embedded MongoDB. Spring Boot will connect to it without any configuration required! How do you do it? You just add a single dependency:
When the auto-configuration process sees that dependency- it will start an embedded MongoDB and configure the connection.
Working with MongoDB
After seeing how easy it is to setup MongoDB, it is time to actually use it. In the
example github project I have created a
I want to use it for storing different
Recognitions that a
Colleague may receive from her peers. The class source
The class is pretty simple, but you can probably imagine, that when working with JPA, you would need a few extra
annotations and certainly there would be some work left when saving this Object. Here Spring Boot comes
with yet another genius idea. You can use a concept of
MongoRepository<Colleague, String> that will help
you with working with the database. Here is the full source of the
MongoRepository that I used in my
As you see, this is just an
Interface. When you look at the
Colleague class and the
it is pretty clear what we are trying to do here. The creators of Spring Boot decided that in fact, it is so clear,
that there is no need to provide any more code! You can use the following repository straight away by using
The framework will provide an appropriate implementation. It is even smart enough to understand how to implement the
findByName(String name) method, by looking at the parameters. To finish this discussion, let’s have a look at
an application controller, that reads, saves and deletes from the MongoDB using all these features provided for us:
As you can see here, the basic operations are automatically implemented- we can easily call
repository.delete(colleague) or even
repository.findByName(name). There is also
repository.deleteAll(), just not shown in the example code above.
Final comments about Spring Boot and MongoDB
I think it is clear, that Spring Boot is a complete game changer when it comes to simplicity of writing small Java applications- standalone or as embedded server. It is fascinating to see how much simpler it makes working with the database. Configuring database connection used to require plenty of boiler plate and tinkering, now it can be as simple as one could imagine! You really can write non-trivial web service within couple hours, thanks to the simplicity and convenience this provides.
This post focuses on MongoDB, as it is very easy and pleasant to work with. You may
find it interesting to know that Spring Boot offers as well
JpaRepository, which makes working with JPA similarly
easy and simpler.
I recommend trying this out yourself to really see, just how much you can achieve in a very limited time! It really feels like the future of Java development is here!