Os serviços Web

Os serviços Web são uma solução para a integração de sistemas e na comunicação entre diferentes aplicações.

Esta tecnologia torna possível desenvolver novas aplicações que interajam com as que já existem, permitindo a compatibilidade entre diferentes plataformas.

Os Serviços Web são componentes que permitem às aplicações enviar e receber dados em formato eXtensible Markup Language (XML). Cada aplicação pode ter a sua própria linguagem, que é traduzida para uma linguagem universal, o formato XML.

Os Serviços Web fazem com que os recursos do software de aplicação estejam dis- poníveis sobre a rede de uma forma normalizada. Outras tecnologias fazem a mesma coisa, como por exemplo, os browsers da Internet acedem às páginas Web disponíveis usando por norma as tecnologias da Internet, Hyper Text Transfer Protocol (HTTP) e HTML.

Utilizando a tecnologia dos Serviços Web, uma aplicação pode invocar outra para efectuar tarefas simples ou complexas mesmo que as duas aplicações estejam em dife- rentes sistemas e escritas em linguagens diferentes. Os Serviços Web disponibilizam os seus recursos para execução por qualquer aplicação cliente.

Os Serviços Web são identicados por um Uniform Resource Identier (URI), descritos e denidos usando XML. É baseado em tecnologias normalizadas, em particular XML e HTTP.

2.5.3.1 Os serviços Web do Moodle 1.8

Na versão 1.8, foi introduzido no Moodle a capacidade de interface com a Application Programming Interface (API) usando o protocolo de Remote Procedure Call (RPC) codicado em XML (XML-RPC).

Foi criada um novo directório de nome mnet que possui as bibliotecas e um cliente de teste. Os serviços Web do Moodle Web expõe a API do Moodle, indirectamente. As funções disponibilizadas são um pequeno conjunto de funções: métodos de au- tenticação, métodos de arrolamento, e chamadas especiais ao sistema para troca de chaves de encriptação.

Para expor algumas funções, através dos serviços Web, têm de ser feitas funções wrapper para chamar as funções localmente e retornar um resultado. Para estas funções serem reconhecidas pelo servidor RPC codicado em XML (XML-RPC), têm de ser descritas usando a especicação dos serviços Web do Moodle e guarda- das na tabela da base de dados, mnet_rpc. Para os métodos de autorização e de arrolamento, é feito automaticamente através da funcionalidade de introspecção em admin/mnet/adminlib.php.

Para possuir funções na tabela mnet_rpc, tem de se modicar a biblioteca ad- minlib.php, para incluir os métodos na introspecção automática. Este rastreamento só é executado quando o administrador acede à página admin/index.php.

O servidor, mnet/xmlrpc/server.php, tem de ser alterado para responder às soli- citações XML-RPC, do serviço Web. O servidor só reconhece métodos em auth.php, enrol.php e aqueles que começam pelo prexo system/.

Para completar a descrição do serviço Web, tem de ser criado um cheiro de linguagem, listando o nome do serviço e os seus métodos. Esta informação estará visível no bloco de administração, no menu Networking-Peers-All Hosts-Services. A partir daqui os serviços podem ser publicados e subscritos pelos Moodle peers.

Se uma aplicação, que não seja Moodle peer, necessita de comunicar com o Moodle, o sistema mnet permite uma opção de comunicação em texto para evitar os mecanismos de encriptação, necessários para os ids dos hosts Moodle. Apesar dos dados trocados serem desencriptados, existe uma certa segurança, uma vez que o Moodle só escutará pedidos enviados de um endereço existente numa lista de hosts de conança (admin/mnet/trustedhosts.php). Um pedido enviado de outro endereço será ignorado.

2.5.3.2 Os serviços Web do Moodle 2.0

Os Serviços Web são utilizados para disponibilizar serviços interactivos na Web, podendo ser acedidos por outras aplicações usando, diferentes protocolos [6]: Sim- ple Object Access Protocol (SOAP), XML-RPC, Representational State Transfer (REST), Action Message Format (AMF).

Figura 2.7: Serviços web, em três camadas (retirada de [6])

O módulo de Serviços Web do Moodle foi desenvolvido a pensar na portabilidade para diferentes versões e para outros projectos. O objectivo é o de dar suporte a vários protocolos.

Os serviços Web do Moodle 2.0, Figura 2.7, baseiam-se numa arquitectura de três camadas: Ligações, Externas e Núcleo. A camada do núcleo, contem as funções das bibliotecas do núcleo do Moodle. Funções interessantes para publicação são por exemplo: funções sobre utilizadores, cursos, grupos, calendário, etc.

Esta camada está a sofrer uma reformulação, uma vez que muitas destas funções do núcleo imprimem mensagens no ecrã. Assim, está a surgir uma API do núcleo, onde não existe impressão de mensagens. Por outro lado, existem mecanismos de tratamento de erros.

A camada externa consiste em diversos cheiros de nome external.php, colocados nos diversos directórios do Moodle. Estes cheiros são empacotadores da camada do núcleo, responsáveis pelo teste de permissões e parâmetros e posterior invocação de funções do núcleo.

A camada das ligações consiste em diversos protocolos de ligação: REST, XML- RPC, SOAP, AMF. Esta camada admite plug-ins adicionais de modo a permitir a integração de outros protocolos no Moodle. Esta camada será a única responsável pela autenticação de ligações HTTP, criação de sessões e ligação com a camada externa.

Figura 2.8: Serviços web (retirada de [6])

protocolo de serviços Web. Este devolve um código de sessão para o cliente, que invoca uma função particular do serviço Web, com os parâmetros: código de sessão, nome do módulo, nome da função, e parâmetros da função.

O servidor do protocolo verica se o código de sessão está activo. O servidor do protocolo chama a função externa, localizada no cheiro external.php existente no módulo. A função externa verica que o utilizador actual tem permissões para efectuar esta operação e chama a função do núcleo do Moodle (normalmente em lib.php) que lhe devolve um resultado, prontamente passado para o servidor de protocolo e posteriormente para o cliente.