使用系統引數表，提升系統的靈活性-有解無憂

1、使用系統引數表的好處

? Spring Boot專案中常有一些相對穩定的引數設定項，其作用范圍是系統級的或模塊級的，這些引數稱為系統引數，這些變數以引數形式進行配置，從而提高變動和擴展的靈活性，保持代碼的穩定性，

? 以資料庫表形式存盤的系統引數表比組態檔（.properties檔案或.yaml檔案）要更靈活，因為無需重啟系統就可以動態更新，

? 系統引數表可用于存盤下列資料：

表欄位列舉值，如下列欄位：

`question_type`   TINYINT(4)   NOT NULL DEFAULT 0 COMMENT '題型，1-單選題，2-多選題，3-問答題',

? 這個欄位現在有3種取值，但是難保將來有擴展的可能，如：是非題、計算題、應用題等，

? 因此將取值的列舉值用系統引數表來配置，可以提高系統擴展靈活性，

? 另一方面，對于前端而言，就可以通過查詢系統引數表資料，用于UI呈現，而不必硬編碼，如前端需要用下拉框來顯示所有可能的”題型“，這個串列就可以查詢系統引數表來獲取，

? 因此可以將所有欄位列舉值納入系統引數表管理，

引數設定，如郵件引數，對接的第三方系統的URL等，

2、系統引數表的表結構

? 系統引數表的表結構如下：

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', '請求介面方法');

3、系統引數表在專案中的使用

? 在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的引數類別的子項串列
	 * @history		:
	 * ------------------------------------------------------------------------------
	 * date			version		modifier		remarks                   
	 * ------------------------------------------------------------------------------
	 * 2021/06/02	1.0.0		sheng.zheng		初版
	 *
	 */
	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();
		}

轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/288197.html

標籤：其他

上一篇：Netty 框架學習 —— EventLoop 和執行緒模型

下一篇：Java面試題(十)：ArrayList和LinkedList的區別