快速搭建maven+springMVC3.0+mybatis項目

原創 咕噜大大 2018-09-02 00:59
創建maven項目：
首先,在你的本機上安裝maven,關於maven的用法可以去官網學習或者去看我的另一篇博客;接着就是打開你的命令行，輸入以下命令創建你的maven項目：
mvn -B archetype:generate  -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-webapp -DgroupId=${project-group-name} -DartifactId=${project-name}

創建完項目後就將maven項目導入到eclipse中，在選擇導入的項目時，記得是選擇導入maven項目，否則eclipse無法辨認出你的項目。引入項目後會發現maven項目會在eclipse中報錯，這是因爲項目找不到運行時需要的一些servlet依賴包。右鍵點擊項目，選擇> properties> Java Build Path> Libraries> Add Library, 接着選擇Server Runtime library加入項目中就行,如果沒有，就要手動配置一個server runtime library,一般是在你的web 容器中,如Tomcat,Apache等。

好了,maven項目準備完成,接下來就開始配置springMVC。

系統配置：
首先，你需要在項目的pom.xml配置需要的springMVC,mybatis等的依賴包
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.guludada.tuzhang</groupId>
  <artifactId>tuzhang</artifactId>
  <packaging>war</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>tuzhang Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>4.1.7.RELEASE</version>
    </dependency>

    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>4.1.7.RELEASE</version>
    </dependency>
    
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.3.0</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis-spring</artifactId>
        <version>1.2.3</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.36</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jdbc</artifactId>
        <version>4.2.0.RELEASE</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>jstl</artifactId>
        <version>1.2</version>
    </dependency>
    
  </dependencies>
  <build>
    <finalName>tuzhang</finalName>
  </build>
</project>
隨後在web.xml文件中配置springMVC的DispatcherServlet,將所有請求都置於springMVC的管理下
  <servlet>  
      <servlet-name>projectName</servlet-name>  
      <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>  
      <load-on-startup>1</load-on-startup>  
  </servlet>  
  <servlet-mapping>  
        <servlet-name>projectName</servlet-name>  
	<url-pattern>/</url-pattern>  
  </servlet-mapping>

接着配置一個和DispatcherServlet的servlet同名的WebApplicationContext文件,也放在WEB-INF目錄下,名字爲:projectName-servlet.xml,裏面配置所有spring要用到的handler,beans,service等。正如官方文檔提到的:"Namespace of theWebApplicationContext. Defaults to[servlet-name]-servlet."

