SpringMVC之旅第1章：基于IDEA 构建Maven+SpringMVC+FreeMarker的Web工程

绝地灬酷狼 2022-05-22 09:46 140阅读 0赞

这篇文章不是解释为啥这么搭这个工程，仅仅是纪录了步骤，便于quickly start...

一、构建基于maven的web工程

首先我们需要构建一个基于maven的web工程~

Step1、File->New->Project->Maven

![70][]

Step2、按照如图s1->s2->s3->s4 这四个步骤操作

![70 1][]

Step3、按要求填写，如有疑问可查看maven相关说明，然后继续next

![70 2][]

Step4、按要求继续填写

![70 3][]

Step4、工程创建完成后我们来看看目录层级，会发现Oh,No! 怎么没有java、resource等等，没关系，这些在后续需要时都可以自己添加~

![70 4][]

比如我创建了java路径和resource路径：

（1）java：主要用于放java文件

（2）resource：主要用于放配置文件

最后在创建package，这个package路径按照之前填写的GroupId进行创建

![70 5][]

二、引入SpringMvc + FreeMarker

1、工程创建好后首先看pom.xml文件。如下**截图中红框圈出来的部分**或者**直接摘出来的配置**都是基于创建好pom.xml文件里增量部分。

（1）定义了版本号

![70 6][]

（2）添加的依赖

<dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</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-context-support</artifactId>
      <version>${spring.version}</version>
    </dependency>
    
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-tx</artifactId>
      <version>${spring.version}</version>
    </dependency>
    
    
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>4.0.0</version>
    </dependency>
    
    
    <dependency>
      <groupId>org.freemarker</groupId>
      <artifactId>freemarker</artifactId>
      <version>2.3.22</version>
    </dependency>

2、然后再看WEB-INF/web.xml文件：整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"
             version="3.0">
    
      <display-name>Archetype Created Web Application</display-name>
    
      
      <servlet>
        <servlet-name>web-dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
          <param-name>contextConfigLocation</param-name>
          <param-value>/WEB-INF/web-dispatcher.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
        <async-supported>true</async-supported>
      </servlet>
      
      <servlet-mapping>
        <servlet-name>web-dispatcher</servlet-name>
        <url-pattern>*.html</url-pattern>
      </servlet-mapping>
    
      
      <filter>
        <filter-name>encodingFilter</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>
        <init-param>
          <param-name>forceEncoding</param-name>
          <param-value>true</param-value>
        </init-param>
      </filter>
      <filter-mapping>
        <filter-name>encodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
      </filter-mapping>
    </web-app>

\----------  我是愉悦的分割线 ：重点说一下servlet------------------------

![70 7][]

\----------  我是愉悦的分割线 ------------------------

3、web-dispatcher.xml文件：

详细配置见下问，可直接复制粘贴使用。

这里的配置包含两层：（1）定义了请求进来，要扫描哪些文件；（2）定义了freemarker的设置

<?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xmlns="http://www.springframework.org/schema/beans" 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.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">
    
        
        <mvc:annotation-driven />
    
        
        <context:component-scan base-package="com.doubleqinyan.practices" />
    
        
        <bean id="fmXmlEscape" class="freemarker.template.utility.XmlEscape"/>
    
        
        <bean id="freemarkerConfig"
              class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
    
            
            <property name="templateLoaderPath">
                <value>/freeMarker/</value>
            </property>
    
            <property name="freemarkerVariables">
                <map>
                    <entry key="xml_escape" value-ref="fmXmlEscape"/>
                </map>
            </property>
    
            
            <property name="freemarkerSettings">
                <props>
                    <prop key="template_update_delay">0</prop>
                    <prop key="default_encoding">UTF-8</prop>
                    <prop key="output_encoding">UTF-8</prop>
                    <prop key="locale">zh_CN</prop>
                    <prop key="date_format">yyyy-MM-dd</prop>
                    <prop key="time_format">HH:mm:ss</prop>
                    <prop key="datetime_format">yyyy-MM-dd HH:mm:ss</prop>
                    <prop key="number_format">#</prop>
                    
                </props>
            </property>
        </bean>
    
        
        <bean id="urlBasedViewResolver"
              class="org.springframework.web.servlet.view.UrlBasedViewResolver">
            <property name="viewClass"
                      value="org.springframework.web.servlet.view.freemarker.FreeMarkerView"></property>
        </bean>
    
        
        <bean id="viewResolver"
              class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
            <property name="viewClass"
                      value="org.springframework.web.servlet.view.freemarker.FreeMarkerView"/>
            <property name="prefix" value=""/>
            <property name="suffix" value=""/>
            <property name="order" value="1"/>
            <property name="viewNames" value="*.ftl"/>
            <property name="requestContextAttribute" value="rc"/>
            <property name="contentType" value="text/html; charset=utf-8"/>
            <property name="cache" value="true"/>
            <property name="exposeSessionAttributes" value="true"/>
        </bean>
    </beans>

\----------  我是愉悦的分割线 ：重点说一下freeMarker-----------------------

（1）

![70 8][]

（2）

![70 9][]

\----------  我是愉悦的分割线 ------------------------

如上，我们已经完成了引入SpringMVC+FreeMarker的所有配置，接下来我们写一个demo，让我们的工程运行起来。

三、Quickly start!

1、相应的文件

![70 10][]

（1）后台相应代码：

@Controller
    @RequestMapping("/test")
    public class Hello {
    
        @RequestMapping(value = "hello")
        public String hello(ModelMap modelMap){
            String w1 = "Hello";
            String w2 = "World!";
            String w3 = "My 1st project.";
            String w4 = "Hahahahaha ^_^";
            modelMap.addAttribute("w1", w1);
            modelMap.addAttribute("w2", w2);
            modelMap.addAttribute("w3", w3);
            modelMap.addAttribute("w4", w4);
            return "Hello.ftl";
        }
    }

（2）前端代码

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    <html>
    <head>
        <meta http-equiv="Content-Type"content="text/html; charset=UTF-8">
        <title>Insert title here</title>
    </head>
    <body>
    <h2>${ w1} ${ w2}</h2></br>
    <h3>${ w3} ${ w4}</h3>
    </body>
    </html>

2、启动

为啥这里是exmple呢？因为我把工程存在了一个example的文件夹里，如果默认不修改工程存储路径，那么应该是demo

![70 11][]

[70]: /images/20220522/c4d5b600b2f54f7fa12076b654f7c03e.png
[70 1]: /images/20220522/7ea9b9b5a6624a09b176cf2e1a2b4406.png
[70 2]: /images/20220522/d36d76712d3943b395d4aaadf63af454.png
[70 3]: /images/20220522/481537edc07847d2b3a3acc221209153.png
[70 4]: /images/20220522/63cd6d141b074273abd5f7cfd5150448.png
[70 5]: /images/20220522/9cbdc5c2614d4531bd13ac57f15e73a8.png
[70 6]: /images/20220522/69107f1dce45470ebd1cabfa6e95fea7.png
[70 7]: /images/20220522/52800b40010b4e0988e4392e8d851c62.png
[70 8]: /images/20220522/2e91d9e42a1841c9bcba246f1382eb04.png
[70 9]: /images/20220522/d0bd6f18141e41a090dd6f658c5eae19.png
[70 10]: /images/20220522/bfb5ef580ee24d0692092b1b9a5b9af9.png
[70 11]: /images/20220522/42cd1ece8b054350a29f4e6a7dfa5abd.png