本文共 4075 字，大约阅读时间需要 13 分钟。

SpringMVC入门实践——搭建一个简单的水果管理系统

刚接触SpringMVC可能会感到无从下手，但我觉得最好的学习办法就是手动搭建一个小项目来理解它的工作原理。本文将详细记录从项目搭建到最终部署的整个过程，帮助你快速上手SpringMVC.

主页面显示

项目启动后，访问http://localhost:8080/SpringMVC_test/会呈现默认欢迎页面。请注意：

• 这个页面不会显示图片，是因为图片链接在本地开发环境下需要更复杂的配置，这里只方便展示文字内容。
• 如果你看到空白页面，不要忧心，说明index.jsp文件已经成功加载。

水果信息页面

访问http://localhost:8080/SpringMVC_test/fruits.action，你就接触到了SpringMVC的动态路由能力。页面会显示：

• 水果列表
• 每个水果的名称和价格

页面内容会实时更新，这是由后端模型驱动的。

项目结构

在SpringMVC_test目录下是你的SpringMVC项目目录。文件结构如下：

├── pom.xml        前言├── web.xml        web配置文件├── Fruit.java     水果实体类├── FruitsController.java    水果控制器├── FruitService.java    水果业务逻辑├── fruitsList.jsp      显示水果列表的JSP页面├── index.jsp         欢迎页面├── springmvc.xml     SpringMVC配置文件└── WEB-INF/        项目私有文件夹    ├── jsps/         JSP页面存放位置    └── web.xml      默认页面配置

第一步：配置Dependencies

在pom.xml中添加必要的依赖：

       
            
     
      junit
             
     
      junit
             
     
      4.11
             
     
      test
         
        
            
     
      org.springframework
             
     
      spring-web
             
     
      5.0.8.RELEASE
         
        
            
     
      org.springframework
             
     
      spring-webmvc
             
     
      5.0.8.RELEASE
         
        
            
     
      javax.servlet
             
     
      javax.servlet-api
             
     
      4.0
             
     
      provided
         
        
            
     
      javax.servlet
             
     
      jstl
             
     
      1.2
         
        
            
     
      taglibs
             
     
      standard
             
     
      1.1.2
         
    
   

第二步：配置web.xml

web.xml是SpringMVC的核心配置文件，主要配置DispatcherServlet：

   
       
    
     Archetype Created Web Application
        
            
     
      springmvc
             
     
      org.springframework.web.servlet.DispatcherServlet
             
                 
      
       contextConfigLocation
                  
      
       classpath:springmvc/springmvc.xml
              
         
        
            
     
      springmvc
             
     
      *.action
         
        
            
     
      index.jsp
         
    
   

请注意：

• DispatcherServlet负责将请求路由到适当的处理器
• *.action是默认的路由规则，适用于我们定义的/fruits.action

第三步：配置实体类

创建Fruit.java文件，定义水果实体：

public class Fruit {    private String name;    private Integer price;    public Fruit(String name, Integer price) {        this.name = name;        this.price = price;    }    // 以下为常用方法，实际项目中需要根据需求添加get和set方法}

第四步：实现控制器接口

创建FruitsController.java文件，实现SpringMVC的Controller接口：

public class FruitsController implements Controller {    public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws Exception {        FruitService fruitService = new FruitService();        List
   
     fruits = fruitService.queryFruitsList();        ModelAndView modelAndView = new ModelAndView();        modelAndView.addObject("fruits", fruits);        modelAndView.setViewName("/WEB-INF/jsp/fruitsList.jsp");        return modelAndView;    }}
   

同时注意FruitService.java：

public class FruitService {    public List
   
     queryFruitsList() {        List
    
      list = new ArrayList<>();        list.add(new Fruit("苹果", 5));        list.add(new Fruit("火龙果", 7));        list.add(new Fruit("雪莲果", 4));        return list;    }}
    
   

请注意：

• 这里省略了set和get方法的实现，实际项目中需要根据需求添加
• 通过modelAndView对象添加了水果数据，并指定了显示页面

第五步：配置JSP页面

在WEB-INF/jsps/目录下创建fruitsList.jsp文件：

    
新鲜水果
               ${varfrt.count}        ${fruit.name}        ${fruit.price}    
   

请注意：

• 为了保证视图的安全性，JSP文件需要放在WEB-INF/jsps/目录下
• /WEB-INF/目录属于项目私有文件夹
• 使用JSTL标签时需要正确导入jstl和c标签库

第六步：配置视图解析器

在springmvc.xml文件中添加视图解析器配置：

请注意：

• 这里的InternalResourceViewResolver用于将逻辑名转换为物理路径
• prefix和suffix属性用于指定默认路径

完整项目部署流程

请注意：

• 如果需要添加新的水果或者修改现有的水果信息，只需要修改FruitService类中的queryFruitsList()方法
• 如果需要扩展系统功能，可以按照SpringMVC的idesign理念逐步添加新的Controller和Service逻辑