原文链接:https://zhang35.coding.me/2018-java-web-2-11.html
使用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。数据表中的行对应实例,列对应实例的属性
@Entity
public 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{
@Autowired
private 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)
@ResponseBody
public 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) + ". " + 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保存,当使用时,按照约定规则拆分即可:
String[] options = questions[i].options.split("#"); //自行约定,这里用#分隔字符
成员变为:
private String options;
完美!
结语
终于搭好Java SSH这个架子,实现了基本功能,但不想再继续写了。Web技术迭代太快,后面去尝试下其它技术。