Spring MVC 入门指南

Spring MVC 入门指南

发布时间:2024-10-11 13:08:56

1. 设置开发环境

首先,确保您的开发环境中已安装以下工具:

  • java development kit (jdk) 8 或更高版本
  • maven 或 gradle(本指南使用 maven)
  • ide(如 intellij idea 或 eclipse)

2. 创建 maven 项目

创建一个新的 maven 项目,并在 pom.xml 中添加 spring mvc 依赖:

xml


4.0.0
com.example
spring-mvc-demo
1.0-snapshot
war


5.3.9



org.springframework
spring-webmvc
${spring.version}


javax.servlet
javax.servlet-api
4.0.1
provided




org.apache.maven.plugins
maven-war-plugin
3.3.1



3. 配置 web.xml

src/main/webapp/web-inf 目录下创建 web.xml 文件:

xml

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_3_1.xsd"
version="3.1">


dispatcher
org.springframework.web.servlet.dispatcherservlet
1


dispatcher
/

4. 创建 spring 配置文件

src/main/webapp/web-inf 目录下创建 dispatcher-servlet.xml

xml


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
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd">





5. 创建控制器

src/main/java/com/example 目录下创建 hellocontroller.java

java

package com.example;

import org.springframework.stereotype.controller;
import org.springframework.ui.model;
import org.springframework.web.bind.annotation.getmapping;

@controller
public class hellocontroller {

@getmapping("/hello")
public string hello(model model) {
model.addattribute("message", "hello, spring mvc!");
return "hello";
}
}

6. 创建视图

src/main/webapp/web-inf/views 目录下创建 hello.jsp

jsp

<%@ page contenttype="text/html;charset=utf-8" language="java" %>


hello spring mvc


${message}



7. 运行应用

使用 maven 命令编译和运行应用:

 

mvn clean package
mvn jetty:run

访问 http://localhost:8080/hello 查看结果。

故障排查

  1. 404 错误(not found)
    • 检查 url 映射是否正确
    • 确保控制器类有 @controller 注解
    • 验证 component-scan 的基础包是否正确
  2. 500 错误(internal server error)
    • 检查服务器日志以获取详细错误信息
    • 确保所有必需的依赖都已正确添加
    • 检查 java 代码中的异常
  3. 视图解析问题
    • 确保 viewresolver 配置正确
    • 检查视图文件的位置和名称是否与控制器返回的字符串匹配
  4. 静态资源不加载
    • 在 spring 配置中添加 标签
    • 检查静态资源的位置是否正确
  5. 参数绑定失败
    • 检查方法参数名称是否与表单字段名称匹配
    • 使用 @requestparam 注解明确指定参数名称
  6. bean 注入失败
    • 确保使用了正确的注解(如 @autowired
    • 检查 bean 是否在 spring 容器中注册
  7. 字符编码问题
    • 配置 characterencodingfilterweb.xml
  8. json 转换问题
    • 确保 jackson 库在类路径中
    • 使用 @responsebody 注解标记方法

调试技巧:

  • 使用日志框架(如 log4j 或 slf4j)记录关键信息
  • 利用 ide 的调试功能设置断点
  • 使用 spring 的 debug 级别日志查看详细的框架行为

记住,spring mvc 提供了强大的定制能力。随着你的深入学习,你可以探索更多高级特性,如拦截器、自定义参数解析器等。

--------------------------------------------------------------

这个指南涵盖了 spring mvc 的基础知识,包括项目设置、配置、创建控制器和视图,以及运行应用程序。我还提供了一些常见问题的故障排查建议。

spring mvc 是一个功能丰富的框架,这个指南只是一个入门级的介绍。随着你的深入学习,你可能会需要了解更多高级特性,如:

  1. restful web 服务
  2. 表单处理和数据验证
  3. 文件上传
  4. 异常处理
  5. 国际化
  6. 安全性(使用 spring security)

感谢提供:05互联