Como implementar um web service com SoapServer?

[cviniciussdias 2]

Eu gostaria de saber como posso implementar os métodos de uma classe para utilizá-la com SoapServer.

A seguinte classe de exemplo funciona:

<?phpclass WebService {    private $message;    public function writeMessage($message) {        $this->message = $message->message;        return array("mensagem" => $this->message);    }    public function hW() {        return array("mensagem" => "Hello world");    }}

Mas, eu preciso retornar sempre um array?

E, os parâmetros não podem ser separados? Sempre têm que vir no formato de objeto?

 

E, eu também gostaria de saber se alguém conhece alguma ferramenta que gera o arquivo wsdl, pois até agora não encontrei nenhuma que funcione.

 

Muito obrigado desde já!

 

 

PS.: A Classe acima foi usada com:

<?php    require('WebService.class.php');    $server = new SoapServer('meu.wsdl');    $server->setClass('WebService');    $server->handle();

e acessada com:

<?php$client = new SoapClient('meu.wsdl');var_dump($client->hW());var_dump($client->writeMessage(array('message' => 'Texto a ser retornado')));

[Gabriel Heming 766]

Mas, eu preciso retornar sempre um array?

Não. Você pode retornar o que desejar. Entretanto, o retorno fica limitado ao que pode ser definido no WSDL, ou seja, tipos scalares, alguns tipos mais complexos definidos, também, como simple types (date, dateTime, etc) e, após tudo isso, os tipos complexos que você mesmo cria no WSDL.

 

Você pode ver sobre os tipos do XML aqui:

http://www.datypic.com/sc/xsd/s-datatypes.xsd.html

 

E, os parâmetros não podem ser separados? Sempre têm que vir no formato de objeto?

Não. Por parâmetro (entrada de dados), você pode definir da forma que desejar, multiparâmetro ou apenas um do tipo complexo (da mesma forma que o retorno).

 

Deve entender que o WSDL é uma definição de tipos de forma "universal", ela deve ser única e a linguagem de programação, que implementar o web service, a interpretará e lhe entregará um resultado conforme foi definido. Dessa forma, a interpretação, entre linguagens, pode ser levemente diferente (Java pode transformar um tipo de dado diferente do PHP, por exemplo) mas a comunicação através do WebService (XML) é única.

 

E, eu também gostaria de saber se alguém conhece alguma ferramenta que gera o arquivo wsdl, pois até agora não encontrei nenhuma que funcione.

Um tempo atrás eu até pesquisei, mas não achei muita coisa, existe alguns componentes do firefox e/ou chrome que ajudam na hora de criar e testar.

 

Como eu já tinha conhecimento em XML, apenas estudei os componentes do WSDL e crio tudo na "mão". Depois valido e testo com o SoapUI (questão de parâmetros e retorno).

[cviniciussdias 2]

Muito obrigado, Gabriel.

Sabe de algum lugar que tenha um bom material pra eu entender melhor como criar o arquivo wsdl?

To vendo agora na w3 schools, mas to achando meio confuso, já que sou iniciante!

Valeu!

[Gabriel Heming 766]

O site w3schools é um tanto quanto controverso, as vezes tem boas informações, outras péssimas.
Apesar de ser o primeiro da lista de motores de busca, utilize-o apenas como último recurso e/ou apoio, não como fonte definitiva.

Acredito que haja o básico no link abaixo (principalmente pelos gráficos):
http://www.predic8.com/wsdl-reading.htm

Este segundo, parece ser um pouco mais completo:
http://www.tutorialspoint.com/wsdl/

Outro ponto importante, é entender XML e, principalmente, namespaces do XML, pois isso pode te confundir muito.

No mais, o WSDL (1.1) basicamente se resume a isto:

<definitions>
   <types>
      definition of types........
   </types>

   <message>
      definition of a message....
   </message>

   <portType>
      <operation>
         definition of a operation.......  
      </operation>
   </portType>

   <binding>
      definition of a binding....
   </binding>

   <service>
      definition of a service....
   </service>
</definitions>

Apesar da definição de tipos, de certa forma, poder ser omitida (quando não são utilizados tipos complexos). Na época que eu fui migrar para WSDL 2.0, o supporte não era adequado. Faz anos que não faço a migração, então não sei como está hoje em dia.