首页 > 代码库 > XXX系统开发小结(SSH+Jquery EasyUI)
XXX系统开发小结(SSH+Jquery EasyUI)
一、项目总体介绍
前一段时间的工作中,笔者大概用了两三个月开发了一个Web管理信息系统,使用的框架集为Struts2.3.1+Spring3.0+Hibernate3+Jquery EasyUI1.3.5,系统业务逻辑并不复杂,完成数据的采集(以问卷的形式)、计算处理和形成报告发布。EasyUI是一个很优秀的JS UI框架,使用简单方便,效果也还可以,是UI效果和带宽速度之间的一个折中之选。系统中还有新闻发布模块,用到了富文本编辑器,在比较了很多插件之后,选择了kindeditor,原因很简单,因为它有网上现成的和EasyUI结合的例子。另外生产图表时用到了JFreechart插件。系统开发运行环境为windows7下Myeclipse8.5+JDK1.6+Tomcat6.0+SqlServer2008R2。
二、关于EasyUI
EasyUI很方便使用,一般只需要在一个页面中导入一些文件之后,其他的页面都是嵌在当前页买中。EasyUI提供了很多组件,如layout、panel、tabs、datagrid等,只需要初始化这些组件,并提供相应的数据即可。每个组件都有两种方式声明或者创建,即使用标记元素的形式和使用js的形式。具体引用参见项目源码或者EasyUI官网提供的API。
EasyUI官网:http://www.jeasyui.com/index.php
EasyUI官方API:http://www.jeasyui.com/documentation/index.php
三、关于系统架构
系统应用了常规的“三层架构”,即视图展示层、业务逻辑层和数据处理层。其中EasyUI+Struts2的Action负责页面展示、数据抓取和推送、视图流程控制,Service层负责业务逻辑的实现,Dao层与Hibernate结合,负责数据的处理,与数据库打交道。而Spring则扮演一个管家的角色,其功能有IOC容器、依赖注入、集成其他插件等,负责将整个系统融合起来,合理调度。
下面对Action、Service、Dao的设计简单小结一下。其基本的流程是Action调用Service,Service调用Dao,且各层都使用Spring的依赖注入来实例化各层属性。
1、 Action层
Action负责接收前台提交的请求,获取请求数据,然后调用Service完成业务处理,然后将请求转发到下一流程(可能返回到某个页面或者另一个Action),并将相应的数据随之一并转发。
本项目中首先写了一个BaseAction,继承了Struts2的ActionSupport。因为EasyUI接收的数据格式都是json格式,所以这里用到了一个json插件fastjson并且提供了一个writeJSON(Object o)方法,用来在需要的时候,将数据写到前台页面,供EasyUI的组件读取。
其他的Action只需继承此Action即可。项目中获取请求参数时采用了模型驱动的方式,即Action实现ModelDriven接口,该接口接受一个泛型T,这里T一般是一个数据模型类,这样前台就可以直接写某个类的属性,后台便能抓取到它们并自动封装到一个对象中。
项目中异常处理在Action层中完成,Service和Dao只负责捕捉,并往上一层抛,在Action才处理。这也并不是绝对的,看具体的要求。
2、 Service
Service层完成具体的业务逻辑。如根据不同的条件调用不同的Dao等。
3、Dao
Dao结合Hibernate与具体的数据库打交道,即完成数据的持久化,或者加载持久化数据对象。这里Dao的设计采用了泛型和接口的结合,首先写了一个带泛型的公用接口BaseDaoI<T>,接口中定义了一些常用的,通用的方法,这些方法接受的或者返回的类型都是泛型。然后实现了该接口,其泛型信息依然保留。这样一来,具体的和某一表相关联的Dao,只需在编写接口时继承该通用接口,并将泛型替换为实体类型,然后编写实现时去实现刚才的接口,并继承通用接口的实现,即可。这样的好处是,通用的功能,都在公用接口中定义了,而且利用泛型,完成了类型的良好过度和检查,而不必用Object来强制转换。
举个例子,以用户实体相关操作为例。
(1)、公用接口
import java.io.Serializable; import java.util.List; import java.util.Map; /** * @author Administrator * * @param <T> */ public interface BaseDaoI<T> { /** * 保存实体 * * @param o * @throws Exception */ void save(T o) throws Exception; /** * 删除实体 * * @param o * @throws Exception */ void delete(T o) throws Exception; /** * 以sql形式删除数据 * @param sql 删除sql * @throws Exception */ void delete(String sql) throws Exception; /** * 更新实体 * * @param o * @throws Exception */ void update(T o) throws Exception; /** * 保存或更新 * * @param o * @throws Exception */ void saveOrUpdate(T o) throws Exception; /** * @param c * @param id * @return * @throws Exception */ T get(Class<T> c,Serializable id)throws Exception; /** * 不带参数的hql查询 * * @param hql * 完整的hql语句 * @return 结果集合 * @throws Exception */ List<T> get(String hql) throws Exception; /** * 带参数的hql查询,该方式使用问号占位符,并按顺序传递参数(不建议使用) * * @param hql * 带参数的hql语句 * @param params * 顺序良好的参数列表 * @return 结果集合 * @throws Exception */ List<T> get(String hql, Object[] params) throws Exception; /** * 带参数的hql查询,该方式使用【:参数名】占位符,并使用Map传递参数(建议使用) * * @param hql * 带参数的hql语句 * @param params * Map参数列表 * @return 结果集合 * @throws Exception */ List<T> get(String hql, Map<String, Object> params) throws Exception; /** * 带参数的分页查询语句,可查询指定条数的记录 * * @param hql * 查询hql * @param params * 参数列表 * @param starRow * 查询起始行(Hibernate行数从0开始) * @param size * 查询数量 * @return 结果集合 * @throws Exception */ List<T> get(String hql, Map<String, Object> params, int starRow, int size) throws Exception; /** * 不带参数的分页查询语句,可查询指定条数的记录 * * @param hql * 查询hql * @param starRow * 查询起始行(Hibernate行数从0开始) * @param size * 查询数量 * @return 结果集合 * @throws Exception */ List<T> get(String hql, int starRow, int size) throws Exception; /** * 不带参数查询记录总数 * @param hql 查询hql(例如"select count(*) from XXXX") * @return 记录总数 * @throws Exception */ Long getTotalAmount(String hql) throws Exception; /** * 带参数查询记录总数 * @param hql 查询hql (例如"select count(*) from XXXX where ...") * @param params 参数列表 * @return 记录总数 * @throws Exception */ Long getTotalAmount(String hql, Map<String, Object> params) throws Exception; /** * 执行特定的hql语句 * @param hql * @return * @throws Exception */ int executeHql(String hql)throws Exception; }
(2)、公用接口的实现
import java.io.Serializable; import java.util.List; import java.util.Map; import org.hibernate.Query; import org.hibernate.SQLQuery; import org.hibernate.Session; import org.springframework.orm.hibernate3.support.HibernateDaoSupport; import com.pmi.dao.BaseDaoI; public class BaseDaoImpl<T> extends HibernateDaoSupport implements BaseDaoI<T> { public void save(T o) throws Exception { getHibernateTemplate().save(o); } public List<T> get(String hql) throws Exception { List<T> list = getHibernateTemplate().find(hql); return list; } public List<T> get(String hql, Object[] params) throws Exception { Session session = getHibernateTemplate().getSessionFactory() .getCurrentSession(); Query q = session.createQuery(hql); if (params != null && params.length > 0) { for (int i = 0; i < params.length; i++) { q.setParameter(i, params[i]); } } List<T> list = q.list(); return list; } public List<T> get(String hql, Map<String, Object> params) throws Exception { Session session = getHibernateTemplate().getSessionFactory() .getCurrentSession(); Query q = session.createQuery(hql); for (String key : params.keySet()) { q.setParameter(key, params.get(key)); } List<T> list = q.list(); return list; } public void delete(T o) throws Exception { getHibernateTemplate().delete(o); } public void saveOrUpdate(T o) throws Exception { getHibernateTemplate().saveOrUpdate(o); } public void update(T o) throws Exception { getHibernateTemplate().update(o); } public List<T> get(String hql, Map<String, Object> params, int starRow, int size) throws Exception { Session session = getHibernateTemplate().getSessionFactory() .getCurrentSession(); Query q = session.createQuery(hql); for (String key : params.keySet()) { q.setParameter(key, params.get(key)); } q.setFirstResult(starRow); q.setMaxResults(size); List<T> list = q.list(); return list; } public List<T> get(String hql, int starRow, int size) throws Exception { Session session = getHibernateTemplate().getSessionFactory() .getCurrentSession(); Query q = session.createQuery(hql); q.setFirstResult(starRow); q.setMaxResults(size); List<T> list = q.list(); return list; } public Long getTotalAmount(String hql) throws Exception { Session session = getHibernateTemplate().getSessionFactory() .getCurrentSession(); Query q = session.createQuery(hql); Long count = (Long) q.uniqueResult(); return count; } public Long getTotalAmount(String hql, Map<String, Object> params) throws Exception { Session session = getHibernateTemplate().getSessionFactory() .getCurrentSession(); Query q = session.createQuery(hql); for (String key : params.keySet()) { q.setParameter(key, params.get(key)); } Long count = (Long) q.uniqueResult(); return count; } public void delete(String sql) throws Exception { Session session = getHibernateTemplate().getSessionFactory() .getCurrentSession(); SQLQuery q = session.createSQLQuery(sql); q.executeUpdate(); } public T get(Class<T> c, Serializable id) throws Exception { return getHibernateTemplate().get(c, id); } public int executeHql(String hql) throws Exception { Session session = getHibernateTemplate().getSessionFactory() .getCurrentSession(); Query q = session.createQuery(hql); int i = q.executeUpdate(); return i; } }
(3)、User实体接口
import com.pmi.model.database.TbYhxx; public interface UserDaoI extends BaseDaoI<TbYhxx> { }
(4)、User实体接口实现
</pre><pre name="code" class="java">import com.pmi.dao.UserDaoI; import com.pmi.model.database.TbYhxx; public class UserDaoImpl extends BaseDaoImpl<TbYhxx> implements UserDaoI { ……(独有的方法) }
4、权限控制
设计思路:项目采用基于角色的权限控制,即用户的权限是以角色来区分的。用户权限包括菜单资源权限、增删改查操作权限。用户登录时,系统根据用户的角色,加载用户所具有的菜单资源和操作权限,匹配的操作才能被完成。
菜单资源权限的实现:这个逻辑比较简单,为角色分配的菜单存放在数据表中,用户登录时,根据角色加载菜单项即可。
操作权限的实现:操作权限是指具体的增删改查操作,比如查看新闻、添加新闻、删除用户等操作。这里采用Struts2的拦截器实现操作权限控制,针对Action层过滤。拦截到请求的action和方法之后,首先判断需不需要进行权限检查,因为不是所有的操作都需要权限控制,比如查看新闻。默认所有的aciton请求都需要检查,如果有例外,通过struts.xml中通过ignoreActions配置。检查流程为,先检查是否登录,如果未登录,阻止请求,并给出提示,若已登录,则检查当前请求的操作权限与用户所具有的是否匹配,匹配则放行,否则阻止请求,给出提示。
5、实体模型
一般在SSH应用中,一个数据表对应一个实体模型,这个Model既完成持久化的相关工作,也是往视图层传递的数据载体,这样比较简单,但同时也带来一定的弊端,比如前台页面中,除了需要该Model对应的数据表中的字段之外,还需要一些额外的参数(分页参数、自定义其他参数)作为属性,又比如在使用Hibernate映射时,一般外键会映射成持有外键表对应Model的对象,而在前台页面,可能并不需要这个对象的所有信息而只是需要一些特定的属性值,这时如果都写在一个Model时,在完成持久化时比较不清晰,对于开发维护人员来说可能会造成逻辑混乱,这里采用的是双Model机制,即一张表对应两个Model实体,一个是完全的数据表字段作为属性,另一个则是与之对应的专门与视图层关联的Model复制体,而这个复制体可能有更多的视图层需要的信息,同时在Service层完成这两个Model的数据复制,利用Spring的BeanUtils类提供的静态copyProperties()方法。以用户信息表为例,用户信息表有如下字段
Model1:Hibernate反向映射自动生成的
public class TbYhxx implements java.io.Serializable { // Fields private Integer yhId; private TbDyxx tbDyxx; private TbYbxx tbYbxx; private TbJsxx tbJsxx; private String yhName; private String yhPwd; private String yhXm; private String phone; private String email; private Integer yhState; private Integer extend1; private String extend2; private String extend3; private Set tbKzwjtbs = new HashSet(0); private Set tbWjtbs = new HashSet(0); private Set tbGgxxes = new HashSet(0); private Set tbFxbgs = new HashSet(0); private Set tbYbkzs = new HashSet(0); private Set tbTsxxes = new HashSet(0); private Set tbTjxxes = new HashSet(0); private Set tbZhzses = new HashSet(0); private Set tbXwggs = new HashSet(0); private Set tbTjjgs = new HashSet(0); ......setters and getters }
Model2:与视图层关联的,前台页面相关联的
public class User extends BaseModel { // Fields // datagrid需要的字段名 private Integer yhId; private Integer dyId; private String dyName; private Integer qyId; private String qyName; private Integer jsId; private String jsName; private String yhName; private String yhPwd; //用户修改密码信息时使用 private String newPwd; private String yhXm; private String phone; private String email; private Integer yhState; private Integer extend1; private String extend2; private String extend3; ........setters and getters }
从例子中可以看出,这两个Model还是有一定区别的,且是有实际意义的。
6、日志记录
日志信息可以检测系统的日常运营信息,如用户操作和异常或者错误场景,一个设计良好的管理信息系统应该具有日志记录功能。本系统采用的是常用的log4j插件作为日志工具。log4j使用相对简单,导入jar包后,增加一个配置文件即可。本项目的配置见下文。
log4j.properties:
log4j.rootCategory=INFO, stdout , R log4j.appender.stdout=org.apache.log4j.ConsoleAppender log4j.appender.stdout.layout=org.apache.log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern=[PMI] %p [%d] %C.%M(%L) | %m%n log4j.appender.R=org.apache.log4j.DailyRollingFileAppender log4j.appender.R.File=D\:/pmi_log/pmi_daily.log log4j.appender.R.layout=org.apache.log4j.PatternLayout log4j.appender.R.layout.ConversionPattern=[PMI] %p \: %m - %c | %t | %d %n