SpringBoot模块多项目解耦的最佳实践

@startuml 
!theme plain 
 
component "TMS Module" as TMS {
    interface ErpOrderAccessor <<Interface>> {
        +fetchOrderDetail(Long): OrderDetail 
    }
    
    class LogisticsService {
        +trackLogistics(Long)
    }
}
 
component "ERP Module" as ERP {
    class ErpOrderServiceImpl {
        +fetchOrderDetail(Long): OrderDetail 
    }
}
 
TMS.ErpOrderAccessor <|.. ERP.ErpOrderServiceImpl : 实现 
TMS.LogisticsService --> TMS.ErpOrderAccessor : 依赖 
 
note right of ERP.ErpOrderServiceImpl 
    @Transactional注解确保事务边界 
    数据访问层隔离在ERP模块内部 
end note 
@enduml

// TMS模块 com.tms.api
public interface ErpOrder {
Accessor    OrderDetail fetchOrderDetail(Long orderId);
}

// ERP模块 com.erp.service.impl 
@Service
public class ErpOrderServiceImpl implements ErpOrderAccessor {
 
    @Autowired
    private ErpOrderMapper erpOrderMapper;
 
    @Override
    @Transactional(readOnly = true)
    public OrderDetail fetchOrderDetail(Long orderId) {
        return erpOrderMapper.selectDetail(orderId);
    }
}

// TMS模块
@Service
public class LogisticsService {
 
    @Autowired
    private ErpOrderAccessor orderAccessor;
 
    public void trackLogistics(Long orderId) {
        OrderDetail detail = orderAccessor.fetchOrderDetail(orderId);
        // 物流跟踪逻辑...
   }

@startuml 
!theme plain 
 
component "TMS Module" as TMS {
    abstract class BaseOrderService {
        +loadOrderDetails(Long): OrderDetail 
    }
    
    class ShippingService {
        +calculateCost(Long)
    }
}
 
component "ERP Module" as ERP {
    class ErpOrderService {
        +loadOrderDetails(Long): OrderDetail 
    }
}
 
TMS.BaseOrderService <|-- ERP.ErpOrderService : 继承 
TMS.ShippingService --> TMS.BaseOrderService : 依赖 
 
note left of TMS.BaseOrderService 
    抽象类可定义模板方法：
    loadAndValidate() {
        detail = loadDetails()
        validate(detail)
    }
end note 
@enduml

// TMS模块 com.tms.abstracts
public abstract class BaseOrderService {
    protected abstract OrderDetail loadOrderDetails(Long orderId);
}

// ERP模块 com.erp.service.impl
@Service
public class ErpOrderService extends BaseOrderService {
 
    @Override
    @Transactional(readOnly = true)
    public OrderDetail loadOrderDetails(Long orderId) {
        // ERP-specific查询实现
    }
}

// TMS模块
@Service
public class ShippingService {
 
    @Autowired
    private BaseOrderService orderService;
 
    public void calculateCost(LongShipping orderId) {
        OrderDetail detail = orderService.loadOrderDetails(orderId);
        // 运费计算逻辑...
    }
}

@Configuration
public classConfig Interface {
    // JDK动态代理代替CGLIB
    @Bean
    public Factory<BeanErpOrderAccessor> erpServiceProxy() {
        return new JdkProxyFactoryBean<>(ErpOrderAccessor.class);
    }
}

@Cacheable(key = "#orderId", cacheNames = "orderDetails")
public abstract OrderDetail loadOrderDetails(Long orderId);

// 通过接口解耦实现跨模块调用
public void traceOrderHistory(Long orderId) {
    OrderDetail detail = erpAccessor.fetch(orderId);
    List<LogisticsNode> nodes = tmsMapperTrack.queryNodes(detail.getLogisticsNo());
    // 视图组装逻辑...
}