Saltar para o conteúdo principal
Versão: Próximo

$singleton

Você pode chamar diretamente as [funções de seus singletons compartilhados] expostas (../Concepts/classes.md#singleton-classes) por meio de REST.

Singleton functions are called in POST or GET requests with the $singleton command and without (). Por exemplo, se você tiver definido uma função buildVehicle() na classe singleton compartilhada VehicleFactory, poderá chamá-la usando a seguinte solicitação:

/rest/$singleton/VehicleFactory/buildVehicle

com dados no corpo do pedido POST: ["truck"]

Na linguagem 4D, esta chamada é equivalente a:

$singleton:=cs.VehicleFactory.me.buildVehicle("truck")
nota

Tenha em mente que somente funções com a palavra-chave exposed podem ser diretamente chamadas de solicitações REST.

Chamadas funções​

Singleton functions can be called using REST POST or GET requests.

A sintaxe formal é:

POST request​

/rest/$singleton/SingletonClass/SingletonClassFunction

with data in the body of the POST request: ["myparam"]

GET request​

/rest/$singleton/SingletonClass/SingletonClassFunction?$params='["myparam"]'

nota

The SingletonClassFunction() function must have been declared with the onHttpGet keyword to be callable with GET (see Function configuration).

Todos os códigos 4D chamados de solicitações REST devem ser thread-safe se o projeto for executado em modo compilado. porque o servidor REST sempre usa processos preventivos neste caso (o valor da configuração [usar processo preemptivo](. /WebServer/preemptiveWeb.md#enabling-the-preemptive-mode-for-the-web-server) é ignorado pelo servidor REST).

info

Você pode restringir chamadas a funções singleton específicas configurando os privilégios apropriados no arquivo roles.json.

Parâmetros​

Você pode enviar parâmetros para funções singleton. Del lado del servidor, serán recibidos en los parámetros declarados de las funciones clase singleton.

O envio de parâmetros para funções singleton é exatamente igual ao envio de parâmetros para funções de classe ORDA. Por favor, consulte o parágrafo Parâmetros da página "Chamando as funções classe" para uma descrição detalhada.

Exemplo​

Você criou um singleton compartilhado simples com uma função exposta:

//class mySingleton

shared singleton Class constructor()

exposed Function sayHello ($value : Text)
	return "Hello "+$value

nota

A classe mySingleton e a função sayHello são listadas quando você chama o comando $catalog.

Pode então executar este pedido:

POST /rest/$singleton/mySingleton/sayHello

Corpo da solicitação: ["John"]

Resposta​

{
	"result": "Hello John"
}