Spring Boot does not require any specific code layout to work. However, there are some best practices that help.
When a class does not include a package
declaration, it is considered to be in the
“default package”. The use of the “default package” is generally discouraged and
should be avoided. It can cause particular problems for Spring Boot applications that use
the @ComponentScan
, @EntityScan
, or @SpringBootApplication
annotations, since every
class from every jar is read.
Tip | |
---|---|
We recommend that you follow Java’s recommended package naming conventions and use a
reversed domain name (for example, |
We generally recommend that you locate your main application class in a root package
above other classes. The @SpringBootApplication
annotation is often placed on your main class, and it
implicitly defines a base “search package” for certain items. For example, if you are
writing a JPA application, the package of the @SpringBootApplication
annotated class
is used to search for @Entity
items. Using a root package also allows component
scan to apply only on your project.
Tip | |
---|---|
If you don’t want to use |
The following listing shows a typical layout:
com +- example +- myapplication +- Application.java | +- customer | +- Customer.java | +- CustomerController.java | +- CustomerService.java | +- CustomerRepository.java | +- order +- Order.java +- OrderController.java +- OrderService.java +- OrderRepository.java
The Application.java
file would declare the main
method, along with the basic
@SpringBootApplication
, as follows:
package com.example.myapplication; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication @SpringBootApplication public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } }