Pour suivre, il est indispensable d’utiliser eclipse, car celui-ci possède un mode graphique pour la création de web-service qui va nous faciliter la vie.

Le fonctionnement

Vous savez certainement qu’un Web-Service est un programme qui permet la communication et l’échange de données entre des applications et des systèmes totalement différents.

Pour que le Web-Service puisse communiquer avec n’importe quels systèmes, il faut utiliser un même format de données. Pour nous, ça sera le SOAP(c’est un protocole procédural basé sur du XML). Dans ce format, il faut aussi bien définir les données qui seront reçues et envoyées par le Web-Service.

Ne vous inquiétez pas si cela vous paraît trop abstrait, on va tout expliquer avec un exemple.

Voici une petite illustration du fonctionnement de ce Web-Service :


Première étape :
L’application java va faire appel au web-service en envoyant un message WSDL (en SOAP).

Qui avait dit que c’était compliqué les web-service ?


Fini la théorie passons à la pratique, nous allons faire un Web-Service qui nous donne le jour en fonction de la date que l’on envoie.

Création du wsdl

Nous allons créer un nouveau projet que nous appellerons MonWebService (il n’y a pas plus clair ^^).


On va commencer par faire le format WSDL (fichier soap) de notre web service.

On le nomme monFormat.wsdl

Pour nous aider, Eclipse nous construit automatiquement un format wsdl par défaut, nous allons le reprendre et le paramétrer. Mais avant tout, je vais vous parler rapidement de l’interface.

C’est avec la boîte à gauche que l’on définit l’adresse du serveur du web-service ( c’est là où tout le traitement php va se faire), Dans le champ de saisie, il faudra mettre : http://localhost/MonWebService/serveur.php

Input qui représente les données que va recevoir le Web-Service
Output qui représente les données que va envoyer le Web-Service


Tout le monde suit ?

En entrée, on aura besoin d’une chaine de caractère(string).
Pour se faire, on fait un clique droit sur case la plus à droite de la ligne input, dans le menu contextuel
On clique sur Set Type puis Existing Type et là on sélectionne string.


On réitère cette opération pour le paramètre de sortie.

Du serveur au client

On va s’attaquer à notre serveur, préparez vos doigts ça va coder !

On va le nommer serveur.php
Attention, le chemin de votre fichier doit être le même que celui que vous avez paramétré dans votre web-service.

Ex : http://localhost/MonWebService/serveur.php => C:\wam\www\MonWebService\serveur.php

Voici le code source, les commentaires parlent d’eux-même :

// Pour supprimer le cache du web-service
ini_set('soap.wsdl_cache_enabled', 0);
// Pour définir le temp maximal d'éxecution de notre web-service
ini_set('default_socket_timeout', 180);

// Nom de notre web-service
class Server {
     // Le service QuelJour que l'on a définit dans notre format wsdl
    function QuelJour($parm) {
    	return 'Web-Service ok';
    }
}
// On tente d'instancier la classe soapServer
// Si cela s'avère impossible, on affiche une erreur
try {
    $server = new SoapServer('monFormat.wsdl',  array('trace' => 1,'encoding'	=> 'ISO-8859-1'));
    // On définit la classe qui va gérer les requêtes SOAP (pour nous c'est la class Server)
    $server -> setclass('Server');
    $server->setPersistence(SOAP_PERSISTENCE_REQUEST);
} catch (Exception $e) {
    echo 'erreur'.$e;
}
// Si l'appel provient d'un Web-Service
if ($_SERVER['REQUEST_METHOD'] == 'POST') {
	try {
		$server -> handle();}
	catch (Exception $e) {
    echo 'erreur'.$e;
	}
}
// Facultatif seulement pour montrer les fonctions disponibles par le web-service
else {
    echo '<strong>This SOAP server can handle following functions : </strong>';
    echo '<ul>';
    foreach($server -> getFunctions() as $func) {
        echo '<li>' , $func , '</li>';
    }
    echo '</ul>';
}

Si tout se passe bien et si on se rend sur cette adresse :

http://localhostMonWebService/serveur.php

On devrait voir :



Tout marche ? On est trop fort \o/

// Pour supprimer le cache du web-service
ini_set('soap.wsdl_cache_enabled', 0);

// Nouveau Client SOAP
try {
    // Nouvelle instance de la classe soapClient
   $client = new SoapClient('http://localhost/MonWebService/monFormat.wsdl', array('trace' => 1));
   $parm = date('Y-m-d');
    // Appel de la méthode QuelJour du service web
   try{
    $oReturn =  $client -> __soapCall('QuelJour', array('string' =>$parm));
	} catch (SoapFault $fault) {
    	trigger_error("SOAP Fault: (faultcode: {$fault->faultcode}, faultstring: {$fault->faultstring})", E_USER_ERROR);
	}
        // affiche le résultat
	var_dump($oReturn);
} catch (SoapFault $fault) {
    echo 'erreur : '.$fault;
}

    function QuelJour($parm) {
    	$aJour[1] = 'Lundi';
    	$aJour[2] = 'Mardi';
    	$aJour[3] = 'Mercredi';
    	$aJour[4] = 'Jeudi';
    	$aJour[5] = 'Vendredi';
    	$aJour[6] = 'Samedi';
    	$aJour[0] = 'Dimanche';
    	return $aJour[date("w",strtotime($parm))];
    }

Debugger un web-service

Le debugage d’un web-service est toujours difficile. Le client interprète directement la réponse du web-service et si la réponse n’est pas correctement formaté (qui ne respecte pas le format wsdl du web-service), il affiche une erreur du type :

