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 helloWorld()
  Local cReturn := "Meu primeiro REST em TL++ "
  oRest:setResponse(cReturn)
Return .T.

Utilizando classe

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

class helloWorld
  public data cReturn

  public method new()

  @Get("/test/helloWorld")
  public method sayHello()
endClass

method new() class helloWorld
    ::cReturn := "Meu primeiro REST em TL++ "
return self

method sayHello() class helloWorld
  oRest:setResponse(::cReturn)
return .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 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)

...