Package Structure of a Spring Boot Project

When developing a Spring Boot project, it's important to follow a well-organized package structure. This not only makes the project easier to navigate but also improves maintainability and scalability. In this blog post, we will discuss the recommended package structure for a Spring Boot project, explaining the purpose of each package.

Why is a Well-Organized Package Structure Important?

A well-organized package structure helps in:

  • Separation of Concerns: Different aspects of the application are handled by different packages.
  • Easier Navigation: Developers can quickly find the code they need to work on.
  • Maintainability: Makes it easier to maintain and extend the application as it grows.
  • Scalability: Helps in scaling the application by adding new features without cluttering the existing structure.

Recommended Package Structure

Here is a recommended package structure for a typical Spring Boot project:

    ├── config
    ├── controller
    ├── dto
    ├── exception
    ├── model
    ├── repository
    ├── service

1. config Package

This package contains configuration classes. These classes are used to configure various aspects of the Spring Boot application such as security, data sources, and application-specific settings.


package com.example.projectname.config;

import org.springframework.context.annotation.Configuration;

public class AppConfig {
    // Configuration beans go here

2. controller Package

This package contains the REST controllers. Controllers handle HTTP requests and map them to appropriate service methods. Each controller typically corresponds to a specific resource or functionality.


package com.example.projectname.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

public class ExampleController {

    public String sayHello() {
        return "Hello, World!";

3. dto Package

This package contains Data Transfer Objects (DTOs). DTOs are used to transfer data between different layers of the application, especially between the controller and service layers.


package com.example.projectname.dto;

public class UserDTO {
    private Long id;
    private String name;

    // Getters and setters

4. exception Package

This package contains custom exception classes and global exception handlers. Handling exceptions in a dedicated package helps in managing application errors more effectively.


package com.example.projectname.exception;

public class ResourceNotFoundException extends RuntimeException {
    public ResourceNotFoundException(String message) {

5. model Package

This package contains the domain models or entities. These classes represent the data structure of the application and are typically mapped to database tables.


package com.example.projectname.model;

import javax.persistence.Entity;
import javax.persistence.Id;

public class User {
    private Long id;
    private String name;

    // Getters and setters

6. repository Package

This package contains the repository interfaces. Repositories are used to interact with the database and perform CRUD operations.


package com.example.projectname.repository;

import com.example.projectname.model.User;

public interface UserRepository extends JpaRepository<User, Long> {
    // Custom query methods can be defined here

7. service Package

This package contains the service classes. Services encapsulate the business logic of the application and interact with the repository layer.


package com.example.projectname.service;

import com.example.projectname.model.User;
import com.example.projectname.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

public class UserService {

    private final UserRepository userRepository;

    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;

    public List<User> getAllUsers() {
        return userRepository.findAll();


This is the main application class that bootstraps the Spring Boot application.


package com.example.projectname;

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

public class ProjectnameApplication {

    public static void main(String[] args) {, args);


Following a well-defined package structure in a Spring Boot project is essential for creating a clean, maintainable, and scalable codebase. By organizing your code into separate packages for configuration, controllers, DTOs, exceptions, models, repositories, and services, you can ensure that your application remains modular and easy to manage as it grows. Happy coding!