Spring MVC 开发(一)

1. SpringMVC

1.1. 作用

框架:一套已经由他人编写完成的代码,用于解决特定的问题,可能会改变原有编程方式,或框架有它自身的运行流程。通常表现为某一个或多个jar包。

Spring框架的主要作用就是:创建和管理对象。

2.1. 作用

SpringMVC解决了V与C的交互问题。

在传统的基于Servlet的编程中,最大的问题在于每个Servlet只用于处理1种请求,例如某Servlet只处理注册请求,而登录功能则需要另一个Servlet,同理,退出登录、修改资料、修改密码等等功能都需要有对应的Servlet,随着项目的功能的增加,所需的Servlet的数量就会越来越多,也会导致:项目运行时,有大量的Servlet占用了服务器的内存空间!

所以,在SpringMVC中,只使用了1个DispatcherServlet去接收所有的请求,然后进行分发到不同的Controller中的某个方法,从而,减少Servlet对象的数量!

SpringMVC还提高了编码效率。

2.2. 开发流程

2.2.1. 创建项目

创建Maven Project,勾选Create a simple project,然后,Group Id通常填当前项目的根包,例如cn.tedu.springArtifact Id可以使用项目名称,例如SPRINGMVC-01-HELLOWORLDPackaging选择war,然后点击Finish,以创建项目。

默认创建的项目中并不包含web.xml文件,所以,必须生成该文件,避免项目报错。

pom.xml中添加spring-mvc的依赖代码:

<dependencies>

    <!-- SpringMVC -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>3.2.8.RELEASE</version>
    </dependency>
    
</dependencies>

然后,添加Tomcat运行环境。

然后,复制此前项目中的Spring配置文件spring-mvc.xml到当前项目中,并删除已有的配置代码,除非你确定那些代码是你需要的。

所以,以后每次创建新的项目后,都应该:1) 生成web.xml,2) 添加依赖,3) 添加Tomcat运行环境,4) 复制Spring配置文件。

2.2.2. 配置web.xml

因为在SpringMVC中,使用了DispatcherServlet接收所有的请求,然后再分发出去,所以,首先必须配置DispatcherServlet,使得它能初始阶段就运行,并接收所有请求!

即使使用了框架,核心技术其实是没有发生变化的,所以,既然要配置DispatcherServlet,就必须在web.xml中添加配置:

<!-- 配置是哪个Servlet -->
<servlet>
    <servlet-name>SpringMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 当Servlet被初始化时加载Spring配置文件 -->
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!-- 当Tomcat启动时就初始化当前Servlet -->
    <load-on-startup>1</load-on-startup>
</servlet>

<!-- 配置Servlet对应的请求路径 -->
<servlet-mapping>
    <servlet-name>SpringMVC</servlet-name>
    <url-pattern>*.do</url-pattern>
</servlet-mapping>

以上代码中,以后可能调整的有:<param-value>classpath:springmvc.xml</param-value>中Spring配置文件的文件名;<url-pattern>*.do</url-pattern>中接收的请求的名称。

当以上配置完成后,应该:当Tomcat启动时,就会初始化DispatcherServlet,用于接收*.do请求,当DispatcherServlet被初始化时,就会加载Spring的配置文件!

2.2.3. 设计目标

希望发出的请求路径是/login.do,并且,显示出webapp/WEB-INF/login.jsp

2.2.4. 控制器

在改进的做法中,不必再配置HandlerMapping

处理请求的一定是控制器,所以,创建控制器类:cn.tedu.spring.controller.UserController,即希望所有关于用户的操作的请求,都交给这个控制器来处理!控制器类都应该是整个项目的关键组件,是应该交给Spring进行管理的,所以,使用@Controller注解这个类,并且,在Spring的配置文件中,添加组件扫描。

注意:这种做法不需要实现Controller接口!并且,处理请求的方法可以自行定义返回值类型、方法名称、参数列表!

此次的目标是显示登录页面,所以,方法名可以是showLogin,由于不需要参数,所以,方法的参数列表为空,处理结束时,不需要转发任何数据,只需要确定视图组件名称即可,所以,返回值类型设计为String

public String showLogin() {
    return "login"; // WEB-INF/login.jsp
}

最后,为了确保/login.do请求能够被这个方法来处理,需要为这个方法添加注解:

@RequestMapping("login.do")
public String showLogin() {
    return "login"; // WEB-INF/login.jsp
}

添加注解后,就产生了请求路径与方法的映射关系。即:当接收到login.do请求后,就会调用以上showLogin()方法!

2.2.5. 视图解析器

在Spring的配置中添加关于视图解析器的配置:

<!-- 配置视图解析器:根据视图名称得到视图资源 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <!-- 配置前缀 -->
    <property name="prefix" value="/WEB-INF/" />
    <!-- 配置后缀 -->
    <property name="suffix" value=".jsp" />
</bean>

2.2.6. 创建视图组件

由于视图解析器配置的前缀是/WEB-INF/,后缀是.jsp,而控制器返回的视图名称是login,所以,此次响应的视图组件应该是/WEB-INF/login.jsp,所以,在/WEB-INF/下创建名为login.jsp的文件即可完成响应。

2.2.7. 常见问题

问题描述:

警告: No mapping found for HTTP request with URI [/SPRINGMVC-02-REQUESTMAPPING/login1.do] in DispatcherServlet with name 'SpringMVC'

问题原因:没有找到请求路径对应的映射,无法处理这个URI对应的请求!

解决方法:

  • 请检查控制器类是否被Spring管理,即:在Spring配置中是否开启了组件扫描,且扫描的位置是否是控制器类的包名或其父级包名!并且,控制器类是否添加了@Controller注解!

  • 请检查是否正确的配置了@RequestMapping,即:在@RequestMapping中填写的请求路径,与浏览器地址栏中输入的路径需要保持完全一致,包括.do后缀!

  • 请检查web.xml中配置的DispatcherServlet接收的请求映射,应该是*.do!

3. 关于@RequestMapping注解

3.1. 基本使用

使用@RequestMapping可以配置请求路径与处理请求的方法之间的映射关系!

使用@RequestMapping可以修饰方法,也可以修饰类!即:在类的声明之前也可以添加该注解,例如:

@Controller
@RequestMapping("user")
public class UserController {

    @RequestMapping("login.do")
    public String showLogin() {
        return "login";
    }

}

则访问时的请求路径应该是:user/login.do

所以,同样是使用@RequestMapping注解,在类之前加的注解并不能取代方法之前的注解!如果在类和方法之前都添加了该注解,其实是组合使用的!

通常,建议在每个控制器类之前都使用@RequestMapping进行注解!

在配置注解时,其中的路径可以添加/,也可以不添加,也就是:

/user       /login.do
/user       login.do
user        /login.do
user        login.do

以上4种做法都是可以正确运行的!推荐使用第1种,也就是类和方法之前的注解都添加/

3.2. 练习

请设计代码,实现对/user/reg.do的处理,最终显示/WEB-INF/reg.jsp页面。

请设计代码,实现对/product/list.do的处理,最终显示/WEB-INF/product_list.jsp页面。

页面内容不作要求!

4. 接收请求参数

4.1. 设计目标

reg.jsp中添加用户名密码的输入框,当点击提交按钮后,以POST的方式将请求提交到/user/handle_reg.do,并且 ,控制器接收到请求后,能够获取用户填写的用户名和密码。

4.2. 【不推荐】通过HttpServletRequest参数获取请求参数

在处理请求的方法中,添加HttpServletRequest类型的参数,然后调用参数对象的String getParameter(String)方法即可获取请求参数:

@RequestMapping("/handle_reg.do")
public String handleReg(HttpServletRequest request) {
    System.out.println("UserController.handleReg() > 准备接收请求参数...");
    
    // getParameter()的参数必须与jsp页面中控件的name保持一致
    String username = request.getParameter("username");
    String password = request.getParameter("password");
    System.out.println("username=" + username);
    System.out.println("password=" + password);
    
    return ""; // 暂不关心返回的视图名,后续运行会出现404
}

4.3. 练习

在界面上添加:要求输入年龄AGE,并且,在控制器接收它的值,要求是Integer类型的!

4.4. 【推荐】直接在处理请求的方法中声明所需的参数

将所需的参数列表直接添加在处理请求的方法中即可:

public String handleReg(String username, String password, 
        Integer age) {
    System.out.println("UserController.handleReg() > 准备接收请求参数...");
    
    // getParameter()的参数必须与jsp页面中控件的name保持一致
    System.out.println("username=" + username);
    System.out.println("password=" + password);
    System.out.println("age=" + age);
    
    return "a"; // 暂不关心返回的视图名,后续运行会出现404
}

