Package org.praxisplatform.uischema.openapi

Interface CanonicalOperationResolver

All Known Implementing Classes:
OpenApiCanonicalOperationResolver
public interface CanonicalOperationResolver
Resolve a identidade canonica de operacoes OpenAPI documentadas.

Esta fronteira desacopla controllers e catalogos da heuristica concreta usada para chegar em group + operationId + path + method. Ela atende tanto fluxos baseados apenas em path + method quanto fluxos que partem de HandlerMethod.

  • Method Details

    • resolveGroup

      String resolveGroup(String path)
      Resolve apenas o grupo canonico associado ao path informado.

    • resolve

      CanonicalOperationRef resolve(String path, String method)
      Resolve uma referencia canonica de rota a partir de path + method.

      Esta sobrecarga garante group, path e method canonicos, mas pode retornar operationId = null porque nao existe contexto de handler associado.

    • resolve

      CanonicalOperationRef resolve(org.springframework.web.method.HandlerMethod handlerMethod, org.springframework.web.servlet.mvc.method.RequestMappingInfo mappingInfo)
      Resolve uma referencia canonica completa a partir do handler e do mapping do Spring MVC.

      Implementacoes podem aplicar heuristicas para escolher o path e o metodo canonicos quando o mapping tiver multiplos valores. Essas heuristicas devem permanecer documentadas porque superficies futuras de discovery dependem delas.

    • resolveByOperationId

      Optional<CanonicalOperationRef> resolveByOperationId(String operationId)
      Procura uma operacao documentada pelo seu operationId.

      Implementacoes podem precisar varrer o registro de handlers do Spring para produzir a referencia completa correspondente.