泛型類與Java的泛型類型參數化RESTful API設計

泛型類在Java中是一種具有類型參數的類。它們允許你在類定義時指定一個或多個類型參數，這些參數可以在類的方法和屬性中使用。泛型類的主要優點是它們提供了類型安全，避免了類型轉換的錯誤，并提高了代碼的重用性。

在設計RESTful API時，泛型類可以幫助你創建更加靈活和可重用的代碼。以下是一些使用泛型類設計RESTful API的示例：

示例1：泛型資源類

假設你要設計一個RESTful API來處理不同類型的資源，例如用戶、訂單和商品。你可以創建一個泛型資源類，然后為每種資源類型創建具體的子類。

public class Resource<T> {
    private T data;

    public Resource(T data) {
        this.data = data;
    }

    public T getData() {
        return data;
    }

    public void setData(T data) {
        this.data = data;
    }
}

public class UserResource extends Resource<User> {
    // UserResource specific methods and properties
}

public class OrderResource extends Resource<Order> {
    // OrderResource specific methods and properties
}

public class ProductResource extends Resource<Product> {
    // ProductResource specific methods and properties
}

示例2：泛型控制器

接下來，你可以創建一個泛型控制器來處理這些資源類型的請求。

@RestController
@RequestMapping("/api")
public class ResourceController<T> {

    private final Repository<T> repository;

    @Autowired
    public ResourceController(Repository<T> repository) {
        this.repository = repository;
    }

    @GetMapping("/{id}")
    public ResponseEntity<T> getResourceById(@PathVariable Long id) {
        T resource = repository.findById(id).orElseThrow(() -> new ResourceNotFoundException(id));
        return new ResponseEntity<>(resource, HttpStatus.OK);
    }

    @PostMapping("/")
    public ResponseEntity<T> createResource(@RequestBody T resource) {
        T savedResource = repository.save(resource);
        return new ResponseEntity<>(savedResource, HttpStatus.CREATED);
    }

    // Other CRUD methods
}

示例3：泛型服務層

為了進一步分離關注點，你可以創建一個泛型服務層來處理業務邏輯。

@Service
public class ResourceService<T> {

    private final Repository<T> repository;

    @Autowired
    public ResourceService(Repository<T> repository) {
        this.repository = repository;
    }

    public T getResourceById(Long id) {
        return repository.findById(id).orElseThrow(() -> new ResourceNotFoundException(id));
    }

    public T createResource(T resource) {
        return repository.save(resource);
    }

    // Other CRUD methods
}

示例4：泛型數據訪問層

最后，你可以創建一個泛型數據訪問層來處理數據庫操作。

public interface Repository<T> extends JpaRepository<T, Long> {
}

通過這種方式，你可以創建一個靈活且可重用的RESTful API，能夠處理不同類型的資源，同時保持類型安全和代碼的可維護性。