# Fornecedores de Serviços Source: https://docs.sisk-framework.org/pt-br/docs/extensions/service-providers.html Fornecedores de Serviços é uma forma de portar seu aplicativo Sisk para diferentes ambientes com um arquivo de configuração portátil. Essa funcionalidade permite alterar a porta do servidor, parâmetros e outras opções sem precisar modificar o código do aplicativo para cada ambiente. Esse módulo depende da sintaxe de construção do Sisk e pode ser configurado por meio do método UsePortableConfiguration. Um provedor de configuração é implementado com IConfigurationProvider, que fornece um leitor de configuração e pode receber qualquer implementação. Por padrão, o Sisk fornece um leitor de configuração JSON, mas também há um pacote para arquivos INI. Você também pode criar seu próprio provedor de configuração e registrá-lo com: ```csharp using var app = HttpServer.CreateBuilder() .UsePortableConfiguration(config => { config.WithConfigReader(); }) .Build(); ``` Como mencionado anteriormente, o provedor padrão é um arquivo JSON. Por padrão, o nome do arquivo procurado é service-config.json, e ele é procurado no diretório atual do processo em execução, não no diretório do executável. Você pode escolher alterar o nome do arquivo, bem como onde o Sisk deve procurar o arquivo de configuração, com: ```csharp using Sisk.Core.Http; using Sisk.Core.Http.Hosting; using var app = HttpServer.CreateBuilder() .UsePortableConfiguration(config => { config.WithConfigFile("config.toml", createIfDontExists: true, lookupDirectories: ConfigurationFileLookupDirectory.CurrentDirectory | ConfigurationFileLookupDirectory.AppDirectory); }) .Build(); ``` O código acima procurará o arquivo config.toml no diretório atual do processo em execução. Se não for encontrado, ele procurará no diretório onde o executável está localizado. Se o arquivo não existir, o parâmetro createIfDontExists será honrado, criando o arquivo, sem conteúdo, no último caminho testado (com base em lookupDirectories), e um erro será lançado no console, impedindo que o aplicativo seja inicializado. > [!TIP] > > Você pode olhar o código-fonte do leitor de configuração INI e do leitor de configuração JSON para entender como um IConfigurationProvider é implementado. ## Lendo configurações de um arquivo JSON Por padrão, o Sisk fornece um provedor de configuração que lê configurações de um arquivo JSON. Esse arquivo segue uma estrutura fixa e é composto pelos seguintes parâmetros: ```json { "Server": { "DefaultEncoding": "UTF-8", "ThrowExceptions": true, "IncludeRequestIdHeader": true }, "ListeningHost": { "Label": "Meu aplicativo Sisk", "Ports": [ "http://localhost:80/", "https://localhost:443/", // Arquivos de configuração também suportam comentários ], "CrossOriginResourceSharingPolicy": { "AllowOrigin": "*", "AllowOrigins": [ "*" ], // Novo no 0.14 "AllowMethods": [ "*" ], "AllowHeaders": [ "*" ], "MaxAge": 3600 }, "Parameters": { "MySqlConnection": "server=localhost;user=root;" } } } ``` Os parâmetros criados a partir de um arquivo de configuração podem ser acessados no construtor do servidor: ```csharp using var app = HttpServer.CreateBuilder() .UsePortableConfiguration(config => { config.WithParameters(paramCollection => { string databaseConnection = paramCollection.GetValueOrThrow("MySqlConnection"); }); }) .Build(); ``` Cada leitor de configuração fornece uma forma de ler os parâmetros de inicialização do servidor. Algumas propriedades são indicadas para estar no ambiente do processo em vez de serem definidas no arquivo de configuração, como dados de API sensíveis, chaves de API, etc. ## Estrutura do arquivo de configuração O arquivo de configuração JSON é composto pelas seguintes propriedades:
Propriedade Obrigatório Descrição
Server Obrigatório Representa o servidor em si com suas configurações.
Server.AccessLogsStream Opcional Padrão para console. Especifica o fluxo de saída do log de acesso. Pode ser um nome de arquivo, null ou console.
Server.ErrorsLogsStream Opcional Padrão para null. Especifica o fluxo de saída do log de erros. Pode ser um nome de arquivo, null ou console.
Server.MaximumContentLength Opcional
Server.MaximumContentLength Opcional Padrão para 0. Especifica o comprimento máximo de conteúdo em bytes. Zero significa infinito.
Server.IncludeRequestIdHeader Opcional Padrão para false. Especifica se o servidor HTTP deve enviar o cabeçalho X-Request-Id.
Server.ThrowExceptions Opcional Padrão para true. Especifica se as exceções não tratadas devem ser lançadas. Defina como false quando em produção e true quando em depuração.
ListeningHost Obrigatório Representa o host de escuta do servidor.
ListeningHost.Label Opcional Representa o rótulo do aplicativo.
ListeningHost.Ports Obrigatório Representa uma matriz de strings, correspondendo à sintaxe ListeningPort.
ListeningHost.CrossOriginResourceSharingPolicy Opcional Configura os cabeçalhos CORS para o aplicativo.
ListeningHost.CrossOriginResourceSharingPolicy.AllowCredentials Opcional Padrão para false. Especifica o cabeçalho Allow-Credentials.
ListeningHost.CrossOriginResourceSharingPolicy.ExposeHeaders Opcional Padrão para null. Essa propriedade espera uma matriz de strings. Especifica o cabeçalho Expose-Headers.
ListeningHost.CrossOriginResourceSharingPolicy.AllowOrigin Opcional Padrão para null. Essa propriedade espera uma string. Especifica o cabeçalho Allow-Origin.
ListeningHost.CrossOriginResourceSharingPolicy.AllowOrigins Opcional Padrão para null. Essa propriedade espera uma matriz de strings. Especifica vários cabeçalhos Allow-Origin. Veja AllowOrigins para mais informações.
ListeningHost.CrossOriginResourceSharingPolicy.AllowMethods Opcional Padrão para null. Essa propriedade espera uma matriz de strings. Especifica o cabeçalho Allow-Methods.
ListeningHost.CrossOriginResourceSharingPolicy.AllowHeaders Opcional Padrão para null. Essa propriedade espera uma matriz de strings. Especifica o cabeçalho Allow-Headers.
ListeningHost.CrossOriginResourceSharingPolicy.MaxAge Opcional Padrão para null. Essa propriedade espera um inteiro. Especifica o cabeçalho Max-Age em segundos.
ListeningHost.Parameters Opcional Especifica as propriedades fornecidas ao método de configuração do aplicativo.