使用这种做法,无须调用HttpServletRequest对象的getParameter()方法,甚至都不需要考虑类型转换问题,例如所需的ageInteger类的,则直接声明参数Integer age即可,SpringMVC框架会自动的转换类型!

注意:使用这种做法,必须前后端使用的名称保持一致,例如前端页面中标签的name值是username,则后端控制器的方法中的参数名称也必须是username,如果不一致,则后端控制器获取到的值将是null值!

注意:如果前端页面没有输入值,则控制器接收到的是空字符串,即"",如果前端页面根本就没有提交这个名称的参数,则控制器接收到的是null!

由于前后端可能是不同的开发团队完成的,则很可能出现名称不一致的问题,针对这种问题,可以在参数之前添加@RequestParam("前端提交的参数名")来解决:

@RequestMapping("/handle_reg.do")
public String handleReg(
        @RequestParam("username") String name, 
        String password, Integer age) {
    System.out.println("UserController.handleReg() > 准备接收请求参数...");
    
    // getParameter()的参数必须与jsp页面中控件的name保持一致
    System.out.println("name=" + name);
    System.out.println("password=" + password);
    System.out.println("age=" + age);
    
    return "a"; // 暂不关心返回的视图名,后续运行会出现404
}

注意:当添加了@RequestParam()注解后,该参数默认是必须提交的,如果没有提交,则报错,该问题后续在@RequestParam专题中详解。

2. 请求类型的GET与POST

发出请求

只能通过表单(Form)或Javascript代码发出POST请求,而发出GET请求的方式则更多,除了这2种做法以外,还可以通过改变浏览器的地址栏中的URL来发出GET请求!所以,发GET请求比发POST请求更加简单!

传输特点

GET请求的参数会暴露在URL中,不适合传输较私密的数据,例如密码,并且,受到URL长度的限制,GET请求不适合传递大量的数据,例如发邮件、上传文件都不可以使用GET请求!

POST请求的参数不会暴露在URL中,可以传输任何数据(传输过程没有额外的加密处理),并且,传输数据没有长度限制!

相比之下,POST请求更加有优势,但是,POST请求的发出限制略高,不便于刷新,并且,无法分享页面!

3. 查看项目的错误

如果项目结构(Eclipse的左侧)提示了任何错误,都应该在Problems面板中查看详情,有些错误可能并不体现在某个文件或代码中。

如果Eclipse默认没有显示该面板,可以点击Window菜单中的Show View项打开,如果在Show View下仍没有Problems,可以选择Other项再查找。

4. 切换JDK/JRE版本

移除旧版本

Libraries下,对旧版的JDK/JRE点右键,选择Build Path中的Remove ...选项,即可移除。

添加新版本

对项目名称点右键,选择Build Path中的Configure,在弹出的对话框中,选择Libraries选项卡,然后点击右侧的Add Library按钮,在弹出的新对话框中选择JRE System Library并点击Next,通常在下个界面中第3项即是当前系统安装的JDK/JRE版本!

如果在这个面板中没有所需的JDK/JRE版本,则点击Installed JREs按钮并浏览到本机中安装JDK/JRE的目录进行选择即可。

5. 使用自定义的数据类型接收请求参数

可以自定义某个数据类型,对应所有的请求参数:

public class User {

    private String username;
    private String password;
    private Integer age;

    // ...
}

然后,在处理请求的方法中,直接将这个类型作为参数即可:

@RequestMapping("/handle_reg.do")
public String handleReg(User user) {
    System.out.println(user);
    return null;
}

注意:使用这种做法也必须保证提交的参数名称,与自定义类型中的属性名称,必须保持一致!如果没有保持一致,则获取到的对象的那些属性将是null值!

小结

在SpringMVC中,处理请求时,有3种方式可以接收请求参数,实际使用的有:直接声明同名参数、使用自定义数据类型,如果有必要的话,这2种方式可以组合使用!

当使用同名参数接收请求参数时,如果名称不一致,可以使用@RequestParam()注解来确定请求参数的名称。

猜你喜欢

转载自www.cnblogs.com/wood-life/p/10289298.html
今日推荐