Spring+SpringMVC+Hibernate实现投票/调查问卷网站

使用SSH架构（Spring+SpringMVC+Hibernate）实现了简单的调查问卷网站。最终效果如图：

下面整理实现流程。

前言

1.SSH架构

SSH是MVC架构的一种实现。

Spring、SpringMVC、Hibernate各自用处分别是：

Hibernate方便了对数据库的操作。一个对象映射一个表，省去了写SQL语句的繁琐，完成数据持久化的任务。
Spring方便了对象的创建和相互关联。比如网站启动时想要初始化的一些对象，可交给Spring管理。
SpringMVC实现了MVC架构，使得结构清晰、分工明确。

（Spring和SpringMVC区别：Spring是IOC和AOP的容器框架，参考：谈谈Spring中的IOC和AOP概念）；SpringMVC是基于Spring实现的MVC Web框架）。

2.Maven

Maven是一个项目管理工具，有一套标准的工程结构。其核心配置文件是pom.xml，描述了项目信息，依赖关系等。

由于Java项目中需要引入各种jar包，还存在版本差异，把这些依赖关系在pom.xml里面描述，maven就会自动从本地或远程仓库寻找依赖，不用再去一个个下载、拷贝jar包了。

例如，想引入springmvc框架，就在pom.xml中加入如下配置：

      <dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>${spring.version}</version></dependency

3.代码结构

Java源码包含Model、DAO、Service、Controller四个包，其中：

Model：存放数据模型
DAO：实现直接操作Model的接口及方法，比如实现getPerson()
Service：使用DAO提供的接口，实现项目需要用到的功能，比如实现getAllPersons()
Controller：使用Service提供的功能，实现数据分发及页面展示。

工程结构如下：

项目源码：https://github.com/zhang35/QuizWeb.git

开发环境

集成开发环境（IDE）：IntelliJ IDEA 2017.3.2
本地服务器：Tomcat 9.0.2
数据库： MySQL 5.7
项目管理：Maven
操作系统：MacOS

开发步骤

1. 准备工作

如何使用IDEA创建web工程，参考：
使用IntelliJ IDEA开发java web
如何使用IDEA配置maven仓库，加快加载依赖包的速度，参考：
IDEA配置maven(配置阿里云中央仓库)

2. 搭建SSH项目

如何在IntelliJ与Maven的环境下搭建Spring+SpringMVC+Hibernate项目，参考：
Spring-SpringMVC-Hibernate在IntelliJ与Maven的环境下搭建

3. 实现投票功能

从操作流程出发，实现思路是：

3.1 输入网址进入投票界面。（SpringMVC控制网址->页面的映射）

3.1.1 在web.xml中配置SpringMVC使之生效，web.xml：

   <servlet><servlet-name>spring-dispatcher</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>spring-dispatcher</servlet-name><url-pattern>/</url-pattern></servlet-mapping>

3.1.2 在SpringMVC的配置文件servletname-servlet.xml中配置地址过滤规则，spring-dispatcher-servlet.xml：

    <context:component-scan base-package="web.quiz.controller" /><!-- 要扫描的包--><mvc:annotation-driven /><!-- 解析网址，加前缀后缀，比如输入index时定位到/WEB-INF/jsp/index.jsp--><bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"><property name="prefix" value="/WEB-INF/jsp/"/><property name="suffix" value=".jsp"/></bean><!-- 不拦截静态资源，保证对js、css、jpg等的正常访问 --><mvc:default-servlet-handler />

3.1.3 最后，在Controller中控制页面分发，QuizController.java：

    @RequestMapping(value = "vote", method = RequestMethod.GET)public String index() {return "vote";}

####3.2 获取问卷内容。（Hibernate+Spring从数据库中读取问卷信息，发送到前端页面）
3.2.1 首先使用Hibernate关联对象与数据库。Hibernate有配置xml和注解两种实现方式，本文使用注解。Person.java：

//@javax.persistence.Entity注解一个实体Bean。数据表中的行对应实例，列对应实例的属性@Entitypublic class Person {@Id   //必须使用 @javax.persistence.Id 注解一个主键；private String id;             //编号private String name;            //姓名}