( ! ) Fatal error: SOAP Fault: (faultcode: Client, faultstring: looks like we got no XML document) in /var/www/MonWebService/client.php on line 17 Call Stack #TimeMemoryFunctionLocation 10.000158584{main}( )../client.php:0 20.002180708trigger_error ( )../client.php:17

Les erreurs :


Pendant le développement de différents de web-services, je suis tombé sur des erreurs de toute part, malheureusement je ne les ai pas tous mémorisé mais voici un début de liste qui pourrait vous aider. Si vous aussi vous êtes embétez un petit commentaire et on pourra certainement vous aider.

Nous allons voir le fonctionnement de l’OpenID ainsi que les méthodes pour l’intégrer dans nos pages.

Fonctionnement de l’OpenID

1. Vous allez sur votre site favori qui utilise l’OpenID.
2. Vous vous connectez en utilisant vos identifiants OpenID.
3. Il vérifie vos identifiants en allant sur votre page web OpenID.
4. Il vous connecte.

OpenId

Comment avoir un compte OpenID ?

Il faut se connecter sur www.myopenid.com et créer un compte.

Vous aurez alors une adresse du type http://votrecompte.myopenid.com/

Il faut la conserver précieusement, c’est votre adresse OpenID .

Se connecter sur un site via OpenID

Nous allons nous inscrire à pibb.com (c’est un site qui permet de gérer une plate forme de communication privée entre utilisateurs) en utilisant notre identifiant OpenId.

On va se rendre sur leur site, pour enregistrer notre openID.

Là, vous inscrivez votre adresse OpenID, comme ceci :

OpenId

Un message de confirmation vous sera adressé.

OpenId

ça y est vous êtes inscrit

Si vous retournez dans votre site myopenid, vous verrez en bas de la page d’accueil un rapport
d’activité. (très utile pour se souvenir des sites où nous nous sommes inscrits)

openid

Sécurité

Il est bien évident qu’il faut être vigilant, lorsque l’on s’inscrit, il faut toujours privilégier l’openID
sur des sites connus (comme le mien :p).

Mais à quoi cela sert réellement ?

A ajouter de la sémantique à votre site internet. En plus de l’information qu’affiche vos pages webs, les microformats vont donner un sens à leurs contenus. Certains sites l’ont adoptés, et cela donne des résultats assez impressionnant :

Flickr : si vous regardez une photo géolocalisée, on peut ouvrir Google maps à l’endroit où la photo a été prise.
Aussi si une carte de contact (format hCard) est disponible sur la page web, on peut aussi l’ajouter dans votre carnet d’adresse Yahoo ou de télécharger le fichier .vcf correspondant;

Comment lire les microformats ?

En passant par le navigateur Firefox vous pouvez installer le plug-in Operator ou Tails Export qui sont actuellement les meilleurs sur le marché.

Création d’une vcard avec les microformats

L’intégration des microformats est très intuitive, vous allez voir ça avec cet exemple ;
nous allons afficher les informations d’une personne, on va l’appeler Wilfried Tartenpion. En plus nous allons attacher à ces informations une vcard de façon transparente.

Comment on va procéder ?

En utilisant simplement le html, avec les balises class des conteneur <div> ou <span>.
Pour indiquer au navigateur que le contenu est la représentation d’une vcard,
il faut nommer créer un conteneur dont la classe est vcard, soit

<div class="vcard">
</div>

Après pour indiquer à la vcard le nom est le prénom il faut utiliser la classe « fn n« .
Et si on veut préciser le prénom et le nom il faut utiliser la classe « given-name » pour le prénom et « family-name » pour le nom.
Enfin pour iniquer l’adresse mail, il faut utiliser la classe « email« .

Ce qui donne :

<div class="vcard">
<span class="fn n" lang="fr">
<span class="given-name">Wilfried</span>
<span class="family-name">Tartenpion</span>
</span><span class="email">wilfried.tartenpion@waanser.com</span>
</div>

Le rendu html :

Les microformats avec Operator ou Tails Export

Maintenant regardez les microformats de cette page à travers Operator ou Tails Export

microformats tails export et operator

Pour Operator, l’onglet Contacts devrait afficher le contact Wilfried Tartenpion.

operator

Pour Tails Export, un menu contextuel devrait s’afficher juste à droite. Dedans, normalement vous devriez voir
une bulle avec les informations sur Wilfried Tartenpion.

tails export

Si l’on clique sur exporter, le navigateur nous propose d’ouvrir un fichier hCard.vcf. Ceci est est normal, c’est justement la vcard que l’on a défini sémantiquement grâce au microformats.

vcf

géolocalisation

Si vous voulez géolocaliser vos contenu (comme une photo) avec des outils comme google map, yahoo map et autre, vous pouvez le faire en utilisant les microformats.

<div class="geo">
<abbr class="latitude" title="37.408183">N 37° 24.491</abbr>
<abbr class="longitude" title="-122.13855">W 122° 08.313</abbr>
</div>

calendrier

Si vous voulez intégrer un calendrier, voici la syntaxe :

<div class="vevent">
<a class="url" href="http://www.waanser.com/">http://www. waanser.com/</a>
<span class="summary">waanser</span>:
<abbr class="dtstart" title="2009-01-25">5 janvier 2009</abbr>-
<abbr class="dtend" title="2009-01-26">26</abbr>,
à <span class="location">Paris</span>
</div>

Attention à respecter le format de date anglophone (année-moi-jour).

Voila, maintenant vous savez rendre le contenu de vos pages webs plus sémantique.

Il faut juste espérer que les navigateurs fassent l’effort d’intégrer les microformats dans leur prochaine version sans que l’on ai besoin d’ajouter une extension.