对于最新稳定版本,请使用Spring Boot 4.0.0spring-doc.cadn.net.cn

构建你的代码

Spring Boot 不需要特定的代码布局才能正常工作。 不过,有一些最佳实践是有帮助的。spring-doc.cadn.net.cn

如果你想基于领域强制执行结构,可以看看Spring Modulith

使用“默认”软件包

当一个类不包含声明时,它被视为“默认包”中的一员。 通常不建议使用“默认软件包”,应避免使用。 对于使用@ComponentScan,@ConfigurationPropertiesScan,@EntityScan@SpringBootApplication注释,因为每个jar的每个类都被读取。spring-doc.cadn.net.cn

我们建议您遵循 Java 推荐的包命名规范,使用反向域名(例如,com.example.project).

定位主应用类

我们通常建议你把主应用类放在根包里,而不是其他类。 这@SpringBootApplication注解通常会放在你的主职业上,并且隐含地定义了某些物品的基础“搜索包”。 例如,如果你正在编写JPA应用程序,这个包@SpringBootApplication注释类用于搜索@Entity项目。 使用根包还允许组件扫描只应用到你的项目上。spring-doc.cadn.net.cn

如果你不想使用@SpringBootApplication@EnableAutoConfiguration@ComponentScan它导入的注释定义了这种行为,所以你也可以用这些注释代替。

以下列表展示了典型的布局:spring-doc.cadn.net.cn

com
 +- example
     +- myapplication
         +- MyApplication.java
         |
         +- customer
         |   +- Customer.java
         |   +- CustomerController.java
         |   +- CustomerService.java
         |   +- CustomerRepository.java
         |
         +- order
             +- Order.java
             +- OrderController.java
             +- OrderService.java
             +- OrderRepository.java

MyApplication.java文件将声明主要方法,以及基本@SpringBootApplication如下:spring-doc.cadn.net.cn

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class MyApplication {

	public static void main(String[] args) {
		SpringApplication.run(MyApplication.class, args);
	}

}
import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.runApplication

@SpringBootApplication
class MyApplication

fun main(args: Array<String>) {
	runApplication<MyApplication>(*args)
}