Over a million developers have joined DZone.

The Plumbing Included With Auto-Configuration in Spring Data Cassandra

DZone 's Guide to

The Plumbing Included With Auto-Configuration in Spring Data Cassandra

With auto-configuration, you can start querying Cassandra with little setup. This helps you finish your code faster and provides a safety net if you forget to create a bean.

· Database Zone ·
Free Resource

I received a few comments on my repository for Reactive Streams With Spring Data Cassandra regarding configuration that was not required. This was due to me not making use of Spring Boot’s auto-configuration which would have allowed me to remove a whole class from my code! Therefore, in an attempt to redeem myself for not taking advantage of auto-configuration, I decided to write a post about what it does for you and how to use it in conjunction with Spring Data Cassandra.

I will provide you with a warning before we begin: there are no code examples in this post because, well, Spring Boot does it all for us.

So let’s get on with it.

As always, if you do not have any current knowledge of Spring Data Cassandra, I recommend you read my first post on the subject: Getting Started With Spring Data Cassandra.

Auto-configuration allows Spring to detect any beans and annotations that have not been included in our code and automatically add them for us. For it to kick in, we must have one of the classes defined in @ConditionalOnClass in the classpath or a property specified in the @ConditionalOnProperty annotation. Because of this, all the beans we need to connect to Cassandra are automatically created just by including the spring-boot-starter-data-cassandra or spring-boot-starter-data-cassandra-reactive dependency and enabling auto-configuration. That’s it. But if we find any reason to define some of the beans that are normally created by auto-configuration, then there is no reason to worry, thanks to the @ConditionalOnMissingBean annotation added to each auto-configured bean, preventing another being created if one already exists in the BeanFactory.

The main classes that deal with Spring Data Cassandra’s auto-configuration are:

  • CassandraRepositoriesAutoConfiguration enables auto-configuration for Cassandra repositories.
  • CassandraRepositoriesAutoConfigureRegistrar applies @EnableCassandraRepositories.
  • CassandraDataAutoConfiguration creates beans revolving around a session such as Session and CassandraTemplate.
  • CassandraAutoConfiguration creates a Cassandra Cluster.

I recommend checking out these classes if you want to know exactly what properties they are setting. All of the properties set on beans in the auto-configuration classes are also set when you extend AbstractCassandraConfiguration but doing so also comes with a few extras, such as startup and shutdown scripts.

There are also reactive versions of each of the above auto-configuration classes that bar CassandraAutoConfiguration, as it only creates a cluster that does not need a reactive implementation. Therefore, if we stick to using auto-configuration, we will have all the beans we need to query data normally as well as reactively using Reactive Streams.

Inside these classes, you will find the CassandraProperties class. This uses the @ConfigurationProperties annotation to pick up all Cassandra configuration that is prefixed with spring.data.cassandra. This means that we can control the application solely from a properties file if we are fine using the auto-configured beans. CassandraProperties contains a lot of properties inside of it — I haven’t gone through each one, but I think it’s is safe to assume that most properties that a Session and Cluster need can be found there.

Remember that we must specify the keyspace or everything goes boom! Before, we would do this in a configuration class that extended AbstractCassandraConfiguration or AbstractReactiveCassandraConfiguration; but because we are using auto-configuration, we are going to add it to application.properties (or whatever you want to call your properties file). For convenience, I also added another property, which will create tables based on the entities.


If you want to change the contact points and port your application uses, then you will need to add the following properties:

spring.data.cassandra.contact-points= <some contact points>
spring.data.cassandra.port= <some port>

One quick thing about the names of the properties: this isn’t restricted to Spring Data Cassandra, but I thought it was worth adding. The way you format or case your properties does not really matter, so you can choose how you write it. Below are a few different ways you could write them.


I personally don’t think you should choose the last one, but it will still work!

The last thing that we need to do is actually enable auto-configuration by using either @SpringBootApplication or @EnableAutoConfiguration on one of the configuration classes. In my example, I used @SpringBootApplication on my main Application class.

And that’s about it, really. I don’t think there is much to gain by showing you the rest of the code, but if you really want to see it, all of it is on my GitHub.

In conclusion, Spring Boot’s auto-configuration allows us to write way less code if we are happy with the magic that it does behind the scenes. Some people do not like using auto-configuration because of this but hopefully, I have pulled back the curtain slightly and allowed you to see what it is doing. If you do decide to use auto-configuration, then you can start querying Cassandra with very little setup — just write some entities and their Cassandra repositories and you good to go. This not only helps you finish your code faster (so you can get back to Reddit) but also gives you a bit of a safety net in case you forget to create a bean you need. That being said, at the end of the day, it is your decision whether you use it or not. If you don’t like Spring Boot doing everything for you, then you can set it all up yourself and sleep easy knowing that you have complete control over your application.

But I’m going to keep being lazy and use auto-configuration so that I can type less.

As mentioned earlier, the rest of the code not shown here can be found on my GitHub.

database ,tutorial ,plumbing ,autoconfiguration ,spring data cassandra

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}