Manoel Campos.com

Liberada mais uma versão do NCLua SOAP, a 0.5.6.6. Esta versão inclui apenas um novo recurso que permite informar o número da porta do serviço web que deseja-se acessar (caso seja uma porta diferente da 80), diretamente na URL do serviço.

Nas versões anteriores, caso os usuários precisassem usar uma porta diferente da 80, era necessário especificar o número da mesma no parâmetro port do método call do módulo ncluasoap. Alguns usuários tiveram dificuldades em consumir serviços que não utilizam a porta 80 justamente por informarem o número da porta dentro da URL do serviço. Tal restrição ocorria devido à classe TCP do NCLua requerer que a porta seja informada em um parâmetro separado. Como o NCLua SOAP possui o módulo http (também desenvolvido por mim e que facilita bastante a realização de requisições usando o protocolo de mesmo nome), isto foi resolvido diretamente neste módulo e o NCLua SOAP passou a utilizar esta nova funcionalidade.

O parâmetro port do método call do módulo ncluasoap ainda existe, para que os programas antigos que o usam não precisem ser alterados, mas vou avaliar a possibilidade de excluir definitivamente tal parâmetro. Assim, recomendo que passem a utilizar o número da porta diretamente na URL do serviço.

Exemplo de chamada para um serviço na porta 8080, usando as versões anteriores do módulo:

local msgTable = {
  address = "http://myserver.com/MyWebService",
  namespace = "MyNamespace",
  operationName = "calc",
  params = {
    a = 10, b = 20
  }
}

--A porta 8080 é passada como parâmetro para o método call
ncluasoap.call(msgTable, getResponse, "1.1", 8080)

Mesmo exemplo usando a nova versão do módulo:

local msgTable = {
  --A porta 8080 é passada diretamente na URL do Web Service
  address = "http://myserver.com:8080/MyWebService",
  namespace = "MyNamespace",
  operationName = "calc",
  params = {
    a = 10, b = 20
  }
}

ncluasoap.call(msgTable, getResponse, "1.1")

Para baixar esta nova versão, acesse http://ncluasoap.manoelcampos.com#download

Mais uma versão do NCLua SOAP liberada. Nela foi incluído suporte ao consumo de Web Services que requerem autenticação HTTP (Basic Authentication), solicitando um usuário e senha para acessar o serviço. Tal recurso já estava implementado no módulo HTTP (implementado por mim, utilizando o módulo TCP disponível em http://www.lua.inf.puc-rio.br/~francisco/nclua/tutorial/exemplo_06.html) e foi apenas utilizado pelo NCLua SOAP. O exemplo9httpauth foi incluído, que acessa o Web Service disponível em http://manoelcampos.com/apps/httpauth/server.php, retornando a lista de estados de uma determinada região do país.

Para realizar a autenticação HTTP, foram incluídos os parâmetros (opcionais) httpUser e httpPasswd no método call do módulo ncluasoap. Para mais detalhes, veja a documentação no diretório doc.

Baixe a nova versão em http://ncluasoap.manoelcampos.com#download

Desde a versão 0.5.5 do NCLua SOAP, foi incluído suporte para que os parâmetros sejam gerados, no XML, na mesma ordem em que foram definidos na tabela Lua, resolvendo problema encontrado com Web Services PHP desenvolvidos com a biblioteca nuSOAP.

Neste artigo mostrarei como fazer acesso a tais Web Services, a partir de aplicações de TV Digital, desenvolvidas em NCL/Lua, utilizando o módulo NCLua SOAP.

Iniciando

O acesso a WebServices em PHP com NCLua SOAP pode ter uma pequena particularidade. Tais WS, desenvolvidos com a biblioteca nuSOAP, desconsideram o nome dos parâmetros de entrada (isto pode depender da versão da biblioteca), considerando apenas a ordem em que foram passados. Leia mais…

Mais uma versão do NCLua SOAP liberada. As novidades são:

• suporte a métodos de Web Service que recebem parâmetros dos tipos array e struct/record;
• incluído exemplo para acesso a método de WS que recebe um struct como parâmetro.

Colaboração de Samuel da Costa Alves Basilio.

Leia mais…