Web Application Description Language (WADL)
Há muita discussão a respeito de interfaces de descrição de serviços REST. Há quem julgue que elas não são necessárias. Outros acham interessante ter um “equivalente” do WSDL para REST.
Consideramos que é conveniente oferecer uma interface simples de consulta dos serviços disponíveis, mas sem tantos detalhes como o WSDL. Uma das opções disponíveis para isso é o WADL. O WADL informa quais são as URIs disponíveis, os métodos permitidos em cada uma delas, e os parâmetros de entrada e saída dos serviços.
O Jersey gera automaticamente um WADL dos nossos serviços a partir de nossas classes Recurso. Consideramos este documento bom o suficiente para não valer a pena gerar algo semelhante de forma customizada. Mais detalhes sobre os serviços podem ser colocados numa Wiki ou página semelhante. A geração do WADL é uma funcionalidade específica do Jersey, e não está presente na JSR-311.
Para acessar o WADL correspondente aos nossos recursos, devemos fazer uma solicitação HTTP GET à URI /application.wadl, na raiz da nossa aplicação. Isto é conveniente por permitir a fácil visualização com um browser. Veja o documento WADL dos serviços do processo de leilão.