看年薪50W的架构师如何手写一个SpringMVC框架

程序员文章站 2023-10-16 23:27:05

前言做 Java Web 开发的你，一定听说过SpringMVC的大名，作为现在运用最广泛的Java框架，它到目前为止依然保持着强大的活力和广泛的用户群。本文介绍如何用eclipse一步一步搭建SpringMVC的最小系统，所谓最小系统，就是足以使项目在SpringMVC框架下成功跑起来，并且能 ......

前言

做 java web 开发的你，一定听说过springmvc的大名，作为现在运用最广泛的java框架，它到目前为止依然保持着强大的活力和广泛的用户群。

本文介绍如何用eclipse一步一步搭建springmvc的最小系统，所谓最小系统，就是足以使项目在springmvc框架下成功跑起来，并且能够做一些简单的事情（比如访问页面）的系统。

在开始之前，想提几个问题让大家思考一下：

为什么要手写springmvc？
如何手写一个springmvc？
手写的springmvc真的可以跑起来吗？

让我们开始吧。

其他环境：
操作系统：windos 10
tomcat ： v7.0
jdk : 1.7

正文

1. 新建一个项目

image

我们用eclipse新建项目，选择dynamic web project(动态的web项目)。

点击next

image

project name里面写上 springmvc，这就是我们项目的名称，其他不用改，直接点击finish 。

ok，项目就建好了。

接下来一定要将项目的字符集改为utf-8

右键项目properties

改为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

内容如下：

1 <%@ page language="java" contenttype="text/html; charset=utf-8" pageencoding="utf-8"%>
2 <html>
3     <head>
4         <meta charset="utf-8" />
5     </head>
6     <body>
7         恭喜，web項目已經成功搭建！
8     </body>
9 </html>

我们现在就将这个项目部署到tomcat,来验证是否可以跑起来。

在项目上右键——debug as——debug on server

直接点击finish

经过一段时间，控制台开始打印日志信息，当我们看到这些信息的时候，说明tomcat已经启动完毕了。

让我们打开浏览器，在地址栏输入以下信息

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

我电脑上tomcat配置的端口号是8088，具体情况视你自己的tomcat决定，可能是8080等。

可见，能够成功访问页面了，这说明我们到目前为止的操作是正确的。

4. 集成`springmvc`

我们在web.xml文件里面添加下面的配置

4.1 配置监听器

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

<listener>
    <listener-class>org.springframework.web.util.introspectorcleanuplistener</listener-class>
</listener>

4.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>

4.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文件。

image

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

4.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，images 都需要放在/resources目录下，这个目录现在我们还没有建。
所有的展示页面，比如jsp文件，都需要放置在/web-inf/pages目录下，这个目录现在我们也没有建。
ok，我们把对应的目录加上。

首先是java文件的目录。

我们在这个地方右键，新建一个 com 包,再在里面建一个springmvc 包，或者用 . 的方式一起建。

点击finish

根据springmvc的分层，我们在springmvc 包下面建三个包，分别是controller ， service， dao

这样的话，当我们项目一旦启动，springmvc就会扫描这三个包，将里面但凡是有注解的类都提取起来，放进spring容器（或者说spring的bean工厂），借由spring容器来统一管理。这也就是你从来没有去new一个controller的原因。

接下来，我们来建静态资源的目录。

在webcontent目录下新建一个resources文件夹。

然后顺便把js，css，img的文件夹都建一下，这里就存放我们的静态资源文件。

最后，我们在web-inf目录下建一个pages文件夹，作为展示页面的存放目录。

将之前的index.jsp拷贝进来。

这样就配置的差不多了。

5. 导包和验证

我们将jar包放到lib目录：

然后启动项目，验证一下到目前为止的构建是否正确。

打开servers视图，点击如图像是甲虫一样的图标。

发现报错了，错误信息如下：

错误：
could not open servletcontext resource [/web-inf/applicationcontext.xml]

它说我们在web-inf下面少了一个applicationcontext.xml这个文件，原来，我们少了对springbean工厂的配置，它的意思就是说，我们要规定一下，在spring容器启动的时候，需要自动加载哪些东西？

于是，我们把 applicationcontext.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: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。

这回不报错了。

6. 配置`viewcontroller`

我们知道，web-inf目录下的任何资源都是无法直接通过浏览器的url地址去访问的，保证了安全性。这也是我们为什么把页面都放在该目录下的原因。

为了有所区分，我们还单独建立了一个pages文件夹，将这些页面保存起来。

现在，为了访问这个页面，我们需要用到springmvc的页面跳转机制。

我们在controller包下新建一个viewcontroller

点击finish

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;

@controller
public 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

结果：

没关系，我们看他报什么错。

message /springmvc/web-inf/pagesindex.jsp

pagesindex.jsp是什么鬼？？

原来，在dispatcher-servlet.xml中，我们少写了一个 "/"

添上去就行了。

保存后，因为修改了xml配置文件，因此我们还是需要重新启动tomcat。

启动完成后，继续！

成功了。

7. 引入静态资源

比如，我在resources/img目录下放了一张图片，怎么引入到index.jsp呢？

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

的确，这是一种方式。可是，它有一个缺点就是根路径写死了，我们肯定不希望这样的。

其实，我们可以在viewcontroller里面拿到项目根路径，然后传递到jsp页面就ok了。

我们把调试信息 “恭喜，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值。

成功了！

获取资料

本次给大家推荐一个免费的学习群，里面概括java架构/分布式/微服务/docker/高性能高并发以及面试资源等。
对java架构感兴趣的程序猿，欢迎加入q群：790047143，不管你是刚入行得还是大牛我都欢迎，还有大牛整理的一套高效率学习路线和教程与您免费分享，同时每天更新视频资料。
最后，祝大家早日学有所成。

上一篇： java设计模式--迭代器模式

下一篇：中兴AXON 10 Pro 5G版8月5日正式开售：国内首款！

看年薪50W的架构师如何手写一个SpringMVC框架

前言

正文

1. 新建一个项目

2. 编写 web.xml

3. 验证web项目是否搭建成功

4. 集成springmvc

4.1 配置监听器

4.2 配置过滤器，解决post乱码问题

4.3 配置springmvc分发器，拦截所有请求

4.4 编写dispatcher-servlet.xml

5. 导包和验证

6. 配置viewcontroller

7. 引入静态资源

获取资料