SpringMVC之配置访问首页及html解析器

最新推荐文章于 2022-08-24 20:59:34 发布

原创最新推荐文章于 2022-08-24 20:59:34 发布 · 5k 阅读

14 ·

CC 4.0 BY-SA版权

文章标签：

#tomcat启动之后首页设置 #index页面找不到 #url-pattern #配置返回html的视图解析器

工作时补充知识专栏收录该内容

1 篇文章

订阅专栏

本文详细探讨了SpringMVC中配置Tomcat加载首页的问题，包括默认加载规则、DispatcherServlet配置后的影响，以及如何处理静态资源访问。通过调整web.xml和SpringMVC配置，解决了.html页面404问题，确保了首页和HTML文件的正确加载。

对于tomcat启动后怎么去加载首页的问题。由于了解少的缘故，这里跳坑用了很长时间。

一、默认加载规则

首先这里说明一下首页的加载规则，会优先去加载index.html；如果index.html不存在，则会找index.jsp；如果index.jsp不存在，则会返回404错误；

我们想配置指定的首页的话，在web.xml文件中添加配置指定文件

<welcome-file-list>

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

</welcome-file-list>

然后在webapp下创建welcome.jsp，启动项目后则会加载welcome.jsp；

<welcome-file-list>

    <welcome-file>welcome.html</welcome-file>

</welcome-file-list>

添加此配置可以加载webapp下的welcome.html文件；

二、配置DispatchServlet之后的加载

DispatcherServlet是前端控制器设计模式的实现，提供SpringWebMVC的集中访问点；

我们知道Springmvc处理一个请求的加载过程，所以在创建完项目之后，我就参照网上资料配置了DispatchServlet，而这个配置，才是入坑的开始；我在web.xml文件中的配置：

<!--前端控制器-->

<servlet>

   <servlet-name>SpringMVC</servlet-name>

    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

    <init-param>

        <param-name>contextConfigLocation</param-name>

        <param-value>classpath:spring-mvc.xml</param-value>

    </init-param>

    <load-on-startup>1</load-on-startup>

</servlet>

<servlet-mapping>

    <servlet-name>SpringMVC</servlet-name>

    <url-pattern>/</url-pattern>

</servlet-mapping>

配置了前端控制器之后，我发现首页加载出问题了，404！！！按照默认加载规则来说，我webapp下存在index.html文件啊，页面找不到？然后我又创建了index.jsp文件放在webapp下，删除了index.html，页面加载到了！！！这里就使我疑惑了，然后我就想加载index.html，我就尝试第三种使用配置来访问：

<welcome-file-list>

    <welcome-file>index.html</welcome-file>

</welcome-file-list>

还是404！！！加载不到html，我就纳闷的很，去看报错！！！

org.springframework.web.servlet.PageNotFound.noHandlerFound No mapping found for HTTP request with URI [/] in DispatcherServlet with name 'SpringMVC'

没有找到URI为[/]的映射，那我就加一个映射，这里我参照网上配置也配置了视图解析器

<!--视图解析器-->

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">

    <property name="prefix" value="/WEB-INF/views/"/>

    <property name="suffix" value=".html"/>

</bean>

同时也写了controller层接口返回index

因为想返回html，所以配置了html后缀，但是仍然404，这里其实有错的，因为InternalResourceViewResolver是解析jsp的，无法处理html，改回jsp，同时打个断点看会不会访问这个接口。

  <!--前端控制器-->
  <servlet>
    <servlet-name>SpringMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring-mvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>SpringMVC</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

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

同时路径下存在index.jsp和index.html文件，这里访问成功，是index.jsp；(注意这里返回的页面名称不一定是index，可以是其他)

我绕在这里很久尝试方法，皆不可以，后来找到几种可以加载html的方法。

三、处理配置前端控制器访问html文件的方法(这里将index.html,index.jsp放回webapp下)

1.访问不到的原因是因为DisPatchServlet中配置url-pattern为"/"，这里会匹配像/index这样的路径，但同时会拦截".html"，".js"，“.css”等静态文件，但是不拦截jsp，所以可以访问到index.jsp；

