详解Spring Boot使用系统参数表提升系统的灵活性


Posted in Java/Android onJune 30, 2021
目录
  • 一、使用系统参数表的好处
  • 二、系统参数表的表结构
  • 三、系统参数表在项目中的使用
    • 3.1、Entity类
    • 3.2、Dao类
    • 3.3、Service类
    • 3.4、ServiceImpl类
    • 3.5、全局配置服务类
    • 3.6、启动时加载
    • 3.7、在服务实现类中访问系统参数

一、使用系统参数表的好处

​​以数据库表形式存储的系统参数表比配置文件(.properties文件或.yaml文件)要更灵活,因为无需重启系统就可以动态更新。

​系统参数表可用于存储下列数据:

表字段枚举值,如下列字段:

`question_type`   TINYINT(4)   NOT NULL DEFAULT 0 COMMENT '题型,1-单选题,2-多选题,3-问答题',

​这个字段现在有3种取值,但是难保将来有扩展的可能,如:是非题、计算题、应用题等。

​因此将取值的枚举值用系统参数表来配置,可以提高系统扩展灵活性。

​另一方面,对于前端而言,就可以通过查询系统参数表数据,用于UI呈现,而不必硬编码。如前端需要用下拉框来显示所有可能的”题型“,这个列表就可以查询系统参数表来获取。

​因此可以将所有字段枚举值纳入系统参数表管理。

参数设置,如邮件参数,对接的第三方系统的URL等。

二、系统参数表的表结构

​系统参数表的表结构如下:

DROP TABLE IF EXISTS `sys_parameters`;
CREATE TABLE `sys_parameters`
(
  `class_id`      INT(11)      NOT NULL DEFAULT 0 COMMENT '参数大类id',
  `class_key`     VARCHAR(60)  NOT NULL DEFAULT '' COMMENT '参数大类key',
  `class_name`    VARCHAR(60)  NOT NULL DEFAULT '' COMMENT '参数大类名称',
  `item_id`       INT(11)      NOT NULL DEFAULT 0 COMMENT '参数大类下子项id',
  `item_key`      VARCHAR(200) NOT NULL DEFAULT '' COMMENT '子项key',
  `item_value`    VARCHAR(200) NOT NULL DEFAULT '' COMMENT '子项值',
  `item_desc`     VARCHAR(512) NOT NULL DEFAULT '' COMMENT '子项描述',

  -- 记录操作信息
  `login_name` VARCHAR(80)  NOT NULL DEFAULT '' COMMENT '操作人账号',
  `delete_flag`   TINYINT(4)   NOT NULL DEFAULT 0 COMMENT '记录删除标记,1-已删除',
  `create_time`   DATETIME  NOT NULL DEFAULT NOW() COMMENT '创建时间',
  `update_time`   DATETIME           DEFAULT NULL ON UPDATE NOW() COMMENT '更新时间',
  PRIMARY KEY (`class_id`, `item_id`)
) ENGINE = InnoDB DEFAULT CHARSET = utf8 COMMENT '系统参数表';

​说明:

​class_id字段只要确保一个参数大类(如一个枚举字段名)使用唯一值。使用class_key和item_key自动,便于提高记录数据和代码的可读性。class_key一般可以取字段名,但如果发生同名时,需要修改,确保不同表的同名字段,使用不同的class_key。对于枚举值类型,item_key可以取item_id相同的值,只是数据类型不同,此item_key转换成整型数,就是对应字段的值。

​这个表的数据一般可以由开发人员提供,包括初始或变动的SQL脚本,由DBA执行,项目无需为此开发界面来维护。

​下面是初始脚本示例:

INSERT INTO sys_parameters(class_id, class_key, class_name, item_id, item_key, item_value, item_desc)
VALUES (11, 'receive_flag', '短信接收标志', 0, '0', '未接收', '');
INSERT INTO sys_parameters(class_id, class_key, class_name, item_id, item_key, item_value, item_desc)
VALUES (11, 'receive_flag', '短信接收标志', 1, '1', '已接收', '');
INSERT INTO sys_parameters(class_id, class_key, class_name, item_id, item_key, item_value, item_desc)
VALUES (11, 'receive_flag', '短信接收标志', 2, '2', '发送失败', '');

