On Server Open Connection database method

O On Server Open Connection database method é chamado uma vez no equipo servidor cada vez que um equipo remoto 4D inicia um processo de conexão. O On Server Open Connection database method NÃO é invocado por outro entorno 4D diferente de 4D Server.

O On Server Open Connection database method é chamado cada vez que:

• um 4D remoto se conecta (inicio do processo principal)
• um 4D remoto abre o entorno Desenho (inicio do processo de Desenho)
• um 4D remoto inicia um processo global, (cujo nome começa por "$") o qual necessita da criação de um processo cooperativo no servidor (*). Este processo pode ser criado utilizando o comando New process, um comando de menu ou caixa de diálogo "Executar um método".

Em cada caso com um 4D remoto, três processos são iniciados. Um na máquina cliente e outros dois no equipo servidor. Na máquina cliente, o processo executa o código e envia as petições a 4D Server. No equipo servidor, o processo 4D Client mantém o entorno da base de dados do processo cliente (as seleções atuais e o bloqueio de registros para o processo usuário) e responde aos pedidos enviadas pelo processo executado na máquina cliente. O processo base 4D Client está a cargo de controlar o processo 4D Client correspondente.

(*) A partir de 4D v13, por razões de otimização os processos servidores (processo apropriado para os acessos ao motor da base e processo cooperativo para o acesso à linguagem) só são criadas durante a execução do código do lado do cliente. Por exemplo, estes são os detalhes de uma sequencia de código 4D que se executa em um novo processo cliente:

Importante: as conexões web e as conexões SQL não provocam a execução do On Server Open Connection database method. Quando um navegador web se conecta a 4D Server, é chamado o Método de banco On Web Aunthentication (se existe) e/ou ao On Web Connection Database Method. Quando 4D Server recebe uma petição SQL, é chamado On SQL Authentication database method(se existe). Para maior informação, consulte a descrição deste método base no manual de Linguagem 4D.

Importante: quando um procedimento armazenado é iniciado, o On Server Open Connection database method NÃO é chamado. Stored Procedures são processos servidor e não processos 4D Client. Eles executam o código no equipo servidor, mas não respondem as solicitações intercaladas por 4D client (ou outros clientes) e 4D Server.

O On Server Open Connection database method é executado no equipo servidor no processo 4D Client que provocou a chamada do método.

Por exemplo, se um 4D remoto se conecta a uma base 4D Server interpretada, é iniciado o processo usuário, o processo de desenho e o processo de registro do cliente (por defeito). O On Server Open Connection database method se executa três vezes seguidas. A primeira vez dentro do processo principal, a segunda vez no processo de inscrição do cliente e a terceira vez no processo de desenhoo. Se os três processos são respectivamente o sexto, sétimo e oitavo processo a iniciar-se no equipo servidor, e é chamado Current process desde o On Server Open Connection database method, a primeira vez Current process devolve 6, a segunda vez 7 e a terceira 8.

Observe que o On Server Open Connection database method se executa no equipo servidor, ao interior do processo 4D Client no servidor, independente do processo executado no cliente. Além disso, no momento em que se invoca o método, o processo 4D Client ainda não foi nomeado (PROCESS PROPERTIES não devolverá neste momento o nome do processo 4D Client).

O On Server Open Connection database method não têm acesso à tabela das variáveis processo do processo executado no client. Esta tabela reside no equipo client, não no equipo servidor.

Quando o On Server Open Connection database method acede a uma variável processo, trabalha com uma tabela de variáveis processo particular, criada dinamicamente pelo processo 4D Client.

4D Server passa três parâmetros de tipo Inteiro longo ao On Server Open Connection database method e espera um resultado Inteiro longo. O método deve portanto ser declarado explicitamente com três parâmetros Inteiro longo assim também como com um resultado de função Inteiro longo:

Se não devolve um valor em $0, por conseguinte deixa a variável indefinida ou inicializada em zero, 4D Server considera que o método base aceita a conexão. Se não é aceitada a conexão, devolve um valor não nulo em $0.

Esta tabela detalha a informação oferecida pelos três parâmetros passados no método base:

Estes números de referencia não são utilizados diretamente como fontes de informação a passar, por exemplo, como parâmetros a um comando 4D. No entanto, oferecem uma maneira particular de identificar um processo 4D Client entre o On Server Open Connection database method e o Método banco de dados On Server Close Connection. A combinação destes valores é único no momento de uma seção 4D Server. Ao guardar esta informação em uma tabela ou em um array entre processos, os dois métodos base podem trocar informações. No exemplo ao final desta sessão, os dois métodos base utilizam esta informação para armazenar a data e hora de inicio e fim de uma conexão no mesmo registro de uma tabela.

O seguinte exemplo mostra como manter um histórico das conexões à base de dados utilizando o On Server Open Connection database method e utilizando o Método banco de dados On Server Close Connection. A tabela [Server Log] (mostrada a continuação) se utiliza para fazer seguimento aos processos de conexão:

A informação armazenada nesta tabela é administrada pelo On Server Open Connection database method e o Método banco de dados On Server Close Connection listado a continuação:

Estas são algumas entradas em [Server Log] mostrando varias conexões remotas:

O seguinte exemplo evita uma nova conexão entre as 2 e 4 A.M.