New process

4D v16.3

New process


New process ( metodo ; pilha {; nome {; param {; param2 ; ... ; paramN}}}{; *} ) -> Resultado

Parâmetro	Tipo	Descrição
metodo	String	Método a executar no processo
pilha	Inteiro longo	Tamanho da pilha em bytes
nome	String	Nome do processo criado
param	Expression	Parâmetros do método
*	Operador	Processo único
Resultado	Inteiro longo	Número do processo criado recentemente ou do processo que está sendo executado

Descrição

O comando New process inicia um novo processo ( na mesma máquina) e devolve o número deste processo.

Caso não foi possível criar o processo (por exemplo, se não têm suficiente memória), New process devolve zero (0) e é gerado um erro. Pode interceptar este erro utilizando um método de gestão de erros instalado pelo comando ON ERR CALL.

Método de processo

Em metodo, é passado o nome do método de gestão do novo processo. Uma vez que 4D tenha definido o contexto para o novo processo, começa a execução deste método que se converte no método de processo.

Pilha de processo

Em pilha, passa a quantidade de memória atribuída para a pilha do processo. Este valor representa o espaço em memória utilizado para “empilhar” as chamadas de métodos, as variáveis locais, os parâmetros de sub rotinas e os registros empilhados.

Passe 0 em pilha para usar o tamanho normal de pilha, adequado para a maioria dos aplicativos (recomendado).
Em certos casos, pode desejar usar um valor personalizado. Deve ser expresso em bytes; se recomenda passar pelo menos 64K (ao redor de 64 000 bytes), mas pode passar valores acima de 512 Kb , principalmente se o processo pode realizar chamadas de strings longas (sub rotinas chamando sub rotinas em cascata)

Nota: a pilha NÃO é a memória total reservada para o processo. Os processos compartilham memória para os registros, as variáveis inter-processo, etc. Um processo utiliza igualmente a memória extra para armazenar suas variáveis processo. A pilha só contém variáveis locais, chamadas de métodos, parâmetros em sub rotinas e registros empilhados.

Nota 4D Server 64 bits: a pilha de um processo executado em 4D Server 64 bits requer mais memória que em 4D Server 32 bits (ao redor do dobro). Lhe recomendamos neste contexto passar um valor de 128 000 bytes em geral e 400 000 bytes em caso de uma cadeia de chamada importante. Tenha certeza de verificar este parâmetro quando seu código esteja destinado a ser executado em 4D Server 64 bits.

Nome do processo

Passe o nome do novo processo em nome. Este nome aparecerá na lista de processos do Runtime Explorer e será devolvido pelo comando PROCESS PROPERTIES quando for aplicado a este novo processo. Pode omitir esse parâmetro; se assim o fizer, o nome do processo será uma string vazia. Pode fazer que um processo seja local em seu escopo ao prefixar seu nome com o símbolo de cifrão ($).

Importante: Lembre que os processos locais não deveriam acessar dados em Cliente/Servidor

Parâmetros do método processo

É possível passar parâmetros ao método de processo usando um ou mais parâmetros param. Se passa os parâmetros da mesmam maneira que se passaria os parâmetros em uma subrotina (ver Passando Parâmetros para Métodos). Ao iniciar a execução no contexto do novo processo, o método de processo recebe os valores dos parâmetros em $1, $2, etc. Lembre que arrays não podem ser passados como parâmetros a um método. Além disso, estas considerações adicionais devem ser levadas em consideração no contexto do comando New process:

ponteiros a tabelas ou campos são permitidos.
ponteiros a variáveis, em particular variáveis locais e processo, não são recomendadas, já que estas variáveis podem ser indefinidas no momento em que forem acessadas pelo método de processo
se passar um parâmetro Object type, 4D vai criar uma cópia do objeto no processo destino.

Nota: se pasar parâmetros ao método de processo, deve passar o parâmetro nome; não pode ser omitido neste caso.

Parâmetro opcional *

Lhe indica a 4D que deve verificar primeiro se está executando um processo com o nome que você passou em nome. Se é assim, 4D não inicia um novo processo e devolve o número do processo com este nome.

Exemplo

Vejamos o seguinte método de projeto:

  ` ADICIONAR CLIENTES

 SET MENU BAR(1)

 Repeat

    ADD RECORD([Clientes];*)

 Until(OK=0)

Se associa este método de projeto a um comando de menu criado no Editor de barras de menu e lhe atribuí a propriedade Iniciar um novo processo, 4D automaticamente iniciará um novo processo no momento da execução do método. A instrução SET MENU BAR(1) associa esta barra de menus ao novo processo. Em ausência de janelas (que poderia ser aberta O [#cmd id="153"/]), a chamada a ADD RECORD abrirá automaticamente uma.

Para poder iniciar o processo Adicionar clientes fazendo clique em um botão situado no painel de controle personalizado, pode escrever:

  ` Método de objeto botão bAdicionarClientes

 $vlProcessoID:=New process("Adicionar Clientes";32*1024;"Adicionar Clientes")

O botão faz o mesmo que o comando de menu personalizado.

Se quando seleciona o elemento de menu ou faz clique no botão, você quer que o processo comece (se não existe) ou passado ao primeiro plano (se já se está executando), pode criar o método INICIAR AGREGAR CLIENTES:

  ` INICIAR AGREGAR CLIENTES

 $vlProcessoID:=New process("Adicionar Clientes";32*1024;"Adição de clientes";*)

 If($vlProcessoID#0)

    BRING TO FRONT($vlProcessoID)

 End if

O método de objeto de bAdicionarClientes é convertido em:

  ` Método de objeto do botão bAdicionarClientes

 INICIAR ADICIONAR CLIENTES

No editor de barras de menus, pode substituir ADICIONAR CLIENTES pelo método INICIAR ADICIONAR CLIENTES, e cancelar a seleção da propriedade Iniciar um novo processo para o comando de menu.

Ver também

Execute on server
Métodos
Métodos de projeto
Processos
Variáveis