INSERT INTO sys_parameters(class_id, class_key, class_name, item_id, item_key, item_value, item_desc)
VALUES (12, 'question_type', '题型', 1, '1', '单选题', '');
INSERT INTO sys_parameters(class_id, class_key, class_name, item_id, item_key, item_value, item_desc)
VALUES (12, 'question_type', '题型', 2, '2', '多选题', '');
INSERT INTO sys_parameters(class_id, class_key, class_name, item_id, item_key, item_value, item_desc)
VALUES (12, 'question_type', '题型', 3, '3', '问答题', '');

INSERT INTO sys_parameters(class_id, class_key, class_name, item_id, item_key, item_value, item_desc)
VALUES (101, 'url_param', 'URL参数', 0, 'url_prefix', 'http://questinvest.abc.com:8880', 'url前缀部分');
INSERT INTO sys_parameters(class_id, class_key, class_name, item_id, item_key, item_value, item_desc)
VALUES (101, 'url_param', 'URL参数', 1, 'url_action', '/questInvest/show', '请求接口方法');

三、系统参数表在项目中的使用

​在Spring Boot项目中,系统参数表一般只需在应用启动时加载一次,并提供更新接口允许管理员来更新数据。下面详细说明使用方法。

3.1、Entity类

​先定义系统参数表的实体类,实体类为SysParameter,代码如下:

package com.abc.questInvest.entity;

import javax.persistence.Column;

import lombok.Data;

/**
 * @className	: SysParameter
 * @description	: 系统参数信息对象类
 *
 */
@Data
public class SysParameter {
	//参数大类id
	@Column(name = "class_id")
	private Integer classId;
	
	//参数大类key
	@Column(name = "class_key")
	private String classKey;

	//参数大类名称
	@Column(name = "class_name")
	private String className;
	
	//子项id
	@Column(name = "item_id")
	private Integer itemId;	
		
	//子项key
	@Column(name = "item_key")
	private String itemKey;	
	
	//子项值
	@Column(name = "item_value")
	private String itemValue;	

	//子项描述
	@Column(name = "item_desc")
	private String itemDesc;	

	//========记录操作信息================
    // 操作人姓名
    @Column(name = "login_name")
    private String loginName;   
    
    // 记录删除标记,保留
    @Column(name = "delete_flag")
    private Byte deleteFlag;    

    // 创建时间
    @Column(name = "create_time")
    private Date createTime;

    // 更新时间
    @Column(name = "update_time")
    private Date updateTime;	
}

3.2、Dao类

​数据访问类为SysParameterDao,代码如下:

package com.abc.questInvest.dao;

import java.util.List;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;

import com.abc.questInvest.entity.SysParameter;

/**
 * @className	: SysParameterDao
 * @description	: sys_parameters表数据访问类
 *
 */
@Mapper
public interface SysParameterDao {

	//查询所有系统参数,按class_id,item_id排序
	@Select("SELECT class_id,class_key,class_name,item_id,item_key,item_value,item_desc"
			+ " FROM sys_parameters WHERE delete_flag = 0" 
			+ " ORDER BY class_id,item_id")
    List<SysParameter> selectAll();
}

​SysParameterDao类,使用Mybatis,只需提供查询接口就行了,因为修改在数据库后台执行了。当然如果项目方认为有必要提供界面来维护该表,则可增加相应CRUD的接口。

3.3、Service类

​服务接口类为SysParameterService,代码如下:

package com.abc.questInvest.service;

import java.util.List;

import com.abc.questInvest.entity.SysParameter;

/**
 * @className	: SysParameterService
 * @description	: 系统参数数据服务
 *
 */
public interface SysParameterService {

	/**
	 * 
	 * @methodName		: loadData
	 * @description		: 加载数据库中数据,允许重复调用
	 * @return			: 成功返回true,否则返回false。
	 *
	 */	
	public boolean loadData();
	
	/**
	 * 
	 * @methodName		: getParameterClass
	 * @description		: 获取指定classKey的参数类别的子项列表
	 * @param classKey	: 参数类别key
	 * @return			: 指定classKey的参数类别的子项列表
	 *
	 */
	public List<SysParameter> getParameterClass(String classKey);
	
