快速搭建一个SpringMVC项目

本文不讲原理,只讲使用,原理放在另一篇文章上
想省时间的话,把项目结构建了,依赖导了之后直接看使用注解实现,restful风格和乱码问题可以跳过,乱码问题遇到了再看就行
建议配合目录使用

1.快速搭建简单的SpringMVC项目

关于项目路径

需要导入的依赖

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.1.10.RELEASE</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
        <scope>provided</scope>
    </dependency>

    <!--JSP依赖-->
    <dependency>
        <groupId>javax.servlet.jsp</groupId>
        <artifactId>javax.servlet.jsp-api</artifactId>
        <version>2.3.3</version>
    </dependency>

    <!--JSTL表达式的依赖-->
    <dependency>
        <groupId>javax.servlet.jsp.jstl</groupId>
        <artifactId>jstl-api</artifactId>
        <version>1.2</version>
    </dependency>

    <!--standard标签库-->
    <dependency>
        <groupId>taglibs</groupId>
        <artifactId>standard</artifactId>
        <version>1.1.2</version>
    </dependency>

</dependencies>

方法一,非注解实现

1.在web.xml中注册mvc的DispatcherServlet

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

    <!--注册DispatcherServlet-->
    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--关联一个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>

2.配置spring的配置springmvc-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">

	<!--配置处理器映射-->
    <bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>
    
    <!--配置处理器适配器-->
    <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>

    <!--视图解析器对DispatcherServlet给它的ModelAndView做处理-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="InternalResourceViewResolver">
        <!--前缀-->
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <!--后缀-->
        <property name="suffix" value=".jsp"/>
    </bean>

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

3.创建Controller

package com.Gw.controller;

import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

import javax.naming.ldap.Control;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class HelloController implements Controller {
    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        ModelAndView mv = new ModelAndView();

        mv.addObject("msg","helloSpringMVC");

        mv.setViewName("hello");  //被视图解析器处理->hello.jsp

        return mv;
    }
}

4.创建对应的视图hello.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>yGw</title>
</head>
<body>
${msg}
</body>
</html>

方法二,注解实现

1.在web.xml中注册mvc的DispatcherServlet

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

    <!--注册DispatcherServlet-->
    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--关联一个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>

2.配置Spring,加入context:component-scan、mvc:default-servlet-handler、mvc:annotation-driven,以便使用注解

注意:头文件的链接也需要加上,不然名空间namespace不可用

<?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/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">

    <!--自动扫描包,让指定包下的注解生效,由IOC容器统一管理-->
    <context:component-scan base-package="com.Gw.controller"/>

    <!--让SpringMVC不处理静态资源-->
    <mvc:default-servlet-handler/>

    <!--用annotation-driven代替handlerMapping和handlerAdapter-->
    <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>

3.编写controller,使用@Controller和@RequestMapping注解

package com.Gw.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller  //指明这是一个Controller,包含很多个servlet

@RequestMapping("/helloController")  //自己定义网页的url
//@RequestMapping()是既可以作用在方法上,也可以作用在类上

public class helloController{
	
    @RequestMapping("/hello1")
    public String hello(Model model){
        
       	//获取模型,从数据库获取数据
        model.addAttribute("msg", "helloAnnotation1");
        
        //选择指定的视图来显示后端数据,跳转到对应的页面
        return "hello";  //被视图解析器处理->/WEB-INF/jsp/hello.jsp
        
    }
    
    //可以为相同的jsp文件用不同的路径来调用不同的方法
    @RequestMapping("/hello2")
    public String hello(Model model){
        model.addAttribute("msg", "helloAnnotation2");
        return "hello";
        //如果选择重定向则为:return "redirect: /index.jsp",此时跳过了视图解析器
        //也可以使用:return "forward: /WEB-INF/jsp/hello.jsp",绕过视图解析器显示指明转发方式
    }
    
}


  • 在Controller中的方法如果返回值是String,并且存在对应的视图,则会被视图解析器自动解析
  • 视图解析器的说明,在方法中返回的字符串默认是转发,如果选择重定向需要加上redirect, 如return “redirect: /index.jsp”

2.RESTful风格

将http://localhost:8080/add?a=1&b=2转变为http://localhost:8080/add/1/2

  • 通过请求的方式判断来实现不同的功能:@GetMapping-查询、@DeleteMapping-删除、@PostMapping-新增、@PutMapping-更新
  • 在url中使用的变量需要@PathVariable
  • RESTful风格实际上是url的一种创建规则,对用户隐藏了服务器中的参数的细节,更安全
package com.Gw.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;

@Controller
public class RestFulController {

    //同一个url同一个jsp页面,调用的方法不同,得到的结果也不同
    
