search

aerospike / spring-data-aerospike

Spring Data Aerospike
https://aerospike.github.io/spring-data-aerospike/
Apache License 2.0
42 stars 29 forks source link
aerospike framework java spring spring-boot spring-data spring-data-aerospike

readme

= Spring Data Aerospike

:maven-image: https://img.shields.io/maven-central/v/com.aerospike/spring-data-aerospike.svg?maxAge=259200 :maven-url: https://search.maven.org/#search%7Cga%7C1%7Ca%3A%22spring-data-aerospike%22 :ci-image: https://github.com/aerospike/spring-data-aerospike/workflows/Build%20project/badge.svg :ci-url: https://github.com/aerospike/spring-data-aerospike/actions?query=branch%3Amain :javadoc-image: https://javadoc.io/badge2/com.aerospike/spring-data-aerospike/javadoc.svg :javadoc-url: https://javadoc.io/doc/com.aerospike/spring-data-aerospike

{maven-url}[image:{maven-image}[maven]] {ci-url}[image:{ci-image}[ci]] {javadoc-url}[image:{javadoc-image}[javadoc]]

The Spring Data Aerospike project aims to provide a familiar and consistent Spring-based programming model for new data stores while retaining store-specific features and capabilities. It provides integration with the Aerospike database. Key functional areas of Spring Data Aerospike are a POJO centric model for interacting with Aerospike DB and easily writing a repository style data access layer.

== Documentation

== Examples

. Demo project example with a step-by-step tutorial can be found https://github.com/aerospike-examples/simple-springboot-aerospike-demo[here] . Demo project with detailed guides is located https://github.com/aerospike-community/spring-data-aerospike-demo[here]

== Getting Started Blog Posts

. https://medium.com/aerospike-developer-blog/simple-web-application-using-java-spring-boot-aerospike-database-and-docker-ad13795e0089?source=friends_link&sk=43d747f5f55e527248125eeb18748d92[Simple Web Application Using Java, Spring Boot, Aerospike and Docker] . https://medium.com/aerospike-developer-blog/how-to-setup-spring-data-aerospike-in-spring-boot-application-afa8bcb59224?source=friends_link&sk=e16a3b69c814bfb22f200634c743e476[How to set up spring-data-aerospike in Spring Boot application] . https://medium.com/aerospike-developer-blog/basic-error-handling-in-spring-data-aerospike-5edd580d77d9?source=friends_link&sk=cff71ea1539b36e5a89b2c3411b58a06[Basic error handling in spring-data-aerospike] . https://medium.com/aerospike-developer-blog/how-to-create-secondary-index-in-spring-data-aerospike-e19d7e343d7c?source=friends_link&sk=413619a568f9aac51ed2f2611ee70aba[How to create secondary index in Spring Data Aerospike] . https://medium.com/aerospike-developer-blog/caching-with-spring-boot-and-aerospike-17b91267d6c?source=friends_link&sk=e166b4592c9c00e3d996663f4c47e2b5[Caching with Spring Boot and Aerospike] . https://medium.com/aerospike-developer-blog/spring-data-aerospike-reactive-repositories-fb6478acea41?source=friends_link&sk=66541b82192ded459a537261e9a38bd5[Spring Data Aerospike: Reactive Repositories] . https://medium.com/aerospike-developer-blog/spring-data-aerospike-projections-951382bc07b5?source=friends_link&sk=d0a3be4fd171bbc9e072d09ccbcf056f[Spring Data Aerospike - Projections]

== Spring Data Aerospike Compatibility

.Compatibility Table [%collapsible]

[width="100%",cols="<24%,<14%,<18%,<26%,<18%",options="header",] |=== |Spring Data Aerospike |Spring Boot |Aerospike Client |Aerospike Reactor Client |Aerospike Server |4.8.x |3.3.x |7.2.x |7.1.x |5.2.x.x +

|4.7.x |3.2.x |7.2.x |7.1.x |5.2.x.x +

|4.6.x |3.2.x |7.2.x |7.1.x |5.2.x.x +

|4.5.x |3.1.x |7.1.x |7.0.x |5.2.x.x +

|4.4.x |3.1.x |7.0.x |7.0.x |5.2.x.x +

|4.3.x |3.1.x |6.1.x |6.1.x |5.2.x.x +

|4.2.x |3.0.x |6.1.x |6.1.x |5.2.x.x +

|4.1.x |3.0.x |6.1.x |6.1.x |5.2.x.x +

|3.5.x |2.7.x |6.1.x |6.1.x |5.2.x.x +

|3.4.x |2.6.x |5.1.x |5.1.x |5.2.x.x +

|3.3.x |2.5.x |5.1.x |5.1.x |5.2.x.x +

|3.2.x |2.5.x |5.1.x |5.0.x |5.2.x.x +

|3.0.x, 3.1.x |2.5.x |5.1.x |5.0.x |

|2.5.x |2.5.x |4.4.x |4.4.x |

|2.4.2.RELEASE |2.3.x |4.4.x |4.4.x |

|2.3.5.RELEASE |2.2.x |4.4.x |4.4.x |

|2.1.1.RELEASE |2.1.x, 2.0.x |4.4.x |3.2.x |

|1.2.1.RELEASE |1.5.x |4.1.x | | |===

== Quick Start

=== 1. Maven configuration

Add the spring-data-aerospike Maven dependency:

[source,xml]

com.aerospike spring-data-aerospike ${spring-data-aerospike.version}

Notes:

=== 2. AerospikeRepository

AerospikeRepository is the simplest way to interact with Aerospike using Spring Data Aerospike.

Create your own custom repository that extends AerospikeRepository which will provide out-of-the-box CRUD operations and query implementations, so you can easily save, find, delete and query single entities and collections of them.

Implementation will be determined by the method names automatically, no need to write any implementation.

For example, given a Person class with first and last name properties, a PersonRepository interface that can query for Person by last name and when the first name matches a like expression is shown below:

[source,java]

public interface PersonRepository extends AerospikeRepository<Person, Long> {

List<Person> findByLastname(String lastname);

List<Person> findByFirstnameLike(String firstname);

}

For non-blocking reactive API use ReactiveAerospikeRepository.

=== 3. Configuration

In order to configure Spring Data Aerospike you will need to create a configuration class that extends AbstractAerospikeDataConfiguration and defines the relevant Spring Data Repositories via @EnableAerospikeRepositories annotation.

To set the connection details you can either override getHosts() and nameSpace() methods of the AbstractAerospikeDataConfiguration class or define spring-data-aerospike.connection.hosts and spring-data-aerospike.connection.namespace in application.properties file.

NOTE: You can further customize your configuration by changing other xref:#configuration[settings].

Here is a simple example of a configuration class that sets up a connection to a local Aerospike DB instance:

[source,java]

@Configuration @EnableAerospikeRepositories(basePackageClasses = PersonRepository.class) class ApplicationConfig extends AbstractAerospikeDataConfiguration {

@Override
protected Collection<Host> getHosts() {
    return Collections.singleton(new Host("localhost", 3000));
}

@Override
protected String nameSpace() {
    return "test";
}

}

=== Usage

Below is an example of a service that uses PersonRepository operations.

[source,java]

@Service public class PersonService {

private final PersonRepository personRepository;

@Autowired
public PersonService(PersonRepository personRepository) {
    this.personRepository = personRepository;
}

public void example() {
    // Delete all existing persons
    personRepository.deleteAll();

    Person person = new Person();
    person.setFirstname("John");
    person.setLastname("Smith");
    // Save the new created person
    personRepository.save(person);

    // Get all persons whose first name starts with "Jo"
    List<Person> firstNameResults = personRepository.findByFirstnameLike("Jo*");
    // Get all persons whose last name is equal to "Smith"
    List<Person> lastNameResults = personRepository.findByLastname("Smith");
}

}

=== AerospikeOperations

AerospikeOperations is the base interface for Aerospike database operations. It is implemented by AerospikeTemplate class.

As a lower-level alternative to AerospikeRepository, AerospikeOperations supports wider variety of operations and greater flexibility, but requires a bit more code writing and less out-of-the-box functionality.

Features supported by AerospikeOperations:

For non-blocking reactive API use ReactiveAerospikeOperations.

== Getting Help

== Contributing to Spring Data Aerospike

Here are some ways you can get involved: