sgcREST: componentes de servidor REST e OpenAPI para Delphi e C++ Builder

O TsgcHTTPRESTServer estende o TsgcHTTPServer padrão com tratamento de CORS através de CORSOptions, e duas propriedades para complementos opcionais: ServerStats e Tenancy. O TsgcHTTPServerStats conta toda requisição por classe de status, rastreia a latência mínima, média e máxima, e serve um endpoint /metrics no formato Prometheus além de um endpoint JSON /health, com GetEndpointStats para um detalhamento por rota. O TsgcHTTPServer_Tenancy resolve o tenant do chamador a partir do nome do host, um segmento de caminho, um cabeçalho de requisição ou uma claim JWT, e a própria propriedade Tenant do servidor lê o resultado para a requisição em andamento. O TsgcHTTPServer_Users é um quarto complemento, independente: um armazenamento local de contas com AddUser, ValidateCredentials, tags de papel e hashing de senha salgado, com criptografia opcional em repouso, consultado diretamente a partir de um manipulador de rota em vez de conectado ao servidor como propriedade.

Spec-first: carregue um documento OpenAPI 3.0 ou 3.1 e o TsgcOpenAPIRouteTable constrói a tabela de rotas automaticamente a partir da sua seção paths. Uma requisição correspondida chega como um TsgcOpenAPIServerContext, com acesso tipado a parâmetros de caminho e query, auxiliares de corpo e RespondJSON/RespondError, o TsgcOpenAPIServerHandler envolve toda chamada em BeforeHandle, AfterHandle e HandleException, e o TsgcOpenAPIJSONValidator verifica corpos, parâmetros de query e de caminho contra os JSON Schemas que a especificação declara. O code-first inverte a fonte da verdade: anote uma classe Delphi comum com os atributos sgcServiceContract, sgcRoute, sgcHttpGet/sgcHttpPost e sgcFromPath/sgcFromQuery/sgcFromBody, e o TsgcOpenAPICodeFirstScanner.GenerateSpec produz o documento OpenAPI diretamente a partir do seu RTTI, sem YAML para escrever à mão. Combine-o com o TsgcOpenAPICodeFirstDispatcher e os métodos anotados são invocados diretamente para cada operação, sem cadeia de dispatch manual. O code-first exige Delphi XE7 ou posterior.

O TsgcOpenAPI_Client é um cliente de runtime genérico para qualquer endpoint que um documento OpenAPI descreva: HTTP_REQUEST carrega a chamada, Authentication cobre autenticação Basic e bearer tokens além de OAuth2 e JWT genéricos, e OnBeforeRequest, OnUpload e OnDownload a acompanham.