	/**
	 * 
	 * @methodName		: getParameterItemByKey
	 * @description		: 根据classKey和itemKey获取参数子项
	 * @param classKey	: 参数类别key
	 * @param itemKey	: 子项key
	 * @return			: SysParameter对象
	 *
	 */
	public SysParameter getParameterItemByKey(String classKey,String itemKey);
	
	/**
	 * 
	 * @methodName		: getParameterItemByValue
	 * @description		: 根据classKey和itemValue获取参数子项
	 * @param classKey	: 参数类别key	
	 * @param itemValue	: 子项值
	 * @return			: SysParameter对象
	 *
	 */
	public SysParameter getParameterItemByValue(String classKey,String itemValue);
}

​SysParameterService类定义了下列接口方法:

  • loadData方法,用于初始加载数据和更新数据。
  • getParameterClass方法,获取指定classKey的类别的所有子项列表。此方法调用会非常频繁。
  • getParameterItemByKey方法,根据classKey和itemKey获取参数子项,用于根据枚举值显示物理含义。此方法调用会非常频繁。
  • getParameterItemByValue方法,根据classKey和itemValue获取参数子项,用于根据物理含义取得枚举值。此方法调用会非常频繁。

3.4、ServiceImpl类

​服务实现类为SysParameterServiceImpl,代码如下:

package com.abc.questInvest.service.impl;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

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

import com.abc.questInvest.dao.SysParameterDao;
import com.abc.questInvest.entity.SysParameter;
import com.abc.questInvest.service.SysParameterService;

import lombok.extern.slf4j.Slf4j;

/**
 * @className	: SysParameterServiceImpl
 * @description	: SysParameterService实现类
 * @summary		: 实现对系统参数的管理
 *
 */
@Slf4j
@Service
public class SysParameterServiceImpl implements SysParameterService{
	//sys_parameters表数据访问对象
	@Autowired
	private SysParameterDao sysParameterDao;
	
	//管理全部的SysParameter表记录
	private Map<String,Map<String,SysParameter>> sysParameterMap = new HashMap<String,Map<String,SysParameter>>();
	
	/**
	 * 
	 * @methodName		: loadData
	 * @description		: 加载数据库中数据 
	 * @return			: 成功返回true,否则返回false。
	 *
	 */	
	@Override
	public boolean loadData() {
		try
		{
			//查询sys_parameters表,获取全部数据
			List<SysParameter> sysParameterList = sysParameterDao.selectAll();
			
			synchronized(sysParameterMap) {
				//先清空map,便于刷新调用
				sysParameterMap.clear();
				//将查询结果放入map对象中,按每个类别组织
				for(SysParameter item : sysParameterList) {
					String classKey = item.getClassKey();
					String itemKey = item.getItemKey();
					Map<String,SysParameter> sysParameterClassMap = null;
					if (sysParameterMap.containsKey(classKey)) {
						//如果存在该类别,则获取对象
						sysParameterClassMap = sysParameterMap.get(classKey);
					}else {
						//如果不存在该类别,则创建
						sysParameterClassMap = new HashMap<String,SysParameter>();
						//加入map中
						sysParameterMap.put(classKey, sysParameterClassMap);
					}
					sysParameterClassMap.put(itemKey,item);
				}
			}
		}catch(Exception e) {
			log.error(e.getMessage());
			e.printStackTrace();
			return false;
		}
		return true;
	}
	
	/**
	 * 
	 * @methodName		: getParameterClass
	 * @description		: 获取指定classKey的参数类别的子项列表
	 * @param classKey	: 参数类别key
	 * @return			: 指定classKey的参数类别的子项列表
	 *
	 */
	@Override
	public List<SysParameter> getParameterClass(String classKey){
		List<SysParameter> sysParameterList = new ArrayList<SysParameter>();
		
		//获取classKey对应的子map,将所有子项加入列表中
		if (sysParameterMap.containsKey(classKey)) {
			Map<String,SysParameter> sysParameterClassMap = sysParameterMap.get(classKey);
			for(SysParameter item : sysParameterClassMap.values()) {
				sysParameterList.add(item);
			}
		}
		
		return sysParameterList;
	}
	