3.2.2 然后实现相应的DAO接口。PersonDAO.java、PersonDAOImpl.java：

    public interface PersonDAO {public List<Person> getAll();}@Repository //@Repository用于标注数据访问组件，即DAO组件；public class PersonDAOImpl implements PersonDAO{@Autowired //@Autowired可以对成员变量、方法和构造函数进行标注，来完成自动装配。默认按照类型进行装配。private SessionFactory sessionFactory;public List<Person> getAll() {Criteria criteria = sessionFactory.getCurrentSession().createCriteria(Person.class);return criteria.list();}}

3.2.3 PersonDAOImpl中要用的sessionFactory怎么来？什么是SessionFactory：

SessionFactory接口负责初始化Hibernate。SessionFactory并不是轻量级的，因为一般情况下，一个项目通常只需要一个SessionFactory就够。

所以把SessionFactory放在Web初始化时候生成，使用Spring实现其自动装配。

首先在web.xml中配置Spring：

    <!--配置Spring--><context-param><param-name>contextConfigLocation</param-name><param-value>classpath:/META-INF/applicationContext.xml,classpath:/META-INF/spring-jdbc.xml</param-value></context-param>

然后在Spring配置文件中配置Hibernate，spring-jdbc.xml：

       <!--自定义的hibernate.properties文件,下面${XXX}的内容来源--><context:property-placeholder location="classpath:/META-INF/properties/hibernate.properties" /><!-- 使用C3P0数据源，MySQL数据库 --><bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"destroy-method="close"><!-- MySQL5 --><property name="driverClass" value="${driverClassName}"></property><property name="jdbcUrl" value="${url}"></property><property name="user" value="${username}"></property><property name="password" value="${password}"></property></bean<!-- session工厂 --><bean id="sessionFactory"class="org.springframework.orm.hibernate4.LocalSessionFactoryBean"><property name="dataSource" ref="dataSource" /><property name="packagesToScan" value="web.quiz.model" /><property name="hibernateProperties"><props><prop key="hibernate.hbm2ddl.auto">${hibernate.hbm2ddl.auto}</prop><prop key="hibernate.dialect">${hibernate.dialect}</prop><prop key="hibernate.show_sql">${hibernate.show_sql}</prop><prop key="hibernate.format_sql">${hibernate.format_sql}</prop></props></property></bean><!--hibernate的事务管理器--><bean id="transactionManager"class="org.springframework.orm.hibernate4.HibernateTransactionManager"><property name="sessionFactory" ref="sessionFactory"></property></bean>

在Spring的默认配置文件applicationContext.xml中配置扫描的包。这些包中有Spring注解为@Component的类，在使用注解配置的情况下，系统启动时会被自动扫描，并添加到bean工厂中去（省去了配置文件中写bean定义了）。applicationContext.xml：

    <context:component-scan base-package="web.quiz.service"/><context:component-scan base-package="web.quiz.DAO"/>

至此，PersonDAOImpl中有了可用的sessionFactory，它的功能也能尽数实现了，如3.2.2中所示。

3.2.4 此时有了PersonDAO的实现，进一步封装成可直接用的服务。DBService.java 、DBServiceImpl.java：

public interface DBService{public List<Person> loadPersons();
}@Service  //@Service用于标注业务层组件
@Transactional //@Transactional 可以作用于接口、接口方法、类以及类方法上。赋予其事务属性
public class DBServiceImpl implements DBService{@Autowiredprivate PersonDAO personDAO;public List<Person> loadPersons(){return personDAO.getAll();}
}

至此，读写数据的功能有了。可以在Controller中调用服务读数据，QuizController.java：

@Controller
public class QuizController {@Resource  //与@Autowired等效，是JDK支持的注解，默认按照名称进行装配private DBService dbService;@PostConstruct  //使用@PostConstruct注释初始化方法。在Controller中，用@PostConstruct修饰的方法会在服务器加载Servlet的时候运行，并且只会被服务器调用一次。private void initQuiz(){this.persons = dbService.loadPersons();}
}

3.2.5 把读取的内容发给前端JSP页面。本文使用了两种方法，一是传json回去，二是直接传对象回去。

