common
项目介绍
Java项目开发用的公用基础模块，包括：Spring容器初始化、配置文件读取工具类、分页对象、Protobuf工具类、反射工具类等
安装教程
- 使用maven package打包成jar，引入到项目中；
使用说明
- 读取配置文件工具类的使用
SystemConfig继承了spring默认加载配置文件类org.springframework.beans.factory.config.PropertyPlaceholderConfigurer，并对其进行了增强，增加了一些常用的方法，所以只需要将原来配置文件中的PropertyPlaceholderConfigurer换成SystemConfig类即可，如下，在spring配置文件中加入bean定义:
<bean class="com.cnsugar.common.config.SystemConfig"> <property name="fileEncoding" value="UTF-8" /> <property name="locations"> <list> <value>classpath:application.properties</value> </list> </property> </bean>
在任何类中只需要用SystemConfig中的方法即可读取application.properties中的所有配置，如:
String str = SystemConfig.getString("key");
int i = SystemConfig.getInt("key");
- Spring容器工具类的使用
通过该工具类，可以使普通的java应用程序集成spring来管理项目的各种对象。
在类中可以通过以下两种方式获取Spring容器中的所有bean对象:
UserService userService = AppContext.getBean("userService");
UserService userService = AppContext.getBean(UserService.class);
注意：如果在SpringMVC项目中使用该工具类，需要在listener初始化方法中调用AppContext.initWebApplicationContext()方法来同步SpringMVC容器，否会在日志中看到spring会初始化两次。如新建一个WebContextListener类：
public class WebContextListener extends org.springframework.web.context.ContextLoaderListener {
@Override
public WebApplicationContext initWebApplicationContext(ServletContext servletContext) {
return super.initWebApplicationContext(servletContext);
}
@Override
public void contextInitialized(ServletContextEvent event) {
super.contextInitialized(event);
initialize(event.getServletContext());
StringBuilder sb = new StringBuilder();
sb.append("\r\n======================================================================\r\n");
sb.append("\r\n 欢迎使用 ").append(SystemConfig.getConfig("app.name")).append("\r\n");
sb.append("\r\n Version ").append(SystemConfig.getConfig("api.version")).append("\r\n");
sb.append("\r\n======================================================================\r\n");
System.out.println(sb.toString());
}
/**
* 系统初始化
* @param servletContext
*/
private void initialize(ServletContext servletContext) {
AppContext.initApplicationContext(WebApplicationContextUtils.getWebApplicationContext(servletContext));
//初始化配置属性
servletContext.setAttribute("conf", SystemConfig.getConfigMap());
}
@Override
public void contextDestroyed(ServletContextEvent event) {
super.contextDestroyed(event);
}
}
在web.xml中加入：
<listener> <listener-class>com.cnsugar.web.listener.WebContextListener</listener-class> </listener>
- 反射工具类的使用
ReflectUtils工具类中的主要方法介绍：
/** * 获取类中非final和static的属性(包括父类中的属性)，带Field属性和对应的setter和getter方法Method对象 */ List<BeanField> getBeanFields(Class clazz); /** * 获取类或所有父类中非final和static的属性 */ List<Field> getFields(Class clazz); /** * 获取类或所有父类中setter方法 */ List<Method> getSetterMethods(Class clazz); /** * 获取类或所有父类中getter方法 */ List<Method> getGetterMethods(Class clazz); /** * 直接读取对象属性值, 无视private/protected修饰符, 不经过getter方法 */ Object getFieldValue(final Object obj, final String fieldName); /** * 直接设置对象属性值, 无视private/protected修饰符, 不经过setter方法 */ void setFieldValue(Object obj, String fieldName, Object value);
- 分页Page对象的使用
一般结合common-jdbc或基于mybatis的PageInterceptor使用，也可直接传一个数据List进去进行分页，toString()方法会生成基于bootstrap的分页操作栏的html代码，可直接在web页面显示。（后面会详细说明）。
- 其他类说明
CamelCaseUtils: 驼峰命名法(CamelCase)和下划线风格(UnderScoreCase)字符串之间的转换工具类;
ProtostuffUtil: protostuff工具类;
Utils: 包含常用的获取系统时间、日期转换、日期比较、时间格式化、普通java类型转换等方法工具类；
Bytes: 各种java类型与byte[]互转工具类；
Base64: Base64编码和解码工具类；