package com.walker.infrastructure.arguments;
|
|
import java.util.List;
|
|
import org.springframework.beans.factory.DisposableBean;
|
import org.springframework.beans.factory.InitializingBean;
|
|
//import com.walker.beans.factory.DisposableBean;
|
//import com.walker.beans.factory.InitializingBean;
|
|
/**
|
* 参数管理器定义</p>
|
* 该管理器实现了如何加载、获取、持久化保存可变参数的功能。</br>
|
* 子类实现具体的加载数据过程，如：xml文件、数据库等。
|
* @author shikeying
|
* @date 2013-11-28
|
*
|
*/
|
public interface ArgumentsManager extends InitializingBean, DisposableBean {
|
|
/**
|
* 根据可变参数ID，返回该参数对象
|
* @param id
|
* @return
|
*
|
* @throws ElementNotFoundException
|
*/
|
Variable getVariable(String id);
|
|
/**
|
* 持久化一个变量值，也就是更新一个现有的变量。</br>
|
* 此方法适用于配置中仅有一个分组，默认就持久化到第一个分组中。
|
* @param variableId
|
* @param value
|
*/
|
void persist(String variableId, Object value);
|
|
/**
|
* 持久化一个变量值，也就是更新一个现有的变量。
|
* @param groupId 分组ID，必须存在
|
* @param variableId 变量ID
|
* @param value 新的变量值
|
*
|
* @throws ArgumentsException 如果保存失败，会抛出此运行时异常。
|
*/
|
void persist(String groupId, String variableId, Object value);
|
|
/**
|
* 持久化批量参数更新，集合中是数组对象，Object[]{groupId, variableId, value}</br>
|
* @param changedList
|
* @throws ArgumentsException 如果保存失败，会抛出此运行时异常。
|
*/
|
void persist(List<Object[]> changedList);
|
|
/**
|
* 加入新的参数集合，集合中是数组对象，Object[]{group, variable}</br>
|
* 如果已经存在该参数，则不再创建。
|
* @param insertList
|
* @throws ArgumentsException 如果保存失败，会抛出此运行时异常。
|
*/
|
void insert(List<Object[]> insertList);
|
|
/**
|
* 返回可变参数的所有分组信息，如果不存在返回<code>null</code>
|
* @return
|
*/
|
List<Group> getGroupList();
|
|
/**
|
* 返回某个分组下所有可变参数集合，如果不存在返回<code>null</code>
|
* @param groupId
|
* @return
|
*/
|
List<Variable> getVariableList(String groupId);
|
|
/**
|
* 设置可变参数加载的原始信息，如：文件名、数据源地址等。</p>
|
* 系统会实现至少两种加载源：
|
* <li>从XML配置文件中加载参数</li>
|
* <li>从数据库中加载参数</li>
|
* @param source
|
*/
|
void setSource(Object source);
|
}
|
