三分鐘學會用SpringMVC搭建最小系統（超詳細）

摘要: 技術選型（只列了一部分技術）服務框架：Dubbo、zookeeper、Rest服務緩存：Redis、ehcache 消息中間件...

前言

本文介紹如何用eclipse一步一步搭建SpringMVC的最小系統，所謂最小系統，就是足以使項目在SpringMVC框架下成功跑起來，並且能夠做一些簡單的事情（比如訪問頁面）的系統。

話不多說，讓我們開始吧。所有的源代碼和jar包都會在最後給出。

其他環境：
操作系統：Windos 10
Tomcat ： v7.0
JDK : 1.7

技術選型（只列了一部分技術）

1、後端

服務框架：Dubbo、zookeeper、Rest服務

緩存：Redis、ehcache

消息中間件：ActiveMQ

負載均衡：Nginx

分佈式文件：FastDFS

數據庫連接池：Alibaba Druid 1.0

核心框架：spring framework

安全框架：Apache Shiro 1.2

視圖框架：Spring MVC 4.0

服務端驗證：hibernate Validator 5.1

佈局框架：SiteMesh 2.4

工作流引擎：Activiti 5.15

任務調度：quartz 1.8.5

持久層框架：MyBatis 3.2

日誌管理：SLF4J 1.7、Log4j

工具類：Apache Commons、Jackson 2.2、Xstream 1.4、Dozer 5.3、POI

2、前端

js框架：jQuery 1.9。

CSS框架： Bootstrap 4 metronic

客戶端驗證：jquery Validation Plugin。

富文本：CKEcitor

文件管理：CKFinder

動態頁籤：Jerichotab

數據表格：jqGrid

對話框：jQuery jBox

樹結構控件：jQuery zTree

其他組件：Bootstrap 4 metronic

3、支持

服務器中間件：Tomcat 6、7、Jboss 7、WebLogic 10、WebSphere 8

數據庫支持：目前僅提供MySQL數據庫的支持，但不限於數據庫，下個版本升級多數據源切換和數據庫讀寫分離：如：Oracle、SqlServer、H2等

支持開發環境：Eclipse、MyEclipse、Ras、Idea等

經典介紹：

源碼結構

更多詳細源碼參考來源

正文

1. 新建一個項目

Paste_Image.png

我們用eclipse新建項目，選擇Dynamic Web Project(動態的Web項目)。

點擊Next

Paste_Image.png

Project name裏面寫上 springmvc，這就是我們項目的名稱，其他不用改，直接點擊Finish 。

Paste_Image.png

OK，項目就建好了。

接下來一定要將項目的字符集改爲UTF-8

右鍵項目——properties

Paste_Image.png

改爲UTF-8，點擊OK。

2. 編寫 web.xml

當我們打開WebContent/WEB-INF目錄的時候，發現裏面只有一個lib目錄，這是存放各種jar包的地方。我們知道一個web項目必須要有一個web.xml文件才行。

既然沒有，我們自己寫一個咯。

右鍵WEB-INF——new——file，新建一個web.xml文件。

點擊Finish

將以下內容填進去即可。

<?xml version="1.0" encoding="UTF-8"?><web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
            xmlns="http://xmlns.jcp.org/xml/ns/javaee" 
            xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" 
            id="WebApp_ID"><!-- 這是項目的名稱 --><display-name>springmvc</display-name></web-app>

這樣就完成了基本的配置，我的意思是說，現在這個項目就已經是一個標準的web項目了。

3. 驗證web項目是否搭建成功

爲了驗證到目前爲止的正確性，我們在WebContent目錄下面新建一個jsp文件。

名字就叫index.jsp

Paste_Image.png

內容如下：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%><html>
    <head>
        <meta charset="UTF-8" />
    </head>
    <body>
        恭喜，web項目已經成功搭建！    </body></html>

我們現在就將這個項目部署到Tomcat,來驗證是否可以跑起來。

在項目上右鍵——Debug As——Debug on Server

直接點擊Finish

經過一段時間，控制檯開始打印日誌信息，當我們看到這些信息的時候，說明Tomcat已經啓動完畢了。

Paste_Image.png

讓我們打開瀏覽器，在地址欄輸入以下信息

http://localhost:8088/springmvc/index.jsp

我電腦上Tomcat配置的端口號是8088，具體情況視你自己的Tomcat決定，可能是8080等。

Paste_Image.png

可見，能夠成功訪問頁面了，這說明我們到目前爲止的操作是正確的。

3. 集成SpringMVC

我們在web.xml文件裏面添加下面的配置
3.1 配置監聽器

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

