Spring中能否继承带@RequestMapping的RestController实现通用接口？

完全可以实现这种通用RestController的设计，借助Spring的注解继承机制，父类定义通用的BREAD（CRUD）接口逻辑，子类仅需指定专属的URL前缀，无需重写父类方法即可完成接口映射。

核心实现步骤及代码示例 #

1. 定义通用父类控制器

父类通过泛型约束实体类型，注入对应的通用服务，实现所有通用CRUD接口方法。注意父类不要添加类级别的@RestController和@RequestMapping，仅在方法上配置相对路径的请求映射：

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.util.List;

public abstract class BaseVehiculeController<T extends Vehicule> {

    protected final VehiculeService<T> service;

    // 构造函数注入通用服务，子类传入具体实现
    protected BaseVehiculeController(VehiculeService<T> service) {
        this.service = service;
    }

    @GetMapping
    public List<T> getAll() {
        return service.findAll();
    }

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

    @PostMapping
    public T create(@RequestBody T entity) {
        return service.save(entity);
    }

    @PutMapping("/{id}")
    public ResponseEntity<T> update(@PathVariable Long id, @RequestBody T entity) {
        if (!service.existsById(id)) {
            return ResponseEntity.notFound().build();
        }
        entity.setId(id);
        return ResponseEntity.ok(service.save(entity));
    }

    @DeleteMapping("/{id}")
    public ResponseEntity<Void> delete(@PathVariable Long id) {
        if (!service.existsById(id)) {
            return ResponseEntity.notFound().build();
        }
        service.deleteById(id);
        return ResponseEntity.noContent().build();
    }
}

2. 实现子类控制器

子类只需添加@RestController和类级别的@RequestMapping指定专属URL，通过构造函数传入自身对应的服务实现即可：

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

@RestController
@RequestMapping("/api/cars")
public class CarController extends BaseVehiculeController<Car> {

    public CarController(CarService carService) {
        super(carService);
    }
}

其他子类如BikeController、ShipController只需修改@RequestMapping的路径和注入的服务类：

@RestController
@RequestMapping("/api/bikes")
public class BikeController extends BaseVehiculeController<Bike> {
    public BikeController(BikeService bikeService) {
        super(bikeService);
    }
}

关键注意事项 #

• 路径自动拼接：父类方法的相对路径会自动与子类的@RequestMapping前缀拼接，比如CarController的@GetMapping("/{id}")最终映射为/api/cars/{id}。
• 依赖自动注入：Spring会根据子类构造函数的参数类型，自动注入对应的服务实现类（如CarService），无需额外配置。
• 灵活扩展：若某个子类需要修改特定接口逻辑，直接在子类中重写对应方法即可，不会影响其他子类。
• 类型安全保障：通过泛型约束T extends Vehicule，确保所有子类控制器处理正确的实体类型，避免类型转换错误。

内容的提问来源于stack exchange，提问作者galalem