Nouveautés de Spring Data (Klara Dan von) Neumann

La traduction de l'article a été préparée en prévision du début du cours "Developer on the Spring Framework" .



Vous pouvez en savoir plus sur le cours en consultant le compte rendu de la journée portes ouvertes .

---

Spring Data Neumann est la première version depuis la transition vers un nouveau cycle de publication de six mois. Réduire le temps entre les versions nous permettra de publier de nouvelles fonctionnalités plus souvent, ce qui, à son tour, vous accélérera également. Dans cette version, en plus des nouvelles fonctionnalités, il y a également des changements importants qui peuvent potentiellement rompre la compatibilité avec les versions précédentes.

Changement de versions majeures

Pour les projets répertoriés ci-dessous, le numéro de version majeur a été augmenté en raison de modifications qui interrompent la compatibilité dans les API ou les pilotes publics:

• Spring Data JDBC 2.0 (version précédente 1.1)
• La migration de 1.1 vers 2.0 est décrite dans cet article .
• Spring Data MongoDB 3.0 (version précédente 2.2)
• Spring Data pour Apache Cassandra 3.0 (version précédente 2.2)
• Spring Data Couchbase 4.0 (version précédente 3.2)
• Spring Data Elasticsearch 4.0 (version précédente 3.2)
• Voir cet article pour plus de détails sur les changements .

Avant de passer à la description de la nouvelle fonctionnalité, examinons les modifications apportées à l'API. Pour plus de détails, consultez les sections Mise à niveau dans la documentation des modules respectifs.



Si vous n'êtes pas prêt à mettre à jour maintenant, gardez à l'esprit que la version précédente de Moore sera prise en charge pendant encore douze mois.

JDBC

Chaque stockage SQL a ses propres caractéristiques qui nécessitent une approche particulière. Pour améliorer leur support, des modifications ont été apportées qui ont influencé l'augmentation de la version majeure. Maintenant, AbstractJdbcConfigurationpar défaut, il essaie d'identifier les Dialectbases de données à partir de données DataSourceou enregistrées DialectResolver. Par défaut, le module JDBC est livré avec des dialectes pour H2, HSQLDB, MySQL, Postgres, MariaDB, Microsoft SqlServer et DB2. Spring Data JDBC échappe désormais tous les noms de table et de colonne par défaut. Bien que cela puisse vous amener à modifier les vôtres CREATE TABLEou les annotations @Column, cela vous donnera plus de flexibilité pour nommer les objets.

MongoDB

Le bocal unique avec les pilotes pour MongoDB (mongo-java-driver) est divisé en plusieurs: -sync et -reactivestreams, ce qui vous permet de sélectionner uniquement le pilote dont vous avez besoin. Autrement dit, les pilotes MongoDB synchrones et réactifs sont désormais des dépendances facultatives qui doivent être ajoutées manuellement. Avec la migration vers de nouveaux pilotes, certaines des API déjà obsolètes ont été définitivement supprimées, affectant les classes de configuration telles que les AbstractMongoConfigurationespaces de noms XML fournis par Spring Data. Consultez la section mise à niveau dans la documentation pour plus de détails .

Apache Cassandra

