第一章 企業項目開發--maven+springmvc+spring+mybatis+velocity整合

說明:本系列文章主要是對本身在一家大型互聯網公司實習的過程當中對所學知識的總結!參與的是實際中使用的上線項目。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的形式對程序進行測試。

整個整合過程就是這樣的。

相關文章
相關標籤/搜索