Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 3 Atual »

Define as configurações de cada servidor HTTP e/ou HTTPS informados na sessão [HTTPSERVER] pela chave {SERVERS}.


ChaveTipoObrigatório
PortintegerX
HostnamestringX
ContentTypesstring
Locationsstring/arrayX
SslCertificatestring
SslCertificateKeystring
TlppDatastring/JSON
UserDatastring/JSON


Chaves da sessão

Port

Define a porta em que o servidor atenderá às requisições após ativado.


Hostname

Define o nome virtual para o servidor ativado.


ContentTypes

Define o nome da sessão que será responsável pela definição dos content-types suportados pelo serviço.


Locations

Define o nome das sessões(locations) deste servidor. O(s) nome(s) definido(s) nesta chave deverão utilizado(s) na chave LOCATIONS.

Caso seja utilizado o arquivo appserver.ini o formato do valor desta chave deve ser string. Caso seja utilizado o JSON, seu valor deve ser do tipo array.


SslCertificate

Informar o path com o nome do arquivo do certificado digital, para utilização do REST com o protocolo HTTPS/SSL.


SslCertificateKey

Informar o path com o nome do arquivo com a chave do certificado digital, para utilização do REST com o protocolo HTTPS/SSL.


TlppData

Esta chave possibilita a configuração simultânea de múltiplos recursos.

O valor informado em tlppData deve ter conteúdo final um JSON válido, e dizemos valor final pois diretamente na chave você irá colocar um conteúdo de tipo string, que pode ser já o JSON desejado ou o nome de arquivo(*) que em seu conteúdo seja o JSON.

Caso seja informado o arquivo, pode-se fazer de duas maneiras:

  • Nome arquivo (irá buscar o arquivo em rootPath)

  • Caminho absoluto + Nome arquivo

Embora no exemplo de configuração dessa documentação essa chave tenha sido usada somente na sessão do Servidor, ela pode ser usada na sessão de definição das Thread Pool e Slaves.

Atenção -> Esse JSON é de uso exclusivo de recursos nativos do REST, portanto para utilizá-lo é preciso seguir à risca a documentação de cada funcionalidade.


UserData

Esta chave possibilita a configuração simultânea de múltiplos recursos, porém diferente do tlppCore essa é de uso exclusivo de cada usuário, portanto a utilize para customizar as configurações em seus recursos específicos.

O valor informado em userData deve ter conteúdo final um JSON válido, e dizemos valor final pois diretamente na chave você irá colocar um conteúdo de tipo string, que pode ser já o JSON desejado ou o nome de arquivo(*) que em seu conteúdo seja o JSON.

Caso seja informado o arquivo, pode-se fazer de duas maneiras:

  • Nome arquivo (irá buscar o arquivo em rootPath)

  • Caminho absoluto + Nome arquivo

Embora no exemplo de configuração dessa documentação essa chave tenha sido usada somente na sessão do Servidor, ela pode ser usada na sessão de definição das Thread Pool e Slaves.


Exemplos de configuração

Arquivo appserver.ini
[INIT_HTTP_REST]
Port=9080
Hostname=TLPP_REST_SERVER
ContentTypes=ContentTypes
Locations=HTTP_ROOT_01
TlppData=c:\config\tlppData.JSON
UserData=c:\config\userData.JSON

[INIT_HTTPS_REST]
Port=9081
Hostname=TLPP_SSL_REST_SERVER
ContentTypes=ContentTypes
Locations=HTTPS_ROOT_01
SslCertificate=totvs_certificate.crt
SslCertificateKey=totvs_certificate_key.pem
TlppData=c:\config\tlppData.JSON
UserData=c:\config\userData.JSON
JSON
jConfig['INIT_HTTP_REST']                      := JsonObject():New()
jConfig['INIT_HTTP_REST']['Port']             := "9080"
jConfig['INIT_HTTP_REST']['HostName']         := "TLPP_REST_SERVER"
jConfig['INIT_HTTP_REST']['ContentTypes']     := "ContentTypes"
jConfig['INIT_HTTP_REST']['Locations']         := {"HTTP_ROOT_01"}
jConfig['INIT_HTTP_REST']['TlppData']         := "c:\config\tlppData.JSON"
jConfig['INIT_HTTP_REST']['UserData']         := "c:\config\userData.JSON"

jConfig['INIT_HTTPS_REST']                     := JsonObject():New()
jConfig['INIT_HTTPS_REST']['Port']             := "9081"
jConfig['INIT_HTTPS_REST']['HostName']         := "TLPP_SSL_REST_SERVER"
jConfig['INIT_HTTPS_REST']['Charset']           := "iso-8859-1"
jConfig['INIT_HTTPS_REST']['ContentTypes']     := "ContentTypes"
jConfig['INIT_HTTPS_REST']['Locations']         := {"HTTPS_ROOT_01"}
jConfig['INIT_HTTPS_REST']['SslCertificate']   := "C:\tlppCore\bin\totvs_certificate.crt"
jConfig['INIT_HTTPS_REST']['SslCertificateKey'] := "C:\tlppCore\bin\totvs_certificate_key.pem"
jConfig['INIT_HTTPS_REST']['TlppData']         := "c:\config\tlppData.JSON"
jConfig['INIT_HTTPS_REST']['UserData']         := "c:\config\userData.JSON"


  • Sem rótulos