SSM框架实现图书管理系统开发实战-代码聚汇网

SSM框架实现图书管理系统开发实战

SSM框架JavaWeb开发图书管理系统

|难度：普通|阅读约 33 分钟

1. 项目概述与核心价值

这个图书管理系统项目采用了经典的JavaWeb技术栈组合：SSM框架（Spring+SpringMVC+MyBatis）作为后端架构，JSP实现动态页面渲染，MySQL作为数据存储方案。这种技术选型在中小型Web应用中非常典型，尤其适合需要快速开发且对性能要求不高的业务场景。

我在实际开发中发现，图书管理系统虽然看似简单，但完整实现前后台功能需要处理诸多技术细节。前台需要做好用户交互体验和响应速度，后台则要确保数据操作的准确性和安全性。SSM框架的轻量级特性正好能满足这种需求——Spring的IoC容器管理各类Bean，SpringMVC处理请求分发，MyBatis简化数据库操作，三者配合能大幅提升开发效率。

特别提示：虽然现在流行前后端分离架构，但SSM+JSP的传统模式对于学校教学、毕业设计等场景仍有重要价值。理解这种模式的运作原理，能为后续学习更复杂的架构打下坚实基础。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 技术栈选型与项目搭建

2.1 开发环境准备

我推荐使用以下环境配置：

JDK 1.8（兼容性最佳）
Tomcat 8.5（支持Servlet 3.1规范）
MySQL 5.7（社区版即可）
IntelliJ IDEA 2023.2（对JavaWeb支持完善）

在IDEA中创建Maven项目时，需要特别注意pom.xml的依赖配置。除了基础的spring-webmvc、mybatis等依赖外，还需要添加：

xml复制<!-- JSP支持 -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>

<!-- MySQL驱动 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.28</version>
</dependency>

<!-- 数据库连接池 -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.2.8</version>
</dependency>

2.2 SSM框架整合关键点

框架整合是项目的基础，需要特别注意以下几个配置文件：

spring.xml：配置包扫描、注解驱动、视图解析器

xml复制<!-- 配置JSP视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/views/"/>
    <property name="suffix" value=".jsp"/>
</bean>

spring-mvc.xml：配置静态资源过滤、文件上传等

xml复制<!-- 静态资源处理 -->
<mvc:resources mapping="/static/**" location="/static/"/>

mybatis-config.xml：配置类型别名、插件等

xml复制<typeAliases>
    <package name="com.example.entity"/>
</typeAliases>

数据库连接配置（db.properties）：

properties复制jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/book_db?useSSL=false&serverTimezone=UTC
jdbc.username=root
jdbc.password=123456

踩坑提醒：MySQL 8.0+需要指定serverTimezone参数，否则会报时区错误。同时建议关闭SSL（useSSL=false）以简化开发环境配置。

3. 数据库设计与实现

3.1 核心表结构设计

图书管理系统的数据库设计需要考虑以下几个核心实体：

用户表(users)：