La mise à jour attendue depuis longtemps des pilotes Apache Cassandra vers 4.0 met non seulement à jour le package et la structure des données, mais modifie également le comportement dans le cluster et dans la gestion des sessions. Cela a conduit à des changements de configuration majeurs qui affectent la configuration XML et peuvent affecter la configuration dans le code pour certains scénarios complexes (plus difficiles qu'un simple paramètre par défaut AbstractCassandraConfiguration).

Couchbase

Suite au SDK Couchbase, nous sommes passés de la version 3.x à 4.x, qui a ajouté la gestion automatique des index et la prise en charge des transactions. En savoir plus sur le blog Couchbase .

Elasticsearch

Ajout de la prise en charge de l'API client HTTP, SSL et proxy. Un certain nombre de modifications ont également été apportées, notamment l'optimisation et la suppression de l'API obsolète, qui ont influencé le changement du numéro de version principal. Le module Elasticsearch inclut désormais Document, qui inclut Get-, Index-et Search-Requests, qui vous permet d'utiliser des types tels que SearchHit, SearchHitset SearchPage.



Passons maintenant aux innovations.

Référentiels avec prise en charge des coroutines Kotlin

La version Neumann continue de s'appuyer sur la prise en charge des coroutines Kotlin qui a commencé dans la version précédente de Moore en ajoutant leur prise en charge dans les référentiels.



Les coroutines sont gérées via des référentiels Spring Data réactifs. Vous pouvez désormais utiliser des méthodes de requête réactives ou écrire vos propres fonctions suspendues.

interface StudentRepository : CoroutineCrudRepository<Student, String> {
    suspend fun findOne(id: String): User
    fun findByLastname(firstname: String): Flow<Student>
}

@Primary-repositories et le mot-clé "recherche"

Ces deux petits changements améliorent la récupération des beans de référentiel et la dénomination des méthodes de requête. Désormais, l'annotation @Primarysur les référentiels d'interface est prise en compte dans la configuration du bean, ce qui aide le conteneur à résoudre les dépendances. Vous pouvez désormais utiliser un préfixe pour les méthodes de requête "search", de la même manière "find". Il est maintenant possible d'écrire des méthodes "search...By...", par exemple searchByFirstname.



Bien que cela ait été fait pour des bases de données comme Elasticsearch, passons à autre chose et voyons comment search...By...vous pouvez utiliser R2DBC dans Spring Data.

Génération de requêtes R2DBC

Jusqu'à présent, Spring Data R2DBC a utilisé l'annotation @Querypour les méthodes de requête , à l'exception des méthodes par défaut exposées via les interfaces *.Repository. La génération de requêtes par nom de méthode fonctionne désormais de la même manière que les autres modules:

interface StudentRepository extends ReactiveCrudRepository<Student, Long> {

	Flux<Student> searchByLastname(String lastname); (1)
}

Cela équivaut à:

@Query("select id, firstname, lastname from customer c where c.lastname = :lastname")

Pagination et génération de requêtes pour JDBC

Spring Data JDBC 2.0 prend en charge encore plus de bases de données relationnelles. Nous exécutons maintenant nos tests d'intégration sur H2, HSQLDB, MySQL, MariaDB, PostgreSQL et DB2.



Pour ces bases de données, nous prenons en charge la génération et la pagination de requêtes. Par exemple:

interface StudentRepository extends PagingAndSortingRepository<Student, Long> {

	Page<Student> findByLastname(String lastname);
}

Dans cette version, nous continuons également à évoluer vers NoSQL, en commençant par MongoDB et une nouvelle façon de modifier les documents.

Agrégations de mise à jour MongoDB

Ce changement important (qui n'était pas entièrement préparé dans la version Moore) permet d'utiliser le pipeline d'agrégation pour mettre à jour les données. Ainsi, les modifications peuvent contenir des expressions complexes telles que des conditions sur les valeurs de champ, par exemple:

AggregationUpdate update = Aggregation.newUpdate()
    .set("average").toValue(ArithmeticOperators.valueOf("tests").avg())
    .set("grade").toValue(ConditionalOperators.switchCases(
        when(valueOf("average").greaterThanEqualToValue(90)).then("A"),
        when(valueOf("average").greaterThanEqualToValue(80)).then("B"),
        when(valueOf("average").greaterThanEqualToValue(70)).then("C"),
        when(valueOf("average").greaterThanEqualToValue(60)).then("D"))
        .defaultTo("F")
    );

template.update(Student.class)
    .apply(update)
    .all();

De plus, Spring Data MongoDB bénéficiera sans aucun doute de la prise en charge récemment ajoutée des objets intégrés dans d'autres modules.

Prise en charge des types intégrés dans Apache Cassandra

Apache Cassandra prend désormais en charge le mappage de type intégré, qui est depuis longtemps disponible dans Spring Data JDBC . Dans le modèle de domaine, les objets intégrés sont utilisés pour les objets de valeur dont les propriétés sont stockées dans une seule table. Dans l'exemple suivant, Student.nameil existe une annotation au-dessus du champ @Embedded, ce qui entraîne le Namestockage de tous les champs de la classe dans une table Studentcomposée de trois colonnes ( student_id, firstnameet lastname):

public class Student {

    @PrimaryKey("student_id")
    private String studentId;

    @Embedded(onEmpty = USE_NULL)
    Name name;
}

public class Name {
    private String firstname;
    private String lastname;
}

Audit Elasticsearch

Étant donné que dans ElasticSearch, la présence n'est idpas un critère suffisant pour déterminer si un objet est nouveau, il est nécessaire de Persistablefournir des informations supplémentaires lors de l'implémentation en utilisant la méthode isNew():

@Document(indexName = "person")
public class Person implements Persistable<Long> {

    @Id private Long id;
    private String lastName;
    private String firstName;

    @Field(type = Date)
    private Instant createdDate;
    private String createdBy

    @Field(type = Date)
    private Instant lastModifiedDate;
    private String lastModifiedBy;

    @Override
    public boolean isNew() {
        return id == null || (createdDate == null && createdBy == null);
    }
}

L'ajout @EnableElasticsearchAuditingà la configuration enregistre ensuite tous les composants requis pour l'audit.

Neo4j

Spring Data Neo4j prend désormais en charge la syntaxe de requête Neo4j 4.0 avec paramètres. La syntaxe d'espace réservé était auparavant obsolète et est désormais complètement supprimée. Le module s'appuie désormais sur les derniers pilotes Java Neo4j-OGM et Neo4j pour améliorer l'interopérabilité avec le dernier Neo4j.



Il y a également un travail actif sur la prise en charge de la réactivité pour les bases de données graphiques et son intégration dans Spring Data avec Neo4j RX (bien que cela ne soit pas inclus dans la version actuelle, il est déjà prêt pour être inclus dans la prochaine).

Apache Geode / VMware Tanzu GemFire

Les modules Spring Data pour Apache Geode et VMware Tanzu GemFire ​​( spring-data-geodeet spring-data-gemfire) sont combinés en un seul projet sous le titre SDG. Apache Geode a été mis à jour vers 1.12.0 et GemFire ​​vers 9.10.0, qui à son tour est basé sur Apache Geode 1.12. De plus, le SDG se compile et s'exécute sur les versions 8 à 14. du JDK. Le



SDG prend désormais en charge la publication d'événements de transaction automatique, qui mappe le Cache TransactionEvent du GemFire ​​/ Geode Cache à l'ApplicationEvent approprié dans le contexte.



Il est également désormais possible de suspendre l'envoi d'événements sur un AEQ configuré avec SDG. De plus, lors de la création d'applications basées sur GemFire ​​/ Geode Locator à l'aide de l'annotation SDG, @LocatorApplicationvous pouvez personnaliserLocator pour se connecter à d'autres localisateurs , créant ainsi un cluster hautement disponible et résilient.

---

En savoir plus sur le cours.

---

Lire la suite

• Spring Boot - OAuth2 et JWT
• Introduction à Spring Boot Actuator Baeldung
• Modèles de conception utilisés dans Spring Framework