常见的Spring项目目录结构

在一个典型的 Spring 项目中，尤其是基于 Spring Boot 或 Spring MVC 的项目，会有一个清晰的目录结构来组织不同的功能模块。下面是一个常见的 Spring Boot 项目的文件结构，包含了大多数常用的目录和文件：

常见的 Spring 项目目录结构 my-spring-project ├── src │ ├── main │ │ ├── java │ │ │ └── com │ │ │ └── example │ │ │ └── myspringproject │ │ │ ├── config # 配置类 │ │ │ ├── controller # 控制器层 (Spring MVC) │ │ │ ├── dao # 数据访问层 (DAO)，（在 MyBatis 项目中，同Mapper 层 ） │ │ │ ├── dto # 数据传输对象 (DTO) │ │ │ ├── exception # 异常处理 │ │ │ ├── model） # 实体类 (PO, VO)（Domain 、Entity） │ │ │ ├── repository # Spring Data JPA / MyBatis Repository │ │ │ ├── service # 服务层 (业务逻辑) │ │ │ ├── util # 工具类 (Utility classes) │ │ │ └── MySpringProjectApplication.java # 启动类 │ │ ├── resources │ │ │ ├── application.properties # 配置文件（application.yml） │ │ │ ├── static # 静态资源（例如：JS, CSS, 图片等） │ │ │ ├── templates # 模板文件（例如：Thymeleaf, FreeMarker） │ │ │ ├── db # 数据库相关脚本 │ │ │ └── application.yml # 配置文件（备用形式） │ ├── test │ │ ├── java │ │ │ └── com │ │ │ └── example │ │ │ └── myspringproject │ │ │ └── MySpringProjectApplicationTests.java # 测试类 │ └── pom.xml (或 build.gradle) # 项目的构建工具配置文件 (Maven 或 Gradle) 解释各个目录和文件的功能 1. src/main/java/com/example/myspringproject

这是项目的 Java 代码部分。

config：配置类，通常包括 @Configuration 注解的类，设置 Spring Boot 或 Spring MVC 的各种配置，如数据源、Security 配置等。

示例：DataSourceConfig.java、SecurityConfig.java

controller：控制器层，包含处理 HTTP 请求的控制器类，使用 @RestController 或 @Controller 注解，负责将请求映射到相应的服务。

示例：UserController.java、OrderController.java

dao：数据访问对象层，通常与数据库交互的类，通常会使用 MyBatis 或 Spring Data JPA 来执行数据库操作。

示例：UserDao.java、OrderDao.java

dto：数据传输对象，主要用于服务层与前端之间的数据传输。通常是简化的 PO（持久化对象）或者聚合多个模型的对象。

示例：UserDTO.java、OrderDTO.java

exception：异常处理类，用于捕获并处理应用程序中的异常。可以使用 @ControllerAdvice 或 @ExceptionHandler 来集中处理。

示例：GlobalExceptionHandler.java

model：模型层，通常是实体类，代表数据库中的表。一般来说，这些类会被映射到数据库表（通过 JPA 或 MyBatis）。

示例：User.java、Order.java

repository：数据仓库层，Spring Data JPA 或 MyBatis 的接口通常放在这里。它与数据库表的交互通过 ORM 框架或 MyBatis Mapper 来实现。

示例：UserRepository.java、OrderRepository.java

service：服务层，包含业务逻辑，通常调用 repository 层来执行 CRUD 操作，同时可以包含一些复杂的业务逻辑。

示例：UserService.java、OrderService.java

util：工具类，包含一些通用的辅助方法或工具类（如日期处理、字符串处理等）。

示例：DateUtils.java、StringUtils.java

MySpringProjectApplication.java：Spring Boot 启动类，包含 @SpringBootApplication 注解的类，是应用程序的入口点，通常包含 main 方法来启动 Spring Boot 应用。

2. src/main/resources

这是资源文件部分。

application.properties 或 application.yml：配置文件，Spring Boot 项目的核心配置文件，定义数据库连接、端口号、日志、缓存等各种配置项。

示例：

server.port=8080 spring.datasource.url=jdbc:mysql://localhost:3306/mydb spring.datasource.username=root spring.datasource.password=root

static：静态资源目录，用于存放前端的静态文件，如 CSS、JavaScript、图片等。这些文件通常不会经过服务器端处理，直接通过 HTTP 访问。

示例：styles.css、scripts.js

templates：模板文件目录，通常用于存放视图模板文件，如 Thymeleaf 或 FreeMarker 模板。

示例：index.html、login.html

db：数据库相关的脚本文件，通常用于存放初始化数据库的 SQL 脚本。

示例：schema.sql、data.sql 3. src/test/java

这是项目的测试代码部分，使用 JUnit 或 TestNG 等框架进行单元测试和集成测试。

MySpringProjectApplicationTests.java：Spring Boot 应用程序的测试类，通常包含对启动类的基本测试，确保应用程序能正确启动。你可以在这个目录下添加其他测试类，如 UserServiceTest.java，用于测试服务层的业务逻辑。 4. 构建工具文件（pom.xml 或 build.gradle）

pom.xml：Maven 构建工具的配置文件，定义了项目的依赖项、插件、构建目标等。

示例：

<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> </dependency> </dependencies>

build.gradle：Gradle 构建工具的配置文件，类似于 Maven 的 pom.xml，用于定义项目的依赖和构建任务。

小结

这是一个 Spring Boot 项目的典型文件结构，随着项目规模的增加，可能会根据需要进行扩展，例如引入新的模块（如消息队列模块、缓存模块等）。这个结构遵循了 分层架构 的设计原则，使得各层功能清晰，易于维护和扩展。