DTO vs entity separation benefit in Spring Boot - Hands-On Comparison

Understanding DTO vs Entity Separation in Spring Boot

📖 Scenario: You are building a simple Spring Boot application to manage books in a library. You want to keep your data organized and safe when sending information between the client and the server.

🎯 Goal: Learn how to separate the data transfer object (DTO) from the entity class to protect your database structure and control what data is shared.

📋 What You'll Learn

Create a Book entity class with fields id, title, and author

Create a BookDTO class with fields title and author only

Write a method to convert a Book entity to a BookDTO

Write a method to convert a BookDTO back to a Book entity

💡 Why This Matters

🌍 Real World

In real apps, separating DTOs from entities helps protect your database details and control exactly what data clients see.

💼 Career

Understanding DTO vs entity separation is important for backend developers working with Spring Boot to build secure and maintainable APIs.

1

Create the Book entity class

Create a class called Book with private fields Long id, String title, and String author. Include public getters and setters for each field.

Spring Boot

// Your code here to create the Book entity class with id, title, and author fields

Hint

Think of the Book class as the real data stored in your database. It needs an id to identify each book uniquely.

2

Create the BookDTO class

Create a class called BookDTO with private fields String title and String author. Include public getters and setters for each field.

Spring Boot

public class Book {
    private Long id;
    private String title;
    private String author;

    public 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;
    }
}

// Your code here to create the BookDTO class with title and author fields

Hint

The BookDTO class is like a simple package that only carries the book's title and author to the client, hiding the database id.

3

Add method to convert Book entity to BookDTO

Add a public static method called fromEntity inside the BookDTO class. It takes a Book object as a parameter and returns a new BookDTO with the title and author copied from the Book.

Spring Boot

public class Book {
    private Long id;
    private String title;
    private String author;

    public 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 class BookDTO {
    private String title;
    private String author;

    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;
    }

    // Add fromEntity method below
    // Your code here
}

Hint

This method helps you create a safe copy of the book data to send outside your app, without exposing the database id.

4

Add method to convert BookDTO to Book entity

Add a public method called toEntity inside the BookDTO class. It returns a new Book object with the title and author copied from the BookDTO. The id should not be set here.

Spring Boot

public class Book {
    private Long id;
    private String title;
    private String author;

    public 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 class BookDTO {
    private String title;
    private String author;

    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 static BookDTO fromEntity(Book book) {
        BookDTO dto = new BookDTO();
        dto.setTitle(book.getTitle());
        dto.setAuthor(book.getAuthor());
        return dto;
    }

    // Add toEntity method below
    // Your code here
}

Hint

This method lets you create a new Book entity from the data received from the client, without setting the database id.

Practice

1. Why is it beneficial to separate DTOs from entities in a Spring Boot application?

easy

A. It allows direct modification of database tables from the UI.

B. It makes the application run faster by skipping database calls.

C. It keeps the database structure hidden and improves security.

D. It reduces the number of classes in the project.

Solution

1. Step 1: Understand the role of entities

   Entities represent the database structure and are tightly linked to how data is stored.

2. Step 2: Understand the role of DTOs

   DTOs are used to transfer data safely between layers or systems, hiding internal details.

3. Final Answer:

   It keeps the database structure hidden and improves security. -> Option C

4. Quick Check:

   DTOs separate data transfer from entities = A [OK]

Hint: DTOs hide database details from outside layers [OK]

Common Mistakes:

• Thinking DTOs speed up database calls
• Believing entities should be exposed directly
• Confusing DTOs with database tables

2. Which of the following is the correct way to define a DTO class in Spring Boot?

easy

A. public class UserDTO { private String name; public String getName() { return name; } }

B. public record UserDTO(String name) {}

C. public enum UserDTO { NAME; }

D. public interface UserDTO { String name; }

Solution

1. Step 1: Review DTO class options

   DTOs are simple data carriers. Java records provide a concise way to define immutable DTOs.

2. Step 2: Identify the correct syntax

   public record UserDTO(String name) {} uses a record, which is modern and recommended for DTOs in Java 17+.

3. Final Answer:

   public record UserDTO(String name) {} -> Option B

4. Quick Check:

   Use records for simple DTOs = D [OK]

Hint: Use Java records for simple DTOs in Spring Boot [OK]

Common Mistakes:

• Using interfaces without methods for DTOs
• Using enums instead of classes or records
• Not providing getters for DTO fields

3. Given this code snippet, what will be the output when converting an entity to a DTO?

record UserDTO(String name) {}
class UserEntity { String name; UserEntity(String name) { this.name = name; } }

UserEntity entity = new UserEntity("Alice");
UserDTO dto = new UserDTO(entity.name);
System.out.println(dto.name());

medium

A. Alice

B. null

C. Compilation error

D. Empty string

Solution

1. Step 1: Understand entity to DTO conversion

   The entity has a name "Alice" which is passed to the DTO constructor.

2. Step 2: Check the output of dto.name()

   Since dto stores "Alice", printing dto.name() outputs "Alice".

3. Final Answer:

   Alice -> Option A

4. Quick Check:

   Entity name passed to DTO = Alice [OK]

Hint: DTO fields hold entity data passed in constructor [OK]

Common Mistakes:

• Assuming dto.name() returns null
• Confusing record syntax causing errors
• Expecting entity and DTO to be the same object

4. Identify the problem in this code snippet that mixes entity and DTO responsibilities:

public class UserEntity {
  private String name;
  public String getName() { return name; }
  public void setName(String name) { this.name = name; }
  public String toJson() { return "{\"name\":\"" + name + "\"}"; }
}

medium

A. The toJson method should return XML instead.

B. Getter and setter methods are missing.

C. The name field should be public.

D. Entity class should not handle JSON formatting.

Solution

1. Step 1: Analyze entity responsibilities

   Entities should focus on data storage and mapping, not formatting or presentation.

2. Step 2: Identify separation violation

   toJson mixes data with presentation logic, which belongs in DTO or service layers.

3. Final Answer:

   Entity class should not handle JSON formatting. -> Option D

4. Quick Check:

   Keep entity and presentation separate = A [OK]

Hint: Entities store data; DTOs handle data format [OK]

Common Mistakes:

• Allowing entities to format output
• Making entity fields public
• Confusing DTO and entity roles

5. You have a UserEntity with sensitive fields like password and internal IDs. How does using a separate UserDTO improve your Spring Boot API's security and maintainability?

hard

A. By exposing only necessary fields and hiding sensitive data from API responses.

B. By allowing direct database updates from the API without validation.

C. By merging all entity fields into one large DTO for simplicity.

D. By removing the need for service layers in the application.

Solution

1. Step 1: Recognize sensitive data risks

   Entities contain all data, including sensitive info like passwords, which should not be exposed.

2. Step 2: Understand DTO role in security

   DTOs can include only safe fields, preventing accidental exposure in API responses.

3. Step 3: Consider maintainability benefits

   Separating DTOs allows easier changes to API without affecting database structure.

4. Final Answer:

   By exposing only necessary fields and hiding sensitive data from API responses. -> Option A

5. Quick Check:

   DTOs protect sensitive data and ease maintenance = B [OK]

Hint: DTOs hide sensitive entity fields from API output [OK]

Common Mistakes:

• Exposing all entity fields directly
• Skipping validation by merging DTO and entity
• Removing service layers causing tight coupling