Eren Avşaroğulları is highly motivated open source developer and enthusiast on Java and related open source technologies. He has over 8 years of professional software design and development experiences in different domains such as telecommunication, finance and control & automation. His areas of interest are Web Frameworks, Distributed and Paralel Computing, High-Performance Systems, High Availability and Scalability. His current focus is Large-Scaled & High Available Enterprise Applications and GSM Network Platform & Service Design and Developments. He writes on the open source technologies. He hold a B.Sc. degree in Electrical & Electronics Engineering and a M.Sc. degree in Control & Automation Engineering. Eren is a DZone MVB and is not an employee of DZone and has posted 9 posts at DZone. You can read more from them at their website. View Full User Profile

Dynamic Property Management in Spring

06.03.2012
| 9097 views |
  • submit to reddit

Static and Dynamic Properties are very important for both operational management and changing the behavior of the system at the production level. Specially, dynamic parameters reduces interruption of the service. This article shows how to manage dynamic properties in Spring Applications by using Quartz.

Multi-Job Scheduling Service by using Spring and Quartz article is offered for Spring and Quartz Integration.

Let us look at Dynamic Property Management in Spring.

Used Technologies :

JDK 1.6.0_31
Spring 3.1.1
Quartz 1.8.5
Maven 3.0.2

STEP 1 : CREATE MAVEN PROJECT

A maven project is created as follows. (It can be created by using Maven or IDE Plug-in).

STEP 2 : LIBRARIES

Spring dependencies are added to Maven’ s pom.xml.

<properties>
    <spring.version>3.1.1.RELEASE</spring.version>
</properties>
 
<dependencies>
    <!-- Spring 3 dependencies -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context-support</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-tx</artifactId>
        <version>${spring.version}</version>
    </dependency>
 
    <!-- Quartz dependency -->
    <dependency>
        <groupId>org.quartz-scheduler</groupId>
        <artifactId>quartz</artifactId>
        <version>1.8.5</version>
    </dependency>
 
    <!-- Log4j dependency -->
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.16</version>
    </dependency>
 
</dependencies>

STEP 3 : CREATE DynamicPropertiesFile.properties

DynamicPropertiesFile covers dynamic properties of the application.

# This property defines message content
# Possible values = Text. Default value : Welcome
Message_Content = Welcome Visitor
 
# This property defines minimum visitor count
# Possible values = positive integer. Default value : 1
Minimum_Visitor_Count = 1
 
# This property defines maximum visitor count
# Possible values = positive integer. Default value : 10
Maximum_Visitor_Count = 10

STEP 4 : CREATE applicationContext.xml

Application Context is created as follows :

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">
 
    <!-- Beans Declaration -->
    <!-- Core Dynamic Properties Bean Declaration -->
    <bean id="CoreDynamicPropertiesBean" class="org.springframework.beans.factory.config.PropertiesFactoryBean" scope="prototype">
        <property name="location" value="classpath:DynamicPropertiesFile.properties" />
    </bean>
    <!-- Dynamic Properties Map Declaration -->
    <bean id="DynamicPropertiesMap" class="java.util.HashMap"/>
 
    <!-- Dynamic Properties File Reader Task Declaration -->
    <bean id="DynamicPropertiesFileReaderTask" class="com.otv.dynamic.properties.task.DynamicPropertiesFileReaderTask">
        <property name="dynamicPropertiesMap"   ref="DynamicPropertiesMap"/>
    </bean>
    <!-- End of Beans Declaration -->
 
    <!-- Scheduler Configuration -->
    <!-- Job Detail-->
    <bean id="DynamicPropertiesFileReaderTaskJobDetail" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
        <property name="targetObject" ref="DynamicPropertiesFileReaderTask" />
        <property name="targetMethod" value="start" />
    </bean>
 
    <!-- Simple Trigger -->
    <bean id="DynamicPropertiesFileReaderTaskTrigger" class="org.springframework.scheduling.quartz.SimpleTriggerBean">
        <property name="jobDetail" ref="DynamicPropertiesFileReaderTaskJobDetail" />
        <property name="repeatInterval" value="60000" />
        <property name="startDelay" value="0" />
    </bean>
 
    <bean class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
        <property name="jobDetails">
           <list>
              <ref bean="DynamicPropertiesFileReaderTaskJobDetail" />
           </list>
        </property>
        <property name="triggers">
           <list>
              <ref bean="DynamicPropertiesFileReaderTaskTrigger" />
           </list>
        </property>
    </bean>
    <!-- End of Scheduler Configuration -->
