从零开始：使用 Spring Boot 开发图书管理系统

如何利用是springboot搭建一个简单的图书管理系统，下面让我们一起来看看吧

文章目录

- - 项目结构
  - 1. 主类 `LibraryApplication.java`
  - - 功能与注意事项：
  - 2. 模型类 `Book.java`
  - - 功能与注意事项：
  - 3. 数据仓库接口 `BookRepository.java`
  - - 功能与注意事项：
  - 4. 服务层 `BookService.java`
  - - 功能与注意事项：
  - 5. 控制器 `BookController.java`
  - - 功能与注意事项：
  - 6. 配置文件 `application.properties`
  - - 功能与注意事项：
  - 运行与测试
  - 注意事项

项目结构

深色版本

src
└── main├── java│   └── com│       └── example│           └── library│               ├── LibraryApplication.java│               ├── controller│               │   └── BookController.java│               ├── model│               │   └── Book.java│               ├── repository│               │   └── BookRepository.java│               └── service│                   └── BookService.java└── resources└── application.properties

1. 主类 `LibraryApplication.java`

这是Spring Boot应用的入口点。

java深色版本

package com.example.library;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
public class LibraryApplication {public static void main(String[] args) {SpringApplication.run(LibraryApplication.class, args);}
}

进入代码分屏

功能与注意事项：

@SpringBootApplication注解：这个注解是组合注解，包含了@Configuration、@EnableAutoConfiguration和@ComponentScan。它告诉Spring Boot自动配置应用程序，并扫描当前包及其子包中的组件。
主方法：main方法是Java程序的入口点，通过调用SpringApplication.run()启动Spring Boot应用。

2. 模型类 `Book.java`

这是一个简单的实体类，代表一本书。

java深色版本

package com.example.library.model;import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;@Entity
public class Book {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;private String title;private String author;private String isbn;// Getters and Setterspublic Long getId() {return id;}public void setId(Long id) {this.id = id;}public String getTitle() {return title;}public void setTitle(String title) {this.title = title;}public String getAuthor() {return author;}public void setAuthor(String author) {this.author = author;}public String getIsbn() {return isbn;}public void setIsbn(String isbn) {this.isbn = isbn;}
}

进入代码分屏

功能与注意事项：

@Entity注解：表示该类是一个JPA实体类，对应数据库表。
@Id注解：标识字段为主键。
@GeneratedValue注解：指定主键生成策略为自增。
Getters and Setters：提供属性的访问和修改方法。确保所有属性都有对应的getter和setter方法，以便JPA和其他框架能够正确地进行对象映射。

3. 数据仓库接口 `BookRepository.java`

使用Spring Data JPA简化数据库操作。

java深色版本

package com.example.library.repository;import com.example.library.model.Book;
import org.springframework.data.jpa.repository.JpaRepository;public interface BookRepository extends JpaRepository<Book, Long> {
}

进入代码分屏

功能与注意事项：

继承JpaRepository：JpaRepository提供了基本的CRUD操作方法，无需手动编写SQL语句。
泛型参数：第一个参数是实体类型（Book），第二个参数是主键类型（Long）。
自定义查询方法：如果需要更复杂的查询，可以在接口中声明自定义的方法名，Spring Data JPA会根据方法名自动生成实现。

4. 服务层 `BookService.java`

业务逻辑处理。

java深色版本

package com.example.library.service;import com.example.library.model.Book;
import com.example.library.repository.BookRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;import java.util.List;
import java.util.Optional;@Service
public class BookService {@Autowiredprivate BookRepository bookRepository;public List<Book> findAllBooks() {return bookRepository.findAll();}public Optional<Book> findBookById(Long id) {return bookRepository.findById(id);}public Book saveBook(Book book) {return bookRepository.save(book);}public void deleteBook(Long id) {bookRepository.deleteById(id);}
}

进入代码分屏

功能与注意事项：

@Service注解：标识该类为服务层组件，便于Spring容器管理。
依赖注入：通过@Autowired注解注入BookRepository实例。
方法设计：每个方法对应一个具体的业务操作，保持方法的单一职责原则。

5. 控制器 `BookController.java`

定义API端点。

java深色版本

