As instruções aqui apresentadas servem tanto para ambientes UNIX quanto Windows (supondo que você tenha instalado o Xavante utilizando a combinação de LuaForWindows e LuaRocks).

Iniciando o Xavante a partir do WSAPI

O Xavante é um servidor Web embutível, ou seja, ele é distribuído como um módulo Lua que deve ser chamado a partir de uma aplicação. Com isso é fácil ter mais de uma instância do Xavante rodando ao mesmo tempo (em portas diferentes), cada um associado à uma aplicação.

A instalação do rock wsapi-xavante cria um executável de nome wsapi que serve como disparador do Xavante. Este executável deve ser chamado a partir do diretório que será considerado a raiz de seu site.

A partir deste diretório você pode tanto executar diretamente o comando wsapi para iniciar um servidor Xavante com sua configuração padrão (ou seja, o tratamento de aplicações WSAPI, com extensão .lua ou .ws), quanto passar parâmetros para o comando wsapi de modo a utilizar configurações alternativas.

Se quiser saber mais sobre as opções do comando wsapi digite

wsapi --help

Por exemplo, para executar o Xavante com suporte a Orbit Pages (supondo que o rock Orbit esteja instalado) você deve utilizar

wsapi --op

Importante: Note que o uso do parâmetro --op se refere somente ao uso de Orbit Pages (com a extensão .op). As aplicações Orbit são aplicações WSAPI normais, ou seja utilizam as mesmas extensões do WSAPI.

Rodando os exemplos de aplicações WSAPI com o Xavante

A instalação do rock wsapi-xavante instala alguns exemplos de uso do WSAPI. Estes exemplos ficam na pasta rocks/wsapi/X.Y.Z-V/samples do seu sistema (onde X.Y.Z-V se refere à versão instalada do WSAPI.

Antes de rodar o exemplo, verifique se não há uma outra instância do Xavante rodando e vá para o diretório de exemplos do WSAPI (substituindo X.Y.Z-V pela versão desejada):

cd rocks/wsapi/X.Y.Z-V/samples

Execute agora o comando wsapi e verifique se a mensagem de inicialização do Xavante foi apresentada no terminal.

Caso esteja tudo funcionando, entre em seu browser e digite a URL do exemplo de script Lua para WSAPI (hello.lua):

O hello.lua é um exemplo simples mas mostra como uma aplicação WSAPI recebe parâmetros da requisição, gera o conteúdo da resposta e finalmente retorna o status HTTP, os cabeçalhos HTTP e o conteúdo em si.

http://localhost:8080/hello.lua

Você deveria ver a seguinte resposta:

Hello Wsapi!

PATH_INFO: /

SCRIPT_NAME: /hello.lua

Importante: Note que os demais exemplos do diretório samples são de disparadores de linha de comando para o WSAPI e não devem ser executados via browser.

Rodando exemplos de aplicações Orbit com o Xavante

Para utilizar o Orbit com o Xavante você precisa inicialmente instalar o rock orbit:

luarocks install orbit

Antes de executar os exemplos, verifique se não há uma outra instância do Xavante rodando e vá para o diretório de exemplos do Orbit (substituindo X.Y.Z-V pela versão desejada):

cd rocks/orbit/X.Y.Z-V/samples

Execute agora o comando wsapi e verifique se a mensagem de inicialização do Xavante foi apresentada no terminal.

Caso esteja tudo funcionando, prossiga para a página de Exemplos.