在Java Web开发中,SpringMVC框架因其高效、易用和高度集成Spring框架的特点而备受开发者喜爱。本文将带你通过一个实战项目来解析SpringMVC框架的使用,帮助你轻松上手。
一、项目简介
本项目将创建一个简单的在线书店,实现书籍的增删改查功能。通过这个项目,你可以了解到SpringMVC框架的基本使用方法,包括控制器、视图和模型等组件。
二、项目环境
- 开发工具:IntelliJ IDEA
- 开发语言:Java
- 数据库:MySQL
- 版本控制:Git
- 构建工具:Maven
三、项目结构
项目采用Maven构建,目录结构如下:
online-bookstore
├── src
│ ├── main
│ │ ├── java
│ │ │ └── com
│ │ │ └── example
│ │ │ └── onlinebookstore
│ │ │ ├── controller
│ │ │ │ └── BookController.java
│ │ │ ├── model
│ │ │ │ └── Book.java
│ │ │ ├── service
│ │ │ │ └── BookService.java
│ │ │ ├── dao
│ │ │ │ └── BookDao.java
│ │ │ └── utils
│ │ │ └── DatabaseUtil.java
│ │ ├── resources
│ │ │ ├── application.properties
│ │ │ └── sqlMapConfig.xml
│ │ └── webapp
│ │ ├── WEB-INF
│ │ │ ├── web.xml
│ │ │ └── views
│ │ └── index.jsp
│ └── test
│ └── java
└── pom.xml
四、关键技术
- Spring框架:用于管理Bean的生命周期和依赖注入。
- SpringMVC框架:用于处理Web请求,返回响应。
- MyBatis框架:用于数据持久层操作。
- JSP:用于展示页面。
- Servlet:用于处理HTTP请求。
五、项目实现
1. 创建Maven项目
使用IntelliJ IDEA创建一个Maven项目,并添加依赖。
<dependencies>
<!-- Spring框架 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.3.10</version>
</dependency>
<!-- SpringMVC框架 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.3.10</version>
</dependency>
<!-- MyBatis框架 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
<!-- JSP相关 -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
<!-- JSTL -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
</dependencies>
2. 配置Spring和MyBatis
在resources目录下创建application.properties和sqlMapConfig.xml文件,配置Spring和MyBatis。
application.properties:
# 数据库配置
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/online_bookstore?useSSL=false&serverTimezone=UTC
jdbc.username=root
jdbc.password=root
# MyBatis配置
mybatis.mapper-locations=classpath:mapper/*.xml
mybatis.type-aliases-package=com.example.onlinebookstore.model
sqlMapConfig.xml:
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="mapper/BookMapper.xml"/>
</mappers>
</configuration>
3. 创建Book实体类
在model包下创建Book实体类,用于表示书籍信息。
package com.example.onlinebookstore.model;
public class Book {
private Integer id;
private String title;
private String author;
private Double price;
// 省略getter和setter方法
}
4. 创建BookMapper接口和XML
在dao包下创建BookMapper接口和BookMapper.xml文件,用于操作数据库。
BookMapper.java:
package com.example.onlinebookstore.dao;
import com.example.onlinebookstore.model.Book;
public interface BookMapper {
List<Book> findAll();
Book findById(Integer id);
void addBook(Book book);
void updateBook(Book book);
void deleteBook(Integer id);
}
BookMapper.xml:
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.onlinebookstore.dao.BookMapper">
<select id="findAll" resultType="Book">
SELECT * FROM book
</select>
<select id="findById" resultType="Book">
SELECT * FROM book WHERE id = #{id}
</select>
<insert id="addBook">
INSERT INTO book (title, author, price) VALUES (#{title}, #{author}, #{price})
</insert>
<update id="updateBook">
UPDATE book SET title = #{title}, author = #{author}, price = #{price} WHERE id = #{id}
</update>
<delete id="deleteBook">
DELETE FROM book WHERE id = #{id}
</delete>
</mapper>
5. 创建BookService接口和实现类
在service包下创建BookService接口和实现类,用于处理业务逻辑。
BookService.java:
package com.example.onlinebookstore.service;
import com.example.onlinebookstore.dao.BookMapper;
import com.example.onlinebookstore.model.Book;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;
@Service
public class BookService {
@Autowired
private BookMapper bookMapper;
public List<Book> findAll() {
return bookMapper.findAll();
}
public Book findById(Integer id) {
return bookMapper.findById(id);
}
public void addBook(Book book) {
bookMapper.addBook(book);
}
public void updateBook(Book book) {
bookMapper.updateBook(book);
}
public void deleteBook(Integer id) {
bookMapper.deleteBook(id);
}
}
6. 创建BookController类
在controller包下创建BookController类,用于处理HTTP请求。
package com.example.onlinebookstore.controller;
import com.example.onlinebookstore.model.Book;
import com.example.onlinebookstore.service.BookService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@Controller
@RequestMapping("/book")
public class BookController {
@Autowired
private BookService bookService;
@GetMapping("/list")
public String list(Model model) {
List<Book> books = bookService.findAll();
model.addAttribute("books", books);
return "list";
}
@GetMapping("/add")
public String add() {
return "add";
}
@PostMapping("/add")
public String addBook(Book book) {
bookService.addBook(book);
return "redirect:/book/list";
}
@GetMapping("/update/{id}")
public String update(@PathVariable Integer id, Model model) {
Book book = bookService.findById(id);
model.addAttribute("book", book);
return "update";
}
@PostMapping("/update")
public String updateBook(Book book) {
bookService.updateBook(book);
return "redirect:/book/list";
}
@GetMapping("/delete/{id}")
public String delete(@PathVariable Integer id) {
bookService.deleteBook(id);
return "redirect:/book/list";
}
}
7. 配置SpringMVC
在webapp/WEB-INF目录下创建web.xml文件,配置SpringMVC。
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<servlet>
<servlet-name>springDispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:applicationContext.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springDispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
在resources目录下创建applicationContext.xml文件,配置Spring。
<?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"
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">
<!-- 扫描Controller -->
<context:component-scan base-package="com.example.onlinebookstore"/>
<!-- 数据源配置 -->
<bean id="dataSource" class="org.apache.commons.dbcp2.BasicDataSource">
<property name="driverClassName" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</bean>
<!-- MyBatis配置 -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource"/>
<property name="configLocation" value="classpath:sqlMapConfig.xml"/>
</bean>
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.example.onlinebookstore.dao"/>
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
</bean>
<!-- SpringMVC配置 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/"/>
<property name="suffix" value=".jsp"/>
</bean>
</beans>
8. 创建视图
在webapp/WEB-INF/views目录下创建list.jsp、add.jsp和update.jsp三个视图。
list.jsp:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>在线书店</title>
</head>
<body>
<h1>书籍列表</h1>
<table border="1">
<tr>
<th>编号</th>
<th>标题</th>
<th>作者</th>
<th>价格</th>
<th>操作</th>
</tr>
<c:forEach items="${books}" var="book">
<tr>
<td>${book.id}</td>
<td>${book.title}</td>
<td>${book.author}</td>
<td>${book.price}</td>
<td>
<a href="update/${book.id}.html">编辑</a>
<a href="delete/${book.id}.html">删除</a>
</td>
</tr>
</c:forEach>
</table>
<a href="add.html">添加书籍</a>
</body>
</html>
add.jsp:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>添加书籍</title>
</head>
<body>
<h1>添加书籍</h1>
<form action="add" method="post">
<label for="title">标题:</label>
<input type="text" id="title" name="title" required><br>
<label for="author">作者:</label>
<input type="text" id="author" name="author" required><br>
<label for="price">价格:</label>
<input type="number" id="price" name="price" required><br>
<input type="submit" value="提交">
</form>
</body>
</html>
update.jsp:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>编辑书籍</title>
</head>
<body>
<h1>编辑书籍</h1>
<form action="update" method="post">
<input type="hidden" name="id" value="${book.id}">
<label for="title">标题:</label>
<input type="text" id="title" name="title" value="${book.title}"><br>
<label for="author">作者:</label>
<input type="text" id="author" name="author" value="${book.author}"><br>
<label for="price">价格:</label>
<input type="number" id="price" name="price" value="${book.price}"><br>
<input type="submit" value="提交">
</form>
</body>
</html>
六、项目运行
- 启动MySQL数据库。
- 运行IntelliJ IDEA,启动Spring Boot应用程序。
- 在浏览器中访问
http://localhost:8080/,即可看到在线书店的首页。
七、总结
通过以上实战项目,你已成功掌握了SpringMVC框架的基本使用方法。希望本文能帮助你轻松上手,并在实际项目中运用SpringMVC框架。祝你学习愉快!