package com.example.library.controller;import com.example.library.model.Book;
import com.example.library.service.BookService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;import java.util.List;
import java.util.Optional;@RestController
@RequestMapping("/api/books")
public class BookController {@Autowiredprivate BookService bookService;@GetMappingpublic List<Book> getAllBooks() {return bookService.findAllBooks();}@GetMapping("/{id}")public ResponseEntity<Book> getBookById(@PathVariable Long id) {Optional<Book> book = bookService.findBookById(id);if (book.isPresent()) {return ResponseEntity.ok(book.get());} else {return ResponseEntity.notFound().build();}}@PostMappingpublic Book createBook(@RequestBody Book book) {return bookService.saveBook(book);}@PutMapping("/{id}")public ResponseEntity<Book> updateBook(@PathVariable Long id, @RequestBody Book bookDetails) {Optional<Book> optionalBook = bookService.findBookById(id);if (optionalBook.isPresent()) {Book book = optionalBook.get();book.setTitle(bookDetails.getTitle());book.setAuthor(bookDetails.getAuthor());book.setIsbn(bookDetails.getIsbn());return ResponseEntity.ok(bookService.saveBook(book));} else {return ResponseEntity.notFound().build();}}@DeleteMapping("/{id}")public ResponseEntity<Void> deleteBook(@PathVariable Long id) {Optional<Book> book = bookService.findBookById(id);if (book.isPresent()) {bookService.deleteBook(id);return ResponseEntity.noContent().build();} else {return ResponseEntity.notFound().build();}}
}

进入代码分屏

功能与注意事项：

@RestController注解：标识该类为控制器，并且所有的方法默认返回JSON格式的数据。
@RequestMapping注解：定义基础路径/api/books，后续的请求都会基于此路径。
HTTP方法映射：使用@GetMapping、@PostMapping、@PutMapping、@DeleteMapping分别映射不同的HTTP方法。
路径变量和请求体：使用@PathVariable获取URL中的路径参数，使用@RequestBody解析请求体中的JSON数据。
响应状态码：根据不同情况返回适当的HTTP状态码，如200 OK、201 Created、404 Not Found等。

6. 配置文件 `application.properties`

配置数据源和其他属性。

properties深色版本

spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=password
spring.h2.console.enabled=true
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

进入代码分屏

功能与注意事项：

内存数据库：使用H2内存数据库，适合快速开发和测试，但不适合生产环境。
H2控制台：启用H2控制台方便调试，可以通过浏览器访问http://localhost:8080/h2-console。
DDL自动更新：设置spring.jpa.hibernate.ddl-auto=update让Hibernate自动更新数据库模式。
显示SQL：开启spring.jpa.show-sql=true以在控制台打印出执行的SQL语句，便于调试。

运行与测试

运行项目：在IDE中直接运行LibraryApplication类中的main方法，或者使用命令行执行mvn spring-boot:run。
访问H2控制台：打开浏览器，访问http://localhost:8080/h2-console，输入JDBC URL为jdbc:h2:mem:testdb，用户名为sa，密码为空即可登录查看数据库内容。
测试API

：使用Postman或其他工具测试API端点：
- GET /api/books: 获取所有书籍
- GET /api/books/{id}: 根据ID获取书籍
- POST /api/books: 创建新书籍（JSON格式）
- PUT /api/books/{id}: 更新指定ID的书籍（JSON格式）
- DELETE /api/books/{id}: 删除指定ID的书籍

注意事项

依赖管理：确保项目的pom.xml文件中包含了必要的依赖项，如Spring Boot Starter Web、Spring Data JPA、H2 Database等。
异常处理：在实际项目中，需要添加全局异常处理器来捕获并返回有意义的错误信息。
安全性：考虑添加安全机制，如JWT认证、角色权限控制等。
性能优化：对于大型系统，需关注SQL查询优化、缓存策略等。
单元测试：编写单元测试覆盖各个组件的功能，确保代码质量。
数据验证：使用JSR-380（Bean Validation）注解对请求体中的数据进行验证，防止无效或恶意数据进入系统。
日志记录：添加日志记录，便于追踪和调试应用行为。
文档编写：编写API文档，帮助其他开发者理解和使用API。