</beans>

STEP 5 : CREATE SystemConstants CLASS

A new SystemConstants Class is created. This class covers all system constants.

package com.otv.common;
 
/**
 * System Constants
 *
 * @author  onlinetechvision.com
 * @since   26 May 2012
 * @version 1.0.0
 *
 */
public class SystemConstants {
 
    //Names of Dynamic Properties...
    public static final String DYNAMIC_PROPERTY_MESSAGE_CONTENT                     = "Message_Content";
    public static final String DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT               = "Minimum_Visitor_Count";
    public static final String DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT               = "Maximum_Visitor_Count";
 
    //Default Values of Dynamic Properties...
    public static final String DYNAMIC_PROPERTY_MESSAGE_CONTENT_DEFAULT_VALUE       = "Welcome";
    public static final String DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT_DEFAULT_VALUE = "1";
    public static final String DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT_DEFAULT_VALUE = "10";
 
    public static final String BEAN_NAME_CORE_DYNAMIC_PROPERTIES_BEAN = "CoreDynamicPropertiesBean";
 
    public static final String APPLICATION_CONTEXT_FILE_NAME = "applicationContext.xml";
}

STEP 6 : CREATE DynamicPropertiesFileReaderTask CLASS

DynamicPropertiesFileReaderTask Class is created. This class is managed by Quartz. It reads all dynamic properties via DynamicPropertiesFile by invoking “start” method in every minute. Reading period can be changed via applicationContext.xml.

Please note that coreDynamicPropertiesBean‘ s scope is Singleton by default. It must return new values of dynamic properties at the runtime so its scope should be set Prototype. Otherwise, new values can not be received.

package com.otv.dynamic.properties.task;
 
import java.util.HashMap;
import java.util.Properties;
 
import org.apache.log4j.Logger;
import org.springframework.beans.BeansException;
import org.springframework.beans.factory.BeanFactory;
import org.springframework.beans.factory.BeanFactoryAware;
 
import com.otv.common.SystemConstants;
 
/**
 * Dynamic Properties File Reader Task
 *
 * @author  onlinetechvision.com
 * @since   26 May 2012
 * @version 1.0.0
 *
 */
public class DynamicPropertiesFileReaderTask implements BeanFactoryAware {
 
    private static Logger logger = Logger.getLogger(DynamicPropertiesFileReaderTask.class);
    private Properties coreDynamicPropertiesBean;
    private HashMap<String, String> dynamicPropertiesMap;
    private BeanFactory beanFactory;
 
    /**
     * Starts reading the dynamic properties
     *
     */
    public void start() {
 
        setCoreDynamicPropertiesBean(createCoreDynamicPropertiesBeanInstance());
 
        logger.info("**** Dynamic Properties File Reader Task is being started... ****");
        readConfiguration();
        logger.info("**** Dynamic Properties File Reader Task is stopped... ****");
    }
 
    /**
     * Reads all the dynamic properties
     *
     */
    private void readConfiguration() {
        readMessageContent();
        readMinimumVisitorCount();
        readMaximumVisitorCount();
    }
 
    /**
     * Reads Message_Content dynamic property
     *
     */
    private void readMessageContent() {
        String messageContent = getCoreDynamicPropertiesBean()
                                   .getProperty(SystemConstants.DYNAMIC_PROPERTY_MESSAGE_CONTENT,
                                                SystemConstants.DYNAMIC_PROPERTY_MESSAGE_CONTENT_DEFAULT_VALUE);
 
        if (messageContent.equals("")){
            getDynamicPropertiesMap().put(SystemConstants.DYNAMIC_PROPERTY_MESSAGE_CONTENT,
                                                 SystemConstants.DYNAMIC_PROPERTY_MESSAGE_CONTENT_DEFAULT_VALUE);
 
            logger.error(SystemConstants.DYNAMIC_PROPERTY_MESSAGE_CONTENT +
                                   " value is not found so its default value is set. Default value : " +
                                   SystemConstants.DYNAMIC_PROPERTY_MESSAGE_CONTENT_DEFAULT_VALUE);
 
        } else {
            messageContent = messageContent.trim();
            getDynamicPropertiesMap().put(SystemConstants.DYNAMIC_PROPERTY_MESSAGE_CONTENT, messageContent);
            logger.info(SystemConstants.DYNAMIC_PROPERTY_MESSAGE_CONTENT + " : " +
                             getDynamicPropertiesMap().get(SystemConstants.DYNAMIC_PROPERTY_MESSAGE_CONTENT));
        }
    }
 
