Daftar Isi

1. Pengantar RESTful API dan Spring Boot
2. Persiapan Lingkungan dan Tools
3. Struktur Proyek Spring Boot
4. Membuat Proyek Spring Boot Pertama
5. Membuat Endpoint REST Dasar
6. Implementasi CRUD dengan Spring Data JPA
7. Validasi Input dan Error Handling
8. Keamanan API dengan Spring Security
9. Testing API dengan JUnit dan Postman
10. Deploy Aplikasi Spring Boot
11. Sumber Belajar dan Source Code

1. Pengantar RESTful API dan Spring Boot

RESTful API adalah arsitektur yang menggunakan protokol HTTP untuk komunikasi antara client dan server. Spring Boot adalah framework Java yang memudahkan pembuatan aplikasi berbasis Spring dengan konfigurasi minimal.

Dalam ebook ini, Anda akan belajar langkah demi langkah bagaimana membangun RESTful API menggunakan Spring Boot 2, mulai dari dasar hingga deployment.

2. Persiapan Lingkungan dan Tools

Sebelum mulai coding, pastikan Anda sudah menyiapkan:

• Java Development Kit (JDK) versi 11 atau lebih baru
• IDE favorit seperti IntelliJ IDEA, Eclipse, atau VS Code
• Build tool: Maven atau Gradle
• Postman untuk testing API
• Git untuk version control

Anda bisa mengunduh JDK dari Adoptium dan Postman dari situs resmi Postman .

3. Struktur Proyek Spring Boot

Struktur proyek Spring Boot biasanya terdiri dari beberapa folder utama:

• src/main/java - kode sumber aplikasi
• src/main/resources - konfigurasi dan resource statis
• src/test/java - kode untuk testing

Package utama biasanya mengikuti domain aplikasi, misalnya com.example.demo .

4. Membuat Proyek Spring Boot Pertama

Anda bisa membuat proyek Spring Boot dengan mudah menggunakan Spring Initializr . Pilih:

• Project: Maven Project
• Language: Java
• Spring Boot: 2.7.x (atau versi terbaru 2.x)
• Dependencies: Spring Web, Spring Data JPA, H2 Database (untuk testing)

Setelah generate, ekstrak dan buka di IDE Anda.

package com.example.demo;

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

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

      

5. Membuat Endpoint REST Dasar

Buat controller sederhana untuk endpoint GET:

package com.example.demo.controller;

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

@RestController
public class HelloController {
  @GetMapping("/hello")
  public String hello() {
    return "Halo, RESTful API dengan Spring Boot!";
  }
}

      

Jalankan aplikasi dan akses http://localhost:8080/hello di browser atau Postman.

6. Implementasi CRUD dengan Spring Data JPA

Kita akan membuat entitas Book dan repository untuk operasi CRUD.

package com.example.demo.model;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class Book {
  @Id
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  private Long id;
  private String title;
  private String author;

  // Getter dan Setter
  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; }
}

      

package com.example.demo.repository;

import com.example.demo.model.Book;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface BookRepository extends JpaRepository<Book, Long> {
}

      

Selanjutnya buat controller untuk CRUD:

package com.example.demo.controller;

import com.example.demo.model.Book;
import com.example.demo.repository.BookRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/api/books")
public class BookController {
  @Autowired
  private BookRepository bookRepository;

  @GetMapping
  public List<Book> getAllBooks() {
    return bookRepository.findAll();
  }

  @PostMapping
  public Book createBook(@RequestBody Book book) {
    return bookRepository.save(book);
  }

  @GetMapping("/{id}")
  public ResponseEntity<Book> getBookById(@PathVariable Long id) {
    return bookRepository.findById(id)
      .map(ResponseEntity::ok)
      .orElse(ResponseEntity.notFound().build());
  }

