第一章企业项目开发--maven+springmvc+spring+mybatis+velocity整合

时间 2019-11-11

标签第一章企业项目开发 maven+springmvc+spring+mybatis+velocity maven springmvc spring mybatis velocity 整合栏目 Maven 繁體版

原文原文链接

说明：本系列文章主要是对本身在一家大型互联网公司实习的过程当中对所学知识的总结！参与的是实际中使用的上线项目。html

代码的github地址：https://github.com/zhaojigang/ssmm0前端

1、ssmm简介java

ssmm是当下企业最经常使用的开发框架架构
maven：管理项目jar包，构建项目
spring：IOC容器，事务管理
springmvc：mvc框架
myBatis：持久层框架
velocity：前端视图模板（相较于jsp，速度很是快，并且不须要占据jvm的永久代内存）

上述这些框架再加上版本控制工具（git）、自动化部署工具（jenkins），就组成了当下中大型企业最经常使用的项目开发部署架构；以上各类框架之后我也会依次作笔记去写的，因此在下边不会作详细介绍。还有，在如下的整合过程当中会有一些细节方面的内容，我会在后续的本系列博客中仔细去说。mysql

2、下面介绍怎样整合ssmmgit

环境：github

eclipse-jee-indigo-SR2-win32（新出的一些eclipse不支持jdk1.6）
jdk1.6.45（当下企业最经常使用的jdk版本）
spring3.2.6
mybatis3.1.1
mybatis-spring1.1.1（mybatis与spring集成的一个工具jar）
mysql5.1.27
maven3.0.5
velocity1.5

2.一、构建maven项目web

步骤：spring

2.1.一、手工建立maven项目（整个过程就是建立一个符合maven格式的目录结构）sql

注意：这里使用手工建立，而不是在eclipse中使用maven插件去建立，是由于我的感受eclipse的maven插件很差用。数据库

首先本身建立一个文件夹ssmm（这个文件夹名称就是咱们的项目名称），而后在ssmm下建立src文件夹和pom.xml文件。

其中，pom.xml文件中的内容以下：

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <project xmlns="http://maven.apache.org/POM/4.0.0" 
 3          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
 5 
 6     <modelVersion>4.0.0</modelVersion>
 7 
 8     <groupId>com.xxx</groupId>
 9     <artifactId>ssmm</artifactId>
10     <version>1.0-SNAPSHOT</version>
11     
12     <name>ssm</name>
13     <packaging>war</packaging>
14 
15 </project>

View Code

以上内容，会在以后的maven模块中讲解。

而后，在src下建立main、test两个文件夹；在main文件夹下建立java、resources、webapp三个文件夹，在test文件夹下创建java、resources两个文件夹；以后在webapp下建立META-INF和WEB-INF两个文件夹，在META-INF文件夹下建立MANIFEST.MF文件，该文件内容以下：

Manifest-Version:1.0

在WEB-INF文件夹下建立templates（该文件夹未来用于存放模板文件）和web.xml文件，web.xml文件内容以下：

1 <?xml version="1.0" encoding="utf-8"?>
2 <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
3     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
5         
6 </web-app>

View Code

当构建好以上目录结构后，在src/main/java下建立一个TestMaven.java文件，文件内容以下：

public class TestMaven {
    public static void main(String[] args) {
        System.out.println("hello zhaojigang!!!");
    }
}

2.1.二、使用命令窗口编译该项目

在ssmm文件夹下（即pom.xml所在的目录）使用打开命令窗口（shift+鼠标右键），使用"mvn compile"编译该项目（前提：电脑安装了maven）。编译成功出现"BUILD SUCCESS"。

2.1.三、引入eclipse

在eclipse中"import"-->"Existing Maven Projects"便可（执行此步以前，须要安装eclipse的maven插件）。

引入项目后，在ssmm项目上右击-->"Properties"-->Text file encoding改成UTF-8

而后对项目进行测试（在webapp目录下创建index.jsp，而后运行项目，在我这里，是使用jetty来运行的，而后经过访问浏览器查看项目是否创建成功）。

2.二、引入spring与springmvc

2.2.一、引入jar包