    /**
     * Reads Minimum_Visitor_Count dynamic property
     *
     */
    private void readMinimumVisitorCount() {
        String minimumVisitorCount = getCoreDynamicPropertiesBean()
                                       .getProperty(SystemConstants.DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT,
                                            SystemConstants.DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT_DEFAULT_VALUE).trim();
 
        try {
            if (Integer.parseInt(minimumVisitorCount) > 0){
                getDynamicPropertiesMap().put(SystemConstants.DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT, minimumVisitorCount);
 
                logger.info(SystemConstants.DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT + " : " +
                                      getDynamicPropertiesMap()
                                             .get(SystemConstants.DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT));
            } else {
                getDynamicPropertiesMap().put(SystemConstants.DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT,
                                                  SystemConstants.DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT_DEFAULT_VALUE);
 
                logger.error("Invalid "+SystemConstants.DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT +
                        " value encountered. Must be greater than 0. Its default value is set. Default value : " +
                        SystemConstants.DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT_DEFAULT_VALUE);
            }
        } catch (NumberFormatException nfe) {
            logger.error("Invalid "+SystemConstants.DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT +
                                 " value encountered. Must be numeric!", nfe);
 
            logger.warn(SystemConstants.DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT +
                                 " default value is set. Default value : " +
                                 SystemConstants.DYNAMIC_PROPERTY_MINIMUM_VISITOR_COUNT_DEFAULT_VALUE);
        }
    }
 
    /**
     * Reads Maximum_Visitor_Count dynamic property
     *
     */
    private void readMaximumVisitorCount() {
        String maximumVisitorCount = getCoreDynamicPropertiesBean()
                                        .getProperty(SystemConstants.DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT,
                                                     SystemConstants.DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT_DEFAULT_VALUE).trim();
        try {
            if (Integer.parseInt(maximumVisitorCount) > 0){
                getDynamicPropertiesMap().put(SystemConstants.DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT, maximumVisitorCount);
 
                logger.info(SystemConstants.DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT + " : " +
                                   getDynamicPropertiesMap()
                                          .get(SystemConstants.DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT));
            } else {
                getDynamicPropertiesMap().put(SystemConstants.DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT,
                                                    SystemConstants.DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT_DEFAULT_VALUE);
 
                logger.error("Invalid "+SystemConstants.DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT +
                                  " value encountered. Must be greater than 0. Its default value is set. Default value : " +
                                  SystemConstants.DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT_DEFAULT_VALUE);
 
            }
        } catch (NumberFormatException nfe) {
            logger.error("Invalid "+SystemConstants.DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT +
                                " value encountered. Must be numeric!", nfe);
 
            logger.warn(SystemConstants.DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT +
                                 " default value is set. Default value : " +
                                 SystemConstants.DYNAMIC_PROPERTY_MAXIMUM_VISITOR_COUNT_DEFAULT_VALUE);
        }
    }
 
    /**
     * Gets CoreDynamicPropertiesBean
     *
     * @return Properties coreDynamicPropertiesBean
     */
    public Properties getCoreDynamicPropertiesBean() {
        return coreDynamicPropertiesBean;
    }
 
    /**
     * Sets CoreDynamicPropertiesBean
     *
     * @param Properties coreDynamicPropertiesBean
     */
    public void setCoreDynamicPropertiesBean(Properties coreDynamicPropertiesBean) {
        this.coreDynamicPropertiesBean = coreDynamicPropertiesBean;
    }
 
    /**
     * Gets DynamicPropertiesMap
     *
     * @return HashMap dynamicPropertiesMap
     */
    public HashMap<String, String> getDynamicPropertiesMap() {
        return dynamicPropertiesMap;
    }
 
