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

Posted 2022-11-28 咕噜大大

创建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 the WebApplicationContext. 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> 

最后显示的结果是：


谢谢大家阅读，最后有什么不对的地方请大家指出，我会虚心接受并学习，然后改正。大家一起进步！