Query String

A Query String é um modelo clássico de manutenção do estado da página. Elas são nada mais do que conjuntos de pares/valores anexados a URL, em diversos sites hoje em dia vemos o uso delas.

Seu uso é simples, após a URL de determinada página, adicionamos o primeiro valor usando a seguinte sintaxe: ?Chave=Valor.

Para passarmos mais de um conjunto, os mesmos devem ser concatenados usando o caractere coringa &.

Do lado da execução do serviço, resgatamos seus valores da seguinte forma:

#include "tlpp-core"
#include "tlpp-rest"
​
@Get("sample/request/querystringexample")
user function sampleQueryString()
​
    local cReturn      := ""
    Local jQueryString := Nil 
​
    jQueryString := oRest:getQueryRequest()
    if ( jQueryString <> Nil )
        cReturn := "Parâmetros capturados: ["+jQueryString:ToJSon()+"]"
    endif
​
    oRest:setResponse(cReturn)
return

Note que fazemos uso do método oRest:getQueryRequest() para obter todos os parâmetros enviados via Query String.

Esse método já nos retorna em formato JSON, portanto, para acessar o dado de um determinado parâmetro, basta seguir como abaixo:

​
jQueryString := oRest:getQueryRequest()
    cCode := jQuery[ 'code' ]
​

Para o exemplo acima funcionar, a chamada deveria ser assim:

    http://localhost:8080/sample/request/querystringexample?code=1

ou

    http://localhost:8080/sample/request/querystringexample?name=Zack&code=1