Package org.praxisplatform.uischema.openapi

Class OpenApiCanonicalOperationResolver

java.lang.Object

org.praxisplatform.uischema.openapi.OpenApiCanonicalOperationResolver

All Implemented Interfaces:

CanonicalOperationResolver

public class OpenApiCanonicalOperationResolver
extends Object
implements CanonicalOperationResolver

Implementacao padrao de CanonicalOperationResolver baseada no registro de handlers do Spring MVC.

No fluxo path + method, a classe apenas normaliza a rota e resolve o grupo associado. No fluxo HandlerMethod + RequestMappingInfo, ela escolhe o menor path declarado no mapping, usa o primeiro metodo HTTP disponivel e define o operationId a partir de Operation.operationId() ou, na falta dele, do nome do metodo Java.

A busca por operationId percorre os handlers registrados no RequestMappingHandlerMapping e devolve a primeira correspondencia exata.

Constructor Summary

Constructors

Constructor	Description
OpenApiCanonicalOperationResolver(OpenApiDocumentService openApiDocumentService, org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping handlerMapping)

Method Summary

Modifier and Type	Method	Description
CanonicalOperationRef	resolve(String path, String method)	Resolve uma referencia canonica de rota a partir de path + method.
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.
Optional<CanonicalOperationRef>	resolveByOperationId(String operationId)	Procura uma operacao documentada pelo seu operationId.
String	resolveGroup(String path)	Resolve apenas o grupo canonico associado ao path informado.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

OpenApiCanonicalOperationResolver

public OpenApiCanonicalOperationResolver(OpenApiDocumentService openApiDocumentService,
 org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping handlerMapping)

Method Details

resolveGroup

public String resolveGroup(String path)

Description copied from interface: CanonicalOperationResolver

Resolve apenas o grupo canonico associado ao path informado.

Specified by:

resolveGroup in interface CanonicalOperationResolver

resolve

public CanonicalOperationRef resolve(String path,
 String method)

Description copied from interface: CanonicalOperationResolver

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.

Specified by:

resolve in interface CanonicalOperationResolver

resolve

public CanonicalOperationRef resolve(org.springframework.web.method.HandlerMethod handlerMethod,
 org.springframework.web.servlet.mvc.method.RequestMappingInfo mappingInfo)

Description copied from interface: CanonicalOperationResolver

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.

Specified by:

resolve in interface CanonicalOperationResolver

resolveByOperationId

public Optional<CanonicalOperationRef> resolveByOperationId(String operationId)

Description copied from interface: CanonicalOperationResolver

Procura uma operacao documentada pelo seu operationId.

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

Specified by:

resolveByOperationId in interface CanonicalOperationResolver