sql复制CREATE TABLE `users` (
  `user_id` int(11) NOT NULL AUTO_INCREMENT,
  `username` varchar(50) NOT NULL,
  `password` varchar(100) NOT NULL,
  `real_name` varchar(50) DEFAULT NULL,
  `phone` varchar(20) DEFAULT NULL,
  `role` enum('admin','user') NOT NULL DEFAULT 'user',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`user_id`),
  UNIQUE KEY `username_UNIQUE` (`username`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

图书表(books)：

sql复制CREATE TABLE `books` (
  `book_id` int(11) NOT NULL AUTO_INCREMENT,
  `isbn` varchar(20) NOT NULL,
  `title` varchar(100) NOT NULL,
  `author` varchar(50) NOT NULL,
  `publisher` varchar(50) DEFAULT NULL,
  `publish_date` date DEFAULT NULL,
  `price` decimal(10,2) DEFAULT NULL,
  `stock` int(11) NOT NULL DEFAULT '0',
  `cover_url` varchar(255) DEFAULT NULL,
  `description` text,
  `category_id` int(11) DEFAULT NULL,
  PRIMARY KEY (`book_id`),
  UNIQUE KEY `isbn_UNIQUE` (`isbn`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

借阅记录表(borrow_records)：

sql复制CREATE TABLE `borrow_records` (
  `record_id` int(11) NOT NULL AUTO_INCREMENT,
  `user_id` int(11) NOT NULL,
  `book_id` int(11) NOT NULL,
  `borrow_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `return_time` datetime DEFAULT NULL,
  `status` enum('borrowed','returned','overdue') NOT NULL DEFAULT 'borrowed',
  PRIMARY KEY (`record_id`),
  KEY `fk_user_idx` (`user_id`),
  KEY `fk_book_idx` (`book_id`),
  CONSTRAINT `fk_book` FOREIGN KEY (`book_id`) REFERENCES `books` (`book_id`),
  CONSTRAINT `fk_user` FOREIGN KEY (`user_id`) REFERENCES `users` (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

3.2 索引优化建议

在实际运行中，我发现以下几个索引优化能显著提升查询性能：

为books表的title和author字段添加联合索引：

sql复制ALTER TABLE books ADD INDEX idx_title_author (title, author);

为borrow_records表添加复合索引：

sql复制ALTER TABLE borrow_records ADD INDEX idx_user_status (user_id, status);

对于大文本字段description，建议使用FULLTEXT索引支持全文搜索：

sql复制ALTER TABLE books ADD FULLTEXT INDEX ft_description (description);

4. 核心功能实现

4.1 用户登录与权限控制

采用Spring Security实现权限控制可能过于重量级，对于小型系统，我推荐使用拦截器实现简单的权限验证：

创建AuthInterceptor：

java复制public class AuthInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, 
                           HttpServletResponse response, 
                           Object handler) throws Exception {
        HttpSession session = request.getSession();
        User user = (User) session.getAttribute("currentUser");
        
        if (user == null) {
            response.sendRedirect("/login");
            return false;
        }
        
        // 检查管理员权限
        String uri = request.getRequestURI();
        if (uri.startsWith("/admin") && !"admin".equals(user.getRole())) {
            response.sendError(HttpServletResponse.SC_FORBIDDEN);
            return false;
        }
        
        return true;
    }
}

在spring-mvc.xml中配置拦截规则：

xml复制<mvc:interceptors>
    <mvc:interceptor>
        <mvc:mapping path="/**"/>
        <mvc:exclude-mapping path="/static/**"/>
        <mvc:exclude-mapping path="/login"/>
        <mvc:exclude-mapping path="/doLogin"/>
        <bean class="com.example.interceptor.AuthInterceptor"/>
    </mvc:interceptor>
</mvc:interceptors>

4.2 图书分页查询实现

前端分页通常需要以下参数：

pageNum：当前页码
pageSize：每页记录数
keyword：搜索关键词

后端Controller实现：

java复制@Controller
@RequestMapping("/book")
public class BookController {
    
    @Autowired
    private BookService bookService;
    
    @RequestMapping("/list")
    public String list(
            @RequestParam(defaultValue = "1") Integer pageNum,
            @RequestParam(defaultValue = "10") Integer pageSize,
            @RequestParam(required = false) String keyword,
            Model model) {
        
        PageInfo<Book> pageInfo = bookService.findByPage(pageNum, pageSize, keyword);
        model.addAttribute("pageInfo", pageInfo);
        return "book/list";
    }
}

Service层使用PageHelper插件简化分页：

java复制@Service
public class BookServiceImpl implements BookService {
    
    @Autowired
    private BookMapper bookMapper;
    
    @Override
    public PageInfo<Book> findByPage(Integer pageNum, Integer pageSize, String keyword) {
        PageHelper.startPage(pageNum, pageSize);
        List<Book> books = bookMapper.selectByKeyword(keyword);
        return new PageInfo<>(books);
    }
}

4.3 图书借阅业务实现

借阅业务需要考虑并发情况，避免超借：

java复制@Transactional
@Service
public class BorrowServiceImpl implements BorrowService {
    
    @Autowired
    private BookMapper bookMapper;
    
    @Autowired
    private BorrowRecordMapper borrowRecordMapper;
    
    @Override
    public boolean borrowBook(Integer userId, Integer bookId) {
        // 检查库存
        Book book = bookMapper.selectByPrimaryKey(bookId);
        if (book == null || book.getStock() <= 0) {
            return false;
        }
        
        // 减少库存（使用乐观锁）
        int rows = bookMapper.reduceStockWithVersion(
            bookId, 
            book.getVersion()
        );
        
        if (rows == 0) {
            throw new RuntimeException("库存不足或数据已被修改");
        }
        
        // 创建借阅记录
        BorrowRecord record = new BorrowRecord();
        record.setUserId(userId);
        record.setBookId(bookId);
        record.setStatus("borrowed");
        borrowRecordMapper.insert(record);
        
        return true;
    }
}

对应的Mapper SQL（使用乐观锁）：

xml复制<update id="reduceStockWithVersion">
    UPDATE books 
    SET stock = stock - 1,
        version = version + 1
    WHERE book_id = #{bookId}
    AND version = #{version}
    AND stock > 0
</update>

5. 前端页面实现技巧

5.1 JSP页面布局优化

使用JSTL和EL表达式简化JSP开发：

jsp复制<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!DOCTYPE html>
<html>
<head>
    <title>图书列表</title>
    <link rel="stylesheet" href="/static/css/bootstrap.min.css">
</head>
<body>
    <div class="container">
        <h2>图书列表</h2>
        <table class="table table-striped">
            <thead>
                <tr>
                    <th>ISBN</th>
                    <th>书名</th>
                    <th>作者</th>
                    <th>库存</th>
                    <th>操作</th>
                </tr>
            </thead>
            <tbody>
                <c:forEach items="${pageInfo.list}" var="book">
                <tr>
                    <td>${book.isbn}</td>
                    <td>${book.title}</td>
                    <td>${book.author}</td>
                    <td>${book.stock}</td>
                    <td>
                        <a href="/book/detail?id=${book.bookId}" class="btn btn-info btn-sm">详情</a>
                        <c:if test="${not empty currentUser}">
                            <a href="/borrow/apply?bookId=${book.bookId}" class="btn btn-primary btn-sm">借阅</a>
                        </c:if>
                    </td>
                </tr>
                </c:forEach>
            </tbody>
        </table>
        
        <div class="row">
            <div class="col-md-12">
                <ul class="pagination">
                    <c:if test="${pageInfo.hasPreviousPage}">
                        <li><a href="/book/list?pageNum=${pageInfo.prePage}">&laquo;</a></li>
                    </c:if>
                    
                    <c:forEach items="${pageInfo.navigatepageNums}" var="num">
                        <li class="${pageInfo.pageNum == num ? 'active' : ''}">
                            <a href="/book/list?pageNum=${num}">${num}</a>
                        </li>
                    </c:forEach>
                    
                    <c:if test="${pageInfo.hasNextPage}">
                        <li><a href="/book/list?pageNum=${pageInfo.nextPage}">&raquo;</a></li>
                    </c:if>
                </ul>
            </div>
        </div>
    </div>
</body>
</html>

5.2 文件上传实现

SpringMVC文件上传配置：

在spring-mvc.xml中添加：

xml复制<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="maxUploadSize" value="10485760"/> <!-- 10MB -->
    <property name="defaultEncoding" value="UTF-8"/>
</bean>

Controller处理方法：

java复制@PostMapping("/upload")
public String upload(
        @RequestParam("file") MultipartFile file,
        @RequestParam("bookId") Integer bookId,
        RedirectAttributes redirectAttributes) {
    
    if (file.isEmpty()) {
        redirectAttributes.addFlashAttribute("message", "请选择要上传的文件");
        return "redirect:/book/edit?id=" + bookId;
    }
    
    try {
        // 保存文件
        String filename = System.currentTimeMillis() + "_" + file.getOriginalFilename();
        String savePath = "/upload/" + filename;
        File dest = new File(request.getServletContext().getRealPath(savePath));
        file.transferTo(dest);
        
        // 更新图书封面信息
        Book book = new Book();
        book.setBookId(bookId);
        book.setCoverUrl(savePath);
        bookService.update(book);
        
        redirectAttributes.addFlashAttribute("message", "上传成功");
    } catch (IOException e) {
        redirectAttributes.addFlashAttribute("message", "上传失败：" + e.getMessage());
    }
    
    return "redirect:/book/edit?id=" + bookId;
}

6. 系统部署与性能优化

6.1 Tomcat生产环境配置

在server.xml中优化连接器配置：

xml复制<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           maxThreads="200"
           minSpareThreads="10"
           acceptCount="100"
           enableLookups="false"
           compression="on"
           compressionMinSize="2048"
           compressableMimeType="text/html,text/xml,text/css,application/javascript"/>

6.2 MySQL性能优化建议

调整InnoDB缓冲池大小（my.cnf）：

ini复制[mysqld]
innodb_buffer_pool_size = 256M  # 对于4GB内存的服务器
innodb_log_file_size = 64M
innodb_flush_log_at_trx_commit = 2  # 平衡性能与安全性

定期优化表：

sql复制-- 分析表
ANALYZE TABLE books;

-- 优化表
OPTIMIZE TABLE borrow_records;

6.3 缓存策略实现

使用Spring Cache简化缓存实现：

在spring.xml中启用缓存：

xml复制<cache:annotation-driven cache-manager="cacheManager"/>

<bean id="cacheManager" class="org.springframework.cache.concurrent.ConcurrentMapCacheManager">
    <property name="cacheNames">
        <set>
            <value>books</value>
            <value>categories</value>
        </set>
    </property>
</bean>

在Service方法上添加缓存注解：

java复制@Cacheable(value = "books", key = "#bookId")
@Override
public Book findById(Integer bookId) {
    return bookMapper.selectByPrimaryKey(bookId);
}

@CacheEvict(value = "books", key = "#book.bookId")
@Override
public void update(Book book) {
    bookMapper.updateByPrimaryKeySelective(book);
}

7. 常见问题排查

7.1 JSP页面无法解析EL表达式

如果JSP中的${}表达式不生效，需要在页面顶部添加：

jsp复制<%@ page isELIgnored="false" %>

或者在web.xml中配置：

xml复制<jsp-config>
    <jsp-property-group>
        <url-pattern>*.jsp</url-pattern>
        <el-ignored>false</el-ignored>
    </jsp-property-group>
</jsp-config>

7.2 MyBatis查询结果映射异常

当遇到"Column 'xxx' not found"错误时，检查：

数据库字段名与实体类属性名是否一致（注意下划线与驼峰转换）
在mybatis-config.xml中开启驼峰命名转换：

xml复制<settings>
    <setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>

7.3 事务不生效问题

确保：

在spring.xml中配置了事务管理器：

xml复制<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
    <property name="dataSource" ref="dataSource"/>
</bean>

<tx:annotation-driven transaction-manager="transactionManager"/>

Service类和方法上有正确的注解：

java复制@Service
@Transactional
public class BookServiceImpl implements BookService {
    // 类级别的事务配置会被方法继承
    // 也可以在方法上单独配置 @Transactional
}

确保调用的是代理对象的方法（同一个类内部方法调用不会触发事务）

8. 项目扩展方向

8.1 添加Redis缓存

对于热门图书信息，可以引入Redis缓存：

添加依赖：

xml复制<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
    <version>2.6.3</version>
</dependency>

配置RedisTemplate：

java复制@Configuration
public class RedisConfig {
    
    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);
        
        // 使用Jackson2JsonRedisSerializer序列化
        Jackson2JsonRedisSerializer<Object> serializer = new Jackson2JsonRedisSerializer<>(Object.class);
        
        ObjectMapper om = new ObjectMapper();
        om.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);
        om.activateDefaultTyping(om.getPolymorphicTypeValidator(), 
                               ObjectMapper.DefaultTyping.NON_FINAL);
        serializer.setObjectMapper(om);
        
        template.setValueSerializer(serializer);
        template.setKeySerializer(new StringRedisSerializer());
        
        template.afterPropertiesSet();
        return template;
    }
}

8.2 实现图书推荐功能

基于用户借阅历史实现简单的协同过滤推荐：

java复制@Service
public class RecommendServiceImpl implements RecommendService {
    
    @Autowired
    private BorrowRecordMapper borrowRecordMapper;
    
    @Autowired
    private BookMapper bookMapper;
    
    @Override
    public List<Book> recommendBooks(Integer userId) {
        // 1. 获取当前用户借阅过的图书
        List<BorrowRecord> myRecords = borrowRecordMapper.selectByUser(userId);
        Set<Integer> myBookIds = myRecords.stream()
                .map(BorrowRecord::getBookId)
                .collect(Collectors.toSet());
        
        if (myBookIds.isEmpty()) {
            return bookMapper.selectPopularBooks(10);
        }
        
        // 2. 找到借阅过相同图书的其他用户
        List<Integer> similarUserIds = borrowRecordMapper
                .selectUsersWhoAlsoBorrowed(myBookIds, userId);
        
        if (similarUserIds.isEmpty()) {
            return bookMapper.selectBooksInSameCategory(myBookIds, 10);
        }
        
        // 3. 获取这些用户借阅的其他图书
        return borrowRecordMapper
                .selectBooksBorrowedByUsers(similarUserIds, myBookIds, 10);
    }
}

8.3 添加Swagger API文档

对于前后端分离的场景，可以集成Swagger：

添加依赖：

xml复制<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>

配置Swagger：

java复制@Configuration
@EnableSwagger2
public class SwaggerConfig {
    
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.controller"))
                .paths(PathSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }
    
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("图书管理系统API文档")
                .description("SSM框架实现的图书管理系统")
                .version("1.0")
                .build();
    }
}

在Controller方法上添加注解：

java复制@ApiOperation("获取图书列表")
@ApiImplicitParams({
    @ApiImplicitParam(name = "pageNum", value = "页码", defaultValue = "1"),
    @ApiImplicitParam(name = "pageSize", value = "每页数量", defaultValue = "10")
})
@RequestMapping(value = "/list", method = RequestMethod.GET)
public Result<PageInfo<Book>> list(
        @RequestParam(defaultValue = "1") Integer pageNum,
        @RequestParam(defaultValue = "10") Integer pageSize) {
    // ...
}

这个图书管理系统项目虽然采用了传统的SSM+JSP架构，但涵盖了Web开发的完整流程和核心技术点。在实际开发中，我发现以下几个经验特别有价值：

分页查询的URL设计：保持分页参数在URL中的一致性，方便用户直接复制链接分享特定页码的内容。
乐观锁的使用：在高并发场景下，乐观锁比悲观锁性能更好，适合库存扣减这类操作。
JSP的模块化：通过<%@ include file="..." %>将公共部分（如页头、页脚）提取出来，大幅减少重复代码。
MyBatis的TypeHandler：对于枚举类型、JSON字段等特殊类型，自定义TypeHandler能简化数据库操作。
生产环境日志：配置Logback按天归档日志，同时区分不同级别的日志文件（info.log, error.log）。

这个项目完全可以作为学习JavaWeb开发的样板工程，理解了其中的技术实现后，可以轻松迁移到其他管理系统的开发中。