Histórico da Página

Ao iniciar qualquer Thread destinada ao funcionamento do REST, existe a possibilidade de executar uma função de Callback para que o usuário possa tomar ações que julgar necessário na criação da Thread.

Pode-se por ela, desde realizar operações de preparação de ambiente, até decidir que essa determinada Thread não será iniciada.

Parâmetros

A função customizada não recebe parâmetros, porém é possível obter as informações pertinentes ao REST através do objeto oRest.

Retorno

O retorno deve ser booleano para que funcione corretamente, e mesmo que a função retorne algo diferente do exigido a camada tlppCore irá se proteger e converter o retorno para booleano, porém para esses casos sempre irá considerar o valor como FALSE.

Sendo assim, o comportamento do REST fica:

Importante ressaltar que, existindo essa função e o valor considerado for FALSE, a Thread não será inicializada e portanto será encerrada tão logo seja iniciada, não ficando disponível para uso. Logo, é preciso atenção para o valor de retorno da função.

Exemplo

user function onStart() as logical
​
    local lOK := .T. as logical
​
    // Somente permitirá criar a Thread se conseguir preparar o Ambiente
    // a lógica de implementação fica a à critério / necessidade de cada um
    lOK := U_preparaAmbiente() 
​
return lOK