Histórico da Página

Após efetuar as configurações pertinentes ao Rest Server, veremos a partir daqui como utilizar as funcionalidades da linguagem TL++ para escrever aplicações REST.

Meu primeiro programa

Como não poderia ser diferente vamos começar pelo básico, então nada melhor do que escrever nosso "Hello World".

...

• Utilizando uma função.

• Utilizando uma classe.

Utilizando função

#include 'tlpp-core.th'
#include 'tlpp-rest.th'
​

@Get("/test/helloWorld")
User Function u_helloWorld()
    Local cReturn := "Meu primeiro REST em TL++ " as character
    oRest:setResponse(cReturn)
Return nil.T.

Utilizando classe

#include 'tlpp-core.th'
#include 'tlpp-rest.th'
​

class helloWorld
​
    public Datadata   cReturn
​
 as character

  public Methodmethod new()

  @Get("/test/helloWorld")
  public Methodmethod sayHello()
​ as logical
endClass
​

method Newnew() class helloWorld
    ::cReturn := "Meu primeiro REST em TL++ "
Returnreturn self
​
@Get("/test/helloWorld")

method sayHello()
​
   as logical class helloWorld
  oRest:setResponse(::cReturn)
​
return nil.T.

Explicando os componentes

Tomando como base os exemplos vistos acima, vamos explicar os componentes utilizados na construção do serviço REST TL++:

Includes

#include 'tlpp-core.th'
#include 'tlpp-rest.th'

As includes tlpp-core.th e tlpp-rest.th são as únicas bibliotecas necessárias para o funcionamento básico que qualquer função\classe REST.

As mesmas já se encontram inclusas no tlpp.rpo bastando apenas declará-las.

@Get

@Get("/test/helloWorld")

A utilização de annotations tornou possível a simplificação na escrita de funções\classes REST.Com elas a aplicação faz o vínculo entre: verbo(delete,get,path,post,put) , a URN e a função/método responsável.

Saiba mais sobre a annotation @Get

oRest:setResponse("mensagem retorno")

oRest:setResponse(::cReturn)

...