	/**
	 * 
	 * @methodName		: getParameterItemByKey
	 * @description		: 根据classKey和itemKey获取参数子项
	 * @param classKey	: 参数类别key
	 * @param itemKey	: 子项key
	 * @return			: SysParameter对象
	 *
	 */
	@Override
	public SysParameter getParameterItemByKey(String classKey,String itemKey) {
		SysParameter sysParameter = null;
		
		if (sysParameterMap.containsKey(classKey)) {
			//如果classKey存在
			Map<String,SysParameter> sysParameterClassMap = sysParameterMap.get(classKey);
			if (sysParameterClassMap.containsKey(itemKey)) {
				//如果itemKey存在
				sysParameter = sysParameterClassMap.get(itemKey);
			}
		}
		
		return sysParameter;
	}
	
	/**
	 * 
	 * @methodName		: getParameterItemByValue
	 * @description		: 根据classKey和itemValue获取参数子项
	 * @param classKey	: 参数类别key	
	 * @param itemValue	: 子项值
	 * @return			: SysParameter对象
	 *
	 */
	@Override
	public SysParameter getParameterItemByValue(String classKey,String itemValue) {
		SysParameter sysParameter = null;
		
		if (sysParameterMap.containsKey(classKey)) {
			//如果classKey存在
			Map<String,SysParameter> sysParameterClassMap = sysParameterMap.get(classKey);
			//遍历
			for (Map.Entry<String,SysParameter> item : sysParameterClassMap.entrySet()) {
				if(item.getValue().getItemValue().equals(itemValue)) {
					//如果匹配值
					sysParameter = item.getValue();
					break;
				}
			}
		}
		
		return sysParameter;
		
	}
}

​SysParameterServiceImpl类使用了Map<String,Map<String,SysParameter>>类型的属性变量sysParameterMap来管理全部的系统参数,外层Map管理classKey到Map<String,SysParameter>的映射关系,每一项为一个参数类别,而里层Map<String,SysParameter>,用于管理itemKey与SysParameter之间的映射关系,每一项为该类别下的一个子项。使用sysParameterMap属性的目的,是将所有系统参数都加载到内存中,从而无需频繁访问数据库。

​loadData方法,用于初始加载数据和更新时刷新数据,为了防止更新时脏读数据,加了同步锁。这个方法调用不频繁。

3.5、全局配置服务类

​全局配置服务类用于管理全局配置参数,包括系统参数、权限树等。如果只有一种参数,可以不必有此类,因为这样加了一层壳。

​服务接口类为GlobalConfigService,代码如下:

package com.abc.questInvest.service;

/**
 * @className	: GlobalConfigService
 * @description	: 全局变量管理类
 *
 */
public interface GlobalConfigService {
	
	/**
	 * 
	 * @methodName		: loadData
	 * @description		: 加载数据 
	 * @return			: 成功返回true,否则返回false
	 *
	 */
	public boolean loadData();
	
	
	//获取SysParameterService对象
	public SysParameterService getSysParameterService();
	
	//获取其它配置数据服务对象
	//public FunctionTreeService getFunctionTreeService();
}

​GlobalConfigService提供了下列接口方法:

  • loadData方法,加载配置对象数据,确定多个配置对象的加载次序。
  • getSysParameterService方法,获取系统参数服务类对象。
  • 获取其它可能的配置服务对象的方法。

​服务实现类为GlobalConfigServiceImpl,代码如下:

package com.abc.questInvest.service.impl;

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

import com.abc.questInvest.service.FunctionTreeService;
import com.abc.questInvest.service.GlobalConfigService;
import com.abc.questInvest.service.RoleFuncRightsService;
import com.abc.questInvest.service.SysParameterService;
import com.abc.questInvest.service.TableCodeConfigService;

/**
 * @className	: GlobalConfigServiceImpl
 * @description	: GlobalConfigService实现类
 *
 */
@Service
public class GlobalConfigServiceImpl implements GlobalConfigService{
		
	//系统参数表数据服务对象
	@Autowired
	private SysParameterService sysParameterService;
	
	//其它配置数据服务对象
	
