Giới thiệu Java Service Provider Interface (SPI) – Tạo các ứng dụng Java dễ mở rộng

Bài viết được sự cho phép của tác giả Nguyễn Hữu Khanh

Hầu hết vòng đời của một ứng dụng xoay quanh việc bảo trì. Một ứng dụng có thể mở rộng cho phép bảo trì dễ dàng, tức là nâng cấp một tính năng mà không ảnh hưởng đến toàn bộ ứng dụng. Trong bài viết này chúng ta sẽ tìm hiểu về Java Service Provider Interface (SPI) và cách chúng ta có thể áp dụng nó vào trường hợp sử dụng thực tế để tạo các ứng dụng dễ dàng mở rộng, tạo ứng dụng theo các kiến trúc module, plugin.

Các thành phần của Java Service Provider Interface (SPI)

Một Service Provider framework là một hệ thống trong đó nhiều nhà cung cấp dịch vụ (Service Provider) implement một Service và hệ thống này cung cấp các implement cho client sử dụng. SPI giúp giảm kết dính và che dấu thông tin giữa các thành phần của ứng dụng.

Java SPI định nghĩa các thành phần chính sau:

• Service : là một tập hợp các interface/ abstract class mà nó cung cấp quyền truy cập vào một số chức năng hoặc tính năng ứng dụng cụ thể.
• Service Provider Interface (SPI): là một tập hợp interface/ abstract hoạt động như một proxy hoặc điểm cuối (endpoint) cho service.
• Service Provider : là một triển khai cụ thể của SPI. Nó chứa một hoặc nhiều class cụ thể implements hoặc extends một Service.
• ServiceLoader : là thành phần không thể thiếu của SPI. Nó có vai trò tìm kiếm và load các implements khi được yêu cầu. Nó sử dụng context classpath để xác định vị trí các provider implement provider và lưu chúng vào cache để tăng performance.

Cài đặt và sử dụng SPI

Giả sử chúng ta có một ứng dụng cung cấp các service cho các ứng dụng khác sử dụng. Mỗi service của chúng ta có nhiều provider (implementation) khác nhau. Các ứng dụng có thể lựa chọn provider mà nó cần hoặc tự implement một provider khác tuân theo đặc tả của SPI.

Để dễ dàng thêm bớt service mà không ảnh hưởng đến các ứng dụng khác, chúng ta sẽ sử dụng tính năng có sẵn trong Java 6 là ServiceLoader. Hãy xem ví dụ sau:

Đầu tiên, tạo project maven với tên là JavaSPI. Cấu hình file pom.xml như sau:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.gpcoder</groupId>
    <artifactId>JavaSPI</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>JavaSPI</name>
    <url>http://maven.apache.org</url>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties>

    <dependencies>
    </dependencies>
</project>

Tiếp theo tạo một Service, chẳng hạn chúng ta cung cấp Serivce hỗ trợ tìm kiếm. Service này chỉ gồm 1 phương thức đơn giản search().

Tham khảo việc làm Java mới nhất trên TopDev

SearchService.java

package com.gpcoder.spi;

import java.util.List;

public interface SearchService {

    List<Result> search(String text);
}

Tiếp theo, chúng ta sẽ tạo các Provider được cung cấp bởi hệ thống:

• DefaultSearchService : hỗ trợ search thông thường.
• FullTextSearchService : hỗ trợ search toàn văn.

DefaultSearchService.java

package com.gpcoder.spi;

import java.util.List;

public class DefaultSearchService implements SearchService {

    @Override
    public List<Result> search(String text) {
        System.out.println("DefaultSearchService#search()");
        return null;
    }
}

FullTextSearchService.java

package com.gpcoder.spi;

import java.util.List;

public class FullTextSearchService implements SearchService {

    @Override
    public List<Result> search(String text) {
        System.out.println("FullTextSearchService#search()");
        return null;
    }
}

Để sử dụng SPI, chúng ta cần tạo một file cấu hình:

• Tên file: là tên đầy đủ của Service, bao gồm cả tên package. Ví dụ: com.gpcoder.spi.SearchService
• Nội dung file: là tên đầy đủ của Service implement, mỗi implement trên một dòng. Ví dụ: com.gpcoder.spi.DefaultSearchService
  com.gpcoder.spi.FullTextSearchService
• Vị trí: đặt file này trong thư mục resources/META-INF/services

Cuối cùng, chúng ta sẽ sử dụng ServiceLoader để lấy các Provider đã được đăng ký thông qua cấu hình SPI ở trên:

package com.gpcoder.spi;

import java.util.ServiceLoader;

public class ServiceLoaderExample {
    public static void main(String[] args) {
        System.out.println("App started ");

        ServiceLoader<SearchService> serviceLoader = ServiceLoader.load(SearchService.class);
        for (SearchService provider : serviceLoader) {
            provider.search("");
        }

        System.out.println("App finished ");
    }
}

Output của chương trình:

App started 
DefaultSearchService#search()
FullTextSearchService#search()
App finished

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.gpcoder.child1</groupId>
    <artifactId>JavaSPIChild1</artifactId>
    <packaging>jar</packaging>

    <name>JavaSPIChild1</name>
    <url>http://maven.apache.org</url>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties>

    <parent>
        <groupId>com.gpcoder</groupId>
        <artifactId>JavaSPI</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <relativePath>../JavaSPI</relativePath>
    </parent>

    <dependencies>
         <dependency>
             <groupId>com.gpcoder</groupId>
             <artifactId>JavaSPI</artifactId>
             <version>0.0.1-SNAPSHOT</version>
         </dependency>
     </dependencies>
</project>

<packaging>pom</packaging>

package com.gpcoder.child1;

import java.util.List;

import com.gpcoder.spi.Result;
import com.gpcoder.spi.SearchService;

public class Child1SearchService implements SearchService {

    @Override
    public List<Result> search(String text) {
        System.out.println("Child1SearchService#search()");
        return null;
    }
}

com.gpcoder.spi.DefaultSearchService
com.gpcoder.child1.Child1SearchService

package com.gpcoder.child1;

import java.util.ServiceLoader;

import com.gpcoder.spi.SearchService;

public class Child1ServiceLoaderExample {
    public static void main(String[] args) {
        System.out.println("App started ");

        ServiceLoader<SearchService> providers = ServiceLoader.load(SearchService.class);
        for (SearchService provider : providers) {
            provider.search("");
        }

        System.out.println("Child1SearchService: ");
        SearchService service = getServiceByName(Child1SearchService.class.getCanonicalName());
        service.search("");

        System.out.println("App finished ");
    }

    public static SearchService getServiceByName(String className) {
        ServiceLoader<SearchService> providers = ServiceLoader.load(SearchService.class);
        for (SearchService provider : providers) {
            if (provider.getClass().getCanonicalName().equals(className)) {
                return provider;
            }
        }
        return null;
    }
}

App started
DefaultSearchService#search()
Child1SearchService#search()
Child1SearchService:
Child1SearchService#search()
App finished

Có thể bạn quan tâm:

• Tránh lỗi ConcurrentModificationException trong Java như thế nào?
• Lưu ý cho Lock trong Java
• Top 10 việc làm tuyển dụng ngành IT mới nhất 2023

Xem thêm công việc CNTT hấp dẫn trên TopDev