使用Validator做SpringMVC的驗證框架 - 配置SpringMVC環境

DevEFX發表於2016-06-02

SpringMVC框架

章節列表

第一章：使用Validator做SpringMVC的驗證框架 - 配置SpringMVC環境
第二章：使用Validator做SpringMVC的驗證框架 - 使用Validator
第三章：使用Validator做SpringMVC的驗證框架 - Validator前端驗證
第四章：使用Validator做SpringMVC的驗證框架 - 自定義驗證元件

讓我們用Validator框架來給SpringMVC實現驗證功能吧

Validator框架原始碼地址：https://github.com/devefx/validator

完成這一章教程的要求

熟悉Java語言
配置好Maven環境
熟悉Eclipse IDE操作
熟悉SpringMVC

如果Maven環境還沒配置好的，請參考Maven在Eclipse中如何配置

我們首先搭建一個SpringMVC的環境，並實現在頁面顯示“HelloWorld”

1 - 新建Maven專案：

第一步用EclipseIDE新建一個專案。點選 > File > New > Other… 然後在彈出的對話方塊中選擇Maven Project 點選 Next 之後的視窗中再勾選Create a Simple Project > Next，最後我們填寫專案的資訊

第一步

第二步

第三步

點選Finish。接下來你會在Package Explorer檢視中看到新建的專案。如果Project Explorer沒有開啟，請在> Window > Show View中找到。

Project Explorer檢視

2 - 新增SpringMVC相關依賴

開啟pom.xml檔案，新增SpringMVC依賴，配置如下

<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>com.devefx</groupId>
  <artifactId>WebProject</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>war</packaging>
  <dependencies>
    <!-- Servlet Web相關依賴 -->
    <dependency>
      <groupId>jstl</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
      <scope>provided</scope>
    </dependency>
    <!-- SpringMVC -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>4.1.6.RELEASE</version>
    </dependency>
  </dependencies>
  <build>
    <pluginManagement>
      <plugins>
        <!-- 打包外掛 -->
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-war-plugin</artifactId>
          <version>2.3</version>
        </plugin>
        <!-- 編譯外掛 -->
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.5.1</version>
          <configuration>
            <source>1.7</source>
            <target>1.7</target>
            <encoding>utf-8</encoding>
          </configuration>
        </plugin>
        <!-- Tomcat7外掛 -->
        <plugin>
          <groupId>org.apache.tomcat.maven</groupId>
          <artifactId>tomcat7-maven-plugin</artifactId>
          <version>2.2</version>
          <configuration>
            <contextReloadable>false</contextReloadable>
            <!-- Tomcat啟動埠號，請保證此埠未被佔用 -->
            <port>80</port>
            <uriEncoding>utf-8</uriEncoding>
            <path>/</path>
          </configuration>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

3 - 編寫Java程式碼

首先新建一個包“com.devefx.website.controller”。右鍵點選src/main/java，然後New > Package，輸入包名，最後點選 Finish。
接下來我們要在包裡面新建一個Java原始檔FirstController.java。

FirstController.java

package com.devefx.web.controller;

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

@Controller
public class FirstController {

    @RequestMapping("/")
    public String index() {
        return "index";
    }
}

再接著我們在src/main/webapp/WEB-INF目錄下新建一個“jsp”目錄。
同樣的我們再建立一個JSP檔案index.jsp。

index.jsp

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
    <head>
        <title>Index</title>
    </head>
    <body>
        Hello World
    </body>
</html>

4 - 配置SpringMVC

接下來我們對SpringMVC進行配置，首先在src/main/resources目錄下新建spring-web.xml檔案作為SpringMVC的核心配置檔案，配置如下

spring-web.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:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context-3.0.xsd
       http://www.springframework.org/schema/mvc
       http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd">
    <!-- 簡化配置
        (1)自動註冊DefaultAnnotationHandlerMapping，AnnotationMethodHandlerAdapter
        (2)提供一系列：資料繫結，數字和日期format @NumberFormat,@DateTimeFormat xml,json預設讀寫支援
    -->
    <mvc:annotation-driven/>

    <!-- 靜態資源對映 -->
    <mvc:resources mapping="/resources/**" location="/resources/"/>

    <!-- 配置jsp顯示ViewResolver -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

    <!-- 掃描web元件 -->
    <context:component-scan base-package="com.devefx.website.controller" />
</beans>

最後我們再web.xml中對SpringMVC進行配置（web.xml在src/main/webapp/WEB-INF下面，如果沒有就新建一個）

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0"
         xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
         http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
  <!-- 配置SpringMVC DispatcherServlet -->
  <servlet>
    <servlet-name>dispatcher</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring-*.xml</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>
</web-app>