Từ trước đến nay, việc phát triển các ứng dụng web chưa bao giờ là hết “hot”. Với việc các website càng ngày càng phức tạp, việc tạo ra các RESTful API (Application Programming Interface) đã trở thành một phần quan trọng của quá trình phát triển. Với RESTful API chúng ta có thể dễ dàng giao tiếp giữa các ứng dụng thông qua giao thức HTTP. Một trong những cách phổ biến để xây dựng RESTful API là sử dụng Spring Boot, một framework Java mạnh mẽ cho phát triển ứng dụng. Trong bài viết này, chúng ta sẽ tìm hiểu cách tạo RESTful API với Spring Boot.

1. Code ví dụ tạo Restful API với Spring Boot

1.1. Cấu trúc dự án

Tạo RESTful API với Spring Boot (Hình 1

Trong sơ đồ trên chúng ta thấy có các thành phần chính là controller, model, repository, service đây cũng là mô hình cơ bản mà chúng ta sẽ thấy rất nhiều trong các dự án sau này. Dưới đây chúng ta sẽ tìm hiểu về từng thành phần trong mô hình trên.

1.2. Cài đặt thư viện

Đầu tiên để chuẩn bị cho việc khởi tạo dự án chúng ta cần phải thêm một số thư viện cần thiết vào pom.xml

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
</dependency>

Ở bước này có thể có sự khác biệt giữa các IDE, cũng như là cấu trúc dự án nên các bạn có thể tìm hiểu hơn về tài liệu tương ứng tại đây.

1.3. Controller

  • Chức năng: Controller là một phần quan trọng của ứng dụng RESTful API, nó nhận và xử lý các yêu cầu HTTP từ các client (thường là trình duyệt hoặc ứng dụng di động) và trả về các phản hồi thích hợp.
  • Cách sử dụng: Bạn đánh dấu các lớp với @RestController hoặc các chú thích tương tự để chỉ định rằng đây là các controller. Các phương thức bên trong controller được đánh dấu với các chú thích như @GetMapping, @PostMapping, @PutMapping, và @DeleteMapping để xác định các endpoint API và xử lý các yêu cầu từ client.

CategoryController.java

@RestController
@RequestMapping("v1/category")
public class CategoryController {

    @Autowired
    private CategoryService categoryService;

    @GetMapping("{id}")
    public ResponseEntity<Category> findCategory(@PathVariable Integer id) {
        Optional<Category> categoryOptional = categoryService.findCategory(id);
        return categoryOptional.map(ResponseEntity::ok)
                .orElseGet(() -> new ResponseEntity<>(HttpStatus.NOT_FOUND));
    }

    @GetMapping
    public ResponseEntity<List<Category>> findAll() {
        return ResponseEntity.ok(categoryService.findAll());
    }

    @PostMapping
    public ResponseEntity<Category> save(@RequestBody Category category) {
        return ResponseEntity.ok(categoryService.save(category));
    }

    @PutMapping
    public ResponseEntity<Category> update(@RequestBody Category category) {
        return ResponseEntity.ok(categoryService.update(category));
    }

    @DeleteMapping
    public void delete(@RequestBody Category category) {
         categoryService.delete(category);
    }
}

1.4. Model

  • Chức năng: Model đại diện cho dữ liệu hoặc đối tượng mà bạn muốn truy cập hay cung cấp thông qua API. Nó định nghĩa cấu trúc dữ liệu và các trường của đối tượng.
  • Cách sử dụng: Bạn tạo các lớp model để mô tả cấu trúc dữ liệu và thông tin về các đối tượng mà bạn sẽ thao tác với trong ứng dụng. Đối tượng model này thường được sử dụng trong các phương thức của Controller và Repository để thao tác với dữ liệu.

Category.java

@Entity
@Table(name = "category")
@Getter @Setter
public class Category {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")
    private Integer id;

    @Column(name = "name")
    private String name;

    @Column(name = "slug")
    private String slug;
}

1.5. Repository

  • Chức năng: Repository làm nhiệm vụ truy cập và tương tác với cơ sở dữ liệu. Nó cung cấp các phương thức để lưu trữ và truy vấn dữ liệu từ cơ sở dữ liệu.
  • Cách sử dụng: Bạn tạo các interface hoặc lớp repository với các phương thức để thực hiện các thao tác CRUD (Create, Read, Update, Delete) với đối tượng model. Spring Boot thường tích hợp Spring Data JPA để giúp bạn tạo repository một cách dễ dàng.

CategoryRepository.java

@Repository
    public interface CategoryRepository extends JpaRepository<Category, Integer> {
}

1.6. Service

  • Chức năng: Service làm nhiệm vụ kết nối giữa Controller và Repository. Nó chứa logic kinh doanh, kiểm tra quyền truy cập, xử lý nghiệp vụ và gọi các phương thức từ Repository để truy cập hoặc cập nhật dữ liệu.
  • Cách sử dụng: Bạn tạo các lớp service để xử lý logic nghiệp vụ. Các controller gọi các phương thức từ service để thực hiện các tác vụ nghiệp vụ. Điều này giúp tách biệt logic nghiệp vụ và logic truy cập dữ liệu, làm cho mã nguồn dễ quản lý và bảo trì.

CategoryService.java

public interface CategoryService {
    Optional<Category> findCategory(Integer id);
    List<Category> findAll();
    Category save(Category category);
    Category update(Category category);
    void delete(Category category);
}

CategoryServiceImpl.java

@Service
public class CategoryServiceImpl implements CategoryService{

    @Autowired
    private CategoryRepository categoryRepository;

    @Override
    public Category save(Category category) {
        return categoryRepository.save(category);
    }

    @Override
    public Optional<Category> findCategory(Integer id) {
        return categoryRepository.findById(id);
    }

    @Override
    public List<Category> findAll() {
        return categoryRepository.findAll();
    }

    @Override
    public Category update(Category category) {
        return categoryRepository.save(category);
    }

    @Override
    public void delete(Category category) {
       categoryRepository.delete(category);
    }
}

 

>>> Xem thêm bài viết:

 

2. Sự hỗ trợ tích hợp nhanh chóng của Stringee

Phía trên, chúng ta đã có nói về việc Stringee đã sử dụng RESTful API trong Spring Boot. Với việc đó, Stringee giúp cho các nhà phát triển có thể dễ dàng tích hợp các tính năng giao tiếp vào các ứng dụng web và di động một cách nhanh chóng và dễ dàng hơn. Chúng ta sẽ cùng nhau tìm hiểu cụ thể xem giải pháp này mang lại lợi ích gì cho các nhà phát triển nhé.

2.1. Dễ dàng tích hợp

Stringee cung cấp các SDK và API dễ sử dụng cho nhiều ngôn ngữ lập trình, trong đó có JavaScript. Điều này cho phép bạn tích hợp các tính năng giao tiếp vào ứng dụng của mình chỉ trong vài bước đơn giản. Hãy xem một ví dụ cụ thể về cách tích hợp cuộc gọi thoại vào ứng dụng web bằng Stringee và JavaScript:

// Khởi tạo StringeeClient
var stringeeClient = new Stringee.Client({ token: 'YOUR_ACCESS_TOKEN' });

// Khi người dùng nhấn nút để gọi
function makeCall() {
   // Tạo cuộc gọi
   var call = stringeeClient.call('USER_ID_OR_PHONE_NUMBER');
   
   // Xử lý sự kiện khi cuộc gọi được chấp nhận hoặc kết thúc
   call.on('addStream', function (data) {
       var remoteStream = data.stream;
       // Hiển thị luồng âm thanh và hình ảnh từ người gọi
   });
   
   // Gửi cuộc gọi
   call.makeCall();
}

Với các dòng mã như trên, bạn đã tích hợp chức năng gọi thoại vào ứng dụng web của mình một cách nhanh chóng.

2.2. Tích hợp đa nền tảng

Stringee không chỉ hỗ trợ tích hợp vào các ứng dụng web mà còn hỗ trợ tích hợp vào các ứng dụng di động trên nhiều nền tảng như iOS và Android. Điều này cho phép bạn phục vụ một lượng lớn người dùng trên các thiết bị khác nhau và tạo trải nghiệm đồng nhất trên cả các nền tảng này.

2.3. Bảo mật và đáng tin cậy

Stringee đảm bảo tính bảo mật và đáng tin cậy của thông tin giao tiếp trong ứng dụng của bạn. Dữ liệu giao tiếp qua Stringee được mã hóa và bảo vệ bằng các biện pháp bảo mật tiên tiến để đảm bảo sự riêng tư của người dùng. Hãy xem một ví dụ về việc thiết lập một cuộc gọi bảo mật bằng Stringee:

// Khởi tạo StringeeClient với mã token đã mã hóa
var stringeeClient = new Stringee.Client({ token: 'ENCRYPTED_ACCESS_TOKEN' });

// Khởi tạo cuộc gọi bảo mật
var call = stringeeClient.call('USER_ID_OR_PHONE_NUMBER', true);

// Xử lý sự kiện khi cuộc gọi được chấp nhận hoặc kết thúc
call.on('addStream', function (data) {
   var remoteStream = data.stream;
   // Hiển thị luồng âm thanh và hình ảnh từ người gọi
});

// Gửi cuộc gọi
call.makeCall();

2.4. Hỗ trợ nhiều tính năng giao tiếp

Ngoài cuộc gọi thoại, Stringee còn hỗ trợ nhiều tính năng giao tiếp khác như tin nhắn và video call. Bạn có thể tích hợp tất cả các tính năng này vào ứng dụng của mình thông qua Stringee một cách dễ dàng.

2.5. Tài liệu và hỗ trợ từ cộng đồng

Stringee cung cấp tài liệu hướng dẫn chi tiết và có cộng đồng hỗ trợ. Bạn có thể tìm thấy hướng dẫn sử dụng, ví dụ mã, và câu hỏi thường gặp trên trang web của Stringee để giúp bạn giải quyết mọi vấn đề tích hợp.

Ví dụ: Tích hợp Chat trong Ứng dụng Web bằng Stringee

Dưới đây là một ví dụ về cách tích hợp tính năng chat vào ứng dụng web bằng Stringee và JavaScript:

// Khởi tạo StringeeClient
var stringeeClient = new Stringee.Client({ token: 'YOUR_ACCESS_TOKEN' });

// Khi người dùng nhấn nút để gửi tin nhắn
function sendMessage() {
   var conversationId = 'CONVERSATION_ID';
   var messageContent = 'Hello, how are you?';
   
   // Tạo một tin nhắn và gửi nó
   var message = stringeeClient.createMessage(conversationId, messageContent);
   
   // Gửi tin nhắn
   message.send(function (res) {
       if (res.code === 0) {
           console.log('Tin nhắn đã được gửi thành công.');
       } else {
           console.log('Lỗi khi gửi tin nhắn: ' + res.message);
       }
   });
}

Với các dòng mã như trên, bạn đã tích hợp tính năng chat vào ứng dụng web của mình sử dụng Stringee.

Tóm lại, Stringee là một nền tảng mạnh mẽ cho phép bạn tích hợp các tính năng giao tiếp vào ứng dụng của mình một cách nhanh chóng và đáng tin cậy. Điều này giúp bạn cung cấp trải nghiệm người dùng tốt hơn và tiết kiệm thời gian phát triển ứng dụng.

Tổng kết

Tạo RESTful API với Spring Boot là một quá trình mạnh mẽ và hiệu quả. Spring Boot giúp bạn tạo ra các API một cách nhanh chóng và dễ dàng, cho phép ứng dụng của bạn giao tiếp với các ứng dụng khác thông qua giao thức HTTP. Điều này rất hữu ích trong việc xây dựng các hệ thống phân tán và microservices.

Hy vọng rằng bài viết này đã giúp bạn hiểu cách tạo RESTful API với Spring Boot. Hãy thử thực hiện các bước trên và bắt đầu xây dựng các API cho ứng dụng của bạn.

Stringee Communication APIs là giải pháp cung cấp các tính năng giao tiếp như gọi thoại, gọi video, tin nhắn chat, SMS hay tổng đài CSKH cho phép tích hợp trực tiếp vào ứng dụng/website của doanh nghiệp nhanh chóng. Nhờ đó giúp tiết kiệm đến 80% thời gian và chi phí cho doanh nghiệp bởi thông thường nếu tự phát triển các tính năng này có thể mất từ 1 - 3 năm.

Bộ API giao tiếp của Stringee hiện đang được tin dùng bởi các doanh nghiệp ở mọi quy mô, lĩnh vực ngành nghề như TPBank, VOVBacsi24, VNDirect, Shinhan Finance, Ahamove, Logivan, Homedy,  Adavigo, bTaskee…

Quý bạn đọc quan tâm xin mời đăng ký NHẬN TƯ VẤN TẠI ĐÂY: