import java.util.*;
/**
* 提供一个保存参数的容器，用来给那些参数多、可选参数多、参数易变的方法提供参数读取能力。
* 直接使用Map等类对于数据类型处理不是方便。本类提供常用数据类型的读取方法。用法示例：<br>
* port = args.get("port",8080);<br>
* 放入Map中的port值可以是"8443"或new Integer(8443)或其他任何类型，只要toString()
* 能够解析出一个整数。
* @author sunlen
* @version 1.0
*/
public class Args
{
/** 一个常量空参数表。用于传递空参数，该参数列表已经锁定，不能修改。*/
public static final Args EMPTY = new Args().lock();
/** 参数列表是否已经锁定，锁定后的参数列表将只读。*/
boolean locked;
/** Map保存的参数。*/
Map args;
/** 创建空参数列表。*/
public Args()
{
this(new HashMap());
}
/**
* 用Map创建参数。
* @param theArgs 保存参数的Map对象。
*/
public Args(Map theArgs)
{
if (theArgs==null)
{
throw new NullPointerException("argument is null");
}
args = theArgs;
}
/**
* 取得字符串参数的方法。
* @param key 参数名。
* @param def 参数值。
*/
public String get(String key,String def)
{
try
{
return args.get(key).toString();
}
catch (Exception ex)
{
return def;
}
}
/**
* 取得整数参数的方法。
* @param key 参数名。
* @param def 参数值。
*/
public int get(String key,int def)
{
try
{
return Integer.parseInt(args.get(key).toString());
}
catch (Exception ex)
{
return def;
}
}
/**
* 取得长整数参数的方法。
* @param key 参数名。
* @param def 参数值。
*/
public long get(String key,long def)
{
try
{
return Long.parseLong(args.get(key).toString());
}
catch (Exception ex)
{
return def;
}
}
/**
* 取得浮点数参数的方法。
* @param key 参数名。
* @param def 参数值。
*/
public float get(String key,float def)
{
try
{
return Float.parseFloat(args.get(key).toString());
}
catch (Exception ex)
{
return def;
}
}
/**
* 取得布尔参数的方法。只有"true"解析成true其他解析成false。
* @param key 参数名。
* @param def 参数值。
*/
public boolean get(String key,boolean def)
{
try
{
return ("true".equals(args.get(key)));
}
catch (Exception ex)
{
return def;
}
}
/**
* 取得原始对象类型。
* @param key 参数名。
* @param def 参数缺省值。
*/
public Object get(String key,Object def)
{
try
{
Object obj = args.get(key);
if (obj==null)
{
return def;
}
return obj;
}
catch (Exception ex)
{
return def;
}
}
/**
* 往当前参数表中添加一个参数。
* @param key 参数名。
* @param value 参数值。
* @return 添加了新参数后的参数表(对象实例没有变)。
* @exception UnsupportedOperationException 如果参数列表已经被锁定。
*/
public Args set(String key,Object value)
{
if(locked)
{
throw new UnsupportedOperationException(
"Args have locked,can modify");
}
args.put(key,value);
return this;
}
/**
* 往当前参数表中添加一个参数。
* @param key 参数名。
* @param value 参数值。
* @return 添加了新参数后的参数表(对象实例没有变)。
* @exception UnsupportedOperationException 如果参数列表已经被锁定。
*/
public Args set(String key,int value)
{
if(locked)
{
throw new UnsupportedOperationException(
"Args have locked,can modify");
}
args.put(key,new Integer(value));
return this;
}
/**
* 往当前参数表中添加一个参数。
* @param key 参数名。
* @param value 参数值。
* @return 添加了新参数后的参数表(对象实例没有变)。
* @exception UnsupportedOperationException 如果参数列表已经被锁定。
*/
public Args set(String key,boolean value)
{
if(locked)
{
throw new UnsupportedOperationException(
"Args have locked,can modify");
}
args.put(key,new Boolean(value));
return this;
}
/**
* 往当前参数表中添加一个参数。
* @param key 参数名。
* @param value 参数值。
* @return 添加了新参数后的参数表(对象实例没有变)。
* @exception UnsupportedOperationException 如果参数列表已经被锁定。
*/
public Args set(String key,long value)
{
if(locked)
{
throw new UnsupportedOperationException(
"Args have locked,can modify");
}
args.put(key,new Long(value));
return this;
}
/**
* 往当前参数表中添加一个参数。
* @param key 参数名。
* @param value 参数值。
* @return 添加了新参数后的参数表(对象实例没有变)。
* @exception UnsupportedOperationException 如果参数列表已经被锁定。
*/
public Args set(String key,float value)
{
if(locked)
{
throw new UnsupportedOperationException("Args have locked,can modify");
}
args.put(key,new Float(value));
return this;
}
/**
* 往当前参数表中添加一个参数。
* @param key 参数名。
* @param value 参数值。
* @return 添加了新参数后的参数表(对象实例没有变)。
* @exception UnsupportedOperationException 如果参数列表已经被锁定。
*/
public Args set(String key,double value)
{
if(locked)
{
throw new UnsupportedOperationException(
"Args have locked,can modify");
}
args.put(key,new Double(value));
return this;
}
/**
* 锁定参数列表。锁定后该参数列表将变成只读的，任何对set()方法的调用都将抛出
* UnsupportedOperationException异常。已经锁定的参数表再次调用本方法没有任何影响。
* @return 锁定后的参数列表(对象实例没有变)。
*/
public Args lock()
{
locked = true;
return this;
}
/**
* 参数列表的字符串描述。
* @return 所有参数值。
*/
public String toString()
{
return args.toString();
}
}
