基于xml、基于注解实现Hello SpringMVC程序

写在前面:

  1. 基于注解实现 Hello SpringMVC(springmvc-02-hellomvc)
  2. 基于注解实现 Hello SpringMVC(springmvc-02-anno)

1. 基于 xml 配置文件实现

  1. 新建一个 Moudle , springmvc-02-hello , 添加 web 的支持!
  2. 确定导入了 SpringMVC 的依赖!
    <dependencies>
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>javax.servlet.jsp-api</artifactId>
            <version>2.3.3</version>
        </dependency>

        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>javax.servlet.jsp.jstl</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.2.0.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>2.5</version>
        </dependency>
    </dependencies>
  1. 配置 web.xml , 注册 DispatcherServlet;绑定 Spring 配置文件 (spring-servlet.xml)
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
         version="5.0">

    <!-- 1.注册DispatcherServlet -->
    <!-- 接收请求、拦截请求 -->
    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 绑定Spring配置文件 -->
        <!-- 关联一个springmvc的配置文件:【servlet-name】-servlet.xml-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc-servlet.xml</param-value>
        </init-param>
        <!--启动级别-1-->
        <load-on-startup>1</load-on-startup>
    </servlet>

    <!--/ 匹配所有的请求;(不包括.jsp)-->
    <!--/* 匹配所有的请求;(包括.jsp)-->
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>
  1. 编写 SpringMVC 的配置文件!名称:springmvc-servlet.xml : [servletname]-servlet.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"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd">

    <!-- 添加 处理映射器 -->
    <!-- 根据url查找控制器 -->
    <bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping" />

    <!-- 添加 处理器适配器 -->
    <!-- 其按照特定的规则去执行Handler -->
    <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter "/>

    <!--视图解析器:DispatcherServlet给他的ModelAndView-->
    <!-- 1.获取了 ModelAndView 的数据
         2. 解析了 ModelAndView 的视图名字
         3. 拼接视图名字,找到对应的视图 /WEB-INF/jsp/hello.jsp
         4. 将数据渲染视图 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="InternalResourceViewResolver">
        <!--前缀-->
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <!--后缀-->
        <property name="suffix" value=".jsp"/>
    </bean>

    <!--Handler-->
    <!-- 注册HelloController -->
    <bean id="/hello" class="com.controller.HelloController"/>

</beans>
  1. 编写我们要操作业务 Controller ,实现 Controller 接口;需要返回一个
    ModelAndView,装数据,封视图;同时在 springmvc-servlet.xml 中注册bean
public class HelloController implements Controller {
    
    
    @Override
    public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws Exception {
    
    
        // ModelAndView 模型和视图
        ModelAndView mv = new ModelAndView();

        // 封装对象,放在 ModelAndView 中
        mv.addObject("message","HelloSpringMVC!");

        // 封装要跳转的视图,放在 ModelAndView 中
        mv.setViewName("hello"); // /WEB-INIF/jsp/hello.jsp
        return mv;
    }
}
  1. 写要跳转的 jsp 页面,显示 ModelandView 存放的数据,以及我们的正常页面;
<%@ page contentType="text/html; charset=UTF-8" language="java" %>

<html>
<head>
    <title>Title</title>
</head>
<body>
    ${message}
</body>
</html>
  1. 配置 Tomcat 启动测试

2. 基于注解实现 [ 重要!]

注解版实现,才是 SpringMVC 的精髓!

  1. 新建一个Moudle,springmvc-03-hello-annotation 。添加 web 支持!
    建立包结构 com.kuang.controller
  2. 由于 Maven 可能存在资源过滤的问题,我们将配置完善
    <build>
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>
    </build>
  1. 在 pom.xml 文件引入相关的依赖:主要有 Spring 框架核心库、Spring MVC、servlet , JSTL等。

  2. 配置web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
         version="5.0">

    <!-- 1.注册DispatcherServlet -->
    <!-- 接收请求、拦截请求 -->
    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 绑定Spring配置文件 -->
        <!-- 关联一个springmvc的配置文件:【servlet-name】-servlet.xml-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc-servlet.xml</param-value>
        </init-param>
        <!--启动级别-1-->
        <load-on-startup>1</load-on-startup>
    </servlet>

    <!--/ 匹配所有的请求;(不包括.jsp)-->
    <!--/* 匹配所有的请求;(包括.jsp)-->
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>

注意:/ 和 /* 的区别:

< url-pattern > / </ url-pattern > 不会匹配到.jsp, 只针对我们编写的请求;即:.jsp 不会进入spring的 DispatcherServlet类 。 
< url-pattern > /* </ url-pattern > 会匹配*.jsp, 会出现返回 jsp视图 时再次进入spring的DispatcherServlet 类,导致找不到对应的controller所以报404错。
  1. 添加 Spring MVC 配置文件(spring-servlet.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:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.springframework.org/schema/context
       https://www.springframework.org/schema/context/spring-context.xsd
       http://www.springframework.org/schema/mvc
       https://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!-- 自动扫描包,让指定包下的注解生效,由IOC容器统一管理 -->
    <context:component-scan base-package="com.controller"/>
    <!-- 让Spring MVC不处理静态资源 -->
    <mvc:default-servlet-handler />

    <!-- 支持mvc注解驱动 在spring中一般采用@RequestMapping注解来完成映射关系
    要想使@RequestMapping注解生效
    必须向上下文中注册DefaultAnnotationHandlerMapping
    和一个AnnotationMethodHandlerAdapter实例
    这两个实例分别在类级别和方法级别处理。
    而annotation-driven配置帮助我们自动完成上述两个实例的注入。 -->
    <mvc:annotation-driven />

    <!-- 视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver "
          id="internalResourceViewResolver">
        <!-- 前缀 -->
        <property name="prefix" value="/WEB-INF/jsp/" />
        <!-- 后缀 -->
        <property name="suffix" value=".jsp" />
    </bean>


</beans>
  1. 创建Controller
    编写一个Java控制类: com.controller.HelloController , 注意编码规范
@Controller
@RequestMapping("/HelloController")
public class HelloController {
    
    

    // 真实访问地址: localhost:8080/HelloController/hello
    @RequestMapping("/hello")
    public String sayHello(Model model){
    
    
        // 向模型中添加属性值message,可以与JSP页面中取出并渲染
        model.addAttribute("message","Hello SpringMVC!!!");
        // WEB-INF/jsp/hello.jsp
        return "hello";
    }
}
  • @Controller 是为了让 Spring IOC 容器初始化时自动扫描到;
  • @RequestMapping 是为了映射请求路径,这里因为类与方法上都有映射所以访问时应该是 /HelloController/hello;
  • 方法中声明 Model 类型的参数是为了把 Action 中的数据带到视图中;
  • 方法返回的结果是视图的名称 hello,加上配置文件中的前后缀变成 WEB-INF/jsp/hello.jsp。
  1. 创建视图层
    在WEB-INF/ jsp目录中创建hello.jsp , 视图可以直接取出并展示从Controller带回的信息;可以通过EL表示取出Model中存放的值,或者对象。
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
${
    
    message}
</body>
</html>
  1. 配置 Tomcat 运行

    ok! 运行成功!!!

3. 可能遇到的问题

可能遇到的问题:访问出现404,排查步骤:

  1. 查看控制台输出,看一下是不是缺少了什么jar包。
  2. 如果jar包存在,显示无法输出,就在IDEA的项目发布中,添加lib依赖!
  3. 重启Tomcat 即可解决!

4. 总结

实现步骤其实非常的简单:

  1. 新建一个web项目
  2. 导入相关 jar 包 3. 编写 web.xml , 注册 DispatcherServlet
  3. 编写 springmvc 配置文件
  4. 接下来就是去创建对应的控制类 , controller
  5. 最后完善前端视图和 controller 之间的对应
  6. 测试运行调试.
    使用 springMVC 必须配置的三大件:
    处理器映射器、处理器适配器、视图解析器
    通常,我们只需要手动配置视图解析器,而处理器映射器处理器适配器只需要开启注解驱动即可,而省去了大段的 xml 配置。

猜你喜欢

转载自blog.csdn.net/Kc635908933/article/details/114821793