1. Spring 5 MVC 的 HelloWorld

時間  2019-11-07
標籤 spring mvc helloworld 欄目 Spring 简体版
原文   原文鏈接

Spring 5 最近也出來了，目前版本號是 5.0.0.M1。這個專欄用於記錄我學習 Spring MVC 的過程。html

下面構建一個基於 Spring 5 的 Spring MVC 應用。
文件組織圖以下：
圖片描述
使用工具：Spring Tool Suite 3.8（裝有 Spring 插件的 Eclipse 也能夠，建議最新版）；Tomcat 8；JDK 8； Maven 3java

1）. 建立一個 Maven Web 項目，項目摘要以下：

圖片描述

2）. 編寫 pom.xml 文件：

<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.techmap</groupId>
    <artifactId>spring5mvc</artifactId>
    <packaging>war</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <name>spring5mvc Maven Webapp</name>
    <url>http://maven.apache.org</url>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

        <!-- 解決控制檯輸出 UTF-8 中文文本時亂碼的問題 -->
        <argLine>-Dfile.encoding=UTF-8</argLine>

        <!-- 自定義參數 -->
        <spring.version>5.0.0.M1</spring.version>

    </properties>

    <dependencies>
        <!-- Jstl 支持 -->
        <dependency>
            <groupId>javax.servlet.jsp.jstl</groupId>
            <artifactId>javax.servlet.jsp.jstl-api</artifactId>
            <version>1.2.1</version>
        </dependency>

        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
        </dependency>

        <!-- log4j 支持 -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
    
        <!-- JSR 330 註解支持 -->
        <dependency>
            <groupId>javax.inject</groupId>
            <artifactId>javax.inject</artifactId>
            <version>1</version>
        </dependency>

        <!-- AspectJ 支持 -->
        <dependency>
            <groupId>org.aspectj</groupId>
            <artifactId>aspectjweaver</artifactId>
            <version>1.8.9</version>
        </dependency>
        <dependency>
            <groupId>org.aspectj</groupId>
            <artifactId>aspectjrt</artifactId>
            <version>1.8.9</version>
        </dependency>

        <!-- Spring 支持 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <!-- Spring 框架支持 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-beans</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-tx</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context-support</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aop</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <!-- JUnit 支持 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>

    </dependencies>

    <repositories>
        <repository>
            <id>spring-milestones</id>
            <name>Spring Milestones</name>
            <url>https://repo.spring.io/libs-milestone</url>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
    </repositories>

    <build>
        <finalName>spring5mvc</finalName>
    </build>

</project>

3）. 編寫 web.xml 文件

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
    id="WebApp_ID" version="3.0">

    <display-name>spring5mvc</display-name>

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

    <context-param>
        <description>Spring MVC 上下文配置文件路徑</description>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:root-context.xml</param-value>
    </context-param>

    <servlet>
        <description>Spring MVC 核心 Servlet</description>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value></param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

</web-app>

這裏配置了 Spring MVC 的核心 Servlet：DispatcherServlet。還指定了上下文配置文件的名稱與路徑：classpath:root-context.xml。若是不指定這個配置文件的名稱與路徑，默認的是 WEB-INF 目錄下的一個叫作 [servlet-name]-servlet.xml 的 Spring 配置文件。web

4）. 進行 Spring MVC 上下文配置

web.xml 文件中指定了 Spring MVC 上下文配置文件爲 root-context.xml，這個文件放在 src/main/resources 下。下面是這個文件的內容：spring

<?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"
    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-4.3.xsd
        http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.3.xsd">

    <context:component-scan base-package="com.techmap.examples.controllers" />
    
    <!-- 
        SpringMVC：啓用 Spring MVC 註解驅動
         -->
    <mvc:annotation-driven />

</beans>

這個上下文配置文件目前只識別包 com.techmap.examples.controllers 下的控制器，即帶有註解 @Controller 的。注意 <mvc:annotation-driven />，這表示啓動 Spring MVC 的註解驅動。我測試了一下，不添加是不行的。apache

5）. 編寫控制器

root-context.xml 文件中指定了控制器所在的包路徑。下面在這個包路徑下寫一個控制器 HelloWorldController：api

package com.techmap.examples.controllers;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class HelloWorldController
{
    
    @RequestMapping("/helloWorld")
    public String helloWorld(Model model)
    {
        System.out.println("-> Hello World!");
        
        model.addAttribute("message", "Hello World!");
        return "helloWorld";
    }
}

6）. Web 主頁

在 webapp 目錄下添加一個簡單的 index.jsp 文件：瀏覽器

<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8"%>
<%
    String basepath = request.getScheme() + "://" + request.getServerName() + ":" 
            + request.getServerPort() + request.getContextPath() + "/";
%>
<!DOCTYPE html>
<html>
<body>
<h2>首頁</h2>
</body>
</html>

7）. 部署、運行與說明

至此，應用建立完成。把應用部署到 tomcat 中。在瀏覽器中輸入spring-mvc

http://localhost:8080/spring5mvc

瀏覽器中應該會顯示 index.jsp 頁面。在瀏覽器中輸入tomcat

http://localhost:8080/spring5mvc/helloWorld

應該會報錯，報錯信息應該是 HTTP Status 500，會像下面那樣：mvc

HTTP Status 500 - Circular view path [helloWorld]: would dispatch back to the current handler URL [/spring5mvc/helloWorld] again. Check your ViewResolver setup! (Hint: This may be the result of an unspecified view, due to default view name generation.)

緣由是，雖然找到了這個路徑，可是沒有對應的視圖能夠顯示。在控制檯中，應該能夠找到相似下面的輸出：

...
DEBUG 2016-09-01 09:09:39,157 Last-Modified value for [/spring5mvc/helloWorld] is: -1  (DispatcherServlet.java:951) 
-> Hello World!
DEBUG 2016-09-01 09:09:39,201 Invoking afterPropertiesSet() on bean with name 'helloWorld'  (AbstractAutowireCapableBeanFactory.java:1620) 
...

這說明確實執行了控制器。關於視圖，會在第二篇中給出一個簡單的例子。

**）這裏附上我使用的 log4j.properties 內容：

# Set root logger level to WARN and append to stdout
log4j.rootLogger=DEBUG, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

# Pattern to output the caller's file name and line number.
#log4j.appender.stdout.layout.ConversionPattern=%d %5p (%c:%L) - %m%n
log4j.appender.stdout.layout.ConversionPattern=%-5p %d{yyyy-MM-dd HH:mm:ss,SSS} %m  (%F:%L) \n

# Print only messages of level ERROR or above in the package noModule.
log4j.logger.noModule=DEBUG

# Spring Stuff
log4j.logger.org.springframework.web.servlet.DispatcherServlet=DEBUG

其餘

其實像上面那樣一路走來，實在是很麻煩。更加省事的方法（實際上隱藏了更多細節）是使用 Spring Boot。官網上有快速讓本身的 Controller 跑起來的教程

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程