Package org.praxisplatform.uischema.controller.docs

Class DomainCatalogController

java.lang.Object

org.praxisplatform.uischema.controller.docs.DomainCatalogController

@RestController
@RequestMapping("/schemas/catalog")
public class DomainCatalogController
extends Object

Exporta um catalogo enxuto de dominios e endpoints do OpenAPI.

Esta superficie foi desenhada para consumo operacional e semantico por clientes que nao precisam do documento OpenAPI completo, como pipelines de RAG, indexadores documentais e discovery incremental. O controller resume operacoes, tags, parametros, exemplos e links para os schemas filtrados correspondentes.

A resolucao de grupo, documento OpenAPI e schema links canonicos e delegada a OpenApiDocumentService, CanonicalOperationResolver e SchemaReferenceResolver.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DomainCatalogController.CatalogResponse
static class	DomainCatalogController.EndpointSummary
static class	DomainCatalogController.FieldSummary
static class	DomainCatalogController.ParameterSummary
static class	DomainCatalogController.RelationSummary
static class	DomainCatalogController.SchemaLinks
static class	DomainCatalogController.SchemaRef

Constructor Summary

Constructors

Constructor	Description
DomainCatalogController()

Method Summary

Modifier and Type	Method	Description
org.springframework.http.ResponseEntity<DomainCatalogController.CatalogResponse>	getCatalog(String group, String pathFilter, String operationFilter)	Gera um catalogo resumido das operacoes publicadas em um grupo OpenAPI.

Methods inherited from class java.lang.Object

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

Constructor Details

DomainCatalogController

public DomainCatalogController()

Method Details

getCatalog

@GetMapping
public org.springframework.http.ResponseEntity<DomainCatalogController.CatalogResponse> getCatalog(@RequestParam(name="group",required=false)
 String group,
 @RequestParam(name="path",required=false)
 String pathFilter,
 @RequestParam(name="operation",required=false)
 String operationFilter)

Gera um catalogo resumido das operacoes publicadas em um grupo OpenAPI.

Cada item do catalogo inclui path, metodo HTTP, resumo, descricao, operationId, parametros, exemplos e schemaLinks canonicos de request/response quando existirem. Esses links passam pelo SchemaReferenceResolver e ficam alinhados ao mesmo contrato estrutural usado por /schemas/filtered.