Edit

Signal

Signals are tools provided by the 4D language to manage interactions and avoid conflicts between processes in a multiprocess application. Signals allow you to make sure one or more process(es) will wait for a specific task to be completed before continuing execution. Any process can wait and/or release a signal.

Semaphores can also be used to manage interactions. Semaphores allow you to make sure that two or more processes do not modify the same resource (file, record...) at the same time. Only the process that sets the semaphore can remove it.

Signal Object

A signal is a shared object that must be passed as a parameter to commands that call or create workers or processes.

A 4D.Signal object contains the following built-in methods and properties:

• .wait()
• .trigger()
• .signaled
• .description.

Any worker/process calling the .wait() method will suspend its execution until the .signaled property is true. While waiting for a signal, the calling process does not use any CPU. This can be very interesting for performance in multiprocess applications. The .signaled property becomes true when any worker/process calls the .trigger() method.

Lembre que para evitar situações de bloqueio, .wait() também pode regrassar depois de que tenha alcançado um tempo de espera definido.

Signal objects are created with the New signal command.

Working with signals

In 4D, you create a new signal object by calling the New signal command. Once created, this signal must be passed as a parameter to the New process or CALL WORKER commands so that they can modify it when they have finished the task you want to wait for.

• signal.wait() deve ser chamado do worker/processo que precisa de outro worker/processo para terminar uma tarefa para poder continuar.
• signal.trigger() deve ser chamado desde worker/processo que terminou sua execução para liberar a todos os outros.

Quando um sinal tiver sido lançado usando uma chamada signal.trigger(), não pode ser reutilizado. If you want to set another signal, you need to call the New signal command again.

Since a signal object is a shared object, you can use it to return results from called workers/processes, provided that you do not forget to write values within a Use...End use structure (see example).

Exemplo

 var $signal : 4D.Signal

  // Creation of a signal
 $signal:=New signal

  // call main process and execute OpenForm method
 CALL WORKER(1;"OpenForm";$signal)
  // do another calculation
 ...
  // Esperando pelo final do processo
 $signaled:=$signal.wait()

  // Processando o resultado
 $calc:=$signal.result+...

OpenForm method :

 #DECLARE ($signal : 4D.Signal)  
 var $form : Object
 $form:=New object("value";0)

  // Abrir o formulário
 $win:=Open form window("Information";Movable form dialog box)
 DIALOG("Information";$form)
 CLOSE WINDOW($win)

  // Adiciona um novo atributo para seu objeto partilhado $signal para passar seu resultado aos outros processos:
 Use($signal)
    $signal.result:=$form.value
 End use

  // Ativa o sinal para o processo de espera
 $signal.trigger()

Resumo

.description : Text
.signaled : Boolean
.trigger( )
.wait( { timeout : Real } ) : Boolean

New signal

Histórico

Versão	Mudanças
v17 R4	Adicionado

New signal { ( description : Text ) } : 4D. Signal

Parameter	Type		Descrição
description	Texto	->	Descrição para o sinal
Resultado	4D. Signal	<-	Objeto nativo encapsulando o sinal

Descrição

O comando New signal cria um objeto 4D. Signal.

Um sinal é um objeto partilhado que pode ser passado como parâmetro de um worker ou processo para outro worker ou processo, de forma que:

• the called worker/process can update the signal object after specific processing has completed
• the calling worker/process can stop its execution and wait until the signal is updated, without consuming any CPU resources.

Opcionalmente, no parâmetro description pode passar um texto personalizado descrevendo o sinal. Esse texto pode também ser definido depois da criação do sinal.

Já que o objeto sinal é um objeto partilhado, pode também ser usado para manter propriedades usuário, incluindo a propriedade .description por chamar a estrutura Use... End use.

Returned value

Um novo objeto 4D. Signal.

Exemplo

Este é um exemplo típico de um worker que fixa um sinal:

 var $signal : 4D.Signal
 $signal:=New signal("This is my first signal")

 CALL WORKER("myworker";"doSomething";$signal)
 $signaled:=$signal.wait(1) //wait for 1 second max

 If($signaled)
    ALERT("myworker finished the work. Result: "+$signal.myresult)
 Else
    ALERT("myworker has not finished in less than 1s")
 End if

O método doSomething poderia ser algo como:

 #DECLARE ($signal : 4D.Signal)
  //any processing
  //...
 Use($signal)
    $signal.myresult:=$processingResult  //retorna o resultado
 End use
 $signal.trigger() // O trabalho terminou

.description

Histórico

Versão	Mudanças
v17 R4	Adicionado

.description : Text

Descrição

A propriedade .description contém uma descrição personalizada para o objeto Signal..

.description pode ser definida ao criar o objeto signal ou a qualquer momento. Note que, dado que o objeto Signal é um objeto compartido, qualquer acesso em modo de escritura a propriedade .description deve estar rodeado por uma estrutura Use... End use.

Essa propriedade éapenas escrita.

.signaled

Histórico

Versão	Mudanças
v17 R4	Adicionado

.signaled : Boolean

Descrição

A propriedade .signaled property contém o estado atual do objeto Signal . Quando se cria um sinal, .signaled é False. Se converte em True quando se chama ao objeto .trigger( ).

Essa propriedade éapenas leitura.

.trigger()

Histórico

Versão	Mudanças
v17 R4	Adicionado

.trigger( )

| Parameter | Type | | Descrição | | --------- | ---- |::| ------------------------------- | | | | | Does not require any parameters |

Descrição

A função .trigger( ) põe a propriedade signaled do objeto sinal como true e desperta a todos os workers ou processos que esperam este sinal.

Se o sinal já estiver no estado de sinalização (ou seja, a propriedade signaled já for true), a função não faz nada.

.wait()

Histórico

Versão	Mudanças
v17 R4	Adicionado

.wait( { timeout : Real } ) : Boolean

Parameter	Type		Descrição
timeout	Real	->	Tempo máximo de espera do sinal em segundos
Resultado	Booleano	<-	Estado da propriedade .signaled

Descrição

A função .wait( ) faz com que o processo atual espere até que a propriedade .signaled do objeto sinal se converte em true ou expire o timeout opcional.

Para evitar que o código se bloqueie, pode passar um tempo máximo de espera em segundos no parâmetro timeout (se aceitam decimais).

Warning: Calling .wait( ) without a timeout in the 4D main process is not recommended because it could freeze the whole 4D application.

Se o sinal já estiver no estado de sinalização (ou seja, a propriedade.signaled já é true), a função devolve imediatamente, sem esperar.

A função devolve o valor da propriedade .signaled. Avaliar esse valor permite saber se a função retornou porque .trigger( ) foi chamado (.signaled é true) ou se o timeout expirou (.signaled é false).

The state of a process that waits for a signal is Waiting for internal flag.