在这里为了方便，我直接给出这些框架整合的完整的pom.xml（具体引入的每一个包作什么用，看pom.xml的注释），以后其余框架的整合就再也不讨论jar包问题了。

  1 <?xml version="1.0" encoding="UTF-8"?>
  2 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  4 
  5     <modelVersion>4.0.0</modelVersion>
  6 
  7     <groupId>com.xxx</groupId>
  8     <artifactId>ssmm</artifactId>
  9     <version>1.0-SNAPSHOT</version>
 10 
 11     <name>ssmm</name>
 12     <packaging>war</packaging>
 13 
 14     <properties>
 15         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 16         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
 17     </properties>
 18 
 19     <!-- 引入实际依赖 -->
 20     <dependencies>
 21         <!-- json -->
 22         <dependency>
 23             <groupId>com.alibaba</groupId>
 24             <artifactId>fastjson</artifactId>
 25             <version>1.1.39</version>
 26         </dependency>
 27         <!-- servlet -->
 28         <dependency>
 29             <groupId>javax.servlet</groupId>
 30             <artifactId>servlet-api</artifactId>
 31             <version>2.5</version>
 32             <scope>provided</scope>
 33         </dependency>
 34         <!-- spring -->
 35         <dependency>
 36             <groupId>org.springframework</groupId>
 37             <artifactId>spring-core</artifactId>
 38             <version>3.2.6.RELEASE</version>
 39         </dependency>
 40         <dependency>
 41             <groupId>org.springframework</groupId>
 42             <artifactId>spring-beans</artifactId>
 43             <version>3.2.6.RELEASE</version>
 44         </dependency>
 45         <dependency>
 46             <groupId>org.springframework</groupId>
 47             <artifactId>spring-context</artifactId>
 48             <version>3.2.6.RELEASE</version>
 49         </dependency>
 50         <dependency>
 51             <groupId>org.springframework</groupId>
 52             <artifactId>spring-web</artifactId>
 53             <version>3.2.6.RELEASE</version>
 54         </dependency>
 55         <dependency>
 56             <groupId>org.springframework</groupId>
 57             <artifactId>spring-webmvc</artifactId>
 58             <version>3.2.6.RELEASE</version>
 59         </dependency>
 60         <!-- 这个是使用velocity的必备包 -->
 61         <dependency>
 62             <groupId>org.springframework</groupId>
 63             <artifactId>spring-context-support</artifactId>
 64             <version>3.2.6.RELEASE</version>
 65             <scope>compile</scope>
 66         </dependency>
 67         <!-- mysql -->
 68         <dependency>
 69             <groupId>mysql</groupId>
 70             <artifactId>mysql-connector-java</artifactId>
 71             <version>5.1.27</version>
 72             <scope>runtime</scope>
 73         </dependency>
 74         <!-- 数据源 -->
 75         <dependency>
 76             <groupId>org.apache.tomcat</groupId>
 77             <artifactId>tomcat-jdbc</artifactId>
 78             <version>7.0.47</version>
 79         </dependency>
 80         <!-- mybatis -->
 81         <dependency>
 82             <groupId>org.mybatis</groupId>
 83             <artifactId>mybatis</artifactId>
 84             <version>3.1.1</version>
 85         </dependency>
 86         <dependency>
 87             <groupId>org.mybatis</groupId>
 88             <artifactId>mybatis-spring</artifactId>
 89             <version>1.1.1</version>
 90         </dependency>
 91         <!-- velocity -->
 92         <dependency>
 93             <groupId>org.apache.velocity</groupId>
 94             <artifactId>velocity</artifactId>
 95             <version>1.5</version>
 96         </dependency>
 97         <dependency>
 98             <groupId>velocity-tools</groupId>
 99             <artifactId>velocity-tools-generic</artifactId>
100             <version>1.2</version>
101         </dependency>
102     </dependencies>
103 </project>

View Code

2.2.二、配置spring.xml文件

这里直接列出spring.xml的完整版，包括读取属性文件、配置数据源、配置fastjson转换器、配置mybatis、配置velocity。

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <beans xmlns="http://www.springframework.org/schema/beans"
 3     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
 4     xmlns:mvc="http://www.springframework.org/schema/mvc"
 5     xsi:schemaLocation="http://www.springframework.org/schema/beans 
 6                            http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
 7                            http://www.springframework.org/schema/context 
 8                            http://www.springframework.org/schema/context/spring-context-3.2.xsd
 9                            http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd">
