ff4j spring boot 基本试用

ff4j 是一个很不错的特性开关开发框架，同时官方也提供了spring boot starter 以下是一个简单的学习试用

docker方式运行

参考自官方文档，同时官方也提供了几个全家桶的集成（基于docker）

• docker 启动

docker run -d -p 8090:8080 clunven/ff4j:ff4j-sample-springboot

• 访问效果

• web console

开启特性

 

 

• web 效果

 

 

代码模式

• 项目结构

 

├── pom.xml

└── src

    ├── main

    │ ├── java

    │ │ └── com

    │ │ └── dalong

    │ │ ├── Application.java

    │ │ ├── FF4JConfiguration.java

    │ │ └── SampleResource.java

    │ └── resources

    │ └── ff4j-features.xml

    └── test

        └── java

• pom.xml

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0"

         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>

​

    <groupId>com.dalong</groupId>

    <artifactId>ff4j-learning</artifactId>

    <version>1.0-SNAPSHOT</version>

    <parent>

        <groupId>org.springframework.boot</groupId>

        <artifactId>spring-boot-starter-parent</artifactId>

        <version>1.5.15.RELEASE</version>

    </parent>

​

    <properties>

        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

        <java.version>1.8</java.version>

    </properties>

​

    <dependencies>

        <dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-web</artifactId>

        </dependency>

​

        <dependency>

            <groupId>org.ff4j</groupId>

            <artifactId>ff4j-spring-boot-starter</artifactId>

            <version>1.8.2</version>

        </dependency>

    </dependencies>

    <build>

        <plugins>

            <plugin>

                <groupId>org.springframework.boot</groupId>

                <artifactId>spring-boot-maven-plugin</artifactId>

            </plugin>

        </plugins>

    </build>

</project>

• ff4j-features.xml

<?xml version="1.0" encoding="UTF-8" ?>

<ff4j xmlns="http://www.ff4j.org/schema/ff4j"

      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

      xsi:schemaLocation="http://www.ff4j.org/schema/ff4j http://ff4j.org/schema/ff4j-1.4.0.xsd">

    <features>

        <feature uid="AwesomeFeature" enable="false" description="some desc">

        </feature>

    </features>

    <properties>

        <property name="maxLoginAttempts" type="int" value="12"/>

    </properties>

</ff4j>

• 代码说明
  主要是ff4j 以及rest api 的
  FF4JConfiguration.java:

 

package com.dalong;

​

import org.ff4j.FF4j;

import org.springframework.context.annotation.Bean;

import org.springframework.context.annotation.Configuration;

​

@Configuration

public class FF4JConfiguration {

​

    @Bean

    public FF4j getFF4j() {

        // You cen define ff4j the way you like

        // the simplest is to use XML and InMemory but there are dozens of DB available.

        return new FF4j("ff4j-features.xml");

​

        // Please add ff4j-store-springjdbc for this sample to work..and a Datasource

        //FF4j ff4j = new FF4j();

        //ff4j.setFeatureStore(new FeatureStoreSpringJdbc(myDataSource));

        //ff4j.setPropertiesStore(new PropertyStoreSpringJdbc(myDataSource));

        //ff4j.setEventRepository(new EventRepositorySpringJdbc(myDataSource));

        // Enable auditing

        //ff4j.audit(true);

        // If feature not found in DB, automatically created (as false)

        //ff4j.autoCreate(enableAutoCreate);

    }

}

• SampleResource.java

package com.dalong;

​

import org.ff4j.FF4j;

import org.ff4j.spring.autowire.FF4JFeature;

import org.ff4j.spring.autowire.FF4JProperty;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RequestMethod;

import org.springframework.web.bind.annotation.RestController;

​

@RestController

public class SampleResource {

​

    // BeanPostProcessor will inject value at runtime, soon source for default ConfigurationProperties

    @FF4JProperty("maxLoginAttempts")

    private int maxLoginAttempts;

​

    @FF4JFeature(value = "AwesomeFeature")

    private boolean awesomeFeature;

​

    @Autowired

    private FF4j getFF4j;

​

    @RequestMapping(value = "/", method = RequestMethod.GET, produces = "text/html")

    public String sayHello() {

        StringBuilder response = new StringBuilder("<html><body><ul>");

        response.append("<p>Is <span style=\"color:red\">Awesome</span> feature activated ? from ff4j.check(\"AwesomeFeature\") <span style=\"color:blue\">");

        response.append(getFF4j.check("AwesomeFeature"));

        response.append("</span></body></html>");

        return response.toString();

    }

​

    @RequestMapping(value = "/maxLoginTries", method = RequestMethod.GET)

    public Integer getMaxTries() {

        return maxLoginAttempts;

    }

}

• 启动

mvn spring-boot:run

• 效果

 

 

说明

以上是一个简单的试用，实际中最好的是结合持久化存储方便的处理特性开发

参考资料

https://github.com/ff4j/ff4j-samples/tree/master/ff4j-sample-springboot-starter
https://github.com/ff4j/ff4j/wiki/Getting-Started