3.2 配置過濾器，解決POST亂碼問題

<filter>
    <filter-name>encoding</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>encoding</filter-name>
    <url-pattern>/*</url-pattern></filter-mapping>

3.3 配置SpringMVC分發器，攔截所有請求

<servlet>
     <servlet-name>springmvc</servlet-name>
     <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
     <init-param>
         <param-name>namespace</param-name>
         <param-value>dispatcher-servlet</param-value>
     </init-param></servlet><servlet-mapping>
     <servlet-name>springmvc</servlet-name>
     <url-pattern>/</url-pattern>
 </servlet-mapping>

在這個配置中，我們規定了 DispatcherServlet 的關聯 XML 文件名稱叫做 dispatcher-servlet。

注意，這裏的路徑是相對於web.xml來說的，也就是說，這個文件也在WEB-INF的根目錄下。

所以，我們需要在WEB-INF的根目錄下新建一個dispatcher-servlet.xml文件。

Paste_Image.png

至此，web.xml文件的編寫就告一段落了。

3.4 編寫dispatcher-servlet.xml
dispatcher-servlet.xml 的作用就是配置SpringMVC分發器。

配置如下：

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

         <!-- 開啓註解模式驅動 -->    
         <mvc:annotation-driven></mvc:annotation-driven>
         <!-- 掃包 -->
         <context:component-scan base-package="com.springmvc.*"></context:component-scan>
         <!-- 靜態資源過濾 -->
         <mvc:resources location="/resources/" mapping="/resources/**"/>


         <!-- 視圖渲染 jsp/freemaker/velocity-->
         <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
               <!-- 制定頁面存放的路徑 -->
               <property name="prefix" value="/WEB-INF/pages"></property>
               <!-- 文件的後綴 -->
               <property name="suffix" value=".jsp"></property>
         </bean> </beans>

根據配置，有三個需要注意的地方。

它會掃描 com.springmvc 包下所有的Java類，但凡是遇到有註解的，比如@Controller ， @Service ， @Autowired ，就會將它們加入到Spring的bean工廠裏面去。
所有的靜態資源文件，比如說 js ， css ， p_w_picpaths 都需要放在/resources目錄下，這個目錄現在我們還沒有建。
所有的展示頁面，比如jsp文件，都需要放置在/WEB-INF/pages目錄下，這個目錄現在我們也沒有建。

OK，我們把對應的目錄加上。

首先是Java文件的目錄。

Paste_Image.png

我們在這個地方右鍵，新建一個 com 包,再在裏面建一個 springmvc 包，或者用 . 的方式一起建。

Paste_Image.png

點擊Finish

Paste_Image.png

根據SpringMVC的分層，我們在springmvc 包下面建三個包，分別是controller ， service ， dao

Paste_Image.png

這樣的話，當我們項目一旦啓動，springmvc就會掃描這三個包，將裏面但凡是有註解的類都提取起來，放進Spring容器（或者說Spring的bean工廠），藉由Spring容器來統一管理。這也就是你從來沒有去new一個Controller的原因。

接下來，我們來建靜態資源的目錄。

在WebContent目錄下新建一個resources文件夾。

然後順便把js，css，img的文件夾都建一下，這裏就存放我們的靜態資源文件。

Paste_Image.png

最後，我們在WEB-INF目錄下建一個pages文件夾，作爲展示頁面的存放目錄。

Paste_Image.png

將之前的index.jsp拷貝進來。

Paste_Image.png

這樣就配置的差不多了。

5. 導包和驗證

我們將jar包放到lib目錄：

Paste_Image.png

然後啓動項目，驗證一下到目前爲止的構建是否正確。

打開Servers視圖，點擊如圖像是甲蟲一樣的圖標。

Paste_Image.png

發現報錯了，錯誤信息如下：

Paste_Image.png

錯誤：
Could not open ServletContext resource [/WEB-INF/applicationContext.xml]

它說我們在WEB-INF下面少了一個applicationContext.xml 這個文件，原來，我們少了對SpringBean工廠的配置，它的意思就是說，我們要規定一下，在Spring容器啓動的時候，需要自動加載哪些東西？

於是，我們把 applicationContext.xml 加上。

Paste_Image.png

<?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:aop="http://www.springframework.org/schema/aop"
    xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"
    xmlns:util="http://www.springframework.org/schema/util" xmlns:p="http://www.springframework.org/schema/p"
    xsi:schemaLocation="http://www.springframework.org/schema/beans   
  http://www.springframework.org/schema/beans/spring-beans.xsd  
  http://www.springframework.org/schema/aop   
  http://www.springframework.org/schema/aop/spring-aop-4.0.xsd
  http://www.springframework.org/schema/tx   
  http://www.springframework.org/schema/tx/spring-tx-4.0.xsd
  http://www.springframework.org/schema/context   
  http://www.springframework.org/schema/context/spring-context-4.0.xsd
  http://www.springframework.org/schema/util   
  http://www.springframework.org/schema/util/spring-util-4.0.xsd
  "></beans>

裏面我們啥也不配置，再次啓動Tomcat。

Paste_Image.png

這回不報錯了。

5. 配置ViewController

我們知道，WEB-INF目錄下的任何資源都是無法直接通過瀏覽器的url地址去訪問的，保證了安全性。這也是我們爲什麼把頁面都放在該目錄下的原因。

爲了有所區分，我們還單獨建立了一個pages文件夾，將這些頁面保存起來。

Paste_Image.png

現在，爲了訪問這個頁面，我們需要用到SpringMVC的頁面跳轉機制。

我們在Controller包下新建一個ViewController

Paste_Image.png

點擊Finish

Paste_Image.png

ViewController 代碼：

package com.springmvc.controller;import javax.servlet.http.HttpServletRequest;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.servlet.ModelAndView;@Controllerpublic class ViewController {    @RequestMapping("/view")
    public ModelAndView view(HttpServletRequest request){
        String path = request.getParameter("path") + "";
        ModelAndView mav = new ModelAndView();
        mav.setViewName(path);        return mav;
    }
}

我只需要將想要訪問的頁面放在path裏面，通過url傳進來就行了。

因爲添加了java類，因此我們重新啓動Tomcat。

啓動完成後，在地址欄輸入：
http://localhost:8088/springmvc/view?path=index

結果：

Paste_Image.png

沒關係，我們看他報什麼錯。

message /springmvc/WEB-INF/pagesindex.jsp

pagesindex.jsp是什麼鬼？？

原來，在dispatcher-servlet.xml中，我們少寫了一個 "/"

Paste_Image.png

添上去就行了。

Paste_Image.png

保存後，因爲修改了XML配置文件，因此我們還是需要重新啓動Tomcat。

啓動完成後，繼續！

Paste_Image.png

成功了。

6. 引入靜態資源

比如，我在resources/img目錄下放了一張圖片，怎麼引入到index.jsp呢？

Paste_Image.png

background : url(http://localhost:8088/springmvc/resources/img/bg.jpg);background-size : 100% 100%;

的確，這是一種方式。可是，它有一個缺點就是根路徑寫死了，我們肯定不希望這樣的。

其實，我們可以在viewController裏面拿到項目根路徑，然後傳遞到jsp頁面就OK了。

Paste_Image.png

我們把調試信息 “恭喜，web項目已經成功搭建！” 刪掉。

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%><html>
    <head>
        <meta charset="UTF-8" />
    </head>

    <style>
        body {            background : url(${contextPath}/resources/img/bg.jpg);            background-size : 100% 100%;
        }    </style>
    <body>

    </body></html>

${contextPath} 可以取到Controller傳過來的contextPath值。

歡迎大家一起學習研究相關技術願意瞭解框架技術或者源碼的朋友直接求求：2042849237
更多詳細源碼參考來源：http://minglisoft.cn/technology

三分鐘學會用SpringMVC搭建最小系統（超詳細）

前言

正文

1. 新建一個項目

2. 編寫 web.xml

3. 驗證web項目是否搭建成功

3. 集成SpringMVC

5. 導包和驗證

5. 配置ViewController

6. 引入靜態資源

使用c#強大的表達式樹實現對象的深克隆之解決循環引用的問題

痞子衡嵌入式：恩智浦i.MX RT1xxx系列MCU啓動那些事（12.A）- uSDHC eMMC啓動時間(RT1170)

GPT-4o 引領人機交互新風向，向量數據庫賽道沸騰了

企業大模型如何成爲自己數據的“百科全書”？

本地SSL證書過期輸入命令在IIS自動生成

基於Ubuntu-22.04安裝K8s-v1.28.2實驗（二）使用kube-vip實現集羣VIP訪問

.NET週刊【5月第2期 2024-05-12】

細心微服務架構的優勢與不足那點事

分佈式架構現在很火嗎?zookeeper dubbo可以？Dubbo、zookeeper、Proxy、RestFul

一句話講清楚什麼是JavaEE

企業大型互聯網分佈式架構{Java分佈式架構 dubbo + springmvc + mybatis + ehcache + redis }

三分鐘學會用SpringMVC搭建最小系統（超詳細）

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結