Implémentation de la gestion des indicateurs de fonctionnalités dans votre application Spring Boot à l'aide d'appels API et de l'interface utilisateur avec Togglz

Dans le développement de logiciels modernes, la capacité de contrôler les fonctionnalités d'une application en direct sans déployer de nouveau code est cruciale. Cette fonctionnalité, connue sous le nom de gestion des indicateurs de fonctionnalités, permet aux équipes d'activer ou de désactiver des fonctionnalités en temps réel, permettant ainsi une livraison continue, des tests A/B et des versions Canary. Il joue également un rôle important dans la réduction des risques associés aux nouveaux déploiements en contrôlant l'exposition des nouvelles fonctionnalités aux utilisateurs.

Dans cet article, nous expliquerons le processus de mise en œuvre de la gestion des indicateurs de fonctionnalités dans une application Spring Boot à l'aide de Togglz. Nous explorerons comment configurer Togglz, définir des indicateurs de fonctionnalités et contrôler leur comportement au sein de votre application.

1. Configuration de Togglz dans votre application Spring Boot

Pour démarrer avec Togglz, vous devrez ajouter les dépendances nécessaires à votre projet Spring Boot. Ouvrez votre fichier build.gradle ou pom.xml et ajoutez les dépendances suivantes :

implementation 'org.togglz:togglz-spring-boot-starter:3.1.2'
implementation 'org.togglz:togglz-console:3.3.3'

Ces dépendances incluent la fonctionnalité principale de Togglz et une console Web facultative pour gérer vos indicateurs de fonctionnalités.

2. Configuration de Togglz

Ensuite, vous devrez configurer Togglz dans votre application Spring Boot. Cela implique la configuration d'un bean FeatureManager que Togglz utilise pour gérer vos indicateurs de fonctionnalités.

Voici comment procéder :

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.togglz.core.manager.FeatureManager;
import org.togglz.core.manager.FeatureManagerBuilder;
import org.togglz.core.repository.jdbc.JdbcStateRepository;
import org.togglz.core.user.NoOpUserProvider;

import javax.sql.DataSource;

@Configuration
public class TogglzConfiguration {

    private final DataSource dataSource;

    @Autowired
    public TogglzConfiguration(DataSource dataSource) {
        this.dataSource = dataSource;
    }

    @Bean
    public FeatureManager featureManager() {
        return new FeatureManagerBuilder()
                .featureEnum(ProductCheckFeature.class)
                .stateRepository(new JdbcStateRepository(dataSource))
                .userProvider(new NoOpUserProvider())
                .build();
    }
}

Explication :

• DataSource : Le DataSource est injecté pour être utilisé par le JdbcStateRepository. Cela permet à Togglz de conserver les états des indicateurs de fonctionnalités dans une base de données.
• FeatureManager : Le FeatureManager est construit à l'aide d'un FeatureManagerBuilder. Nous spécifions l'énumération qui définit les fonctionnalités (ProductCheckFeature.class), utilisons un JdbcStateRepository pour stocker les états des fonctionnalités et un NoOpUserProvider puisque nous n'associons pas les utilisateurs aux fonctionnalités dans cet exemple.

3. Définir des indicateurs de fonctionnalité avec des énumérations

Togglz utilise des énumérations pour définir des indicateurs de fonctionnalités. Chaque constante de l'énumération représente une fonctionnalité qui peut être activée ou désactivée. Voici un exemple :

import org.togglz.core.Feature;
import org.togglz.core.annotation.Label;

public enum ProductCheckFeature implements Feature {

    @Label("product-check")
    PRODUCT_CHECK,

}

Explication :

Label : l'annotation @Label fournit un nom lisible par l'homme pour la fonctionnalité. Ce nom sera affiché dans la console Togglz si vous décidez de l'utiliser.

4. Utilisation des indicateurs de fonctionnalités dans votre application

Une fois les indicateurs de fonctionnalités définis et la configuration en place, vous pouvez commencer à les utiliser dans votre application. Voici un exemple de la façon de vérifier si une fonctionnalité est active avant d'exécuter certains codes :

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.togglz.core.manager.FeatureManager;
import reactor.core.publisher.Mono;

import javax.servlet.http.HttpServletRequest;

@RestController
@RequestMapping("/api/products")
public class ProductController {

    private final FeatureManager featureManager;
    private final ProductService productService;

    public ProductController(FeatureManager featureManager, ProductService productService) {
        this.featureManager = featureManager;
        this.productService = productService;
    }

    @GetMapping("/check")
    public Mono<ResponseEntity<?>> checkProduct(@RequestParam String isbn, HttpServletRequest httpServletRequest) {
        if (featureManager.isActive(ProductCheckFeature.PRODUCT_CHECK)) {
            return productService
                    .productCheck(isbn, JwtUtils.getUserJwt(httpServletRequest), Boolean.FALSE)
                    .flatMap(response -> Mono.just(ResponseEntity.ok(response)));
        } 
        return Mono.just(ResponseEntity.status(HttpStatus.NOT_IMPLEMENTED).body("Feature is disabled"));
    }
}

Explication :

• FeatureManager : Le FeatureManager est injecté dans le contrôleur et utilisé pour vérifier si la fonctionnalité PRODUCT_CHECK est active.
• Logique conditionnelle : si la fonctionnalité est active, l'opération de vérification du produit est effectuée ; sinon, un message « La fonctionnalité est désactivée » est renvoyé.

5. Gestion des indicateurs de fonctionnalités via la console Togglz

La console Togglz est un outil puissant qui vous permet de gérer vos drapeaux de fonctionnalités via une interface web. Pour activer la console Togglz, ajoutez simplement la propriété suivante à votre fichier application.properties ou application.yml :

implementation 'org.togglz:togglz-spring-boot-starter:3.1.2'
implementation 'org.togglz:togglz-console:3.3.3'

Vous pouvez accéder à la console en accédant à /togglz-console dans votre navigateur Web. La console fournit une interface facile à utiliser pour activer ou désactiver des fonctionnalités, modifier leurs stratégies et afficher leur état actuel.

Conclusion

La mise en œuvre de la gestion des indicateurs de fonctionnalités avec Togglz dans votre application Spring Boot est un processus simple qui offre un contrôle puissant sur vos fonctionnalités. En suivant les étapes décrites dans cet article, vous pouvez facilement configurer, définir et gérer les indicateurs de fonctionnalités, vous permettant ainsi de publier de nouvelles fonctionnalités en toute confiance et flexibilité.

Que vous déployiez progressivement une nouvelle fonctionnalité, effectuiez des tests A/B ou souhaitiez simplement minimiser les risques de déploiement, Togglz fournit une solution robuste qui s'intègre parfaitement à votre application Spring Boot.

Bon codage ! ?

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!