    /**
     * Sets DynamicPropertiesMap
     *
     * @param HashMap dynamicPropertiesMap
     */
    public void setDynamicPropertiesMap(HashMap<String, String> dynamicPropertiesMap) {
        this.dynamicPropertiesMap = dynamicPropertiesMap;
    }
 
    /**
     * Gets a new instance of CoreDynamicPropertiesBean
     *
     * @return Properties CoreDynamicPropertiesBean
     */
    public Properties createCoreDynamicPropertiesBeanInstance() {
        return  (Properties) this.beanFactory.getBean(SystemConstants.BEAN_NAME_CORE_DYNAMIC_PROPERTIES_BEAN);
    }
 
    /**
     * Sets BeanFactory
     *
     * @param BeanFactory beanFactory
     */
    public void setBeanFactory(BeanFactory beanFactory) throws BeansException {
        this.beanFactory = beanFactory;
    }
 
}

STEP 7 : CREATE Application CLASS

Application Class starts the project.

package com.otv.starter;
 
import org.springframework.context.support.ClassPathXmlApplicationContext;
 
import com.otv.common.SystemConstants;
 
/**
 * Application Starter Class
 *
 * @author  onlinetechvision.com
 * @since   26 May 2012
 * @version 1.0.0
 *
 */
public class Application {
 
    /**
     * Main method of the Application
     *
     */
    public static void main(String[] args) {
        new ClassPathXmlApplicationContext(SystemConstants.APPLICATION_CONTEXT_FILE_NAME);
    }
}

STEP 8 : RUN PROJECT

If Application Class is run, following console logs are shown :

26.05.2012 17:25:09  INFO (DefaultLifecycleProcessor.java:334) - Starting beans in phase 2147483647
26.05.2012 17:25:09  INFO (SchedulerFactoryBean.java:648) - Starting Quartz Scheduler now
26.05.2012 17:25:09  INFO (PropertiesLoaderSupport.java:177) - Loading properties file from class path resource [DynamicPropertiesFile.properties]
26.05.2012 17:25:09  INFO (DynamicPropertiesFileReaderTask.java:36) - **** Dynamic Properties File Reader Task is being started... ****
26.05.2012 17:25:09  INFO (DynamicPropertiesFileReaderTask.java:63) - Message_Content : Welcome Visitor
26.05.2012 17:25:09  INFO (DynamicPropertiesFileReaderTask.java:76) - Minimum_Visitor_Count : 1
26.05.2012 17:25:09  INFO (DynamicPropertiesFileReaderTask.java:96) - Maximum_Visitor_Count : 10
26.05.2012 17:25:09  INFO (DynamicPropertiesFileReaderTask.java:38) - **** Dynamic Properties File Reader Task is stopped... ****
 
26.05.2012 17:26:09  INFO (PropertiesLoaderSupport.java:177) - Loading properties file from class path resource [DynamicPropertiesFile.properties]
26.05.2012 17:26:09  INFO (DynamicPropertiesFileReaderTask.java:36) - **** Dynamic Properties File Reader Task is being started... ****
26.05.2012 17:26:09  INFO (DynamicPropertiesFileReaderTask.java:63) - Message_Content : Welcome Visitor, Bruce!
26.05.2012 17:26:09  INFO (DynamicPropertiesFileReaderTask.java:76) - Minimum_Visitor_Count : 2
26.05.2012 17:26:09  INFO (DynamicPropertiesFileReaderTask.java:96) - Maximum_Visitor_Count : 20
26.05.2012 17:26:09  INFO (DynamicPropertiesFileReaderTask.java:38) - **** Dynamic Properties File Reader Task is stopped... ****

STEP 9 : DOWNLOAD

OTV_SpringDynamicPropertyManagement

REFERENCES :

Spring Framework Reference 3.x

 

 

 

 

 

 

 

 

 

 

 

 

Published at DZone with permission of Eren Avşaroğulları, author and DZone MVB. (source)

(Note: Opinions expressed in this article and its replies are the opinions of their respective authors and not those of DZone, Inc.)

Comments

Daniel Slazer replied on Tue, 2012/06/12 - 12:07pm

Here is the improvised version of the codes. What we notice if we put the extra \r\n the corruption is lesser but still appear later part too. The corruption is always in the beginning of the first few characters

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.