	/**
	 * 
	 * @methodName		: loadData
	 * @description		: 加载数据 
	 * @return			: 成功返回true,否则返回false
	 *
	 */
	@Override
	public boolean loadData() {
		boolean bRet = false;
				
		//加载sys_parameters表记录
		bRet = sysParameterService.loadData();
		if (!bRet) {
			return bRet;
		}
		
		//加载其它配置数据
				
		return bRet;
	}
	
	
	//获取SysParameterService对象
	@Override
	public SysParameterService getSysParameterService() {
		return sysParameterService;
	}
	
	//获取其它配置数据服务对象方法
	
}

3.6、启动时加载

​全局配置服务类在应用启动时加载到Spring容器中,这样可实现共享,减少对数据库的访问压力。

​实现一个ApplicationListener类,代码如下:

package com.abc.questInvest;

import javax.servlet.ServletContext;
import org.springframework.context.ApplicationListener;
import org.springframework.context.event.ContextRefreshedEvent;
import org.springframework.stereotype.Component;
import org.springframework.web.context.WebApplicationContext;

import com.abc.questInvest.service.GlobalConfigService;

/**
 * @className	: ApplicationStartup
 * @description	: 应用侦听器
 *
 */
@Component
public class ApplicationStartup implements ApplicationListener<ContextRefreshedEvent>{
    //全局变量管理对象,此处不能自动注入
    private GlobalConfigService globalConfigService = null;
    
    @Override
    public void onApplicationEvent(ContextRefreshedEvent contextRefreshedEvent) {
        try {
    	    if(contextRefreshedEvent.getApplicationContext().getParent() == null){ 
    	    	//root application context 没有parent.
				
    	    	System.out.println("========定义全局变量==================");
    	    	// 将 ApplicationContext 转化为 WebApplicationContext
    	        WebApplicationContext webApplicationContext =
    	                (WebApplicationContext)contextRefreshedEvent.getApplicationContext();
    	        // 从 webApplicationContext 中获取  servletContext
    	        ServletContext servletContext = webApplicationContext.getServletContext();
    	        
    	        //加载全局变量管理对象
    	        globalConfigService = (GlobalConfigService)webApplicationContext.getBean(GlobalConfigService.class);
    	        //加载数据
    	        boolean bRet = globalConfigService.loadData();
    	        if (false == bRet) {
    	        	System.out.println("加载全局变量失败");
    	        	return;
    	        }        
    	        //======================================================================
    	        // servletContext设置值
    	        servletContext.setAttribute("GLOBAL_CONFIG_SERVICE", globalConfigService);  
    	        
    	    }
    	} catch (Exception e) {
    	    e.printStackTrace();
    	}        
    }
}

​注意,globalConfigService不能自动注入,否则得到空指针。通过下列代码来加载bean。

//加载全局变量管理对象
globalConfigService = (GlobalConfigService)webApplicationContext.getBean(GlobalConfigService.class);

​代码中,将globalConfigService对象作为全局变量加入ServletContext中,就可以实现共享了。

​在启动类中,加入该应用侦听器ApplicationStartup。

public static void main(String[] args) {
    SpringApplication springApplication = new SpringApplication(QuestInvestApplication.class);
    springApplication.addListeners(new ApplicationStartup());
    springApplication.run(args);  
}

3.7、在服务实现类中访问系统参数

​HttpServletRequest类型对象request在控制器方法中可以获取,可作为参数传入服务实现类的方法中。下面是服务实现类访问系统参数的示例代码:

//获取ServletContext对象
ServletContext servletContext = request.getServletContext();
//获取全部数据服务对象
GlobalConfigService globalConfigService = (GlobalConfigService)servletContext.getAttribute("GLOBAL_CONFIG_SERVICE");
//获取系统参数url_prefix的值
String url_prefix = "";
SysParameter sysParameter = null;
sysParameter = globalConfigService.getSysParameterService().getParameterItemByKey("url_param", "url_prefix");
if (sysParameter != null) {
    url_prefix = sysParameter.getItemValue();
}

以上就是详解Spring Boot使用系统参数表提升系统的灵活性的详细内容,更多关于Spring Boot使用系统参数表提升系统的灵活性的资料请关注三水点靠木其它相关文章!