這裏需要特別注意的是url-pattern的地址寫法。首先需要明確的是:
< url-pattern > / </ url-pattern >   不會匹配到*.jsp，即：*.jsp不會被spring的 DispatcherServlet類 匹配到。
< url-pattern > /* </ url-pattern > 會匹配*.jsp，會出現返回的jsp視圖再次被spring的DispatcherServlet 類匹配，而出現找不到對應的controller所以報404錯。
所以當我們設置controller的名字爲test，action的名字爲helloWorld，配置爲< url-pattern > / </ url-pattern >時,可以找到"localhost:8080/projectName/test/helloWorld",返回的/WEB-INF/jsp/helloWorld.jsp因爲不會被DispatcherServlet匹配，也能被正確解析返回。如果配置爲< url-pattern > /* </ url-pattern >，雖然也可以找到正確的URI，但是返回的/WEB-INF/jsp/helloWorld.jsp視圖因爲符合“/*”的匹配模式，而會被DispatcherServlet再進行一次攔截匹配，就會出現找不到視圖的URI而導致的mapping資源的錯誤。另外，可以設置配置爲：< url-pattern >/subPath/* </ url-pattern >, 這樣正確匹配的URI應該是"localhost:8080/projectName/subPath/test/helloWorld",返回的/WEB-INF/jsp/helloWorld.jsp視圖因爲不符合“/subPath/*”的url-pattern，所以不會被DispatcherServlet攔截而報錯。

用標籤標明使用spring的註解功能
<mvc:annotation-driven />
並指定下面的包中的controller對象自動註冊爲spring bean
<context:component-scan base-package="com.your-project.controller"/>
在projectName-servlet.xml文件中配置view解析器，並指定springMVC handler返回的視圖文件是JSP;
   <bean id="viewResolver"
        class="org.springframework.web.servlet.view.UrlBasedViewResolver">
	    <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
	    <property name="prefix" value="/WEB-INF/jsp/"/>
	    <property name="suffix" value=".jsp"/>
    </bean>
配置數據源和它的業務管理器
<!-- 配置DataSource數據源 -->
	<bean id="dataSource"
		class="org.springframework.jdbc.datasource.DriverManagerDataSource">
		<property name="driverClassName" value="com.mysql.jdbc.Driver" />
		<property name="url" value="jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=UTF-8" />
		<property name="username" value="${your username}" />
		<property name="password" value="${your password}" />
	</bean>

	<!--創建sqlSessionFactory -->
	<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
		<property name="dataSource" ref="dataSource" />
		<property name="mapperLocations" value="classpath:mapper/*.xml" />
		<property name="typeAliasesPackage" value="com.guludada.test.domain"/>
	</bean>
	<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
		 <property name="dataSource" ref="dataSource" />
	</bean>
配置mybatis的mapperScanner，它會自動幫你將包含sqlSessionFactory實例的dao的實現類注入到所有引用它的業務類中
	<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
	  <property name="basePackage" value="com.guludada.tuzhang.dao" />
	</bean>
最後一步就是將你的業務類註冊爲spring bean
<bean id="postService" class="com.guludada.test.serviceImpl.showUserImpl"
		scope="prototype">
</bean>


下面是完整的文件示例：
projectName-servlet.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:p="http://www.springframework.org/schema/p"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd">
    
    <mvc:annotation-driven />
	<context:component-scan base-package="com.guludada.test.controller"/>

    <bean id="viewResolver"
        class="org.springframework.web.servlet.view.UrlBasedViewResolver">
	    <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
	    <property name="prefix" value="/WEB-INF/jsp/"/>
	    <property name="suffix" value=".jsp"/>
	</bean>
	
	<!-- 配置DataSource數據源 -->
	<bean id="dataSource"
		class="org.springframework.jdbc.datasource.DriverManagerDataSource">
		<property name="driverClassName" value="com.mysql.jdbc.Driver" />
		<property name="url" value="jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=UTF-8" />
		<property name="username" value="${your username}" />
		<property name="password" value="${your password}" />
	</bean>

	<!--創建sqlSessionFactory -->
	<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
		<property name="dataSource" ref="dataSource" />
		<property name="mapperLocations" value="classpath:mapper/*.xml" />
		<property name="typeAliasesPackage" value="com.guludada.test.domain"/>
		
	</bean>

	<bean id="transactionManager"
		class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
		<property name="dataSource" ref="dataSource" />
	</bean>

        <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
	  <property name="basePackage" value="com.guludada.test.dao" />
	</bean>
<bean id="postService" class="com.guludada.test.serviceImpl.showUserImpl"scope="prototype"> </bean> </beans> 



數據層：首先,我們需要創建mybatis對SQL的mapping文件,可以是java對象POJO，也可以是xml文件，我們這裏以xml文件爲主。/resource/mapper/user.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.guludada.test.dao.usersDao">

<resultMap type="com.guludada.test.domain.usersBean" id="usersmap">
	<id column="id" property="id"/>
        <result column="nickname" property="nickname"/>
	</resultMap>

<select id="getUsers" resultMap="usersmap">
	select nickname from Users 
</select>
	
</mapper>


接着配置mybatis的數據庫的增刪改查操作類，也就是我們通常說的Dao類,這裏只需定義一個接口，具體的功能mybatis會根據你的user.xml的配置自動實現並通過spring注入到業務層對象中。

/com/guludada/test/dao/usersDao.java
package com.guludada.tuzhang.dao;

import java.util.List;

import com.guludada.test.domain.usersBean;

public interface usersDao {
	public List<usersBean> getUsers();
}
從數據庫中讀取出來的數據都會存進數據bean中，所以我們還要有一個數據bean對象

/com/guludada/test/domain/usersBean.java
package com.guludada.test.domain;

public class usersBean {
	private int id;
	private String nickname;
	public int getId() {
		return id;
	}
	public void setId(int id) {
		this.id = id;
	}
	public String getNickname() {
		return nickname;
	}
	public void setNickname(String nickname) {
		this.nickname = nickname;
	}
	
	
}

業務層：
我們使用spring的依賴注入功能解除代碼耦合，實現容器中對象的控制反轉，提高維護性。其實現核心就是接口，所以先要定義一個業務類的接口。

/com/guludada/test/service/showUser.java
package com.guludada.test.service;

import com.guludada.test.dao.usersDao;

public interface showUser {
	
	public String showNickname();

}


以及業務實現類

/com/guludada/test/serviceImpl/showUserImpl.java
package com.guludada.test.serviceImpl;

import java.util.List;

import org.springframework.beans.factory.annotation.Autowired;

import com.guludada.test.dao.usersDao;
import com.guludada.test.domain.usersBean;
import com.guludada.test.service.showUser;


public class showUserImpl implements showUser{
@Autowired
private usersDao usersdao;


	public String showNickname() {
		List<usersBean> userslist = usersdao.getUsers();
		System.out.println("hello world!"+userslist.get(0).getNickname()+"!"); 
                return userslist.get(0).getNickname();
	}

}

控制層：
到了springMVC 3.0版本，spring開始用註解的方式來指示controller對象和mapping的URI。下面是使用註解的方式定義controller對象

com/guludada/test/controller/helloworldController.java
package com.guludada.test.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

import com.guludada.test.service.showUser;
import com.guludada.test.serviceImpl.showUserImpl;


@Controller
@RequestMapping(value="/test")
public class helloworldController {
	
	@Autowired
	private showUser showuser;
	
	@RequestMapping(value="/helloWorld",method = RequestMethod.GET)
	public String helloWorld(Model model) {
		model.addAttribute("message", showuser.showNickname(););
		return "helloWorld";
	}

	
}



視圖層：
webapp/WEB-INF/jsp/helloWorld.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page isELIgnored="false" %>
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
Hello World! ${message}
<f:view>

</f:view>
</body>
</html>



注意的是在控制層和業務層中，聲明要注入的對象的接口上面要加上@Autowired，這樣spring纔會將對象實例注入到相應的實例中，否則會返回空指針異常。在正式的開發中，還需要將spring bean的聲明單獨放入一個配置文件中，方便維護和管理。


另一個值得注意的地方是很多人一開是的jsp文件上無法顯示controller傳過去的參數值，而是直接顯示“${attributes}”EL符號，這是因爲jsp版本低，低版本的jsp是默認關閉el標籤功能的，需要在jsp文件中加入
<%@ page isELIgnored="false" %>
標示該jsp文件使用el標籤。

或者在web.xml文件中聲明使用jsp2.0版本，因爲2.0以上版本默認是使用el標籤的
<web-app id="WebApp_ID" version="2.4" 
xmlns="http://java.sun.com/xml/ns/j2ee" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee 
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
//...
</web-app> 



最後顯示的結果是：



謝謝大家閱讀，最後有什麼不對的地方請大家指出，我會虛心接受並學習，然後改正。大家一起進步！











    





發表評論














所有評論



還沒有人評論，想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.







相關文章








Flume+Hadoop+Hive的離線分析系統基本架構






 咕噜大大

2018-09-02 00:59:21