{"id":2897,"date":"2020-09-24T11:19:20","date_gmt":"2020-09-24T11:19:20","guid":{"rendered":"https:\/\/alternative-spaces.com\/blog\/?p=2897"},"modified":"2023-05-12T09:12:34","modified_gmt":"2023-05-12T09:12:34","slug":"introduction-to-feature-flags-in-java-using-the-spring-boot-framework","status":"publish","type":"post","link":"https:\/\/alternative-spaces.com\/blog\/introduction-to-feature-flags-in-java-using-the-spring-boot-framework\/","title":{"rendered":"Introduction to Feature Flags in Java Using the Spring Boot Framework"},"content":{"rendered":"\n

Feature flag (also known as feature toggle or feature switch) is a technique that allows separating feature release from deploying code during software development. That way, an application is under full control since developers can set who sees its features and when. This makes feature toggles integral to the continuous delivery approach which facilitates quick and reliable releases. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The credits for introducing the concept of feature flagging go to Martin Fowler<\/a> and Facebook\u2019s development team. Feature toggles were presented as an alternative to feature branches, i.e. maintaining multiple source-code branches. Feature branches make feature releases tied to code deployment.<\/p>\n\n\n\n

How Feature Flags Work<\/strong><\/h2>\n\n\n\n

When marketers are targeting users based on various attributes \u2014 age, location, gender, etc. \u2014 they want to ensure the information they want to share gets to the specific users. Thus, user targeting gives control over what is shared, with whom, and when. Something similar happens with feature flagging. <\/p>\n\n\n\n

When a web application loads, it will use the specific user\u2019s attributes to determine what features will be shown. For example, canary launches imply a specific feature functioning only for a small group of users. The group can be chosen from the internal users, or based on demographics, or deliberately at random; it varies from company to company.\u00a0<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

That way, after logging in, all the \u2018canaries\u2019 will see the newest features firsthand. The other users won\u2019t see anything new yet. With time, when new features prove their efficiency, they will be gradually introduced to a larger audience. If new features prove to be less than hoped for, they can be turned off.<\/p>\n\n\n\n

According to Martin Fowler, feature toggles can be classified<\/a> as follows:<\/p>\n\n\n\n

  1. Release toggles.<\/strong> These toggles are used to hide incomplete features from groups of users or from all users. <\/li>
  2. Experiment toggles.<\/strong> This type is used for A\/B testing.<\/li>
  3. Ops toggles.<\/strong> These toggles are used to control the operational aspects of a system.<\/li>
  4. Permissioning toggles.<\/strong> This type is used to manage what features are available for different groups of users (e.g., premium users).<\/li><\/ol>\n\n\n\n

    Feature Flags in Java<\/strong><\/h2>\n\n\n\n

    Feature flags in Java work by the same principle \u2014 they help when it\u2019s still too early to introduce new features in a Java application, or if they should be available, only for specific users. Reasons may vary. For example, the business or application itself, might not be ready.\u00a0 So it is handy to add a specific feature toggle and default it to \u2018off\u2019 until it is needed.\u00a0<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Also, there are feature toggle management tools that allow adding feature toggles to improve the code. When the development team opens the code and changes it, it\u2019s not Java flags at work, it\u2019s a release deployment. Sometimes, release deployment is chosen over feature switches whose main drawback is a higher level of complexity. <\/p>\n\n\n\n

    There are two ways to prevent feature switches from becoming unmanageable:<\/p>\n\n\n\n

    1. Prevent feature flag coupling.<\/strong> This means all values of feature toggles should be put into a particular class. That class will work as a single source of truth. It gives greater freedom and flexibility since it is possible to replace feature toggles storage with a database. It is also possible to implement switching flags in runtime.<\/p>\n\n\n\n

    2. Extracting feature toggles in Spring Boot.<\/strong> When there is a separate bean for all feature toggles, it is possible to insert Spring flags from the application.properties<\/em> file through the @ConfigurationProperties<\/em> annotation. <\/p>\n\n\n\n

    Feature Flags with Spring Boot<\/strong><\/h2>\n\n\n\n

    Spring Boot is an open-source framework based on Java. This project is built on the Spring framework and allows running various types of applications more swiftly and simply. Some remarkable Spring Boot features are:<\/p>\n\n\n\n

    1. Intelligent auto-configuration. <\/strong>Spring Boot analyzes the environment and developers\u2019 hints to set an application based on that data.<\/li>
    2. Standalone.<\/strong> Spring Boot has no attachment to web servers or any special environments.<\/li>
    3. Opinionated.<\/strong> That feature loads and configures the most often used libraries in the most typical way. Often, that means that developers need not do it manually every time and save time for coding.<\/li><\/ol>\n\n\n\n

      As was mentioned before, feature toggles allow web developers to disable some functions of a web application in development. The best thing about Spring toggle is that developers need not redeploy the app or even change the code. Some feature toggles work globally, so when you configure them, they stop or start working for the whole application, but some of them can be disabled or enabled per request or per user. The development process requires using the simplest approach to resolving a problem. Feature toggles can come in handy because using them removes some unnecessary complications.<\/p>\n\n\n\n

      Smartly used feature toggles can stabilize the development process, while misusing them can add even more complication and trouble. Developers should know what they are doing and why. <\/p>\n\n\n\n

      Feature flags may be used in the following scenarios: <\/p>\n\n\n\n

      1. Nontrivial features that are used in trunk-based development. When frequent integration is required, sometimes it is not possible to release some bits of functionality. The use of feature flags can help to proceed with release without making changes available until they are complete.<\/p>\n\n\n\n

      2. A\/B testing. When using feature switches, it is possible to release different solutions to a single problem and see what works best. <\/p>\n\n\n\n

      3. Canary releasing. The release of new features may be gradual, starting with a small group of users and continuously expanding, if the features behave correctly. That can be done using feature toggles.<\/p>\n\n\n\n

      4. Feature flags can be used to toggle the right setup for the right environment. <\/p>\n\n\n\n

      Feature Flag Technique Using Spring Boot<\/strong><\/h2>\n\n\n\n

      There are many ways to implement feature toggles, but the most common is to activate one or another implementation of some interface. Which depends on the value of the feature flag.<\/p>\n\n\n\n

      1. application.yml and @ConditionalOnProperty <\/strong><\/p>\n\n\n\n

      It is very convenient to use\u00a0application.yml<\/em>\u00a0for feature flags in Spring Boot apps. This file usually defines the configuration of an application and simultaneously can be a perfect place for feature\u00a0toggles:<\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      The next step requires turning on some implementation options of the feature, depending on the flag\u2019s value.\u00a0@ConditionalOnProperty<\/em>\u00a0annotation is used for this.\u00a0 <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      If the\u00a0feature-flags.is-new-books-service-enabled<\/em>\u00a0value is\u00a0-false<\/em>, or there is no such flag in the configuration, an object from the class\u00a0BooksDefaultService<\/em>\u00a0will be created. For the\u00a0-true<\/em>\u00a0value, an object from the class\u00a0BooksNewService<\/em>\u00a0will be created. This is what those classes look like: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Now, it is possible to use an object of\u00a0\u00a0BookService<\/em>\u00a0interface with actual implementation (polymorphism in action): <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Sometimes, there is a need to turn off the controller itself. It is done the same way through the\u00a0@ConditionalOnProperty<\/em>\u00a0annotation: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      That way, if the value of feature-flags.is-new-books-service-enabled<\/em> is -false<\/em>, or such a flag doesn\u2019t exist in application.yml<\/em>, the request \/books<\/em> will return the 404 error.<\/p>\n\n\n\n

      2. @ConfigurationProperties<\/strong><\/p>\n\n\n\n

      It is not only convenient but also important to encapsulate properties of feature toggles in an object that will be registered in the Spring application\u2019s container. For doing this, the developer needs to include the dependency\u00a0spring-boot-configuration-processor:<\/em><\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Now, it is time for class with field flags: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      For Spring to gather object from the class\u00a0FeatureFlags<\/em>\u00a0with properties from\u00a0application.yml<\/em>, it is necessary to do the following: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      So now it is possible to use the object from the class\u00a0FeatureFlags<\/em>\u00a0as a bean through Spring dependency: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Feature Flags Adjustment in Runtime<\/strong><\/h2>\n\n\n\n

      1. Configuration Server.<\/strong><\/h3>\n\n\n\n

      Feature flags often need to be adjusted and modified during the run of the app. One way to do this is through the Configuration Server. Configuration Server is a separate Spring Boot application that provides HTTP resource-based API for the main app to request its configuration. A simple Configuration Server looks like this:<\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      It\u2019s necessary to add a dependency: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      A feature flag information can be stored in a database. Let\u2019s consider the example of\u00a0MySQL<\/em>\u00a0by creating a\u00a0properties<\/em>\u00a0table with a structure like this: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      It is necessary to add dependencies to work with a database: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n
      \"\"<\/figure>\n\n\n\n

      Then, feature flags are added into the table: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Configuration Server\u2019s\u00a0application.yml<\/em>\u00a0looks like this: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Through HTTH, the main app will receive feature flags from the Configuration Server if the following dependency is added: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Also, it is needed to add the following\u00a0bootstrap<\/em>\u00a0configuration: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Now it is possible to store flags in a database and load them to the main app at the start.<\/p>\n\n\n\n

      2. Spring Actuator and @RefreshScope.<\/strong><\/h3>\n\n\n\n

      Now, what if the app is already running and some feature needs to be activated? Spring Actuator will help. First, it is necessary to add a dependency:<\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Auto-configuration of the Actuator\u2019s refresh endpoint will be used via JMX, but it is possible to use it via HTTP: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      For refreshing properties of flags,\u00a0@RefreshScope<\/em>\u00a0annotation should be added: <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Now it is possible to summon new values of flags through POST \/actuator\/refresh<\/em>.<\/p>\n\n\n\n

      The diagram below presents the described architecture.<\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      How will the implementation change? Beans are created when the app launches with the help of the annotation\u00a0@ConditionalOnProperty<\/em>, and they won\u2019t change after the refresh. The problem can be solved with the help of\u00a0@PostConstruct<\/em>, the same\u00a0@RefreshScope<\/em>\u00a0annotation, and the Proxy pattern:<\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      3. Front-end.<\/strong><\/h3>\n\n\n\n

      Frequently, new functions are not only about the back-end changes. Feature flags should be used for the front-end as well. To do this, it is enough to use an additional endpoint\u00a0GET \/feature-flags:<\/em><\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Now you can see that the Spring framework has simple and flexible tools used to work with feature toggles. Web developers don\u2019t need to use any additional libraries since Standard Spring Boot features and other ready-to-use Spring projects (Spring Actuator, Spring Cloud Config Server, etc.) cover all their needs. <\/p>\n\n\n\n

      Making new features visible to a limited number of users allows collecting feedback from the users in the early stages. It empowers the development team to make adjustments and changes before releasing a web application. If some new features are still too early to release, developers can turn them on just for themselves to try, test, and adjust. This helps ensure a flawless release.<\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      The feature flag technique makes software development more stable, quick, and controllable, and helps resolve several major troubles in production release, thus reducing the development costs for the web application owner. Regular high-quality software feature releases are vital for a good user experience and holding the users\u2019 attention. <\/p>\n\n\n\n

      If there is a project you are considering,\u00a0our expert team<\/a>\u00a0can help bring your idea to life and ensure that it evolves through seamless feature releases.<\/p>\n\n\n\n

      Content created by our partner, Onix-systems.<\/p>\n","protected":false},"excerpt":{"rendered":"

      Feature flag (also known as feature toggle or feature switch) is a technique that allows separating feature release from deploying code during software development. That way, an application is under full control since developers can set who sees its features and when. This makes feature toggles integral to the continuous delivery approach which facilitates quick […]<\/p>\n","protected":false},"author":13,"featured_media":2898,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-2897","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/alternative-spaces.com\/blog\/wp-json\/wp\/v2\/posts\/2897","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/alternative-spaces.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/alternative-spaces.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/alternative-spaces.com\/blog\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/alternative-spaces.com\/blog\/wp-json\/wp\/v2\/comments?post=2897"}],"version-history":[{"count":1,"href":"https:\/\/alternative-spaces.com\/blog\/wp-json\/wp\/v2\/posts\/2897\/revisions"}],"predecessor-version":[{"id":2930,"href":"https:\/\/alternative-spaces.com\/blog\/wp-json\/wp\/v2\/posts\/2897\/revisions\/2930"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/alternative-spaces.com\/blog\/wp-json\/wp\/v2\/media\/2898"}],"wp:attachment":[{"href":"https:\/\/alternative-spaces.com\/blog\/wp-json\/wp\/v2\/media?parent=2897"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/alternative-spaces.com\/blog\/wp-json\/wp\/v2\/categories?post=2897"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/alternative-spaces.com\/blog\/wp-json\/wp\/v2\/tags?post=2897"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}