Java/Android 相关文章推荐
Java Optional<Foo>转换成List<Bar>的实例方法
Jun 20 Java/Android
自从在 IDEA 中用了热部署神器 JRebel 之后,开发效率提升了 10(真棒)
Jun 26 Java/Android
SpringBoot整合RabbitMQ的5种模式实战
Aug 02 Java/Android
java如何实现socket连接方法封装
Sep 25 Java/Android
Java Spring 控制反转(IOC)容器详解
Oct 05 Java/Android
springboot 多数据源配置不生效遇到的坑及解决
Nov 17 Java/Android
Java生成日期时间存入Mysql数据库的实现方法
Mar 03 Java/Android
springboot 自定义配置 解决Boolean属性不生效
Mar 18 Java/Android
java后台调用接口及处理跨域问题的解决
Mar 24 Java/Android
openGauss数据库JDBC环境连接配置的详细过程(Eclipse)
Jun 01 Java/Android
Java实现注册登录跳转
Jun 16 Java/Android
Spring boot admin 服务监控利器详解
Aug 05 Java/Android
浅谈resultMap的用法及关联结果集映射
Spring中bean的生命周期之getSingleton方法
每日六道java新手入门面试题,通往自由的道路
Jun 30 #Java/Android
mybatis 解决从列名到属性名的自动映射失败问题
Jun 30 #Java/Android
Java基础之this关键字的使用
Jun 30 #Java/Android
Java图书管理系统,课程设计必用(源码+文档)
详解Java ES多节点任务的高效分发与收集实现
Jun 30 #Java/Android
You might like
PHP类与对象中的private访问控制的疑问
2012/11/01 PHP
php实现对两个数组进行减法操作的方法
2015/04/17 PHP
关于PHP开发的9条建议
2015/07/27 PHP
PHP实现ASCII码与字符串相互转换的方法
2017/04/29 PHP
javascript写的一个链表实现代码
2009/10/25 Javascript
jQuery中ajax的load()与post()方法实例详解
2016/01/05 Javascript
基于Javascript实现二级联动菜单效果
2016/03/04 Javascript
基于SpringMVC+Bootstrap+DataTables实现表格服务端分页、模糊查询
2016/10/30 Javascript
vue中datepicker的使用教程实例代码详解
2019/07/08 Javascript
Vue数字输入框组件示例代码详解
2020/01/15 Javascript
Element DateTimePicker日期时间选择器的使用示例
2020/07/27 Javascript
使用AutoJs实现微信抢红包的代码
2020/12/31 Javascript
Python处理PDF及生成多层PDF实例代码
2017/04/24 Python
Python面向对象编程基础解析(二)
2017/10/26 Python
Python 实现王者荣耀中的敏感词过滤示例
2019/01/21 Python
django创建超级用户过程解析
2019/09/18 Python
python库matplotlib绘制坐标图
2019/10/18 Python
pytorch三层全连接层实现手写字母识别方式
2020/01/14 Python
python使用for...else跳出双层嵌套循环的方法实例
2020/05/17 Python
CSS3实现淘宝留白的方法
2020/06/05 HTML / CSS
CSS3 对过渡(transition)进行调速以及延时
2020/10/21 HTML / CSS
中国综合网上购物商城:苏宁易购
2016/08/09 全球购物
广州某公司软件工程师面试题
2014/12/22 面试题
本科生详细的自我评价
2013/09/19 职场文书
中专生求职自荐信范文
2013/12/22 职场文书
初一体育教学反思
2014/01/29 职场文书
模具设计与制造专业求职信
2014/07/19 职场文书
法定代表人授权委托书范文
2014/08/02 职场文书
幼儿园校园小喇叭广播稿
2014/10/17 职场文书
二年级学生期末评语
2014/12/26 职场文书
理解深度学习之深度学习简介
2021/04/14 Python
Golang中interface{}转为数组的操作
2021/04/30 Golang
JavaScript的function函数详细介绍
2021/11/20 Javascript
Mysql多层子查询示例代码(收藏夹案例)
2022/03/31 MySQL
Win11显卡控制面板打开显卡设置方法
2022/04/20 数码科技
Nginx报404错误的详细解决方法
2022/07/23 Servers