  @PutMapping("/{id}")
  public ResponseEntity<Book> updateBook(@PathVariable Long id, @RequestBody Book bookDetails) {
    return bookRepository.findById(id).map(book -> {
      book.setTitle(bookDetails.getTitle());
      book.setAuthor(bookDetails.getAuthor());
      Book updated = bookRepository.save(book);
      return ResponseEntity.ok(updated);
    }).orElse(ResponseEntity.notFound().build());
  }

  @DeleteMapping("/{id}")
  public ResponseEntity<Void> deleteBook(@PathVariable Long id) {
    return bookRepository.findById(id).map(book -> {
      bookRepository.delete(book);
      return ResponseEntity.ok().build();
    }).orElse(ResponseEntity.notFound().build());
  }
}

      

7. Validasi Input dan Error Handling

Gunakan anotasi validasi dari javax.validation untuk memastikan data yang masuk valid.

package com.example.demo.model;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.validation.constraints.NotBlank;

@Entity
public class Book {
  @Id
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  private Long id;

  @NotBlank(message = "Title wajib diisi")
  private String title;

  @NotBlank(message = "Author wajib diisi")
  private String author;

  // Getter dan Setter
  // ...
}

      

Tambahkan validasi di controller dengan anotasi @Valid dan tangani error dengan @ExceptionHandler atau @ControllerAdvice .

import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

import java.util.HashMap;
import java.util.Map;

@RestControllerAdvice
public class ValidationExceptionHandler {
  @ExceptionHandler(MethodArgumentNotValidException.class)
  public Map<String, String> handleValidationExceptions(MethodArgumentNotValidException ex) {
    Map<String, String> errors = new HashMap<>();
    ex.getBindingResult().getAllErrors().forEach(error -> {
      String fieldName = ((FieldError) error).getField();
      String errorMessage = error.getDefaultMessage();
      errors.put(fieldName, errorMessage);
    });
    return errors;
  }
}

      

8. Keamanan API dengan Spring Security

Tambahkan dependensi Spring Security dan konfigurasi sederhana untuk mengamankan endpoint.

package com.example.demo.config;

import org.springframework.context.annotation.Bean;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.web.SecurityFilterChain;

public class SecurityConfig {
  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
    http.csrf().disable()
      .authorizeRequests()
      .antMatchers("/api/**").authenticated()
      .anyRequest().permitAll()
      .and()
      .httpBasic();
    return http.build();
  }
}

      

Dengan konfigurasi ini, semua endpoint /api/** memerlukan autentikasi Basic Auth.

9. Testing API dengan JUnit dan Postman

Buat unit test sederhana untuk controller menggunakan JUnit dan MockMvc:

package com.example.demo;

import com.example.demo.controller.HelloController;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.test.web.servlet.MockMvc;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

@WebMvcTest(HelloController.class)
public class HelloControllerTest {
  @Autowired
  private MockMvc mockMvc;

  @Test
  public void testHello() throws Exception {
    mockMvc.perform(get("/hello"))
      .andExpect(status().isOk())
      .andExpect(content().string("Halo, RESTful API dengan Spring Boot!"));
  }
}

      

Gunakan Postman untuk menguji endpoint CRUD dengan berbagai metode HTTP (GET, POST, PUT, DELETE).

10. Deploy Aplikasi Spring Boot

Setelah aplikasi siap, Anda bisa deploy ke berbagai platform seperti Heroku, AWS, atau server VPS.

Contoh deploy ke Heroku:

1. Install Heroku CLI dan login
2. Build aplikasi dengan mvn clean package
3. Buat aplikasi di Heroku dengan heroku create nama-aplikasi
4. Push kode ke Heroku dengan Git
5. Jalankan aplikasi dan akses URL Heroku

11. Sumber Belajar dan Source Code

Berikut beberapa sumber belajar dan channel yang sangat membantu untuk menguasai RESTful API dengan Spring Boot:

• Spring Official Guide: Building a RESTful Web Service
• Baeldung: REST with Spring Series
• Java Brains (YouTube Channel)
• Programming Techie (YouTube Channel)
• Spring Boot GitHub Repository

Source Code Lengkap:

• https://github.com/yourusername/spring-boot-restful-api-100-steps