10                            
11     <!-- 注解扫描 -->
12     <context:component-scan base-package="com.xxx" />
13     
14     <!-- 引入属性文件 -->
15     <context:property-placeholder location="classpath:jdbc.properties"/>
16     
17     <!-- 配置fastjson转换器 -->
18     <mvc:annotation-driven>
19         <mvc:message-converters register-defaults="true">
20             <bean class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter"></bean>
21         </mvc:message-converters>
22     </mvc:annotation-driven>
23     
24     <!-- 引入数据源 -->
25     <bean id="xxxDataSource" class="org.apache.tomcat.jdbc.pool.DataSource" destroy-method="close">
26         <property name="driverClassName" value="${jdbc.driverClassName}" />
27         <property name="url" value="${jdbc.url}" />
28         <property name="username" value="${jdbc.username}" />
29         <property name="password" value="${jdbc.password}" />
30     </bean>
31     
32     <!-- 引入mybatis -->
33     <bean id="xxxSqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
34         <property name="dataSource" ref="xxxDataSource" />
35     </bean>
36     <bean id="xxxMapperScannerConfigurer" class="org.mybatis.spring.mapper.MapperScannerConfigurer">
37         <property name="basePackage" value="com.xxx.mapper" />
38         <property name="sqlSessionFactoryBeanName" value="xxxSqlSessionFactory" />
39     </bean>
40     
41     <!-- 配置velocity -->
42     <bean id="velocityConfigurer" class="org.springframework.web.servlet.view.velocity.VelocityConfigurer">
43         <property name="resourceLoaderPath">
44             <value>WEB-INF/templates/</value>
45         </property>
46         <property name="velocityProperties">
47             <props>
48                 <prop key="input.encoding">UTF-8</prop>
49                 <prop key="output.encoding">UTF-8</prop>
50             </props>
51         </property>
52     </bean>
53     <bean id="viewResolver" class="org.springframework.web.servlet.view.velocity.VelocityViewResolver"> 
54         <property name="suffix" value=".vm" /> 
55         <property name="contentType" value="text/html;charset=utf-8" />  
56         <property name="dateToolAttribute" value="date"/>
57         <property name="numberToolAttribute" value="number"/>
58     </bean>
59 </beans>

View Code

在读取数据源的时候，用一个jdbc.properties文件来存放全部的信息。

1 jdbc.driverClassName = com.mysql.jdbc.Driver
2 jdbc.url = jdbc:mysql://localhost:3306/blog?zeroDateTimeBehavior=convertToNull&amp;useUnicode=true&amp;characterEncoding=utf-8
3 jdbc.username = root
4 jdbc.password = 123456

View Code

注意：上述属性文件中有一些细节，以后会讲。

2.2.三、配置web.xml文件

这里直接给出web.xml的完整版，包括配置DispatcherServlet、CharacterEncodingFilter与欢迎页面。

注意：不须要配置spring的ContextLoaderListener了。

 1 <?xml version="1.0" encoding="utf-8"?>
 2 <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
 3     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
 5 
 6     <servlet>
 7         <servlet-name>dispatcherServlet</servlet-name>
 8         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
 9         <init-param>