方法一：传json到前端，用拼接字符串的方式生成页面。这种方法很笨，当时知识面太窄。不过用json传数据在做数据可视化时比较方便，所以也保留了这些代码。QuizController.java：

 @RequestMapping(value = "/loadPaper", method = RequestMethod.GET)@ResponseBodypublic byte[] loadPaper() throws IOException {ObjectMapper objectMapper = new ObjectMapper();String jsonString = objectMapper.writeValueAsString(this.quiz);byte[] b = jsonString.getBytes("UTF-8");        //解决传到前端后中文乱码问题return b;}

在前端用js解析json，生成页面。问卷页面vote.jsp：

function loadPage(){$.getJSON("loadPaper",function(data){  //获取问卷数据quiz,放入data中var names = data.names;for (var i=0; i< names.length; i++){var testDiv = '<div class="test">' + '<p class="name">' + (i+1) + ".&nbsp" + names[i] + '：</p>';...$("form").append(testDiv);}}

方法二：借助ModelAndView对象，直接传对象到前端。配合JSP的特点，比较优雅高效。QuizController.java中：

//在方法的参数列表中添加形参 ModelMap map, spring 会自动创建ModelMap对象。
//然后调用map的put(key,value)或者addAttribute(key,value)将数据放入map中，spring会自动将数据存入request。
public ModelAndView check(HttpServletRequest request, HttpServletResponse response, ModelMap model){model.addAttribute("persons", persons);  //添加名为persons的对象return new ModelAndView("result");   //返回页面result.jsp
}

在前端使用JSTL <c:forEach>和EL表达式循环生成表格。显示成绩页面result.jsp：

        <c:forEach items="${persons}" var="person"><tr><td>${person.id}</td><td><a href="${person.id}/detail">${person.name}</a></td> <!--REST风格--><td>${person.department}</td></tr></c:forEach>

（注意：使用EL表达式时，需加入<%@page isELIgnored=“false” %>）

这里把每个人名作为一个超链接，点进去显示其测评结果。${person.id}/detail会变成如1/detail这样的地址。该地址在QuizController.java中这么解析：

@RequestMapping(value = "/{id}/detail", method = RequestMethod.GET)public ModelAndView detail(HttpServletRequest request, ModelMap model, @PathVariable String id) {Result result = dbService.getResultByID(id);String name = result.getName();model.addAttribute("name", name);return new ModelAndView("detail");}

3.2.6 扩展知识
上述传参方式叫REST( Representational State Transfer)风格。
关于SpringMVC应用REST风格，参考：Spring MVC 实现增删改查 - CSDN博客
关于其它URL传参方式，参考： SpringMVC之@RequestParam @PathVariable对比
关于SpringMVC中各种常用传值方法，参考：springMVC 将controller中数据传递到jsp页面

3.3 填写问卷，点提交。(Controller接收前端表单，结果写入数据库)

主要是前端传值到后端的问题。
在vote.jsp中：

<form method="POST" action="submit">
...
</form>

在QuizController.java中：

 @RequestMapping(value = "/submit", method = RequestMethod.POST)public String submit(HttpServletRequest request, HttpServletResponse response) {Enumeration<String> enu = request.getParameterNames();        //获得表单中所有值while (enu.hasMoreElements()) {String paraName = (String) enu.nextElement();String value = request.getParameter(paraName);   //按照表单中的顺序，一个个接收值...dbService.saveOrUpdateResult(result); //将成绩写入数据库中}}

3.4 管理员登录，查看结果。(身份验证后，JSP展示结果)

提供管理员登录页面login.jsp，登录后进入参评人列表页面result.jsp；点击参评人超链接，进入详细成绩页面detail.jsp，统计分析个人得票结果。

到这里已经没有什么难度，不再写了。

一点心得

1. hibernate如何将数组成员对应到数据库

对于Question对象，成员id、title都能自动对应数据库中表的一列，而options作为一个List就带来很多麻烦。

解决方法：把List拼接成一个String保存，当使用时，按照约定规则拆分即可：

    String[] options = questions[i].options.split("#"); //自行约定，这里用#分隔字符

成员变为：

 private String options;

完美！

结语

终于搭好Java SSH这个架子，实现了基本功能，但不想再继续写了。Web技术迭代太快，后面去尝试下其它技术。