Spring MVC接口實(shí)例

概述

前文記錄了MVC模式和Spring MVC的初步認(rèn)識(前文連接:http://www.itdecent.cn/p/c19732ac8f76),現(xiàn)在記錄創(chuàng)建一個項(xiàng)目,配置Spring MVC,編寫接口程序。

創(chuàng)建項(xiàng)目

打開IntelliJ IDEA,點(diǎn)擊“File->New->Project...”,在打開的界面中左側(cè)選擇“Maven”,勾選“Create from archetype”,選中“maven-archetype-webapp”,點(diǎn)擊“Next”:


SpringMVC01.png

填寫GroupId等信息填寫完整,點(diǎn)擊“Next”:


SpringMVC02.png

配置好本機(jī)安裝的maven目錄,點(diǎn)擊“Next”:
SpringMVC03.png

設(shè)置好項(xiàng)目存放目錄,點(diǎn)擊“Finish”:


SpringMVC04.png

maven需要下載相應(yīng)的依賴,稍后片刻,創(chuàng)建完成,目錄結(jié)構(gòu)如下:
SpringMVC05.png

此時目錄結(jié)構(gòu)是缺失的,需要進(jìn)行完善,點(diǎn)擊“File->Project Structure...”,左側(cè)選中“Modules”,點(diǎn)擊“Sources”:
SpringMVC06.png

選中“main”目錄,右鍵菜單中點(diǎn)擊“New Folder...”,新建一個名為“java”的文件夾:
SpringMVC07.png

選中“java”文件夾,點(diǎn)擊上方“Sources”按鈕,可以看到“java”文件夾變色,并已被標(biāo)記為“Source Folders”文件夾:
SpringMVC08.png

SpringMVC09.png

選中“main”目錄,右鍵菜單中點(diǎn)擊“New Folder...”,新建一個名為“resources”的文件夾:


SpringMVC10.png

選中“resources”文件夾,點(diǎn)擊上方“Resources”按鈕,可以看到“resources”文件夾標(biāo)識變更,并已被標(biāo)記為“Resources Folders”文件夾:
SpringMVC11.png

選中“src”目錄,右鍵菜單中點(diǎn)擊“New Folder...”,新建一個名為“test”的文件夾,選中“test”目錄,右鍵菜單中點(diǎn)擊“New Folder...”,新建一個名為“java”的文件夾:
SpringMVC12.png

選中“java”文件夾,點(diǎn)擊上方“test”按鈕,可以看到“java”文件夾變色,并已被標(biāo)記為“Test Source Folders”文件夾:
SpringMVC13.png

然后創(chuàng)建包,選中java目錄,右鍵“New->Package”,輸入包名“com.snow.dcl.controller”,點(diǎn)擊“確定”:
SpringMVC15.png

至此項(xiàng)目目錄結(jié)構(gòu)就配置完整了。

配置Tomcat

Tomcat配置前文已經(jīng)記錄過了,此處不做重復(fù)記錄(前文連接:http://www.itdecent.cn/p/3cf98b5156e7)。

添加Spring MVC依賴

打開pom文件,在<dependencies>標(biāo)簽中添加如下依賴:

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>4.3.10.RELEASE</version>
</dependency>
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
</dependency>

基于配置的控制器實(shí)例

配置前端控制器DispatcherServlet

DispatcherServlet的核心功能是分發(fā)請求,請求會被分發(fā)給對應(yīng)處理的Java類,稱為Handle,在Spring 2.5版本以前開發(fā)一個Handle必須實(shí)現(xiàn)org.springframework.web.servlet.mvc.Controller接口,Controller接口必須實(shí)現(xiàn)ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception方法,Controller接口的實(shí)現(xiàn)類可以通過該方法傳遞參數(shù)訪問對應(yīng)請求的HttpServletRequest和HttpServletResponse對象,請求處理完成后,返回一個包含模型對象和視圖路徑的ModelAndView對象;在Spring 2.5版本新增了可基于注解的控制器,即不需要實(shí)現(xiàn)Controller接口,通過注釋類型來描述即可完成功能。
先不使用注解的方式進(jìn)行記錄,展開項(xiàng)目的目錄結(jié)構(gòu),雙擊打開web.xml文件,替換為下面內(nèi)容:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">

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

    <!--welcome pages-->
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>

    <!--配置Spring MVC DispatcherServlet-->
    <servlet>
        <servlet-name>springMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <!--配置/WEB-INF目錄下的springmvc-servlet.xml作為mvc的配置文件-->
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/springmvc-servlet.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
        <async-supported>true</async-supported>
    </servlet>
    <!--配置Spring MVC DispatcherServlet攔截所有請求-->
    <servlet-mapping>
        <servlet-name>springMVC</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

然后配置springmvc-servlet.xml,在WEB-INF目錄下右鍵“New->File”創(chuàng)建springmvc-servlet.xml,雙擊打開該文件,填寫以下內(nèi)容:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       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">

    <!--配置Handle,映射"/hello"請求-->
    <bean name="/hello" class="com.snow.dcl.controller.HelloController"/>
    <!--將bean的name作為url進(jìn)行查找-->
    <bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>
    <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>
    <!--視圖解析器-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"/>

</beans>

配置文件內(nèi)容含義:

  • 首先聲明了HelloController業(yè)務(wù)控制器類,并將其映射到/hello請求。
  • 配置了處理映射器BeanNameUrlHandlerMapping,以Bean的名稱作為url進(jìn)行查找。
  • 配置了處理器適配器SimpleControllerHandlerAdapter,對HelloController類的handleRequest方法進(jìn)行調(diào)用。
  • 配置視圖解析器InternalResourceViewResolver解析視圖,將view呈現(xiàn)給用戶。

\color{red}{注意:}Spring 4.0版本之后,處理映射器、處理器適配器、視圖解析器不需要進(jìn)行配置,Spring會提供默認(rèn)配置進(jìn)行使用,此處進(jìn)行配置是為了理解原理。
在“com.snow.dcl.controller”包下右鍵“New->Java Class”,創(chuàng)建一個名為“HelloController”的類,編寫如下代碼:

public class HelloController implements Controller {

    @Override
    public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) {
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("message", "Hello!");
        modelAndView.setViewName("/WEB-INF/content/welcome.jsp");
        return modelAndView;
    }

}

HelloController是實(shí)現(xiàn)了Controller接口的控制器,處理請求動作;handleRequest是必須實(shí)現(xiàn)的方法,該方法的參數(shù)對應(yīng)請求的HttpServletRequest和HttpServletResponse,必須返回一個包含視圖名或視圖名和模型的ModelAndView對象,此處返回的模型中包含message字符串對象,返回的視圖路徑/WEB-INF/content/welcome.jsp,即請求被轉(zhuǎn)發(fā)到welcome.jsp。
選中WEB-INF目錄,右鍵“New->Directory”,命名為“content”,然后同樣方式在該目錄中創(chuàng)建welcome.jsp,文件中編寫如下代碼:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html" charset="UTF-8">
    <title>welcome</title>
</head>
<body>
${requestScope.message}
</body>
</html>

此處使用JSP的EL表達(dá)式${requestScope.message}來獲取HelloController的ModelAndView對象中message的值并顯示在瀏覽器中。

測試

啟動TomcatServer,啟動完成后,打開瀏覽器輸入:http://localhost:8080/hello,訪問成功。

基于注解的控制器實(shí)例

Spring 2.5版本后,增加了基于注解的控制器,即不需要實(shí)現(xiàn)Controller接口,通過注解即可實(shí)現(xiàn)功能。

修改HelloController類

打開HelloController類文件,代碼修改如下:

@Controller
public class HelloController {

    @RequestMapping(value = "/hello")
    public ModelAndView hello() {
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("message", "Hello!");
        modelAndView.setViewName("/WEB-INF/content/welcome.jsp");
        return modelAndView;
    }

}

HelloController是一個基于注解的控制器,使用@Controller注解標(biāo)示,@RequestMapping注解用來映射一個請求和請求的方法,value = "/hello"表示請求由hello方法進(jìn)行處理,方法返回一個包含視圖名或視圖名和模型的ModelAndView對象。

修改Spring MVC的配置文件

打開springmvc-servlet.xml,內(nèi)容修改如下:

<?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:context="http://www.springframework.org/schema/context"
       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">

    <!--spring可以自動掃描base-package設(shè)置的包或子包下的java類,如果掃描到有spring相關(guān)注解的類,則注冊為spring的bean-->
    <context:component-scan base-package="com.snow.dcl.controller"/>
    <!--配置annotation類型的映射處理器-->
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>
    <!--配置annotation類型的處理器適配器-->
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"/>
    <!--視圖解析器-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"/>

</beans>

Spring的掃描機(jī)制會自動掃描com.snow.dcl.controller包下使用了@Controller注解的控制器類,配置的RequestMappingHandlerMapping映射處理器處理會根據(jù)請求查找映射,配置的RequestMappingHandlerAdapter來完成對@RequestMapping注解的方法的調(diào)用,配置的InternalResourceViewResolver解析視圖呈現(xiàn)給用戶。
\color{red}{注意:}Spring 4.0版本之后,處理映射器、處理器適配器會有跟簡單的方式進(jìn)行配置,此處進(jìn)行配置是為了理解原理。

測試

啟動TomcatServer,啟動完成后,打開瀏覽器輸入:http://localhost:8080/hello,訪問成功。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • 16. Web MVC 框架 16.1 Spring Web MVC 框架介紹 Spring Web 模型-視圖-...
    此魚不得水閱讀 1,158評論 0 4
  • 1、Spring MVC請求流程 (1)初始化:(對DispatcherServlet和ContextLoderL...
    拾壹北閱讀 2,016評論 0 12
  • SpringMVC介紹 Spring web mvc 和Struts2都屬于表現(xiàn)層的框架,它是Spring框架的一...
    day_Sunny閱讀 898評論 0 0
  • MVC 設(shè)計(jì)概述 在早期 Java Web 的開發(fā)中,統(tǒng)一把顯示層、控制層、數(shù)據(jù)層的操作全部交給 JSP 或者 J...
    我沒有三顆心臟閱讀 400,047評論 87 543
  • 我愿 沒有天荒地老, 不談滄海桑田, 只言片語, 卻總能撥響那根名為心動的弦。 我愿 就像蒲公英飄向遠(yuǎn)方, 就像風(fēng)...
    大叔云軒閱讀 125評論 0 0

友情鏈接更多精彩內(nèi)容