10             <param-name>contextConfigLocation</param-name>
11             <param-value>classpath*:spring*.xml</param-value>
12         </init-param>
13         <load-on-startup>1</load-on-startup>
14     </servlet>
15     <servlet-mapping>
16         <servlet-name>dispatcherServlet</servlet-name>
17         <url-pattern>/</url-pattern>
18     </servlet-mapping>
19 
20     <filter>
21         <filter-name>encodingFilter</filter-name>
22         <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
23         <init-param>
24             <param-name>encoding</param-name>
25             <param-value>UTF-8</param-value>
26         </init-param>
27         <init-param>
28             <param-name>forceEncoding</param-name>
29             <param-value>true</param-value>
30         </init-param>
31     </filter>
32     <filter-mapping>
33         <filter-name>encodingFilter</filter-name>
34         <url-pattern>/*</url-pattern>
35     </filter-mapping>
36 
37     <welcome-file-list>
38         <welcome-file>/index.jsp</welcome-file>
39     </welcome-file-list>
40 </web-app>

View Code

2.三、引入mybatis

引入jar在pom.xml中搞定了；配置mybatis在spring.xml中搞定了。

注意：这里对于mybatis的配置并不彻底，由于这里我只用到了mybatis的注解，并无用到xml形式，关于注解与xml的使用场景以及mybatis的一些其余方面的知识，之后再作记录。

2.四、引入velocity

引入jar在pom.xml中搞定了；配置mybatis在spring.xml中搞定了。具体的配置信息在之后会作记录。

2.五、测试

在以上程序搭建完成后，造成下边的结构（本身注意看上述所述的各个文件的位置所在）

而后进行测试：

测试的内容包含两部分逻辑

注册：注册成功后返回true，注册失败后返回false（注意：在下边的controller中，这一块json的返回会在以后详细讲解）
登陆：登陆成功后跳到userinfo.vm文件，并输出登陆的用户信息；登陆失败后跳到error.vm文件，并输出相关的错误提示信息。

数据库表：

1）编写后台

后台代码结构如图

UserController：

 1 package com.xxx.web;
 2 
 3 import org.springframework.beans.factory.annotation.Autowired;
 4 import org.springframework.stereotype.Controller;
 5 import org.springframework.web.bind.annotation.RequestMapping;
 6 import org.springframework.web.bind.annotation.RequestParam;
 7 import org.springframework.web.bind.annotation.ResponseBody;
 8 import org.springframework.web.servlet.ModelAndView;
 9 
10 import com.xxx.model.User;
11 import com.xxx.service.UserService;
12 
13 @Controller
14 @RequestMapping("user")
15 public class UserController {
16     
17     @Autowired
18     private UserService userService;
19     
20     @ResponseBody
21     @RequestMapping("register")
22     public boolean register(@RequestParam("username") String username,
23                             @RequestParam("password") String password){
24         User user = new User();
25         user.setUsername(username);
26         user.setPassword(password);
27         
28         boolean isRegisterSuccess = userService.register(user);
29         
30         return isRegisterSuccess;
31     }
32     
33     @RequestMapping("login")
34     public ModelAndView login(@RequestParam("username") String username,
35                               @RequestParam("password") String password){
36         User user = userService.login(username, password);
37         
38         ModelAndView modelAndView = new ModelAndView();
39         if(user == null){
40             modelAndView.addObject("message", "用户不存在或者密码错误！请从新输入");
41             modelAndView.setViewName("error");
42         }else{
43             modelAndView.addObject("user", user);
44             modelAndView.setViewName("userinfo");
45         }
46         
47         return modelAndView;
48     }
49 }

View Code

UserService：

 1 package com.xxx.service;
 2 
 3 import org.springframework.beans.factory.annotation.Autowired;
 4 import org.springframework.stereotype.Service;
 5 
 6 import com.xxx.dao.UserDAO;
 7 import com.xxx.model.User;
 8 
 9 @Service
10 public class UserService {
11     
12     @Autowired
13     private UserDAO userDao;
14     
15     public boolean register(User user){
16         return userDao.register(user);
17     }
18     
19     public User login(String username, String password) {
20         return userDao.login(username, password);
21     }
22 }

View Code

UserDAO：

 1 package com.xxx.dao;
 2 
 3 import org.springframework.beans.factory.annotation.Autowired;
 4 import org.springframework.stereotype.Repository;
 5 
 6 import com.xxx.mapper.UserMapper;
 7 import com.xxx.model.User;
 8 
 9 @Repository
10 public class UserDAO {
11     
12     @Autowired
13     private UserMapper userMapper;
14     
15     public boolean register(User user){
16         return userMapper.insertUser(user)==1?true:false;
17     }
18     
19     public User login(String username ,String password){
20         return userMapper.selectByUsernameAndPwd(username, password);
21     }
22 }

View Code

UserMapper：

 1 package com.xxx.mapper;
 2 
 3 import org.apache.ibatis.annotations.Insert;
 4 import org.apache.ibatis.annotations.Param;
 5 import org.apache.ibatis.annotations.Result;
 6 import org.apache.ibatis.annotations.Results;
 7 import org.apache.ibatis.annotations.Select;
 8 
 9 import com.xxx.model.User;
10 
11 public interface UserMapper {
12     
13     @Insert("INSERT INTO userinfo(username, password) VALUES(#{username},#{password})")
14     public int insertUser(User user);
15     
16     @Select("SELECT * FROM userinfo WHERE username = #{username} AND password = #{password}")
17     @Results(value = { @Result(id = true, column = "id", property = "id"),
18                        @Result(column = "username", property = "username"), 
19                        @Result(column = "password", property = "password")})
20     public User selectByUsernameAndPwd(@Param("username")String username ,@Param("password")String password);
21 }

View Code

具体逻辑本身看吧，很简单的。

2）编写前台

error.vm

 1 <!DOCTYPE html>
 2 <html lang="zh-cn">
 3 <head>
 4     <meta charset="UTF-8">
 5     <title>登陆失败</title>
 6 </head>
 7 <body>
 8     <div>
 9         $message
10     </div>
11 </body>
12 </html>

View Code

userinfo.vm

 1 <!DOCTYPE html>
 2 <html lang="zh-cn">
 3 <head>
 4     <meta charset="UTF-8">
 5     <title>登陆成功</title>
 6 </head>
 7 <body>
 8     <div>
 9         id:$user.id
10         username:$user.username
11         password:$user.password
12     </div>
13 </body>
14 </html>

View Code

velocity的语法本身查看相关的文档吧。

最后，经过浏览器输入带参数URL的形式对程序进行测试。

整个整合过程就是这样的。

第一章 企业项目开发--maven+springmvc+spring+mybatis+velocity整合

第一章企业项目开发--maven+springmvc+spring+mybatis+velocity整合