当url-pattern值为"/*"时，这里会匹配到带后缀类型的url，基本是所有的url会被匹配，".jsp"和“.html”都不能访问，通过localhost:8080/index.jsp也无法访问，说明这里也拦截了".jsp"文件

  <!--前端控制器-->
<servlet>
    <servlet-name>SpringMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring-mvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>SpringMVC</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

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

这里我注释了controller的接口，这个知识点有点模糊，因为网上资料说".jsp"和".html"是可以匹配到的，希望可以指出错误之处。贴出web.xml；

这个解释的话就可以理解为啥会拦截到jsp了，同时这个解释搭配"/"时的情况，也就可以理解拦截静态资源访问不了index.html原因了。

当值为*.do或者*.action(扩展名自定义)时，匹配以.do或.action结尾的url；此时设置的首页可以访问到，无论是index.jsp和index.html。

四、当url-pattern为"/"时访问html处理

在这里，不能访问html文件是因为拦截了静态文件的访问，需要配置不拦截的静态路径，web.xml文件中配置：

  <!--前端控制器-->
  <servlet>
    <servlet-name>SpringMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring-mvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>SpringMVC</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

  <welcome-file-list>
    <welcome-file>/static/index.html</welcome-file>
  </welcome-file-list>

spring-mvc文件的配置

    <!--包扫描-->
    <context:component-scan base-package="com.demo.pretest.controller"/>
    <!--注解驱动-->
    <mvc:annotation-driven/>
    <!--视图解析器-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/"/>
        <property name="suffix" value=".jsp"/>
    </bean>


    <!-- 对静态资源文件的访问， 将无法mapping到Controller的path交给default servlet handler处理 -->
    <mvc:default-servlet-handler />

    <!-- 静态资源映射 -->
    <mvc:resources mapping="/static/**" location="/static/"/>

然后在webapp下创建static文件夹，之后将静态文件就放在这个目录下

再次访问成功。but，“/*”仍然无法访问html，怎么解决呢？

参考网上，注掉了原有的视图解析器，spring-mvc.xml添加的配置：

    <!-- 设置freeMarker的html视图解析器 -->
         <bean id="freemarkerConfiguration"
             class="org.springframework.beans.factory.config.PropertiesFactoryBean">
       </bean>

     <bean id="viewResolver" class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
           <property name="exposeRequestAttributes" value="true" />
           <property name="exposeSessionAttributes" value="true" />
           <property name="viewClass">
               <value>org.springframework.web.servlet.view.freemarker.FreeMarkerView</value>
           </property>
           <property name="cache"><value>true</value></property>
           <property name="suffix"><value>.html</value></property>
           <property name="contentType">
               <value>text/html; charset=UTF-8</value>
           </property>
       </bean>

applicationContext.xml配置：

<bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
            <property name="templateLoaderPath" value="/WEB-INF/views/models/htmls/"/>
            <property name="freemarkerSettings">
                <props>
                <prop key="template_update_delay">0</prop>
                <prop key="default_encoding">UTF-8</prop>
                <prop key="number_format">0.##########</prop>
                <prop key="datetime_format">yyyy-MM-dd HH:mm:ss</prop>
                <prop key="classic_compatible">true</prop>
                <prop key="template_exception_handler">ignore</prop>
            </props>
            </property>
  </bean>

web.xml文件配置:

  
<web-app>
<display-name>Archetype Created Web Application</display-name>
  <!--Spring MVC 配置 并添加监听-->
  <context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:applicationContext.xml</param-value>
  </context-param>

  <!-- 字符过滤器 传值乱码-->
  <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>

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

  <!--前端控制器-->
  <servlet>
    <servlet-name>SpringMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring-mvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>SpringMVC</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

pom文件添加这两个jar包，注意这里spring版本是4.1.6.RELEASE：

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context-support</artifactId>
      <version>4.1.6.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.freemarker</groupId>
      <artifactId>freemarker</artifactId>
      <version>2.3.22</version>
    </dependency>

主要是这两个jar包起作用；然后controller：

    @RequestMapping(value = "/", method = RequestMethod.GET)
    public String index(){
        return "/welcome";
    }

这样就可以访问到html了；不过不怎么会使用，大多使用jsp文件就满足了

这里还有很多东西需要掌握，比如web.xml文件的加载顺序等知识点，之后会补充