SpringMVC框架（1） —— 入門案例

項目結構

• java
  • controller
    • HelloController.java（Java文件）
• resources
  • springmvc.xml（springmvc配置文件）
• webapp
  • WEB-INF
    • pages
      • success.jsp（web頁面）
    • web.xml（web配置文件）
  • index.jsp（web頁面）
• pom.xml（maven項目配置文件）

maven項目配置文件

• 配置maven項目需要的依賴
  • spring-context
  • spring-web
  • spring-webmvc
  • servlet-api
  • jsp-api

web配置文件

• 前端控制器（DispatcherServlet）
  • 配置一個前端控制器（<servlet>）
    • 創建前端控制器時，加載Spring配置文件（<init-param>）
    • 啓動服務器時，創建前端控制器（<\load-on-startup>）
  • 配置前端控制器的作用範圍（<servlet-mapping>）

springmvc配置文件

• 導入名稱空間（<beans xmlns="">）
• 開啓註解掃描（<context:component-scan base-package="">）
• 配置視圖解析器（InternalResourceViewResolver）
  • 配置前綴（prefix -> “/WEB-INF/pages”）
  • 配置後綴（suffix -> “.jsp”）
• 開啓SpringMVC註解支持（<mvc:annotation-driven>）

Java文件

• 表現層
  • 類
    • 添加進IoC核心容器（@Controller）
    • 設置請求映射（@RequestMapping()）
      • 一級目錄（path=""）
      • 設置允許訪問的請求方法（method=""）
      • 設置必需的參數和參數值（params=""）
      • 設置必需的請求頭（headers=""）
  • 方法
    • 設置請求映射（@RequestMapping()）
      • 二級目錄（path=""）
    • 返回值（return “success”;）

JSP文件

• 超鏈接（href=“一級目錄/二級目錄”）

執行代碼

pom.xml

<?xml version="1.0" encoding="UTF-8"?>

<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/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>cn.water</groupId>
  <artifactId>section01_Introduction</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>war</packaging>

  <name>section01_Introduction Maven Webapp</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>

  <!-- 版本鎖定 -->
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <spring.version>5.0.2.RELEASE</spring.version>
  </properties>

  <!-- 依賴注入 -->
  <dependencies>
    <!-- spring -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <!-- spring-web -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <!-- spring-webmvc -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <!-- servlet -->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>servlet-api</artifactId>
      <version>2.5</version>
      <scope>provided</scope>
    </dependency>
    <!-- jsp -->
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.0</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>

  <build>
    <finalName>section01_Introduction</finalName>
    <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
      <plugins>
        <plugin>
          <artifactId>maven-clean-plugin</artifactId>
          <version>3.1.0</version>
        </plugin>
        <!-- see http://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_war_packaging -->
        <plugin>
          <artifactId>maven-resources-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.8.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>2.22.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-war-plugin</artifactId>
          <version>3.2.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-install-plugin</artifactId>
          <version>2.5.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-deploy-plugin</artifactId>
          <version>2.8.2</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

web.xml

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
  <display-name>Archetype Created Web Application</display-name>

  <!--   【Filter】   -->
  <filter>
    <!--   創建過濾器   -->
    <filter-name>characterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <!--   配置編碼   -->
    <init-param>
      <param-name>encoding</param-name>
      <param-value>UTF-8</param-value>
    </init-param>
  </filter>
  <!--   映射   -->
  <filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

  <!--   【Servlet】   -->
  <servlet>
    <!--   創建前端控制器   -->
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!--   創建前端控制器時，加載spring配置文件   -->
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!--   啓動服務器時，創建前端控制器   -->
    <load-on-startup>1</load-on-startup>
  </servlet>
  <!--   映射   -->
  <servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

springmvc.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">


    <!-- 開啓註解掃描 -->
    <context:component-scan base-package="cn.water"/>


    <!-- 視圖解析器 -->
    <bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver" >
        <!-- 配置前綴 -->
        <property name="prefix" value="/WEB-INF/pages/"></property>
        <!-- 配置後綴 -->
        <property name="suffix" value=".jsp"></property>
    </bean>


    <!-- 開啓springMVC框架註解支持 -->
    <mvc:annotation-driven conversion-service="conversionServiceFactoryBean"/>


</beans>

HellowController.java

package cn.water.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller /* 將此類添加進IoC核心容器 */
@RequestMapping(path = "/controller",method = {RequestMethod.GET},params = {"username=cat"},headers = {"Accept"})
                /* 設置一級目錄 */    /* 設置允許訪問的請求方法 */    /* 設置必需的參數和值 */    /* 設置必需的請求頭 */
public class HelloController {

    @RequestMapping("/sayHello")
                /* 設置二級目錄 */
    public String sayHello(){
        System.out.printf("Hello StringMVC");
        return "success";
    }

}

index.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <h3>入門</h3>
    <a href="controller/sayHello?username=cat">請點擊</a>
</body>
</html>

success.jsp

<html>
<head>
    <title>Title</title>
</head>
<body>
    <h3>訪問成功！！！</h3>
</body>
</html>