    @RequestMapping("/add/{a}/{b}")  //a、b为前端传回的值
    String test(@PathVariable int a, @PathVariable int b, Model model){
        model.addAttribute("msg",a+0*b);
        return "hello";
    }
    //以get方式请求时调用该页面
    @GetMapping("/add/{a}/{b}")  //<=>@RequestMapping(value = "add/{a}/{b}", method = {RequestMethod.GET})
    String test1(@PathVariable int a, @PathVariable int b, Model model){
        model.addAttribute("msg",a+1*b);
        return "hello";
    }
    @PostMapping("/add/{a}/{b}")  //提交表单时调用该页面
    String test2(@PathVariable int a, @PathVariable int b, Model model){
        model.addAttribute("msg",a+2*b);
        return "hello";
    }
    //以delete方式请求时调用该页面
    @DeleteMapping("/add/{a}/{b}")
    String test3(@PathVariable int a, @PathVariable int b, Model model){
        model.addAttribute("msg",a+3*b);
        return "hello";
    }
    //以put方式请求时调用该页面
    @PutMapping("/add/{a}/{b}")
    String test4(@PathVariable int a, @PathVariable int b, Model model){
        model.addAttribute("msg",a+4*b);
        return "hello";
    }
}

3.前端传参和后端传数据的问题

前端传参给Controller

1.域名称和参数名一致,直接用就行;http://localhost:8080/hello?name=ygw

@RequestMapping("/hello")
public String hello(String name){
    System.out.println(name)
    return "hello";
}

2.域名称和参数名不一致,使用@RequestParam注解指定域名称;http://localhost:8080/hello?username=ygw

@RequestMapping("/hello")
public String hello(@RequestParam("username")String name){
    System.out.println(name)
    return "hello";
}

3.如果前端提交的是一个对象,并且url上的变量名与对象中的变量名对应的部分直接赋值,不对应的变量默认为null,则可以直接给对象中的变量赋值

@RequestMapping("/hello")
public String hello(User user){
    System.out.println(user.toString())
    return "hello";
}

数据库返回模型给视图

1.Model 继承了ModelMap,大部分情况下使用Model

@RequestMapping("/hello")
public String hello(User user, Model model){
    model.addAttribute("msg", "hello")
    System.out.println(user.toString())
    return "hello";
}

2.ModelMap继承了LinkedHashMap

3.ModelAndView几乎不用

乱码问题

问题出现在java层面,前端数据正常,sout输出乱码,需要加一层过滤器解决

利用spring解决乱码问题,在web.xml中添加spring自带的过滤器

<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>
    <!--将.jsp文件也进行一个过滤-->
</filter-mapping>

如果还是解决不了,使用下面的这个过滤器

package com.Gw.filter;

import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletRequestWrapper;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.util.Map;

/**
* 解决get和post请求 全部乱码的过滤器
*/
public class GenericEncodingFilter implements Filter {

   @Override
   public void destroy() {
  }

   @Override
   public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
       //处理response的字符编码
       HttpServletResponse myResponse=(HttpServletResponse) response;
       myResponse.setContentType("text/html;charset=UTF-8");

       // 转型为与协议相关对象
       HttpServletRequest httpServletRequest = (HttpServletRequest) request;
       // 对request包装增强
       HttpServletRequest myrequest = new MyRequest(httpServletRequest);
       chain.doFilter(myrequest, response);
  }

   @Override
   public void init(FilterConfig filterConfig) throws ServletException {
  }

}

//自定义request对象,HttpServletRequest的包装类
class MyRequest extends HttpServletRequestWrapper {

   private HttpServletRequest request;
   //是否编码的标记
   private boolean hasEncode;
   //定义一个可以传入HttpServletRequest对象的构造函数,以便对其进行装饰
   public MyRequest(HttpServletRequest request) {
       super(request);// super必须写
       this.request = request;
  }

   // 对需要增强方法 进行覆盖
   @Override
   public Map getParameterMap() {
       // 先获得请求方式
       String method = request.getMethod();
       if (method.equalsIgnoreCase("post")) {
           // post请求
           try {
               // 处理post乱码
               request.setCharacterEncoding("utf-8");
               return request.getParameterMap();
          } catch (UnsupportedEncodingException e) {
               e.printStackTrace();
          }
      } else if (method.equalsIgnoreCase("get")) {
           // get请求
           Map<String, String[]> parameterMap = request.getParameterMap();
           if (!hasEncode) { // 确保get手动编码逻辑只运行一次
               for (String parameterName : parameterMap.keySet()) {
                   String[] values = parameterMap.get(parameterName);
                   if (values != null) {
                       for (int i = 0; i < values.length; i++) {
                           try {
                               // 处理get乱码
                               values[i] = new String(values[i]
                                      .getBytes("ISO-8859-1"), "utf-8");
                          } catch (UnsupportedEncodingException e) {
                               e.printStackTrace();
                          }
                      }
                  }
              }
               hasEncode = true;
          }
           return parameterMap;
      }
       return super.getParameterMap();
  }

   //取一个值
   @Override
   public String getParameter(String name) {
       Map<String, String[]> parameterMap = getParameterMap();
       String[] values = parameterMap.get(name);
       if (values == null) {
           return null;
      }
       return values[0]; // 取回参数的第一个值
  }

   //取所有值
   @Override
   public String[] getParameterValues(String name) {
       Map<String, String[]> parameterMap = getParameterMap();
       String[] values = parameterMap.get(name);
       return values;
  }
}

然后在web.xml中注册

<filter>
    <filter-name>encoding</filter-name>
    <filter-class>com.Gw.Filter.GenericEncodingFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>encoding</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
posted @ 2022-07-16 17:01  CDUT的一只小菜鸡  阅读(708)  评论(0编辑  收藏  举报