Architecture des S.I.

Etape 5 : Déployer un Service Web et compléter son WSDL

2011-12-05T14:48:00.001+02:00

Il s’agit de la 5ieme étape d’un tutorial sur la création de service web JAX-WS. L’objectif de cette étape est, dans notre approche Contract First, de compléter le WSDL naturellement généré par les annotations JAX-WS. Nous allons en effet constater que les annotations JAX-WS ne permettent pas la génération d’un WSDL contenant toutes les précisions nécessaires (comme la longueur d’une chaine de caractères). Nous allons voir comment surcharger le WSDL généré afin qu’il soit conforme au besoin de notre approche Contract First.

Cette étape s’appuie sur :

l’étape précédente qui a permis l’annotation des classes métiers précédemment créées Etape 4 : Annotations JAX-WS et JAXB des classes.

Dans cette partie nous allons déployer notre service web sur JBoss 5.1 et analyser le WSDL qui est produit. Ensuite, nous allons compléter le WSDL afin d’ajouter des informations plus précises sur les contraintes des types. Pour cela nous allons enregistrer le WSDL généré et le surcharger en utilisant un schéma XSD complémentaire.

Rappel des étapes du tutorial sur les services avec JAX-WS :

Présentation du tutorial et de l'approche Contract First avec JAX-WS
Etape 2 : Configuration d'un projet Eclipse pour un WebService JAX-WS
Etape 3 : Création des objets métier et d’une exception JAX-WS
Etape 4 : Annotations JAX-WS et JAXB des classes
Etape 5, Ce billet : Déployer un Service Web et compléter son WSDL

Déployer un service web

Je ne vais pas reprendre dans le détail le déploiement d’un service web. Le déploiement est assez spécifique au serveur d’application et j’ai déjà réalisé trois tutoriaux mettant en œuvre le déploiement d’un service web :

http://jl2tho.blogspot.com/2011/11/ce-tutorial-adapte-pour-ibm-websphere-6.html : pour WebSphere 6.1
http://jl2tho.blogspot.com/2011/11/tutorial-service-web-avec-jbosss-51.html : Pour JBoss 5.1
http://jl2tho.blogspot.com/2007/05/tutorial-service-web-avec-jbosss-42.html : Pour JBoss 4.2

Dans notre cas, nous allons créer un WAR puis le déployer sur le serveur d’application.

Génération du War

Assurez vous d’avoir bien sauvegarder l’ensemble des fichiers.

Cliquez droit dans l’explorateur de ressource d’Eclipse sur votre projet JaxWsContractFirst, sélectionnez Export –> WAR File, dans la dialogue « Export » qui s’affiche choisissez :

Web Project : JaxWsContractFirst qui est le nom de votre projet
Destination : Naviguez pour sélectionner l’emplacement et le nom du WAR File. Pour ma part je l’ai créé sur le bureau. Le nom du fichier est JaxWsContractFirst.war.
Décochez l’option “Optimize for a specific server runtime”

Le nom du war n’a aucune importance, il n’est pas utilisé pour obtenir le WSDL et n’a aucun d’impact sur le contenu du WSDL.

Appuyez, ensuite sur Finish. Vous devriez trouver un fichier JaxWsContractFirst.war sur le bureau.

Déployer le war

Cette partie est très spécifique de votre serveur d’application. Je me contente du cas JBoss 5.1.

Pour WebSphere, je vous renvoie à mon tutoriel : http://jl2tho.blogspot.com/2011/11/ce-tutorial-adapte-pour-ibm-websphere-6.html

Avec JBoss, la solution la plus simple est de copier le war dans le répertoire C:\jboss-5.1.0.GA\server\default\deploy.

Vous n’avez pas besoin de redémarrer le serveur s’il est lancé, vous devriez voir apparaitre après quelques secondes dans la console :

12:08:51,352 INFO [DefaultEndpointRegistry] register: jboss.ws:context=JaxWsContractFirst,endpoint=WebContractHelpdesk
12:08:51,778 INFO [TomcatDeployment] deploy, ctxPath=/JaxWsContractFirst
12:08:52,555 INFO [WSDLFilePublisher] WSDL published to: file:/C:/jboss-5.1.0.GA/server/default/data/wsdl/JaxWsContractFirst.war/WebContractHelpdesk7856945428892376495.wsdl

On y retrouve le nom du War que l’on a déployé et le nom du service web (le endpoint).

Si on tape l’url suivante dans un browser : http://localhost:8080/jbossws/services une page JBossWS/Services s’affiche.

Il doit y a avoir une page avec un Endpoint name jboss.ws:context=JaxWsContractFirst,endpoint=WebContractHelpdesk, un WSDL est accessible sur la ligne suivante : http://127.0.0.1:8080/JaxWsContractFirst?wsdl

Attention ! les URLs dépendent des serveurs d’application. On a par exemple, pour obtenir le WSDL :

Pour JBoss 5.1 : http://127.0.0.1:8080/JaxWsContractFirst?wsdl
Pour WebSphere 6.1 : http://localhost:9080/JaxWsContractFirst/WebContractHelpdesk?WSDL

Analyse du WSDL généré

En cliquant sur le lien précédent : http://127.0.0.1:8080/JaxWsContractFirst?wsdl on affiche le WSDL du service.

Le WSDL dépend du serveur d’application : par exemple WebSphere 6.1 sépare en deux fichiers le WSDL du schema XSD définissant les types XML. JBoss ne fait lui qu’un seul fichier.

Nous allons analyser succinctement son contenu afin de mettre en évidence les correspondances entre les annotations et le contenu du WSDL.

Dans mes précédents tutoriaux sur JAX-WS, j’ai déjà analysé les différentes correspondances, je me limiterai dans cette étape à quelques points nouveaux :

l’objet Question : comment un objet Java apparait dans le WSDL
l’énumération
le FaultBean qui permet de transférer une exception vers le client

L’objet Question

Il devient un ComplexType, son type QuestionType correspond à l’annotation XmlType.

On constate que les name des différents éléments correspondent à l’annotation XmlElement.

<xs:complexType name="QuestionType">
<xs:sequence>
<xs:element minOccurs="0" name="NUMERO" type="xs:string"/>
<xs:element minOccurs="0" name="DESCRIPTION" type="xs:string"/>
<xs:element minOccurs="0" name="SUBMITDATE" type="xs:dateTime"/>
<xs:element name="TITLE" type="xs:string"/>
<xs:element minOccurs="0" name="PRODUCT" type="xs:string"/>
<xs:element minOccurs="0" name="URGENCY" type="tns:urgencyEnum"/>
<xs:element name="PRIORITY" type="xs:string"/>
<xs:element minOccurs="0" name="TYPE" type="xs:string"/>
</xs:sequence>
</xs:complexType>

On remarque qu’on utilise des types simples provenant du schéma xs, à l’exception de URGENCY qui pointe vers le schéma tns (c’est le WSDL) et plus particulièrement vers notre type énumération.

Si on compare avec le WSDL généré par Axis2 à l’étape : http://jl2tho.blogspot.com/2007/05/etape-5-tutorial-axis2-gnration-des.html dans notre tutorial Services web avec Axis2 : Approche Contract First, on avait pour l’objet Question :

<xsd:complexType name="Question">
<xsd:sequence>
<xsd:element name="Numero" type="tns:QuestionID"></xsd:element>
<xsd:element name="SubmitDate" type="xsd:date"></xsd:element>
<xsd:element name="Product">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:length value="2"></xsd:length>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Type">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="BUGINPROD"></xsd:enumeration>
<xsd:enumeration value="CONFIG"></xsd:enumeration>
<xsd:enumeration value="USAGE"></xsd:enumeration>
<xsd:enumeration value="BUGINDEV"></xsd:enumeration>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Priority" type="tns:Urgency"></xsd:element>
<xsd:element name="Description" type="xsd:string"></xsd:element>
<xsd:element name="Title">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:maxLength value="250"></xsd:maxLength>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>

On diffère sur plusieurs points significatifs (les noms ne le sont pas car ils sont paramétrables par annotation comme on pu le voir à l’étape suivante) :

le type de SubmitDate est date au lieu de dateTime
l’énumération est directement incluse dans le type, dans notre cas elle est externalisée.
avec axis2, il est possible d’être plus précis sur les restrictions de type : notamment on peut indiquer la taille maximale d’un champ.
par défaut, il aurait fallu indiquer systématiquement required à true. cela indique que le nœud est toujours présent et fait disparaitre le minOccurs. Attention, cela n’a rien à voir avec la valeur null.
avec axis2, on a pu utiliser un type simple externe QuestionID permettant de préciser les contraintes sur le contenu du nœud.

Enumération

On avait surchargé les valeurs des énumérations par annotation, on voit qu’on retrouve un SimpleType qui reprend ces valeurs.

Si on compare à la définition ci-dessus qui provient d’Axis2 et qui était incluse directement dans l’objet Question, on retrouve la même structure.

<xs:simpleType name="urgencyEnum">
<xs:restriction base="xs:string">
<xs:enumeration value="URGENCY_BUGINPROD"/>
<xs:enumeration value="URGENCY_CONFIG"/>
<xs:enumeration value="URGENCY_USAGE"/>
<xs:enumeration value="URGENCY_BUGINDEV"/>
</xs:restriction>
</xs:simpleType>

Exception et Fault

Nos méthodes pouvaient renvoyer une exception, on retrouve cette possibilité dans la définition de l’opération :

On a un attribut fault pour nos opérations.

Par rebond, on arrive à la définition du beanFault :

<xs:complexType name="faultBean">
<xs:sequence>
<xs:element minOccurs="0" name="businessMessage" type="xs:string"/>
<xs:element minOccurs="0" name="code" type="xs:string"/>
</xs:sequence>
</xs:complexType>

On voit qu’il contient les deux propriétés qu’on avait définies.

Vous pouvez chercher dans le WSDL, vous ne trouverez aucune référence à la propriété message d’une exception Java. Cette information n’est pas visible dans le WSDL.

Compléter le WSDL

Nous avons deux éléments en écart par rapport à ce qu’on pouvait faire dans l’approche Axis2 :

le format d’un champ date
la possibilité de définir des contraintes plus fortes sur un type simple

Propriété de type Date

La documentation officielle d’Oracle (http://docs.oracle.com/cd/E17802_01/webservices/webservices/reference/tutorials/wsit/doc/DataBinding2.html) considère que le type à utiliser pour une date est en priorité le type XMLGregorianCalendar : si on utilise le type java Date, on ne pourra aller que vers le type XML dateTime. A contrario, le type XMLGregorianCalendar offre une plus grande liberté et peut être envoyé vers un type XML date.

Pour information, les outils qui génère du Java à partir du WSDL vont généralement vers ce type XMLGregorianCalendar.

On va donc modifier doublement la déclaration de notre propriété submitDate dans l’objet Question :

on change son type java
on lui ajoute une annotation XmlSchemaType afin de préciser qu’on souhaite un type date et non plus dateTime.

On obtient pour sa déclaration le code suivant :

    @XmlElement(name = "SUBMITDATE")
    @XmlSchemaType(name="date")
     public javax.xml.datatype.XMLGregorianCalendar submitDate;

Il faudra également penser à mettre à son jour son getter et son setter.

Propriété de type Token ou normalizedString

Au niveau des types de base du XML, il existe trois types simples pour une chaine de caractères : le type string que nous avons utilisé (il s’agit du défaut pour une String Java) et les types token et normalizedString qui peuvent être précisé avec l’utilisation de XmlSchemaType.

Les deux différent du type string par le traitement des caractères retour à la ligne, Entrée, tabulation ainsi que des espaces en début et fin de chaine :

token : indique au processeur XML de simplement supprimer ces caractères. Vous obtenez ainsi une chaine sans caractères espaces en début ou fin et sans tabulation ou retour chariot et cela indépendamment de ce qu’envoie le client du service web.
normalizedString va un cran plus loin, car il interdit la présence de tel caractère.

Nous allons modifier les propriété product et type afin d’essayer ces deux types. On obtient pour la définition des propriétés de l’objet Question, le code suivant :

On obtient pour sa déclaration le code suivant :

@XmlElement(name = "DESCRIPTION")
private String description;

    @XmlElement(name = "SUBMITDATE")
    @XmlSchemaType(name="date")
     public javax.xml.datatype.XMLGregorianCalendar submitDate;

@XmlElement(name = "TITLE", required=true)
private String title;

    @XmlElement(name = "PRODUCT")
    @XmlSchemaType(name="token")
    private String product;

@XmlElement(name = "URGENCY")
private UrgencyEnum urgency;

@XmlElement(name = "PRIORITY", required=true)
private String priority;

    @XmlElement(name = "TYPE")
    @XmlSchemaType(name="normalizedString")
    private String type;

…

On a mis en gras les modifications.

Il n’est pas nécessaire de modifier les getter et setters.

Ajouter des contraintes à un type simple

Cette dernière opération est la plus délicate : on a vu précédemment que les types simples dans axis2 étaient plus précis : il était possible de spécifier la taille maximale d’une chaine de caractères et il était possible de préciser une expression régulière vérifiée par la chaine.

Les annotations JAX-WS ou JAXB ne permettent pas une telle précision, or cette information (surtout d’ailleurs pour la taille d’une chaine de caractères) est particulièrement importante d’un point de vu contractuel. Nous allons aborder ce dernier point dans ce chapitre.

La seule approche possible est l’utilisation d’un WSDL en local : les annotations n’étant pas assez puissante, il faut les aider en reprenant la main. Il y a bien l’annotation XmlSchemaType qui permet d’indiquer un type de données propriétaire : on n’est pas limité aux types du schema standard, il suffit de préciser un autre namespace. Mais il n’existe pas d’annotation permettant d’inclure son propre schéma XSD. Heureusement, nous disposons d’un attribut wsdlLocation dans l’annotation WebService permettant de préciser son propre WSDL. c’est cette approche que nous allons utiliser mais afin d’être moins intrusif, on va également utiliser un schéma XSD complémentaire.

Le principe de base de notre approche est l’utilisation maximale de la génération automatique du WSDL : on partira d’un fichier WSDL généré. Ce fichier WSDL généré que l’on récupère en l’enregistrant va être complété en se limitant au strict nécessaire (ce qui n’aura pas pu être mis en annotation comme l’inclusion d’un schema XSD complémentaire ou bien les annotations length sur les strings).

Fichier XSD pour les contraintes

Tout d’abord nous allons définir un nouveau schéma XSD afin de définir les types nécessitant des contraintes plus fortes comme dans notre exemple le numéro d’une Question. Le numéro est une chaine de caractères de 9 chiffres. Nous allons définir un type simple. Afin de limiter l’impact sur le WSDL généré, nous allons mettre dans un fichier externe : un nouveau fichier XSD.

On crée un répertoire wsdl dans WEB-INF. Il semble impératif qu’il soit dans WEB-INF : il est préférable de mettre ce fichier à coté du fichier WSDL qui doit être sous WEB-INF pour JBoss.

On se place sur le nœud WEB-INF dans WebContent, et on clique droit, choisir New –> Other… Dans la dialogue qui s’ouvre choisir Folder dans le nœud General. Le nom du dossier sera wsdl puis validez.

Dans ce répertoire wsdl, on crée un fichier xsd : HelpDeskBasic.xsd. On se place sur le nœud wsdl que l’on vient de créer, et on clique droit, choisir New –> Other… Dans la dialogue qui s’ouvre choisir XML dans le nœud XML. Tapez HelpDeskBasic.xsd come File name et validez. Le fichier est créé. S’il est ouvert,fermez le afin de le rouvrir en mode Editeur XML.

Ajoutez, le code suivant :

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns:tns="http://basic.demo.jl2tho.fr" xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://basic.demo.jl2tho.fr">
<simpleType name="QuestionId">
<annotation>
<documentation>Type pour un numero de question</documentation>
</annotation>
<restriction base="string">
<length value="9"></length>
<pattern value="\d*"></pattern>
</restriction>
</simpleType>
</schema>

Il est important de noter qu’on utilise pour ce fichier un namespace différent de celui du WSDL en l’occurrence : http://basic.demo.jl2tho.fr. J’en profite pour rappeler qu’un namespace est juste une étiquette : par convention il ressemble à une URL mais il n’y a rien à cette emplacement.

Utilisation d’un type propriétaire avec JAXB

Maintenant que notre nouveau type est défini, nous allons l’utiliser dans notre objet Question. Pour cela, on modifie le champ id de l’objet Java en ajoutant une annotation XmlSchemaType.

cette annotation permet de préciser un type XML (nos l’avons déjà utilisé plus haut). Dans notre cas, comme le type n’appartient au schéma par défaut, nous devons également indiquer le namespace : dans notre cas, c’est celui de notre nouveau XSD.

On obtient pour sa déclaration le code suivant :

@XmlElement(name = "NUMERO")
@XmlSchemaType(name="QuestionId", namespace="http://basic.demo.jl2tho.fr")
private String id;

Il n’est pas nécessaire de mettre à jour son getter et son setter puisqu’on a juste ajouter une annotation.

Création du fichier WSDL local

Pour obtenir la version de départ du WSDL, je souhaite m’appuyer sur le WSDL généré automatiquement. Comme je viens de modifier mes annotations, il faut que je déploie ma nouvelle version sur le serveur JBoss. Je crée un nouveau WAR que je copie sous C:\jboss-5.1.0.GA\server\default\deploy comme au début de ce tutorial. Je rappelle qu’il n’est pas nécessaire de redémarrer le serveur pour prendre en compte une nouvelle version.

On obtient lors du déploiement, le message suivant sur la console :

10:25:46,777 INFO [TomcatDeployment] undeploy, ctxPath=/JaxWsContractFirst
10:25:46,899 INFO [DefaultEndpointRegistry] remove: jboss.ws:context=JaxWsContractFirst,endpoint=WebContractHelpdesk
10:25:47,031 INFO [DefaultEndpointRegistry] register: jboss.ws:context=JaxWsContractFirst,endpoint=WebContractHelpdesk
10:25:47,102 INFO [TomcatDeployment] deploy, ctxPath=/JaxWsContractFirst
10:25:47,340 ERROR [JBossXSErrorHandler] JBossWS_demo.jl2tho.fr6970218092484449523.xsd[domain:http://www.w3.org/TR/xml-schema-1]::[key=src-resolve.4.2]::Message=src-resolve.4.2: Error resolving component 'ns1:QuestionId'. It was detected that 'ns1:QuestionId' is in namespace 'http://basic.demo.jl2tho.fr', but components from this namespace are not referenceable from schema document 'file:/C:/jboss-5.1.0.GA/server/default/tmp/jbossws/JBossWS_demo.jl2tho.fr6970218092484449523.xsd'. If this is the incorrect namespace, perhaps the prefix of 'ns1:QuestionId' needs to be changed. If this is the correct namespace, then an appropriate 'import' tag should be added to 'file:/C:/jboss-5.1.0.GA/server/default/tmp/jbossws/JBossWS_demo.jl2tho.fr6970218092484449523.xsd'.
10:25:47,434 INFO [WSDLFilePublisher] WSDL published to: file:/C:/jboss-5.1.0.GA/server/default/data/wsdl/JaxWsContractFirst.war/WebContractHelpdesk6191007714417398541.wsdl

En dépit du message d’erreur qui indique qu’il ne trouve pas la définition du type QuestionId, il est possible d’obtenir un WSDL à jour (il contient bien la référence au nouveau type QuestionId).

Pour le récupérer, on tape l’URL suivante http://127.0.0.1:8080/JaxWsContractFirst?wsdl.

Dans le navigateur, une fois le WSDL affiché, aller dans le menu “Enregistrer Sous…” et enregistrer votre fichier avec le nom JaxWsContractFirst.wsdl. Attention ! l’extension par défaut est XML.

Copier ce fichier dans le répertoire WebContent/WEB-INF/wsdl. Nous avons donc notre fichier WSDL local.

On modifie le fichier en ajoutant au début du fichier un import du xsd qu’on a créé précédemment. Comme ils sont dans le même répertoire, il n’est pas nécessaire de préciser un répertoire.

On obtient pour sa déclaration le code suivant :

La déclaration va permettre au WSDL de savoir que si on fait référence au namespace http://basic.demo.jl2tho.fr, il doit chercher la définition dans le nouveau schéma XSD. Il faut faire attention à la correspondance avec le nom du fichier xsd.

Bean Webservice HelpdeskServiceBean

Pour finir, on modifie le bean implémentant le Web Service. L’annotation @WebService dispose d’un attribut wsdlLocation qui permet d’indiquer que l’on souhaite utiliser un WSDL local. Attention ! dans le cas de JBoss, il semble indispensable que le fichier WSDL soit sous WEB-INF.

On obtient pour sa déclaration le code suivant :

package fr.j2ltho.webcontracthelpdesk.server;

import javax.ejb.Stateless;
import javax.jws.WebService;

@Stateless
@WebService(endpointInterface="fr.j2ltho.webcontracthelpdesk.server.IWebHelpDesk",
        portName="HelpdeskServicePort", serviceName="WebContractHelpdesk",
        targetNamespace = "http://demo.jl2tho.fr",
        wsdlLocation="WEB-INF/wsdl/JaxWsContractFirst.wsdl")
public class HelpdeskServiceBean implements IWebHelpDesk {

    public String createQuestion(Question pNewQuestion)
            throws BusinessFaultException {
        if (pNewQuestion==null) {
            FaultBean faultBean = new FaultBean();
            faultBean.setBusinessMessage("Erreur Question nulle");
            faultBean.setCode("01");
            // Le message dans l'exception est disponible dans l'exception recu
            // mais sa déclaration est absente du wsdl
            throw new BusinessFaultException("Internal Message" , faultBean );
        }
        return null;
    }

    public Question getQuestionWithId(String pNumero)
            throws BusinessFaultException {
        if (pNumero==null) {
            FaultBean faultBean = new FaultBean();
            faultBean.setBusinessMessage("Erreur : Numero de question nul");
            faultBean.setCode("02");
            // Le message dans l'exception est disponible dans l'exception recu
            // mais sa déclaration est absente du wsdl
            throw new BusinessFaultException("Internal Message" , faultBean );
        }
        return null;
    }

}

On voit que la modification au WSDL généré est minimale : cela me permet d’opter pour régénération du WSDL plutôt que la modification du WSDL local lors d’une modification. Je retire le wsdlLocation, je déploie, je récupère le nouveau WSDL, je l’enregistre et je rajoute ma ligne d’import. Je termine en réactivant le wsdlLocation.

Je régénère mon war et le déploie de nouveau. Le message d’erreur dans la console JBoss a disparu. Si on affiche le WSDL on aura une ligne d’import qui apparait en début de WSDL. Elle diffère de celle que l’on a ajouté :

Le même war se déploie parfaitement sous WebSphere 6.1. Attention ! l’url du WSDL est http://localhost:9080/JaxWsContractFirst/WebContractHelpdesk?WSDL. Avec ce format d’adresse, Websphere sait afficher le WSDL qu’il faut utiliser. Dans notre cas il le remplace par http://localhost:9080/JaxWsContractFirst/WebContractHelpdesk/WEB-INF/wsdl/JaxWsContractFirst.wsdl alors que quand il s’agit d’un WSDL généré automatiquement, il le redirige vers http://localhost:9080/JaxWsContractFirst/WebContractHelpdesk/webcontracthelpdesk.wsdl (le WEB-INF/wsdl a été supprimé).

On constate que ce n’est pas parce que le WSDL est local, qu’il n’y a pas certaine modification : la définition de l’import change et le nœud soap:address qui contient l’URL du service web sont modifiés à la volée.

Conclusion

Nous avons terminé la partie de création du WSDL avec une approche Contract First. Nous avons obtenu le WSDL de notre choix avec le degré de précision que nous souhaitions.

Nous avons du aider JAX-WS et JAXB car dans la version 2.0, il n’est pas possible en se limitant aux annotations d’être suffisamment précis : il manque des contraintes sur les champs comme la longueur d’une chaine de caractères. La solution retenue repose sur un schéma complémentaire XSD définissant ses contraintes, conjointement utilisé avec un WSDL local afin d’être capable d’ajouter l’import de ce fichier XSD.

Cette approche est beaucoup plus efficace que la solution Axis2 que j’avais décrite en 2007 (voir le tutorial : http://jl2tho.blogspot.com/2007/04/tutorial-services-web-avec-axis2.html).

D’autre part, j’ai pu testé que le même WAR se déploie sur différents serveurs d’application : ce point est important car c’est l’objectif d’une norme comme JAX-WS. Toutefois, souvent, quand on essaie d’aller jusqu’au bout d’une norme censé apporter de la portabilité on se heurte à quelques détails qui cassent sur la fin la portabilité. Cela n’a pas été le cas dans notre exemple qui se veut pourtant complet.

Dans les étapes suivantes, nous allons créer un client puis nous allons coder “véritablement” le service web en introduisant Spring.

Etapes : 1 | 2 | 3 | 4 | 5 – Suivant >

Etape 4 : Annotations JAX-WS et JAXB des classes

2011-12-02T12:28:00.001+02:00

Il s’agit de la 4ieme étape d’un tutorial sur la création de service web JAX-WS. Cette étape s’appuie sur :

le projet Eclipse créé précédemment (http://jl2tho.blogspot.com/2011/11/etape-2-du-tutorial-configuration-dun.html) qui référencent les jars contenant les annotations
les objets Java (classe métier, interface et bean de service) créés à l’étape précédente Etape 3 : Création des objets métier et d’une exception JAX-WS .

Dans cette partie nous allons annoter les objets métiers créés précédemment afin de les transformer en Service Web. L’objectif est d’utiliser les annotations afin d’obtenir une complète maitrise du WSDL généré. Dans cette étape on se concentre sur les possibilités des annotations. On ne complètera pas le fonctionnelle de notre service web. Le code restera identique.

Ce billet peut vous être utile si vous rechercher comment maitriser un aspect du WSDL en utilisant JAX-WS 2.0.

Nous allons annoter les éléments suivants :

l’interface et le bean afin de définir le service
l’objet métier Question et l’énumération Java afin de préciser la structure du XML permettant le stockage d’un objet Java.

Rappel des étapes du tutorial sur les services avec JAX-WS :

Présentation du tutorial et de l'approche Contract First avec JAX-WS
Etape 2 : Configuration d'un projet Eclipse pour un WebService JAX-WS
Etape 3 : Création des objets métier et d’une exception JAX-WS
Etape 4, Ce billet : Annotations JAX-WS et JAXB des classes

Les annotations JAX-WS

Les annotations JAX-WS se place sur l’interface et son implémentation : elles permettent de définir le service web. Le serveur d’application va les utiliser pour déployer le service web, générer le WSDL et assurer la correspondance entre les messages XML qui arrivent en entrée et l’appel de la méthode Java que l’on aura défini pour le traitement.

Pour une documentation de référence sur les annotations JAX-WS 2.0 vous pouvez vous reporter aux pages suivantes :

Interface IWebHelpDesk

C’est au niveau de l’interface qu’on a la plus grande maitrise sur la génération du WSDL :

on y définit le protocole utilisé
on y définit le nom de la majorité des nœuds XML

Au niveau de l’interface, nous définissons deux types d’annotations :

celles qui annotent l’interface directement : @Remote, @WebService et @SOAPBinding
celles qui annotent une méthode de l’interface : @WebMethod, @WebResult et @WebParam

Les premières permettent de définir le protocole des messages, comment on assemble les messages, le nom du service…

@WebService permet de définir le nom du PortType. Je surcharge systématiquement le targetNameSpace afin de donner une URL neutre (détachée du nom de mes classes). je réutilise la même URL partout. Attention ! une uRL a déjà été utilisée au niveau de la BusinessFaultException.
@SOAPBinding : j’utilise systématiquement Document, Literal et Wrapped qui sont les standards de fait (les plus utilisés). Cela m’assure que le client est capable d’accéder correctement au service indépendamment de la qualité de son implémentation.

Les secondes permettent de définir les éléments de base d’une opération : le nom des nœuds ou attributs XML. Ceux sont les annotations les plus déterminantes pour maitriser la forme du message XML et donc de la partie sensible du WSDL.

@WebMethod : indique le nom de l’opération du WSDL. Ce nom est également utilisé dans le mode WRAPPED comme nom du message en entrée du service et comme nom du message de réponse (dans ce dernier cas, on ajoute Response au nom). Dans l’exemple, j’ai volontairement pris un nom différent du nom de la méthode, mais il est préférable, dans la mesure du possible, de conserver un nom identique afin de faciliter la phase de test.
@WebResult : nom de l’objet XML encapsulant la valeur retournée.
@WebParam : permet d’indiquer le nom du paramètre (par défaut on a arg0…). Il s’agit d’un des éléments les plus importants pour maitriser le WSDL et pour le rendre compréhensible.

On modifie le code initiale avec les annotations suivantes, afin d’obtenir le code suivant :

package fr.j2ltho.webcontracthelpdesk.server;

import javax.ejb.Remote;
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;

@Remote
@WebService(name = "ISwHelpDeskPortType", targetNamespace = "http://demo.jl2tho.fr" )
@SOAPBinding(style=Style.DOCUMENT, use=SOAPBinding.Use.LITERAL, parameterStyle= SOAPBinding.ParameterStyle.WRAPPED)
public interface IWebHelpDesk {

    @WebMethod(operationName="retrouverQuestionApartirId")
    @WebResult(name = "QUESTION")
    public Question getQuestionWithId(
            @WebParam(name = "NUMERO")String pNumero
            ) throws BusinessFaultException;

    @WebMethod(operationName="creerNouvelleQuestion")
    @WebResult(name = "NUMERO")
    public String createQuestion(
            @WebParam(name = "INPUT_QUESTION") Question pNewQuestion
            ) throws BusinessFaultException;
}

Attention ! Pour que les annotations soit utilisables, il est indispensable d’avoir correctement définis les External Jars de votre projet Eclipse (voir Etape 2 : Configuration d'un projet Eclipse pour un WebService JAX-WS de ce tutorial).

Attention ! WebSphere 6.1 ne supporte pas bien les noms de paramètres avec un tiret (-). Le signe souligné (_) est préférable comme séparateur si vous décidez d’utiliser des noms en majuscule pour les nœuds XML.

Bean WebService

Au niveau du bean implémentant le Webservice, il n’y a pas grand chose à préciser si ce n’est le nom du WebService lui même.

Attention ! Dans une approche avec un WAR, il faut assurer la correspondance du nom avec celui indiqué dans le servlet-name de web.xml.

Pour les différents attributs de l’annotation WebService d’un bean nous avons :

endpointInterface : elle indique le nom de l’interface Java décrivant le service Web (dans notre cas IWebHelpDesk).
portName : la valeur est utilisée comme Port et Binding dans le WSDL. Il s’agit d’un élément de contrôle supplémentaire sur le WSDL mais je doute de l’intérêt de le surcharger.
serviceName : ce sera le nom du service web. Il correspond aux nœuds Definition et Service du WSDL. Il doit correspondre au servlet-name du web.xml : dans notre cas : WebContractHelpdesk
targetNamespace : je reprends le même que celui définit dans l’interface. Il s’agit plus pour moi d’éviter de voir apparaitre dans le WSDL des informations sur la structure du développement.

On modifie le code initial afin d’obtenir le code suivant :

package fr.j2ltho.webcontracthelpdesk.server;

import javax.ejb.Stateless;
import javax.jws.WebService;

@Stateless
@WebService(endpointInterface="fr.j2ltho.webcontracthelpdesk.server.IWebHelpDesk",
portName="HelpdeskServicePort", serviceName="WebContractHelpdesk",
targetNamespace = "http://demo.jl2tho.fr")
public class HelpdeskServiceBean implements IWebHelpDesk {

}

On constate que l’impact sur l’implémentation du service Web est bien plus faible que sur l’interface.

Avec l’annotation de l’interface et de la classe implémentant le service web, on a définit une grande partie du WSDL. En fait si on travaille sur des types simples on a tout définis.

Annotation JAXB sur la classe Question

Néanmoins, dans le cadre d’un vrai service, il est fort probable qu’il vous faille échanger des données un peu plus structurées comme un objet.

Dans notre cas, nous avons un objet métier Question qui va nous permettre d’aborder ce point. En développement Java, il va de soi, qu’il s’agit d’une classe.

JAX-WS 2.0 travaille de pair avec JAXB 2.0 pour plier les objets Java. JAXB a également recours aux annotations pour préciser le pliage sous forme d’objet XML. Nous allons en utiliser 3 :

@XmlType : il s’agit du point départ. elle porte sur l’objet et elle indique que l’on souhaite surcharger le comportement par défaut de JAXB. Elle est un prérequis pur l’utilisation des deux autres. Je l’utilise pour surcharger le nom du type XML correspondant à l’objet. Attention ! Son nom est présent dans la partie Schema du WSDL, mais son nom n’intervient pas dans le balisage XML du message SOAP. C’est également lui qui permet de surcharger le comportement par défaut du targetNameSpace. Il permet pour finir de définir l’ordre d’apparition des propriétés, mais j’avoue ne pas très bien comprendre son utilité.
@XmlAccessorType : il permet de choisir entre deux façons de plier un objet Java en XML : XmlAccessType.FIELD dans ce cas, chaque propriété correspond à un nœud XML, XmlAccessType.ATTRIBUTE dans ce cas, il n’y a qu’un seul nœud XML pour l’objet et les propriétés correspondent à des attributs du nœud XML. Je pense que le plus robuste et standard est XmlAccessType.FIELD, c’est pour cela que je préfère son utilisation.
@XmlElement : Il se place au niveau de chaque propriété de la classe. Son utilisation nécessite l’annotation XmlType au niveau de la classe. Il permet de préciser le nom du nœud XML correspondant à la propriété. L’attribut required à true retire le minOccurs à 0 du WSDL.

Pour plus d’information sur JAXB, je vous renvoie au très bon article : http://blog.paumard.org/cours/jaxb-rest/chap01-jaxb-annotations.html.

On édite la classe Java Question pour modifier sa première partie. Les constructeurs et getter/setter ne sont pas modifiés.

Le début du code (jusqu’au constructeur) est modifié afin d’obtenir le code suivant :

package fr.j2ltho.webcontracthelpdesk.server;

import java.util.Date;

import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlType;

@XmlType(name="QuestionType", propOrder = { "id", "description", "submitDate", "title", "product", "urgency", "priority", "type" })
@XmlAccessorType(XmlAccessType.FIELD)
public class Question {
    @XmlElement(name = "NUMERO")
    private String id;
    @XmlElement(name = "DESCRIPTION")
    private String description;
    @XmlElement(name = "SUBMITDATE")
    private Date submitDate;
    @XmlElement(name = "TITLE", required=true)
    private String title;
    @XmlElement(name = "PRODUCT")
    private String product;
    @XmlElement(name = "URGENCY")
    private UrgencyEnum urgency;
    @XmlElement(name = "PRIORITY", required=true)
    private String priority;
    @XmlElement(name = "TYPE")
    private String type;


    public Question() {
        super();
    }

…

Certaines annotations JAXB comme le nillable ne sont pas traitées par JAX-WS. Elles n’auront alors aucun effet sur le WSDL.

Attention ! Les annotations JAXB peuvent nécessiter un jar différent que celles de JAX-WS. C’est notamment le cas de JBoss 5.1 qui nécessite jaxb-api.jar.

Si vous avez suivi à la lettre mon Etape 2 : Configuration d'un projet Eclipse pour un WebService JAX-WS de ce tutorial et que vous utilisez JBoss 5.1, vous ne devriez pas avoir de problème.

XmlEnum et XmlEnumValue

Nous avions définis une énumération comme propriété, nous allons également annoter cette enum java afin de maitriser également sa transformation XML.

L’annotation XmlEnumValue permet de définir la chaine de caractères qui correspond à la valeur de l’énumération dans le message.

Editez UrgencyEnum et modifiez la afin d’obtenir le code suivant :

package fr.j2ltho.webcontracthelpdesk.server;

import javax.xml.bind.annotation.XmlEnum;
import javax.xml.bind.annotation.XmlEnumValue;
import javax.xml.bind.annotation.XmlType;

@XmlType
@XmlEnum(String.class)
public enum UrgencyEnum {
    @XmlEnumValue("URGENCY_BUGINPROD") BUGINPROD,
    @XmlEnumValue("URGENCY_CONFIG") CONFIG,
    @XmlEnumValue("URGENCY_USAGE") USAGE,
    @XmlEnumValue("URGENCY_BUGINDEV") BUGINDEV
}

Conclusion

Nous avons finis d’annoter nos classes, interface et énumérations Java. Vous allez voir dans l’étape suivante à quoi correspond le WSDL généré automatiquement à partir de ces annotations.

Vous constaterez alors que nous avons une très grande maitrise grâce aux différentes annotations utilisées à cette étape. Nous n’avons pas progressé sur l’implémentation du service. Nous sommes bien encore dans une approche Contract First : jusqu’à présent tous nos efforts ont consisté à définir l’interface du service web.

Etapes : 1 | 2 | 3 | 4| 5 – Suivant >

Etape 3 du tutorial : Création des objets métier et Exception JAX-WS

2011-11-30T21:43:00.001+02:00

Il s’agit de la 3ieme étape d’un tutorial sur la création de service web JAX-WS. Cette étape s’appuie sur le projet Eclipse créé précédemment (http://jl2tho.blogspot.com/2011/11/etape-2-du-tutorial-configuration-dun.html).

Dans cette partie nous allons créer les objets métiers indépendamment de l’aspect Web Service (les annotations seront ajoutées dans le billet suivant). La seule spécificité Web Service de cette étape est la définition d’une exception supportant les particularités de JAX-WS et son utilisation.

Nous allons voir, qu’avec JAX-WS, il faut spécialiser sa propre exception si on souhaite que le client du service puisse récupérer toutes les informations.

Nous allons créer les éléments suivants :

Question : il s’agit de l’objet métier qui sert à transporter une information structurée
l’exception métier pour le service
l’interface du service
le bean d’implémentation du service

Rappel des étapes du tutorial sur les services avec JAX-WS :

Présentation du tutorial et de l'approche Contract First avec JAX-WS
Etape 2 : Configuration d'un projet Eclipse pour un WebService JAX-WS
Etape 3, Ce billet : Création des objets métier et d’une exception JAX-WS

L’objet métier Question

Il s’agit d’un objet métier, un simple POJO permettant le stockage des informations correspondant à la question. Comme il s’appuie sur une énumération pour la propriété Urgency, on commence par créer l’enum suivante : UrgencyEnum

Enumération UrgencyEnum

Dans Eclipse, à partir de la barre de menu : File -> New -> Enum.

Dans la dialogue New Java Class :

Pour Package, tapez : fr.j2ltho.webcontracthelpdesk.server
Pour Name tapez : UrgencyEnum

Laissez les autres options par défaut et appuyez sur Finish. Il faut maintenant compléter le code. Il s’agit de définir les différentes valeurs de l’enum :

package fr.j2ltho.webcontracthelpdesk.server;

public enum UrgencyEnum {
BUGINPROD, CONFIG, USAGE, BUGINDEV
}

Création de l’objet Question

L’objet Question est un objet métier qui sert à transporter une information structurée entre le client et le serveur de service web. Il me parait préférable de définir des objets métiers dédiés au service web plutôt que de réutiliser tel quel un objet existant :

l’objet est plus simple et probablement plus adapté aux besoins de l’utilisateur
vous évitez d’envoyer des informations confidentielles qui pourraient être disponibles dans l’objet métier existant

Nous pouvons maintenant créer notre objet Question. Dans Eclipse, à partir de la barre de menu : File -> New -> Class.

Dans la dialogue New Java Class :

Pour Package, tapez : fr.j2ltho.webcontracthelpdesk.server
Pour Name tapez : Question

Laissez les autres options par défaut et appuyez sur Finish. Il faut maintenant compléter le code. Il s’agit de définir les propriétés du bean et ses getter/setter. Nous avons également défini un constructeur.

package fr.j2ltho.webcontracthelpdesk.server;

import java.util.Date;

public class Question {
    private String id;
    private String description;
    private Date submitDate;
    private String title;
    private String product;
    private UrgencyEnum urgency;
    private String priority;
    private String type;

    public Question() {
        super();
    }

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getDescription() {
        return description;
    }

    public void setDescription(String description) {
        this.description = description;
    }

    public Date getSubmitDate() {
        return submitDate;
    }

    public void setSubmitDate(Date submitDate) {
        this.submitDate = submitDate;
    }

    public String getTitle() {
        return title;
    }

    public void setTitle(String title) {
        this.title = title;
    }

    public String getProduct() {
        return product;
    }

    public void setProduct(String product) {
        this.product = product;
    }

    public UrgencyEnum getUrgency() {
        return urgency;
    }

    public void setUrgency(UrgencyEnum urgency) {
        this.urgency = urgency;
    }

    public String getPriority() {
        return priority;
    }

    public void setPriority(String priority) {
        this.priority = priority;
    }

    public String getType() {
        return type;
    }

    public void setType(String type) {
        this.type = type;
    }

}

Exception métier pour un service web

Par défaut, une exception java contient une propriété Message. C’est cette propriété qui contient l’information sur l’exception.

Pour les services web on parle de Fault. Il s’agit d’un message que peut renvoyer un service quand il juge qu’il y a une erreur. Cela est proche de l’exception Java, si ce n’est que JAX-WS n’indique pas la propriété Message d’une exception Java dans le WSDL. Cela rend son utilisation délicate pour une autre technologie. En revanche, JAX-WS recherche une propriété faultInfo.

Afin de rendre exploitable les exceptions, nous allons définir un bean FaultBean qui servira à stocker l’information de l’exception.

Puis nous définirons notre propre exception BusinessFaultException qui définira un getter pour récupérer la propriété faultinfo.

Création de l’objet FaultBean

Nous pouvons maintenant créer notre objet Question. Dans Eclipse, à partir de la barre de menu : File -> New -> Class.

Dans la dialogue New Java Class :

Pour Package, tapez : fr.j2ltho.webcontracthelpdesk.server
Pour Name tapez : FaultBean
Cocher la case : Constructor from superclass

Laissez les autres options par défaut et appuyez sur Finish. Il faut maintenant compléter le code. Il s’agit de définir les propriétés du bean et ses getter/setter.

Nous définissons deux propriétés (la liste est libre ainsi que les noms) :

code pour stocker un identifiant technique
businessMessage : pour stocker un libellé associé destiné à l’utilisateur

package fr.j2ltho.webcontracthelpdesk.server;

public class FaultBean {
    private String code;
    private String businessMessage;

    public FaultBean() {
    }

    public String getCode() {
        return code;
    }

    public void setCode(String code) {
        this.code = code;
    }

    public String getBusinessMessage() {
        return businessMessage;
    }

    public void setBusinessMessage(String businessMessage) {
        this.businessMessage = businessMessage;
    }
}

Création de l’exception BusinessFaultException

Nous pouvons maintenant créer notre objet Question. Dans Eclipse, à partir de la barre de menu : File -> New -> Class.

Dans la dialogue New Java Class :

Pour Package, tapez : fr.j2ltho.webcontracthelpdesk.server
Pour Name tapez : BusinessFaultException
Superclass : tapez exception est naviguez pour sélectionner : Exception – java.lang

Laissez les autres options par défaut et appuyez sur Finish. Il faut maintenant compléter le code. Il s’agit de d’ajouter la propriété faultInfo et son getter ainsi que deux constructeurs.

On ajoute également la propriété static serialVersionUID car une exception est serialisable.

Pour finir, on ajoute les annotations :

name sera le nom de la Fault dans la définition du service web
faultBean indique le nom de l’objet Java contenant l’information
targetNamespace indique l’espace nom pour les types XML

On obtient le code suivant :

package fr.j2ltho.webcontracthelpdesk.server;

import javax.xml.ws.WebFault;

@WebFault(name="BusinessFault", faultBean="fr.j2ltho.webcontracthelpdesk.server.FaultBean",
        targetNamespace = "http://demo.jl2tho.fr ")
public class BusinessFaultException extends Exception {
    private static final long serialVersionUID = 3061940459819421533L;
    private FaultBean faultInfo;

    public BusinessFaultException(String internalMessage, FaultBean faultInfo, Throwable cause) {
        super(internalMessage, cause);
        this.faultInfo = faultInfo;
    }

    public BusinessFaultException(String internalMessage, FaultBean faultInfo) {
        super(internalMessage);
        this.faultInfo = faultInfo;
    }

    public FaultBean getFaultInfo() {
        return faultInfo;
    }

}

Interface et implémentation du service

Maintenant que les éléments nécessaires à la création du service (Objets métier et exception) existent, nous allons pouvoir créer le service lui même, ou du moins son prototype.

Interface IWebHelpDesk

Nous allons créer une interface avec deux méthodes :

getQuestionWithId prend une String et retourne une Question.
createQuestion qui prend un objet Question en entrée et qui retourne un numéro de question

Créons notre interface. Dans Eclipse, à partir de la barre de menu : File -> New -> Interface.

Dans la dialogue New Java Class :

Pour Package, tapez : fr.j2ltho.webcontracthelpdesk.server
Pour Name tapez : IWebHelpDesk

Laissez les autres options par défaut et appuyez sur Finish. Il faut maintenant compléter le code. Il s’agit de d’ajouter les deux méthodes. On utilisera l’exception créée précédemment pour renvoyer un éventuel message en cas de problème.

On obtient le code suivant :

package fr.j2ltho.webcontracthelpdesk.server;

public interface IWebHelpDesk {
public Question getQuestionWithId(String pNumero) throws BusinessFaultException;
public String createQuestion(Question pNewQuestion) throws BusinessFaultException;
}

Bean Service HelpdeskServiceBean

Le nom de la classe Java implémentant l’interface doit correspondre à celle définie dans le web.xml pour la servlet. Dans notre cas, ce sera impérativement HelpdeskServiceBean.

Créons notre classe. Dans Eclipse, à partir de la barre de menu : File -> New –> Class.

Dans la dialogue New Java Class :

Pour Package, tapez : fr.j2ltho.webcontracthelpdesk.server
Pour Name tapez : HelpdeskServiceBean
Appuyez sur le bouton Add pour l’interface et choisir IWebHelpDesk - fr.j2ltho.webcontracthelpdesk.server

Laissez les autres options par défaut et appuyez sur Finish. Il faut maintenant compléter le code. Nous allons montrer l’utilisation d’une exception Web service sur les deux méthodes :

createQuestion retourne une exception si Question est nulle
getQuestionWithId retourne une exception si le numéro est nulle.

On obtient le code suivant :

package fr.j2ltho.webcontracthelpdesk.server;

public class HelpdeskServiceBean implements IWebHelpDesk {

}

On voit que l’utilisation d’une exception dans le cadre d’un service web est un peu plus compliqué qu’en Java traditionnel si on souhaite que le client puisse correctement récupérer les informations : dans un premier temps on crée notre FaultBean avec les informations transmises au client. Puis on crée l’exception avec ce FaultBean en paramètre.

Conclusion

Nous avons vu dans ce billet, le mécanisme de création d’une exception pour un service web.

Nous avons créé tous les objets Java qui vont être nécessaires à la définition de notre WSDL. Mais, comme vous avez pu le constater, ces objets sont vides : on ne peut pas dire que nous ayons codé. Nous sommes rester concentrer sur la définition du service.

Dans l’étape suivante : http://jl2tho.blogspot.com/2011/12/etape-4-annotations-jax-ws-et-jaxb-des.html, nous allons annoter nos objets Java afin que le WSDL correspondent à notre besoin.

Etapes : 1 | 2 | 3 | 4 | 5 – Suivant >

Etape 2 du Tutorial : Configuration d’un projet JAX-WS

2011-11-29T23:25:00.001+02:00

Il s’agit du second billet d’un tutorial sur l’approche Contract First avec JAX-WS.

Il suit le premier billet : http://jl2tho.blogspot.com/2011/11/tutorial-approche-contract-first-avec.html qui présentait le tutorial et expliquait son approche.

Dans cette étape nous allons définir la configuration du projet et créer le projet Eclipse.

La configuration d’un projet Eclipse pour un service web est relativement simple. il faut :

définir le service web dans le web.xml
ajouter les jars nécessaire à la compilation des annotations comme “externals jars”.

Nous allons créer un projet Eclipse JaxWsContractFirst.

Le nom du service web sera : WebContractHelpdesk et le bean qui l’implémentera sera : fr.j2ltho.webcontracthelpdesk.server.HelpdeskServiceBean .

Configuration

Pour plus de simplicité, je définis précisément mon environnement de travail, cela facilitera votre tâche si vous êtes dans la même configuration

Le développement a eu lieu sur un poste Windows 7 sous 64 bits. Cela aura un impact sur les noms des répertoires mais cela est très limité.
Le runtime et le jdk Java sont à la version 1.5.0_11.
Nous allons utiliser Eclipse : 3.5.2. Nous utilisons la distribution pour le développement JEE qui inclut le projet WTP. Ce projet permet la création d’un projet “Web Dynamic” que nous allons utiliser.

Le serveur d’application utilisé sera JBoss 5.1. Il est installé sous C:\jboss-5.1.0.GA conformément au tutorial suivant : http://jl2tho.blogspot.com/2010/03/installation-de-jboss-51-sur-windows-7.html. Attention ! Je rappelle qu’une installation sous “Program files” ou tous répertoires contenant des espaces peut être source d’ennuis.

A partir du moment ou vous utilisez une version de Java supérieure ou égale à la 1.5 et un serveur d’application implémentant JAX-WS 2.0, ce tutorial devrait également fonctionner : il vous faudra néanmoins adapter à votre environnement certaine partie comme notamment la liste des externals jars.

Des éléments de configuration, c’est le serveur JBoss qui nécessite le plus grand effort d’adaptation pour suivre ce tutorial : j’utilise son utilitaire wsconsume pour générer le client, les Externals Jars nécessaires ont des noms et emplacements spécifiques à chaque serveur d’application et version, pour finir le déploiement et l’URL du WSDL dépendent également du serveur d’application.

Je vous encourage donc à utiliser JBoss 5.1 pour suivre ce tutorial.

Création du projet Eclipse

Nous allons créer un projet de type “Dynamic Web Project”. Il s’agit d’un type de projet Eclipse qui permet la création de WAR. Il crée l’organisation du projet permettant de disposer d’un répertoire WEB-INF et il crée un fichier web.xml.

Ceux qui ont suivi mes tutoriaux sous JBoss 4.2 ou 5.1, ont créé des projets Java simples car pour un Service Web très simple, nous n’avons pas besoin de ressources extérieures. Pour des projets plus proches de la réalité, il vous faudra accéder à d’autre ressources, configurer le fonctionnement de l’application… Tout cela nécessite un déploiement plus complexe qui est mieux géré à travers un WAR.

Dans Eclipse, on crée un projet de type “Dynamic Web Project” que l’on nommera JaxWsContractFirst. Ces projets permettent la création d’un WAR.

Dans Eclipse, à partir de la barre de menu : File -> New –> Other.
Dans la dialogue New, choisir le dossier “Web” puis le nœud “Dynamic Web Project”. Appuyez sur le bouton Next.
Pour Project name, tapez : JaxWsContractFirst et laissez les autres options par défaut (Dans mon cas cela veut dire que j’utilise un runtime Tomcat 6.0 et un Java 1.5).
Appuyez sur Finish. Acceptez le choix de la perspective si la dialogue « Open Associated Perspective » s’affiche.

Fichier web.xml et définition du service web

Dans le répertoire WebContent –> WEB-INF de votre projet, se trouve le fichier web.xml : il s’agit d’une caractéristique d’un “Dynamic Web project”.

En Java 1.5, le service web est un servlet. Nous allons ajouter la déclaration du servlet qui correspondra à notre service web : WebContractHelpdesk.

Editer ce fichier web.xml.

On ajoute la déclaration de la servlet qui correspondra au service web.

servlet-name correspond au serviceName de l’annotation WebService du bean implémentant le service web. C’est ce nom qui sera utilisé pour accéder au WSDL. Dans notre cas, ce sera WebContractHelpdesk.
servlet-class correspond au nom complet du bean qui implémente le service web : fr.j2ltho.webcontracthelpdesk.server.HelpdeskServiceBean

On obtient le code suivant :

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
<display-name>JaxWsContractFirst</display-name>
<servlet>
<servlet-name>WebContractHelpdesk</servlet-name>
<servlet-class>fr.j2ltho.webcontracthelpdesk.server.HelpdeskServiceBean</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>WebContractHelpdesk</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>

<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
</web-app>

Ajout des External Jars

Il s’agit de la partie qui dépend le plus du serveur d’application.

Nous allons ajouté les jars nécessaires à la compilation des annotations JAX-WS et JAXB. Nous avons besoin de ces jars uniquement pour la compilation. A l’exécution, nous utiliserons celles du serveur d’application. Nous ne voulons donc pas que lors de la construction du WAR, les jars soient inclus dans le WAR. Pour cela, il faut les définir comme “external Jars” dans le projet Eclipse.

Il faut importer des jar JBoss : cliquez droit sur le projet dans l’explorateur et choisissez Properties. Dans la dialogue qui s’ouvre choisir « Java Build Path ».

Appuyer sur « Add External Jars.. », et utiliser l’explorateur pour aller dans le répertoire C:\jboss-5.1.0.GA\common\lib et sélectionnez les jar suivant :

Jboss-javaee.jar qui définit les annotations @Stateless et @Remote
Jbossws-native-jaxws.jar qui définit les annotations @WebService, @SOAPBinding et @SOAPBinding

Validez en appuyant sur Ok et appuyez de nouveau sur « Add External Jars.. », et utiliser l’explorateur pour aller dans le répertoire C:\jboss-5.1.0.GA\lib\endorsed et sélectionnez le jar suivant :

jaxb-api.jar qui définit les annotations @XmlElement

Validez en appuyant sur Ok.

Je disais, en entrée que cette partie dépend du serveur d’application. Il peut être particulièrement délicat, de trouver les bon jars et leur emplacement.

Par exemple pour WebSphere 6.1, il faut les jars :

com.ibm.jaxws.thinclient_6.1.0.jar dans C:\IBM\Websphere\AppServer\runtimes\
j2ee.jar dans C:\IBM\Websphere\AppServer\lib\

On voit que le nom, l’emplacement et leur nombre n’ont rien à voir.

Conclusion

Nous avons créer un projet Eclipse JaxWsContractFirst.

Nous avons modifié sa configuration afin que le nom du service web soit : WebContractHelpdesk et le bean qui l’implémentera sera : fr.j2ltho.webcontracthelpdesk.server.HelpdeskServiceBean.

L’étape suivante va consister à créer les objets java nécessaires à la définition du service (dont le bean fr.j2ltho.webcontracthelpdesk.server.HelpdeskServiceBean).

Comme indiqué en première partie, nous nous limiterons aux prototypes de ces classes dans cette étape.

Etapes : 1 | 2 | 3 | 4 | 5 – Suivant >

Tutorial Approche Contract First avec JAX-WS

2011-11-29T18:19:00.001+02:00

Voilà plus de 4 ans (avril 2007), j’ai fait un long tutoriel sur l’approche Contract First avec Axis2 : http://jl2tho.blogspot.com/2007/04/tutorial-services-web-avec-axis2.html.

Peu après, je découvrais la norme JAX-WS pour les Services Web et réalisais un tutorial pour créer un service web pour JBoss 4.2 en utilisant JAX-WS : http://jl2tho.blogspot.com/2007/05/tutorial-service-web-avec-jbosss-42.html. On était toujours en 2007.

Plus récemment, j’ai actualisé ce dernier tutorial pour une utilisation avec JBoss 5.1 http://jl2tho.blogspot.com/2011/11/tutorial-service-web-avec-jbosss-51.html puis WebSphere 6.1 : http://jl2tho.blogspot.com/2011/11/ce-tutorial-adapte-pour-ibm-websphere-6.html. Mais ces tutoriaux JAX-WS, ne montre qu’un cas d’utilisation très simple.

Aujourd’hui, avec ce nouveau tutorial, je souhaite montrer toute la puissance de l’approche JAX-WS sur un exemple plus complet, proche de celui de mon tutoriel sur Axis2.

Avant d’aller plus loin, je vais vous présenter les étapes de ce tutorial :

Etape 1 : Approche Contract first (ce bilet)
- Approche Contract First
- JAX-WS
- La synthèse
- Le projet
Etape 2 : Configuration du projet
- Création du projet Eclipse
- web.xml
Etape 3 : Le métier
- Objet Question
- FaultBean et exception
- Interface
- Implémentation
Etape 4 : Annotation
- JAX-WS : interface et implémentation
- JAXB pour décrire l’objet question
Etape 5 : déploiement et WSDL
- WSDL
- Type simple plus compliqué
- inclure son propre WSDL
Etape 6 : Injection Spring pour le métier
- Ajout des jar Spring
- Surcharge du bean pour activation de l’autowired

Chaque étape fera l’objet d’un billet. L’objectif de ce tutorial est de faire le tour d’un exemple suffisamment complexe pour être un cas significatif de la problématique qui sera rencontrée dans le cadre d’un véritable développement.

Si vous êtes débutant sur JAX-WS, je vous encourage à suivre au préalable mon tutorial d’introduction à JAX-WS avec JBoss 5.1 : http://jl2tho.blogspot.com/2011/11/tutorial-service-web-avec-jbosss-51.html. Ce tutorial présente les concepts et mécanismes de base sur lesquels je vais m’appuyer sans pour autant les reprendre de manière détaillée dans ce tutorial.

Dans la suite de ce billet, je développe les raisons de mon choix et de mon approche.

Approche Contract First : Avantages et inconvénients

Dans l’absolu, l’approche Contract First consiste à définir le contrat qui va lier le consommateur du service web avec son fournisseur. Dans la norme Web Service, ce contrat est le WSDL. Il s’agit d’un fichier XML qui décrit le format des messages XML qui seront échangés entre le client et le service.

Sa structure est normée mais sa lecture et compréhension sont peu aisées ou du moins fastidieuses. Dans mon tutorial Axis2 http://jl2tho.blogspot.com/2007/04/tutorial-services-web-avec-axis2.html, je présente un outil permettant d’écrire ce fichier WSDL

Pour moi, cette approche Contract First est intéressante car elle permet de dégager le contrat des implémentations technologiques du service : les types simples ne dépendent pas du langage choisi, on augmente ses chances que le service que l’on va produire puisse être réutilisé par des clients dans des technologies différentes.

En revanche, la solution retenue est longue et fastidieuse : il faut définir des messages ainsi que tous les champs constitutifs un à un.

D’autre part, la solution Axis2 utilisée, n’offrait pas à l’époque, un modèle de développement très efficace : mon code d’appel du service sans passer par la couche Service Web diffère trop (à mon gout) de l’appel du même service en direct. Cela me dérange, car je pense aux cas de tests jUnit que je pourrais plus facilement réutiliser avec une approche dans laquelle les deux interfaces seraient plus proches.

JAX-WS

Très rapidement après cette première expérience Axis2, j’ai découvert JAX-WS. Il s’agit d’un élément de la norme des EJB 3.0 sur laquelle elle s’appuie.

Ce qui m’a plu dans l’approche JAX-WS est son efficacité au niveau du développement : on ne multiplie pas les fichiers de configuration grâce aux annotations. Mais surtout, on ne manipule plus la structure des fichiers XML (les messages) que l’on soit sur le client ou le serveur.

La vision du développement du service ou du client utilisateur du service est celle d’un simple appel d’une méthode possédant des paramètres : on ne peut faire plus simple.

Les différents tutoriaux que j’ai réalisé sur cette approche, montre bien cette simplicité :

JBoss 4.2 : http://jl2tho.blogspot.com/2007/05/tutorial-service-web-avec-jbosss-42.html
JBoss 5.1 http://jl2tho.blogspot.com/2011/11/tutorial-service-web-avec-jbosss-51.html
WebSphere 6.1 : http://jl2tho.blogspot.com/2011/11/ce-tutorial-adapte-pour-ibm-websphere-6.html.

Ils montrent également la puissance de la norme, car au delà des différences de configuration de l’environnement de développement et du déploiement, le développement est identique. Si on retient l’approche WAR utilisée pour WebSphere, le même binaire (WAR) peut être déployé sur les différents serveurs d’application sans modification.

Dès 2007, nous avons opté pour l’approche JAX-WS au niveau de tous nos développements en remplacement de la solution Axis (version 1) que nous utilisions jusqu’à présent. Cela montre l’intérêt que j’ai eu pour cette approche.

JAX-WS et l’approche Contract First

Je vais certainement choquer quelques extrémistes, mais je souhaitais concilier les deux approches : utiliser les annotations JAX-WS pour définir mon contrat : le fichier WSDL.

JAX-WS fonctionnant par annotation d’une classe Java représentant de fait du code, il peut paraitre contradictoire de parler d’approche Contract First : j’écris du code Java avant le WSDL.

Néanmoins, en premier lieu, je me limite à la déclaration de mon interface et une implémentation vide : je n’ai que des prototypes de classe : parler de code est un peu excessif à ce niveau. De plus, je décris en Java le service que je veux offrir plus que son implémentation qui reste vide à cette étape.

Je vais ensuite annoter ces classes et interfaces par itération jusqu’à obtenir le WSDL qui me convient. Ce n’est qu’ensuite que je commence à coder l’implémentation du métier.

De mon point de vu, au lieu d’utiliser un outil graphique comme celui que j’ai utilisé avec Axis2, pour définir le WSDL, j’utilise le langage Java et les annotations JAX-WS. Je considère cette approche doublement plus efficace :

elle est plus naturelle : on commence par décrire le prototype d’un service.
j’ai eu l’impression d’avoir une plus grande maitrise du WSDL produit avec les annotations JAX-WS qu’avec l’outil graphique

Cela ne fonctionne que parce que JAX-WS produit un WSDL technologiquement neutre : les types simples ne sont pas Java. Je n’ai pas eu à faire des efforts démesurés pour utiliser des types basics.

Un dernier avantage et un petit inconvénient (les deux sont liés) :

Il est possible d’avoir une démarche agile avec cette approche : je peux travailler sur le WSDL en adaptant les annotations tout en avançant sur l’implémentation du service à chaque run.
On peut avoir tendance à passer aux développements trop rapidement (avant d’avoir fini la partie WSDL) et/ou à réutiliser des objets provenant du développement dans les prototypes des méthodes de service. Cela peut être problématique car l’objet peut avoir une complexité ou une structure inadaptée au service souhaité.

Projet du tutorial

Notre mini projet consistera à rendre disponible un service de consultation des Questions soumise à un Helpdesk (on reprend la thématique du projet Axis2).

Nous allons créer 3 services qui manipulent un objet Question en paramètre :

rechercher une question à partir de son ID (validation d’un format en entrée 9 caractères numériques)
créer une question : retourne un ID de question (objet complexe en entrée, un format date, une énumération, un entier compris en 0 et 4 pour l’urgence)
récupérer une liste de questions avec une énumération en entrée (liste d’objets en sortie et énumération)

J’ai recherché à tester les aspects suivants :

Manipulation d’objets métier structurés
Typage fort des données : au delà du simple type (entier, string…) spécifier la taille limite, des plages de valeurs…
Manipulation de liste d’objets structurés

Il s’agit des mêmes objectifs que ceux que j’avais adopté lors de mon tutoriel Axis 2 : Approche Contract First.

Afin de rester dans une approche Contract First malgré l’utilisation de JAX-WS, l’implémentation réelle des services ne sera abordé qu’en dernier lieu avec l’injection de bean Spring.

Toutes les étapes préliminaires vont servir à définir le plus précisément le WSDL du service en utilisant :

les annotations JAX-WS
les annotations JAXB : il s’agit d’une norme sœur de JAX-WS permettant de décrire comment un objet Java est transformé en XML.
l’utilisation d’une exception particulière afin de définir précisément les messages d’erreur retournés par le service
la surcharge du WSDL produit afin de compléter les déclarations de type

Ce n’est qu’une fois le WSDL validé que l’on se penchera sur la récupération des ressources configurées (DAO, Factory Hibernate…) nécessaires à l’implémentation du service. C’est à ce moment que Spring sera introduit.

J’ai fini de présenter les objectifs de ce tutorial, nous allons passer dans le billet suivant dans le vif du sujet : la configuration du projet (étape 2 du tutorial).

Etapes : 1 | 2 | 3 | 4 | 5 – Suivant >

Tutorial Service Web avec WebSphere 6.1

2011-11-21T12:44:00.001+02:00

Ce tutorial adapte pour IBM WebSphere 6.1, mon tutorial sur la création de Service Web avec JBoss 5.1 qui peut être trouvé à l’adresse suivante : http://jl2tho.blogspot.com/2011/11/tutorial-service-web-avec-jbosss-51.html.

Il s’agit d’un tutorial qui présente la création d’un Service Web très simple en utilisant le mécanisme d’annotation JAX-WS avec comme serveur d’application WebSphere 6.1.

J’ai cherché dans ce tutorial à me débarrasser de l’outillage IBM qui semble ajouter de nombreux fichiers de configuration spécifiques à WebSphere. L’ensemble du tutorial (en dehors du serveur d’application) est indépendant de l’outillage IBM.

Une rapide présentation des Services Web avec WebSphere 6.1

Tout d’abord, il faut savoir que la version standard de WebSphere 6.1 ne permet pas la réalisation de Service Web reposant sur la norme JAX-WS. Pour bénéficier du support de la norme, il faut ajouter deux Feature Packs (Service Web et EJB 3.0) ainsi que 3 Fix Packs.

Le même WAR que j’avais déployé sur la version 6.1.0 qui ne fonctionnait pas, fonctionne parfaitement une fois toutes ces installations réalisées.

WebSphere s’appuie sur les EJB 3.0 pour définir et implémenter les Services Web. Il respecte les spécifications de JAX-WS pour la définition des services web. Cette norme définit un ensemble d’annotations qui permettent la transformation d’un EJB 3.0 en service web. Les annotations sont interprétées par le serveur d’application afin de transformer les classes Java en service web.

La définition des différentes annotations peut être trouvée sur le site de Sun à l’adresse suivante : http://java.sun.com/javaee/5/docs/api/javax/jws/package-summary.html

Les annotations simplifient grandement la réalisation de services web. Elles permettent de définir :

toutes les informations pertinentes pour construire un WSDL à partir de la classe Java
les correspondances entre les messages SOAP du service web et la méthode de la classe Java responsable du traitement.

Par exemple, il est possible de définir le nom du service web, des opérations et des paramètres.

Les services web nécessite la présence d’un serveur d’application capable d’être serveur de service web : dans notre tutorial nous allons utiliser WebSphere dans sa version 6.1.

Organisation du tutorial

Ce tutorial a pour objectif de présenter une mise en œuvre basique d’un Service Web avec WebSphere 6.1.

Le tutorial comprendra les étapes suivantes :

La configuration du serveur WebSphere
La réalisation du service web dans Eclipse
Le déploiement du service web dans WebSphere.
L’analyse du code et du WSDL

Configuration

Configuration de Websphere 6.1

Le tutorial a été réalisé sur un poste Windows 7.

Ce tutorial repose sur l’utilisation d’Eclipse 3.5 et sa distribution JEE. Le runtime JDK utilisé par Eclipse est la version 1.5.0_11.

Le serveur d’application utilisée est une version d’essai de IBM WebSphere 6.1 : il s’agit d’une version 32 bits pour Windows que j’ai installé dans C:\IBM afin d’éviter tout problème de droits lié à Windows 7. Pour que l’installation fonctionne sur mon poste, j’ai du utiliser le fichier responsefile.base.txt et faire une installation en mode commande.

Je ne rentrerai pas dans le détail de cette installation, ce n’est pas l’objet de ce billet. De même, je ne rentrerai pas dans le détail des installations nécessaires pour les services web : j’ai suivi, l’excellent tutorial (en anglais) qui se trouve à l’adresse suivante : http://www.myeclipseide.com/documentation/quickstarts/blueedition/blue_install_websphere6.1/

Je précise que j’ai du récupérer :

l’UpdateInstaller de Webphere 6.1.9 : download.updii.61019.windows.ia32.zip : Cet utilitaire est nécessaire à l’installation des Fix Pack. Je l’ai installé dans C:\IBM\WebSphere.
les 3 Fix Packs suivants :
- 6.1.0-WS-WAS-WinX32-FP0000013.pak
- 6.1.0.9-WS-WASWebSvc-IFPK53084.pak
- 6.1.0-WS-WASWebSvc-WinX32-FP0000013.pak
les 2 feature Packs suivants :
- 6.1.0-WS-WAS-WSFEP-WinX32.zip : pour les Services Web
- fep.61.ejb3.windows.ia32.zip : pour les EJB 3.0

Tous les fichiers ont été récupéré depuis le site IBM : il s’agit d’autant de téléchargements supplémentaires. J’ai utilisé l’utilitaire DownLoad Director d’IBM pour tous à l’exception du Fix Pack 6.1.0.9-WS-WASWebSvc-IFPK53084.pak pour lequel le serveur a répondu pendant toute une journée qu’il était occupé. Pour ce dernier, j’ai utilisé le téléchargement par HTTP.

Attention ! utilisant Windows 7 qui n’est pas officiellement supporté par WebSphere 6.1, j’ai du à plusieurs reprises acquitter un message m’indiquant que je n’avais pas passé le test de compatibilité. Il a toujours été possible de Continuer l’installation.

De même à chaque fin d’installation, on m’a averti que l’installation s’était peut-être mal passée, j’ai du répondre que je considérais que l’installation était correcte

En dehors de ces petits avertissements, j’ai respecté à la lettre la procédure d’installation indiquée plus haut qui se décompose comme suit :

J’ai arrêté mon serveur WebSphere : je suis passé par le menu “Tous les programmes” –> “IBM Websphere” –> “Application Server V6.1” –> Profils –> AppSrv01 –> “Arrêter le serveur”.
J’ai installé l’UpdateInstaller.
J’ai copié le fichier 6.1.0-WS-WAS-WinX32-FP0000013.pak dans C:\IBM\WebSphere\updateInstaller\maintenance
J’ai lancé son installation par l’updateInstaller en cliquant droit sur le menu “Tous les programmes” –> “IBM Websphere” –> “Update Installer for Websphere V6.1 Software –> Update Installer” et choisissant “Executer en tant qu’administrateur”
J’ai installé (sans passer par l’update installer) le Feature Pack 6.1.0-WS-WAS-WSFEP-WinX32.zip après l’avoir dézippé.
J’ai copié les fichiers 6.1.0.9-WS-WASWebSvc-IFPK53084.pak et 6.1.0-WS-WASWebSvc-WinX32-FP0000013.pak dans C:\IBM\WebSphere\updateInstaller\maintenance
J’ai lancé l’installation de 6.1.0.9-WS-WASWebSvc-IFPK53084.pak par l’updateInstaller (toujours en tant qu’administrateur)
J’ai lancé l’installation de 6.1.0-WS-WASWebSvc-WinX32-FP0000013.pak par l’updateInstaller (toujours en tant qu’administrateur)
J’ai installé (sans passer par l’update installer) le Feature Pack fep.61.ejb3.windows.ia32.zip après l’avoir dézippé.
J’ai fait l’augmentation du Profil AppSrv01 en lui ajoutant le profil EJB 3.0

Je n’ai pas eu besoin de récréé un Profil avec le profil Service Web JAX-WS.

Cette phase de configuration peut bien prendre un ou deux jours. Il s’agit réellement d’une opération fastidieuse.

Création d’un projet Eclipse pour le service web

Autant avec JBoss, j’avais pu me contenter de créer un jar (voir mon tutorial http://jl2tho.blogspot.com/2011/11/tutorial-service-web-avec-jbosss-51.html), avec WebSphere 6.1, j’ai été obligé de passer par un WAR.

Dans Eclipse, on crée un projet de type “Dynamic Web Project” que l’on nommera MaCalculetteWasSwWar. Ces projets permettent la création d’un WAR.

Dans Eclipse, à partir de la barre de menu : File -> New –> Other.

Dans la dialogue New, choisir le dossier “Web” puis le nœud “Dynamic Web Project”. Appuyez sur le bouton Next.

Pour Project name, tapez : MaCalculetteWasSwWar et laissez les autres options par défaut (je rappelle que WebSphere 6.1 utilise un Runtime Java 1.5, il faudra donc éviter d’utiliser un Runtime 1.6).

Appuyez sur Finish. Acceptez le choix de la perspective si la dialogue « Open Associated Perspective » s’affiche.

Ajout des External Jars

Nous allons ajouter des external jars au projet : ces jars ne sont pas déployé dans le war. Ils sont juste nécessaire pour la phase de compilation. Il s’agit de jar qui font parti du serveur d’application.

Il faut importer des jar WebSphere : cliquez droit sur le projet dans l’explorateur et choisissez Properties. Dans la dialogue qui s’ouvre choisir « Java Build Path ».

Appuyer sur « Add External Jars.. », et utiliser l’explorateur pour aller dans le répertoire C:\IBM\WebSphere\AppServer\lib et sélectionnez le jar suivant :

j2ee.jar qui définit l’annotation @Remote

Validez en appuyant sur Ouvrir.

Appuyer sur « Add External Jars.. », et utiliser l’explorateur pour aller dans le répertoire C:\IBM\WebSphere\AppServer\runtimes et sélectionnez le jar suivant :

com.ibm.jaxws.thinclient_6.1.0.jar qui définit les annotations @WebService, @SOAPBinding et @SOAPBinding

Validez en appuyant sur Ouvrir.

Validez en appuyant sur le bouton OK.

Notre poste est maintenant correctement configuré pour construire un Service Web.

Création de l’interface

Nous commençons par créer l’interface du service. L’interface définit les méthodes qui seront disponibles dans l’EJB et le service web.

Nous allons créer l’interface fr.j2ltho.calculette.was.Calculette. Par rapport à la définition d’un EJB, il faut ajouter deux autres informations au niveau de la classe :

Le nom du service web qui sera dans notre cas ICalculetteSw
Le format et le style des messages échangés entre le client et le serveur. En d’autre terme, on choisit entre RPC/encoded et Document/literal, tout comme on choisit pour un Document/Literal s’il est wrapped ou unwrapped. Le format le plus répandu et portable étant Document/Literal/Wrapped c’est ce dernier que l’on retiendra.

Ensuite pour chaque méthode, il faut indiquer qu’elle est accessible comme opération du service web, il est possible de définir son nom pour le service web, le nom du paramètre de sortie et le nom des paramètres dans le fichier WSDL (ce point est important car par défaut, leur nom est arg0, arg1…).

Création de l’interface

Dans Eclipse, à partir de la barre de menu : File -> New -> Interface.

Dans la dialogue New Java Interface:

Pour Package, tapez : fr.j2ltho.calculette.was
Pour Name tapez : Calculette

Laissez les autres options par défaut et appuyez sur Finish.

On modifie le code pour définir les deux méthodes add et substract du service.

On ajoute l’annotation @Remote pour spécifier au conteneur d’EJB qu’il devra créé un lien de type Remote avec cette interface pour l’EJB.

Ajout des annotations Service Web

On ajoute l’annotation @WebService qui déclare la classe comme un service web. Le paramètre name, permet de définir un nom différent de celui de la classe. C’est le nom du portType du WSDL. Ce sera le nom également de la classe d’interface cliente si on utilise l’outil JBoss wsconsume pour créer les classes clientes à partir du WSDL.

On ajoute ensuite l’annotation @SOAPBinding qui permet de définir le format des messages :

Le paramètre style permet de choisir entre DOCUMENT et RPC,
le paramètre use permet de choisir entre LITERAL et ENCODED
le paramètre parameterStyle entre WRAPPED ou BARE (unwrapped).

Il faut ensuite pour chaque méthode ajouter le tag @WebMethod pour indiquer qu’il s’agira d’une opération du service web. Le paramètre operationName permet de définir un nom dans le WSDL différent de celui de la méthode Java. Il est également possible grâce au tag @WebResult de définir le nom du paramètre de sortie de la méthode tel qu’il apparait dans le WSDL.

Pour chaque paramètre, il est possible de définir grâce au tag @WebParam son nom (par défaut ce sera arg0, arg…) mais également grâce à la propriété mode si un paramètre est IN, OUT ou IN/OUT.

On obtient le code suivant (en gras le code ajouté par rapport à l’EJB):

package fr.j2ltho.calculette.was;

@Remote
@WebService(name = "ICalculetteSw")
@SOAPBinding(style=Style.DOCUMENT, use=SOAPBinding.Use.LITERAL, parameterStyle= SOAPBinding.ParameterStyle.WRAPPED)
public interface Calculette {

    @WebMethod(operationName="ajouterWithWAS")
    @WebResult(name = "resultat")
    public int add(int x, int y);

    @WebMethod
    public int subtract(
    @WebParam(name = "x")
    int x,
    @WebParam(name = "y")
    int y);

}

Création du Bean

Pour la classe qui implémente le service web défini par l’interface précédente, il est possible d’utiliser l’implémentation de l’EJB : Il suffira d’y ajouter l’annotation @Webservice en indiquant la propriété endpointInterface : cette propriété doit pointer vers l’interface du service. C’est grâce aux informations contenue dans l’interface que le conteneur saura quel WSDL généré.

Nous commençons par créer la classe qui implémente le service.

Dans Eclipse, à partir de la barre de menu : File -> New -> Class.

Dans la dialogue New Java Class :

Pour Package, tapez : fr.j2ltho.calculette.was
Pour Name tapez : CalculetteBean

Appuyez, sur le bouton Add.. afin de définir l’interface. Dans la dialogue « Implemented Interfaces Selection » tapez Calculette puis sélectionnez l’interface Calculette – fr.j2ltho.calculette.was de votre projet. Validez en appuyant sur Ok. La dialogue se referme et l’interface apparait dans la liste Interfaces de la dialogue « New java Class ».

Laissez les autres options par défaut et appuyez sur Finish. Le code de la classe apparait avec les deux méthodes créées, il faut maintenant compléter le code.

Il faut également ajouter :

l’annotation @Stateless en début de classe. Cette annotation précise que cet EJB sera sans état : il ne conserve pas une mémoire de ce qu’il a fait précédemment.
l’annotation @WebService pour indiquer la classe d’interface qui contient les annotations décrivant le service web. Il permet également de définir le nom du service web tel qu’il apparait dans le WSDL.

On obtient le code suivant :

package fr.j2ltho.calculette.was;

import javax.ejb.Stateless;
import javax.jws.WebService;

@Stateless
@WebService(endpointInterface="fr.j2ltho.calculette.was.Calculette", serviceName="CalculetteWasSw")
public class CalculetteBean implements Calculette {

    public int add(int x, int y) {
        return x + y ;
        }

    public int subtract(int x, int y) {
        return x - y;
        }

}

Assurez vous d’avoir bien sauvegarder la classe et son interface.

Déploiement du service web sur Websphere 6.1

Nous avons du créer un Dynamic Web Project afin de pouvoir créer simplement un WAR pour déployer le Service Web dans Websphere.

Avant de créer le war puis de le déployer, nous allons finir la configuration du projet en modifiant le fichier web.xml afin d’y déclarer notre service web.

Déclarer un service web dans le web.xml

Dans le répertoire WebContent –> WEB-INF de votre projet, se trouve le fichier web.xml. Editer ce fichier.

On ajoute la déclaration de la servlet qui correspondra au service web.

servlet-name correspond au serviceName de l’annotation WebService du bean CalculetteBean. C’est ce nom qui sera utilisé pour accéder au WSDL
servlet-class correspond au nom complet du bean qui implémente le service web.

On obtient le code suivant :

?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
<display-name>MaCalculetteWasSwWar</display-name>
    <servlet>
        <servlet-name>CalculetteWasSw</servlet-name>
        <servlet-class>fr.j2ltho.calculette.was.CalculetteBean</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>CalculetteWasSw</servlet-name>
        <url-pattern>/*</url-pattern>
    </servlet-mapping>
<welcome-file-list>
    <welcome-file>index.html</welcome-file>
    <welcome-file>index.htm</welcome-file>
    <welcome-file>index.jsp</welcome-file>
    <welcome-file>default.html</welcome-file>
    <welcome-file>default.htm</welcome-file>
    <welcome-file>default.jsp</welcome-file>
</welcome-file-list>
</web-app>

Génération du War

Assurez vous d’avoir bien sauvegarder l’ensemble des fichiers.

Cliquez droit dans l’explorateur de ressource d’Eclipse sur votre projet MaCalculetteWasSwWar, sélectionnez Export –> WAR File, dans la dialogue « Export » qui s’affiche choisissez :

Web Project : MaCalculetteWasSwWar qui est le nom de votre projet
Destination : Naviguez pour sélectionner l’emplacement et le nom du WAR File. Pour ma part je l’ai créé sur le bureau. Le nom du fichier est MaCalculetteWasSwWar.war.
Décochez l’option “Optimize for a specific server runtime”

Le nom du war n’a aucune importance, il n’est pas utilisé pour obtenir le WSDL et n’a aucun d’impact sur le contenu du WSDL.

Appuyez, ensuite sur Finish. Vous devriez trouver un fichier MaCalculetteWasSwWar.war sur le bureau.

Déploiement sous WebSphere 6.1

Le serveur doit être lancé, soit il est lancé automatiquement au démarrage (en tant que service Windows), soit il peut être démarré par le menu : “Tous les programmes” –> “IBM Websphere” –> “Application Server V6.1” –> Profils –> AppSrv01 –> “Démarrer le serveur”.

On se connecte à la console d’administration : https://localhost:9043/ibm/console/logon.jsp

Sélectionnez sous le nœud Applications le lien “Installation d’une nouvelle application”

Dans Système de fichiers local, sélectionnez MaCalculetteWasSwWar.war et saisir pour :

Racine du contexte : MaCalculetteWasSwWar : j’ai repris le nom du projet Eclipse qui est également le display name du web.xml. Cela sera utile pour récupérer le WSDL.

En théorie, cet écran permet le déploiement direct d’un JAR. Cette option ne fonctionne que suite à l’installation de la série de Feature et Fix Packs. Sans ces packs, il n’est pas possible d’installer simplement un jar dans WebSphere 6.1. Néanmoins dans mon cas, si le JAR semble avoir été correctement déployé, je n’ai pas pu accéder au WSDL. L’application WebSphere résultant du déploiement n’avait pas les mêmes options que celle contenant un Service Web correctement déployé. C’est pour cette raison que nous sommes passé dans ce tutorial par un WAR.

Appuyez sur Suivant.

Sur l’écran “sélection des options d’installation”, on choisit :

On coche : “Déploiement de beans entreprise”
Nom de l’application : on laisse le nom par défaut en : MaCalculetteWasSwWar_war
On coche “Déploiement de services Web”

On appuie sur Suivant, sur l’écran “Mapper les modules vers les serveurs”, je laisse les options par défaut :

On appuie sur Suivant puis Terminer. L’écran Installation en cours s’affiche. On obtient après un délai, la page suivante :

On appuie sur le lien Sauvegarder qui se trouve en bas de la page.

Si on clique ensuite sur “Applications d’entreprise”, on doit voir une ligne MaCalculetteWasSwWar_war qui s’affiche : il s’agit du nom par défaut laissé à l’étape “Sélection des options d’installation”

Il faut démarrer l’application : cochez la case en début de ligne puis appuyez sur le bouton Démarrer. Après un lapse de temps, une flèche verte s’affiche en fin de ligne.

Vérifier le déploiement

Dans “Applications d’entreprise”, il est possible de cliquer sur le lien MaCalculetteWasSwWar_war. Cela affiche la page de configuration de l’application.

Pour un application contenant un service web fonctionnant correctement, vous pouvez appuyer sur le lien “Publication des fichiers WSDL” dans la rubrique “Propriétés des services Web”.

Sur la nouvelle page, vous devriez avoir une ligne indiquant un fichier zip contenant le WSDL de votre service web.

Si vous obtenez le même résultat, cela indique que votre service web est correctement déployé.

Analyse du WSDL

Dans cette dernière partie nous allons récupérer le WSDL non pas par la console d’administration mais directement par un navigateur puis, nous allons l’analyser.

Récupération du WSDL

Pour récupérer le WSDL d’un Web Service déployé sous WebSphere 6.1, il faut taper l’URL suivante : http://localhost:9080/MaCalculetteWasSwWar/CalculetteWasSw?WSDL

Où :

MaCalculetteWasSwWar est la Racine du contexte qui est spécifiée lors du déploiement du Service Web dans la console d’administration
CalculetteWasSw est le servlet-name dans le web.xml. Il correspond également au serviceName du bean.

Si vous obtenez l’erreur suivante :

Error 404: No target servlet configured for uri:

Vérifier le nom MaCalculetteWasSwWar qui doit correspondre à la racine du contexte.

Si vous obtenez l’erreur suivante :

Error 404: SRVE0201E: Le servlet [fr.j2ltho.calculette.was.CalculetteBean] : n'est pas une classe de servlet

Vérifier le nom CalculetteWasSw qui doit correspondre au servlet name du web.xml. La racine du contexte est correcte. C’est le nom du service qui est incorrecte.

Nous allons analyser succinctement son contenu afin de mettre en évidence les correspondances entre les annotations et le contenu du WSDL.

ServiceName

Tout d’abord le premier tag, le tag definition :

Il contient le nom du Service Web tel qu’il est définit par la propriété serviceName dans l’annotation @WebService du bean d’implémentation.

On retrouve ce nom de service dans le tag service à la fin du WSDL :

Choix du protocole et du format des messages

Le service web est la collection de protocoles qu’il est possible d’utiliser pour déclencher un traitement donné. Dans certains cas plusieurs protocoles peuvent être mis à disposition comme SOAP 1.1, SOAP 1.2 et http.

Le protocole est de type SOAP 1.1. Un seul mécanisme est retenu dans cette implémentation. Il n’y a qu’un seul tag port dans le tag service, de même il n’y a qu’un seul tag binding. C’est la présence de l’annotation @SOAPBinding qui est responsable du choix du protocole SOAP.

Cette annotation permet également de définir le format du message :

Le paramètre style permet de choisir entre DOCUMENT et RPC : cela est visible dans le tag soap:binding la propriété style indique le style.

<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

Le paramètre use permet de choisir entre LITERAL et ENCODED : cela est visible dans les tags soap:body avec la propriété use qui indique le mécanisme d’encodage :

<soap:body use="literal" />

Pour finir, le paramètre parameterStyle permettait de choisir entre WRAPPED ou BARE (unwrapped). Le mode WRAPPED implique que dans le message appelant, les paramètres sont encapsulés dans un type portant le nom de l’opération. On peut le vérifier dans la partie message ou operation du WSDL où l’on voit la définition de l’opération ajouterWithWAS indiquer un input message (notez que cette partie diffère de ce que l’on obtient sur JBoss : les noms de message diffère) :

Cet input message fait référence à un message composé d’un unique élément qui porte comme nom ajouterWithWAS (le nom de l’opération) :

Les annotations sur les méthodes

Les annotations @WebMethod, @WebResult et @WebParam utilisées dans l’interface modifie les noms par défaut des opérations dans le WSDL.

On a pu constater que la propriété operationName de @WebMethod a permis pour la méthode add que celle-ci apparaisse sous le nom de ajouterWithWAS dans le WSDL. Le nom par défaut aurez été add (on peut le vérifier avec la méthode substract).

Définition des types

Le WSDL généré par WebSphere n’inclut pas la définition des types : les arguments et les résultats.

Le tag types indique qu’on importe un schéma qui se trouve dans le fichier CalculetteWasSw_schema1.xsd.

Pour afficher la définition, il faut taper l’URL suivante : http://localhost:9080/MaCalculetteWasSwWar/CalculetteWasSw/CalculetteWasSw_schema1.xsd où l’on a remplacé le wsdl par le nom du schéma devant être importé : CalculetteWasSw_schema1.xsd.

Avec l’opération ajouterWithWAS, on constate que les noms des arguments de la méthode sont peu significatifs :

<xs:complexType name="ajouterWithWAS">

<xs:sequence>

<xs:element name="arg0" type="xs:int"/>

<xs:element name="arg1" type="xs:int"/>

</xs:sequence>

</xs:complexType>

Le WSDL étant le contrat entre le client et le serveur, il est également la première source de documentation pour utiliser un service web, il est donc souhaitable que les noms d’éléments soient plus significatifs. On a utilisé pour cela l’annotation @WebParam pour la méthode substract afin d’imposer la valeur de la propriété name. Il faut également savoir que c’est cette valeur qui sera prise par l’outil wsconsume de JBoss afin de nommer les paramètres lors de la génération du stub client (comme on le verra plus loin). En conséquence des noms correctes et significatifs vont grandement simplifier l’utilisation du service.

Pour finir, on constate que l’annotation @WebResult a permis de renommer le nom de l’élément de sortie (la valeur renvoyée par la méthode) :

<xs:complexType name="ajouterWithWASResponse">

<xs:sequence>

<xs:element name="resultat" type="xs:int" />

</xs:sequence>

</xs:complexType>

On obtient une valeur resultat au lieu de return : cela n’a priori pas d’intérêt particulier dans notre cas.

PortType ou name de @WebService

On constate que la propriété name du tag portType du WSDL reprend la valeur de la propriété name de l’annotation @Webservice de l’interface.

Ce nom est utilisé lors de la génération des classes Java cliente avec l’outil wsconsume comme nom pour la classe d’interface qui sera utilisée. Je vous conseille donc d’utiliser le même nom que celui de l’interface afin de simplifier votre développement.

Types des données

Les données pour les types simples qu’on a utilisés utilisent des types simples du XMLSchema :

<xs:element name="arg0" type="xs:int" />

<xs:element name="arg1" type="xs:int" />

Ces types simples sont indépendants des langages de programmation. Cela est un point positif.

Conclusion

Ce tutorial est déjà bien long, je ne montrerai pas la création d’un client. Vous pouvez néanmoins vous reporter à mon tutorial sur les Service Web avec JBoss 5.1 : http://jl2tho.blogspot.com/2011/11/tutorial-service-web-avec-jbosss-51.html. J’y décris longuement la création d’un client. Faites attention ! l’url du WSDL n’est pas la même et les noms de méthodes et services sont différents : il vous faudra faire preuve d’un minimum d’adaptation.

L’exemple est volontairement simple et certainement pas très significatif vis-à-vis de la problématique d’un véritable projet mais il donne un point de départ pour la création de service web sans utiliser tout l’outillage d’IBM : Nous n’avons, hors phase de déploiement, utilisé que des mécanismes standards : ceux sont les mêmes que j’ai utilisé dans mon tutorial JBoss 5.1.

La seule adaptation a été l’utilisation d’un WAR pour le déploiement du service web : on reste ainsi dans une approche standard du déploiement.

Le service web déployé sous WebSphere 6.1 peut être appelé en utilisant un client JBoss 5.1. J’ai testé avec succès l’utilisation du wsconsume de JBoss pour générer mon client. La norme des services web joue (sur une exemple simple) son rôle : faciliter l’interopérabilité entre différentes technologies.

Tutorial Service Web avec JBosss 5.1

2011-11-11T18:57:00.001+02:00

Ce tutorial actualise la version que j’avais écrite en 2007 avec le serveur JBoss 4.2 : elle est disponible à l’url suivante : Tutorial Service Web avec JBoss 4.2. Ce nouveau tutorial présente la création d’un Service Web très simple avec JBoss 5.1.

Une rapide présentation des Services Web avec JBoss

JBoss s’appuie sur les EJB 3.0 pour définir et implémenter les Services Web. La version 5.1 de JBoss inclut à la fois le conteneur d’EJB et un module Service Web.

Aucun rappel ne sera fait sur les EJB dans ce post : je vous renvoie donc au post que j’avais écris à l’époque : Tutorial EJB 3.0 de session avec JBoss 4.2

Le module service web fait partie du package default. Vous devez trouver dans le répertoire deploy de la configuration default, un sous répertoire jbossws.sar.

JBoss respecte les spécifications de JAX-WS pour la définition des services web. Cette norme définit un ensemble d’annotations qui permettent la transformation d’un EJB 3.0 en service web. Les annotations sont interprétées par le serveur d’application afin de transformer les classes Java en service web.

La définition des différentes annotations peuvent être trouvées sur le site de Sun à l’adresse suivante : http://java.sun.com/javaee/5/docs/api/javax/jws/package-summary.html

Les annotations simplifient grandement la réalisation de services web. Elles permettent de définir :

toutes les informations pertinentes pour construire un WSDL à partir de la classe Java
les correspondances entre les messages SOAP du service web et la méthode de la classe Java responsable du traitement.

Par exemple, il est possible de définir le nom du service web, des opérations et des paramètres.

Les services web nécessite la présence d’un serveur d’application capable d’être serveur de service web : dans notre tutorial nous allons utiliser JBoss dans sa version 5.1.

Organisation du tutorial

Ce tutorial a pour objectif de présenter une mise en œuvre basique d’un Service Web avec JBoss 5.1.

Nous ne reprendrons pas l’installation et la configuration de JBoss 5.1 décrite dans le tutorial : Installation de JBoss 5.1 sur Windows 7 64 bits

Un Service Web est avant tout un EJB, il est possible de reprendre n’importe quel EJB et de le compléter afin de le transformer en Service Web.

Ce tutorial repose sur l’utilisation d’Eclipse 3.5 et sa distribution JEE.

Le tutorial comprendra les étapes suivantes :

La réalisation du service web dans Eclipse
La construction du client pour ce service web réalisé dans un autre projet Eclipse.
L’analyse du code et du WSDL

Configuration

Le tutorial a été réalisé sur un poste Windows 7.

Le runtime et le jdk Java sont à la version 1.5.0_11.

Pour JBoss, j’ai utilisé la version 5.1 : l’installation est décrite dans le billet : Installation de JBoss 5.1 sur Windows 7 64 bits

Création d’un projet Eclipse pour le service web

Dans Eclipse, on crée un projet Java simple que l’on nommera MaCalculetteSW.

Dans Eclipse, à partir de la barre de menu : File -> New -> Project.

Dans la dialogue New Project, choisir le dossier Java puis le nœud Java Project. Appuyez sur le bouton Next.

Pour Project name, tapez : MaCalculetteSW et laissez les autres options par défaut.

Appuyez sur Finish. Acceptez le choix de la perspective Java si la dialogue « Open Associated Perspective » s’affiche.

Il faut importer des jar JBoss : cliquez droit sur le projet dans l’explorateur et choisissez Properties. Dans la dialogue qui s’ouvre choisir « Java Build Path ».

Appuyer sur « Add External Jars.. », et utiliser l’explorateur pour aller dans le répertoire C:\jboss-5.1.0.GA\common\lib et sélectionnez les jar suivant :

Jboss-javaee.jar qui définit les annotations @Stateless et @Remote
Jbossws-native-jaxws.jar qui définit les annotations @WebService, @SOAPBinding et @SOAPBinding

Validez en appuyant sur Ok.

Notre poste est maintenant correctement configuré pour construire un Service Web.

Pour information, avec JBoss 6.0 Final, les jars ont de nouveau changé : il s’agit de :

jboss-ejb-api_3.1_spec.jar
jsr181-api.jar

qui se trouvent tous les deux dans c:\jboss-6.0.0\common\lib

Création de l’interface

Nous commençons par créer l’interface du service. L’interface définit les méthodes qui seront disponibles dans l’EJB et le service web.

Nous allons créer l’interface fr.j2ltho.calculette.ejb. MaCalculette. Par rapport à la définition d’un EJB, il faut ajouter deux autres informations au niveau de la classe :

Le nom du service web qui sera dans notre cas MaCalculetteSw
Le format et le style des messages échangés entre le client et le serveur. En d’autre terme, on choisit entre RPC/encoded et Document/literal, tout comme on choisit pour un Document/Literal s’il est wrapped ou unwrapped. Le format le plus répandu et portable étant Document/Literal/Wrapped c’est ce dernier que l’on retiendra.

Création de l’interface

Dans Eclipse, à partir de la barre de menu : File -> New -> Interface.

Dans la dialogue New Java Interface:

Pour Package, tapez : fr.j2ltho.calculette.ejb
Pour Name tapez : MaCalculette

Laissez les autres options par défaut et appuyez sur Finish.

On modifie le code pour définir les deux méthodes add et substract du service.

On ajoute l’annotation @Remote pour spécifier au conteneur d’EJB qu’il devra créé un lien de type Remote avec cette interface pour l’EJB.

Ajout des annotations Service Web

On ajoute ensuite l’annotation @SOAPBinding qui permet de définir le format des messages :

Le paramètre style permet de choisir entre DOCUMENT et RPC,
le paramètre use permet de choisir entre LITERAL et ENCODED
le paramètre parameterStyle entre WRAPPED ou BARE (unwrapped).

On obtient le code suivant (en gras le code ajouté par rapport à l’EJB):

package fr.j2ltho.calculette.ejb;

import javax.ejb.Remote;

import javax.jws.WebMethod;

import javax.jws.WebParam;

import javax.jws.WebResult;

import javax.jws.WebService;

import javax.jws.soap.SOAPBinding;

import javax.jws.soap.SOAPBinding.Style;

@Remote

@WebService(name = "MaCalculetteSw")

@SOAPBinding(style=Style.DOCUMENT, use=SOAPBinding.Use.LITERAL, parameterStyle= SOAPBinding.ParameterStyle.WRAPPED)

public interface MaCalculette {

@WebMethod(operationName="ajouter")

@WebResult(name = "resultat")

public int add(int x, int y);

@WebMethod

public int subtract(

@WebParam(name = "x")

int x,

@WebParam(name = "y")

int y);

}

Création du Bean

Nous commençons par créer la classe qui implémente le service.

Dans Eclipse, à partir de la barre de menu : File -> New -> Class.

Dans la dialogue New Java Class :

Pour Package, tapez : fr.j2ltho.calculette.ejb
Pour Name tapez : MaCalculetteBean

Appuyez, sur le bouton Add.. afin de définir l’interface. Dans la dialogue « Implemented Interfaces Selection » tapez MaCalculette puis sélectionnez l’interface MaCalculette – fr.j2ltho.calculette.ejb de votre projet. Validez en appuyant sur Ok. La dialogue se referme et l’interface apparait dans la liste Interfaces de la dialogue « New java Class ».

Laissez les autres options par défaut et appuyez sur Finish. Le code de la classe apparait avec les deux méthodes créées, il faut maintenant compléter le code.

Il faut également ajouter :

l’annotation @Stateless en début de classe. Cette annotation précise que cet EJB sera sans état : il ne conserve pas une mémoire de ce qu’il a fait précédemment.
l’annotation @WebService pour indiquer la classe d’interface qui contient les annotations décrivant le service web. Il permet également de définir le nom du service web tel qu’il apparait dans le WSDL.

On obtient le code suivant :

package fr.j2ltho.calculette.ejb;

import javax.ejb.Stateless;

import javax.jws.WebService;

@Stateless

@WebService(endpointInterface="fr.j2ltho.calculette.ejb.MaCalculette", serviceName="MaSwCalculette")

public class MaCalculetteBean implements MaCalculette {

public int add(int x, int y) {

return x + y ;

}

public int subtract(int x, int y) {

return x - y;

}

Génération du jar

Assurez vous d’avoir bien sauvegarder la classe et son interface.

Cliquez droit dans l’explorateur de ressource d’Eclipse sur votre projet MaCalculetteSW, sélectionnez Export…, dans la dialogue « Export » qui s’affiche choisissez, dans Java, JAR file. Puis Next. Sélectionner l’emplacement et le nom du JAR File. Pour ma part je l’ai créé directement dans le répertoire C:\jboss-5.1.0.GA\server\default\deploy qui est le répertoire de déploiement pour la configuration par default. Le nom du fichier est MaCalculette.jar.

Le nom du jar n’a aucune importance, il n’est pas utilisé pour obtenir le WSDL et n’a aucun d’impact sur le contenu du WSDL.

Appuyez, ensuite sur Finish. Vous devriez trouver un fichier MaCalculette.jar dans le répertoire C:\jboss-5.1.0.GA\server\default\deploy.

On lance JBoss, si on tape l’url suivante dans un browser : http://localhost:8080/jbossws/services une page JBossWS/Services s’affiche. Il doit y a avoir une page avec un ServiceEndID avec MaCalculetteBeanService, un WSDL est accessible sur la ligne suivante : http://127.0.0.1:8080/MaCalculette/MaCalculetteBean?wsdl

Analyse du WSDL

En cliquant sur le lien précédent : http://127.0.0.1:8080/MaCalculette/MaCalculetteBean?wsdl on affiche le WSDL du service.

Nous allons analyser succinctement son contenu afin de mettre en évidence les correspondances entre les annotations et le contenu du WSDL.

ServiceName

Tout d’abord le premier tag, le tag definition :

Il contient le nom du Service Web tel qu’il est définit par la propriété serviceName dans l’annotation @WebService du bean d’implémentation.

On retrouve ce nom de service dans le tag service à la fin du WSDL :

Choix du protocole et du format des messages

Cette annotation permet également de définir le format du message :

Le paramètre style permet de choisir entre DOCUMENT et RPC : cela est visible dans le tag soap:binding la propriété style indique le style.

<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" />

Le paramètre use permet de choisir entre LITERAL et ENCODED : cela est visible dans les tags soap:body avec la propriété use qui indique le mécanisme d’encodage :

<soap:body use="literal" />

</operation>

Cet input message fait référence à un message composé d’un unique élément qui porte comme nom ajouter (le nom de l’opération) :

</message>

Les annotations sur les méthodes

Les annotations @WebMethod, @WebResult et @WebParam utilisées dans l’interface modifie les noms par défaut des opérations dans le WSDL.

On a pu constater que la propriété operationName de @WebMethod a permis pour la méthode add que celle-ci apparaisse sous le nom de ajouter dans le WSDL. Le nom par défaut aurez été add (on peut le vérifier avec la méthode substract).

Avec l’opération ajouter, on constate que les noms des arguments de la méthode sont peu significatifs :

<xs:complexType name="ajouter">

<xs:sequence>

<xs:element name="arg0" type="xs:int" />

<xs:element name="arg1" type="xs:int" />

</xs:sequence>

</xs:complexType>

Le WSDL étant le contrat entre le client et le serveur, il est également la première source de documentation pour utiliser un service web, il est donc souhaitable que les noms d’éléments soient plus significatifs. On a utiliser pour cela l’annotation @WebParam pour la méthode substract afin d’imposer la valeur de la propriété name. Il faut également savoir que c’est cette valeur qui sera prise par l’outil wsconsume de JBoss afin de nommer les paramètres lors de la génération du stub client (comme on le verra plus loin). En conséquence des noms correctes et significatifs vont grandement simplifier l’utilisation du service.

Pour finir, on constate que l’annotation @WebResult a permis de renommer le nom de l’élément de sortie (la valeur renvoyée par la méthode) :

<xs:complexType name="ajouterResponse">

<xs:sequence>

<xs:element name="resultat" type="xs:int" />

</xs:sequence>

</xs:complexType>

On obtient une valeur resultat au lieu de return : cela n’a priori pas d’intérêt particulier dans notre cas.

PortType ou name de @WebService

On constate que la propriété name du tag portType du WSDL reprend la valeur de la propriété name de l’annotation @Webservice de l’interface.

Types des données

Les données pour les types simples qu’on a utilisés utilisent des types simples du XMLSchema :

<xs:element name="arg0" type="xs:int" />

<xs:element name="arg1" type="xs:int" />

Ces types simples sont indépendants des langages de programmation. Cela est un point positif.

Création d’un projet Eclipse pour le client

Qu’on est récupéré le projet EJB ou créé un projet de rien, il faut dans tous les cas créé un nouveau client. Dans Eclipse, on crée un second projet Java simple que l’on nommera MonClientSW.

Dans Eclipse, à partir de la barre de menu : File -> New -> Project.

Dans la dialogue New Project, choisir le dossier Java puis le nœud Java Project. Appuyez sur le bouton Next.

Pour Project name, tapez : MonClientSW et laissez les autres options par défaut.

Appuyez sur Finish. Acceptez le choix de la perspective Java si la dialogue « Open Associated Perspective » s’affiche.

Il faut importer des jar JBoss nécessaire à l’appel d’un Service Web : cliquez droit sur le projet dans l’explorateur et choisissez Properties. Dans la dialogue qui s’ouvre choisir « Java Build Path ».

Appuyer sur « Add External Jars.. », et utiliser l’explorateur pour aller dans le répertoire C:\jboss-5.1.0.GA\client et sélectionnez les jar :

activation.jar
javassist.jar
jaxb-api.jar
jaxb-impl.jar
jaxb-xjc.jar
jboss-serialization.jar
jboss-system-client.jar
mail.jar
policy.jar
stax-api.jar
wsdl4j.jar
wstx.jar
jbossws-native-core.jar
jbossws-native-jaxrpc.jar
jbossws-native-jaxws.jar
jbossws-native-jaxws-ext.jar
jbossws-native-saaj.jar
jboss-xml-binding.jar
ejb3-persistence.jar
jbossws-spi.jar
jbossws-common.jar
jboss-logging-spi.jar
jboss-common-core.jar
commons-logging.jar
jboss-remoting.jar

Puis ajouter depuis le répertoire C:\jboss-5.1.0.GA\lib\endorsed

serializer.jar
xalan
xercesImpl

Validez en appuyant sur Ok.

Génération des stubs

Nous allons utiliser l’utilitaire wsconsume.bat qui est livré avec JBoss. Il se trouve dans le répertoire C:\jboss-5.1.0.GA\bin. Cet utilitaire permet à partir d’un WSDL de générer un ensemble de classes qui facilitent l’appel du Service Web.

On ouvre une fenêtre invite de commandes DOS. On se positionne sur le répertoire, il faut positionner la variable JAVA_HOME vers l’installation Java de votre poste.

On lance la commande en indiquant à la fois le WSDL et le répertoire du projet Eclipse :

Cd C:\jboss-5.1.0.GA\bin

SET JAVA_HOME=C:\Program Files\Java\jdk1.6.0_18

wsconsume.bat -k -p fr.j2ltho.client.jboss.ejb http://127.0.0.1:8080/MaCalculette/MaCalculetteBean?wsdl -o "C:\Documents and Settings\jltho\Mes documents\PrjJava\MonClientSW\src"

Où C:\Documents and Settings\j2ltho\Mes documents\PrjJava est le nom de mon répertoire contenant mes projets Java.

Si vous avez l’erreur “Le chemin d'accès spécifié est introuvable.”, c’est que probablement la variable JAVA_HOME a été incorrectement spécifiée.

Les lignes suivantes s’affichent :

fr\j2ltho\client\jboss\ejb\Ajouter.java

fr\j2ltho\client\jboss\ejb\AjouterResponse.java

fr\j2ltho\client\jboss\ejb\MaCalculetteSw.java

fr\j2ltho\client\jboss\ejb\MaSwCalculette.java

fr\j2ltho\client\jboss\ejb\ObjectFactory.java

fr\j2ltho\client\jboss\ejb\Subtract.java

fr\j2ltho\client\jboss\ejb\SubtractResponse.java

fr\j2ltho\client\jboss\ejb\package-info.java

Dans Eclipse si on fait F5 sur le projet, un nouveau package fr.j2ltho.client.jboss.ejb apparait.

Création de la classe cliente

Dans Eclipse. Nous allons créer une classe de type Main afin d’appeler ce service web.

Dans Eclipse, à partir de la barre de menu : File -> New -> Class.

Dans la dialogue New Java Class :

Pour Package, tapez : fr.j2ltho.client.test.sw
Pour Name tapez : TestMaCalculetteMain
Cochez la checkbox public static void main(String[] args)

et laissez les autres options par défaut.

Appuyez sur Finish.

Le code à ajouter est très simple :

On récupère d’abord un objet sur le service web que l’on souhaite appeler. Le nom de la classe correspond au nom du service. Il s’agit à ce niveau d’une collection de protocole de communication qu’il est possible d’appeler.

Ensuite on récupère une interface sur ce service : c’est cette interface que l’on va pouvoir utiliser comme une simple classe. Vous pouvez constater que sa définition ressemble à celle de l’interface client. Le nom de la classe est celui du tag portType du WSDL. Comme on a forcé son nom à MaCalculetteSw, c’est ce nom qu’il prend. Dans la pratique, il est probablement plus intéressant de conserver le même nom que l’interface.

Pour finir, on appelle les deux services.

package fr.j2ltho.client.test.sw;

import java.util.Date;

import fr.j2ltho.client.jboss.ejb.MaCalculetteSw;

import fr.j2ltho.client.jboss.ejb.MaSwCalculette;

public class TestMaCalculetteMain {

/**

* @param args

public static void main(String[] args) {

System.out.println("debut:"+new Date());

MaSwCalculette service = new MaSwCalculette();

MaCalculetteSw calculator =service.getMaCalculetteBeanPort();

System.out.println("apres initialisation:"+new Date());

System.out.println(calculator.ajouter(2, 4));

System.out.println("fin du add:"+new Date());

System.out.println(calculator.subtract(8, 3));

System.out.println("fin du substract:"+new Date());

}

Création du fichier META-INF/standard-jaxws-client-config.xml

Dans le répertoire src, on créé un nouveau Folder META-INF : Cliquez droit sur le répertoire src et sélectionnez New –> Other. La dialogue “New – Select a wizard” apparait. Choisir dans le noeud General, l’élément Folder et appuyez sur Next. Saisir le nom du folder qui doit impérativement être META-INF et validez.

Le répertoire META-INF a été créé dans le répertoire src de votre projet.

Ensuite, on copie depuis C:\jboss-5.1.0.GA\server\default\deployers\jbossws.deployer\META-INF, le fichier satandard-jaxws-client-config.xml dans le nouveau répertoire META-INF : il suffit de faire un glisser/déposer de l’explorateur Windows vers le répertoire META-INF dans le Project explorer d’Eclipse.

Aucune adaptation n’est nécessaire à ce fichier. Il s’agit d’une nouveauté nécessaire avec JBoss 5.1.

Sans ce fichier vous auriez eu à l’exécution l’erreur suivante :

exception in thread "main" org.jboss.ws.WSException: Cannot find configFile: META-INF/standard-jaxws-client-config.xml
    at org.jboss.ws.metadata.config.JBossWSConfigFactory.filenameToURL(JBossWSConfigFactory.java:196)
    at org.jboss.ws.metadata.config.JBossWSConfigFactory.getConfig(JBossWSConfigFactory.java:150)
    at org.jboss.ws.metadata.umdm.EndpointMetaData.initEndpointConfigMetaData(EndpointMetaData.java:874)
    at org.jboss.ws.metadata.umdm.EndpointMetaData.initEndpointConfig(EndpointMetaData.java:851)
    at org.jboss.ws.metadata.builder.jaxws.JAXWSClientMetaDataBuilder.rebuildEndpointMetaData(JAXWSClientMetaDataBuilder.java:292)
    at org.jboss.ws.core.jaxws.spi.ServiceDelegateImpl.getPortInternal(ServiceDelegateImpl.java:269)
    at org.jboss.ws.core.jaxws.spi.ServiceDelegateImpl.getPort(ServiceDelegateImpl.java:200)
    at javax.xml.ws.Service.getPort(Service.java:141)
    at fr.j2ltho.client.jboss.ejb.MaSwCalculette.getMaCalculetteBeanPort(MaSwCalculette.java:55)
    at fr.j2ltho.client.test.sw.TestMaCalculetteMain.main(TestMaCalculetteMain.java:18)

Tester l’application

Pour tester, on sauve, puis on clique droit sur la classe TestMaCalculetteMain dans le Package Explorer d’Eclipse. Choisissez le menu Run As, puis le sous menu Java Application.

La console affichée en bas est rafraichie et affiche deux lignes :

debut:Tue May 22 10:59:32 CEST 2007

apres initialisation:Tue May 22 10:59:33 CEST 2007

fin du add:Tue May 22 10:59:33 CEST 2007

fin du substract:Tue May 22 10:59:33 CEST 2007

On constate que le temps d’initialisation de l’appel est long (de l’ordre de 2s sur mon poste, un core duo 2 avec 2 Go). La documentation de JBoss indique que cette opération est longue et ne doit être faite qu’une seule fois et recommande de conserver cette classe en mémoire. Le test met l’accent sur l’importance de suivre cette recommandation.

Quelques exceptions et leur solution

Lorsqu’on lance l’exécution de l’application de test, on est susceptible d’obtenir des exceptions s’il manque un ou plusieurs jar. J’indique ci dessous certaines des erreurs que j’ai rencontré et le jar que j’ai du ajouté pour résoudre le problème :

L’exception suivante est résolue par l’ajout du jar : jbossws-spi.jar

Exception in thread "main" java.lang.NoClassDefFoundError: org/jboss/wsf/spi/deployment/UnifiedVirtualFile
at org.jboss.ws.core.jaxws.spi.ProviderImpl.createServiceDelegate(ProviderImpl.java:63)

L’exception suivante est résolue par l’ajout du jar : jbossws-common.jar

Exception in thread "main" java.lang.NoClassDefFoundError: org/jboss/wsf/common/ResourceLoaderAdapter
at org.jboss.ws.core.jaxws.spi.ServiceDelegateImpl.<init>(ServiceDelegateImpl.java:118)

L’exception suivante est résolue par l’ajout du jar : policy.jar

Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/ws/policy/Policy
at org.jboss.ws.metadata.builder.jaxws.JAXWSClientMetaDataBuilder.buildMetaData(JAXWSClientMetaDataBuilder.java:91)
at org.jboss.ws.core.jaxws.spi.ServiceDelegateImpl.<init>(ServiceDelegateImpl.java:138)

L’exception suivante est résolue par l’ajout du jar : jboss-remoting.jar

Exception in thread "main" javax.xml.ws.WebServiceException: java.lang.IllegalStateException: Failed to load org.jboss.ws.core.client.RemoteConnection.http: org.jboss.ws.core.client.SOAPProtocolConnectionHTTP
    at org.jboss.ws.core.jaxws.client.ClientImpl.handleRemoteException(ClientImpl.java:396)
    at org.jboss.ws.core.jaxws.client.ClientImpl.invoke(ClientImpl.java:302)
    at org.jboss.ws.core.jaxws.client.ClientProxy.invoke(ClientProxy.java:170)
    at org.jboss.ws.core.jaxws.client.ClientProxy.invoke(ClientProxy.java:150)
    at $Proxy15.ajouter(Unknown Source)
    at fr.j2ltho.client.test.sw.TestMaCalculette3Main.main(TestMaCalculette3Main.java:22)
Caused by: java.lang.IllegalStateException: Failed to load org.jboss.ws.core.client.RemoteConnection.http: org.jboss.ws.core.client.SOAPProtocolConnectionHTTP
    at org.jboss.wsf.spi.util.ServiceLoader.loadFromServices(ServiceLoader.java:97)
    at org.jboss.wsf.spi.util.ServiceLoader.loadService(ServiceLoader.java:59)
    at org.jboss.ws.core.client.RemoteConnectionFactory.getRemoteConnection(RemoteConnectionFactory.java:61)
    at org.jboss.ws.core.CommonClient.invoke(CommonClient.java:339)
    at org.jboss.ws.core.jaxws.client.ClientImpl.invoke(ClientImpl.java:290)
    ... 4 more
Caused by: java.lang.NoClassDefFoundError: org/jboss/remoting/marshal/Marshaller
    at java.lang.Class.getDeclaredConstructors0(Native Method)
    at java.lang.Class.privateGetDeclaredConstructors(Class.java:2357)
    at java.lang.Class.getConstructor0(Class.java:2671)
    at java.lang.Class.newInstance0(Class.java:321)
    at java.lang.Class.newInstance(Class.java:303)
    at org.jboss.wsf.spi.util.ServiceLoader.loadFromServices(ServiceLoader.java:92)
    ... 8 more

L’exception suivante est résolue par l’ajout du jar : commons-logging.jar

Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory
    at org.apache.ws.policy.util.Loader.<clinit>(Loader.java:32)
    at org.apache.ws.policy.util.PolicyFactory.getPolicyReader(PolicyFactory.java:56)
    at org.jboss.ws.extensions.policy.metadata.PolicyMetaDataBuilder.processPolicyExtensions(PolicyMetaDataBuilder.java:155)
    at org.jboss.ws.metadata.builder.jaxws.JAXWSClientMetaDataBuilder.buildMetaData(JAXWSClientMetaDataBuilder.java:92)
    at org.jboss.ws.core.jaxws.spi.ServiceDelegateImpl.<init>(ServiceDelegateImpl.java:138)
    at org.jboss.ws.core.jaxws.spi.ProviderImpl.createServiceDelegate(ProviderImpl.java:63)
    at javax.xml.ws.Service.<init>(Service.java:79)

L’exception suivante est résolue par l’ajout du jar : jboss-common-core.jar

Exception in thread "main" java.lang.NoClassDefFoundError: org/jboss/util/NotImplementedException
    at org.jboss.ws.metadata.umdm.ServiceMetaData.<init>(ServiceMetaData.java:85)
    at org.jboss.ws.metadata.builder.jaxws.JAXWSClientMetaDataBuilder.buildMetaData(JAXWSClientMetaDataBuilder.java:80)
    at org.jboss.ws.core.jaxws.spi.ServiceDelegateImpl.<init>(ServiceDelegateImpl.java:138)
    at org.jboss.ws.core.jaxws.spi.ProviderImpl.createServiceDelegate(ProviderImpl.java:63)
    at javax.xml.ws.Service.<init>(Service.java:79)

Conclusion

L’exemple est volontairement simple et certainement pas très significatif vis-à-vis de la problématique d’un véritable projet. Néanmoins, il me parait intéressant de mettre l’accent sur quelques points qui devront être confirmé avant de s’enthousiasmer plus :

Le WSDL généré est standard. Pour cet exemple simple il ne contient aucune référence au langage Java. Sur un exemple un peu plus compliqué en utilisant l’approche POJO de Axis2 cela n’avait pas été du tout le cas.
Les diverses annotations ont permis de générer un WSDL qui peut être extrêmement précis et indépendant de l’implémentation Java. On obtient ainsi à la fois des classes Java proche du métier mais également le WSDL que l’on souhaite. Toujours sur un exemple plus compliqué, j’ai eu beaucoup plus de mal avec Axis2 (voir le tutorial http://jl2tho.blogspot.com/2007/04/tutorial-services-web-avec-axis2.html)
A priori, le code est indépendant de la solution retenu : tout serveur d’application respectant JAX-WS doit être capable d’héberger le service web. Le Jar ServiceWeb généré avec un runtime JBoss 4.2 fonctionne sur JBoss 5.1. Seule l’URL du WSDL a changé. Le code du service et sa définition (annotation) ne change pas.
Le code client généré par l’utilitaire wsconsume.bat de JBoss est plus simple et plus portable que celui généré par wsdl2java d’Axis2 en utilisant le binding ADB.
L’EJB est accessible : pour ceux qui ont réalisé le tutorial sur les EJB, ils peuvent relancer l’application cliente et constater qu’elle continue de s’exécuter correctement.
Les modèles de programmations pour le client que l’on utilise un EJB, un service web ou bien que l’on appelle directement la classe d’implémentation restent très proches. La seule différence réside dans l’obtention de la classe d’interface, le reste du code peut être identique. Cela peut être un gros avantage pour la mise en œuvre de la solution lors du développement, en supprimant les étages.

Comme on le voit tout cela semble très positif. Le seul point qui parait négatif mais pour lequel je n’ai pas de comparaison c’est l’aspect performance : la création d’un bean permettant l’appel d’un service web est long.

Passer son iPhone sous iOS 5

2011-11-01T10:46:00.001+02:00

Depuis le 12/10/2011, la nouvelle version de iOS est disponible en téléchargement depuis iTunes.

Ce billet décrit la mise à jour d’un iPhone (en l’occurrence un iPhone 4) avec cette version. Il est fort probable qu’il faudra prendre les mêmes précautions (tout comme il fallait déjà prendre les mêmes précautions) pour les versions suivantes.

Attention ! un iPhone 3G ainsi que les version précédentes ne peuvent pas installer iOS 5.0. Cette opération est réservée aux possesseurs d’iPhone 3GS et 4 ainsi qu’aux possesseurs d’iPad et iPad2.

Retrouver le PC avec lequel l’iPhone est synchronisé

La mise à jour de iOS 5 nécessite le PC de référence avec lequel vous synchronisez votre iPhone. Apple considère qu’un iPhone se synchronise avec un ordinateur principal unique : c’est avec ce PC que votre iPhone synchronise sa musique, ses contacts son calendrier, ses Apps…

Pour beaucoup de personnes, la première étape sera de se souvenir du PC et du compte Windows avec lequel l’iPhone est synchronisé. Une piste pour reconnaitre le bon PC : lors de la synchronisation de l’iPhone avec iTunes ce dernier reconnait votre iPhone et ne demande pas si vous souhaitez écraser votre iPhone ou s’il s’agit d’un nouvel iPhone ou tout autre question indiquant que iTunes ne connait pas cet iPhone.

Une autre piste, est le fait que toutes les options de synchronisations pour les Contacts, le Calendrier, la Musique et les Apps soient actives.

Si ce n’est pas le cas et que vous ne retrouvez pas le bon PC, je vous encourage en premier lieu de resynchroniser complètement votre iPhone avec ce PC et cet iTunes. Attention aux pertes de données, tout particulièrement la musique qui ne peut pas redescendre d’un iPhone. Il vous faudra récupérer la bibliothèque avec laquelle vous vous synchronisiez.

Mettre à jour iTunes

Une fois retrouvé le bon ordinateur et le bon compte Windows, la première étape consiste à mettre à jour iTunes.

Lors de son lancement, il vous avertira probablement qu’il existe une nouvelle mise à jour. Je vous recommande d’accepter systématiquement la mise à jour iTunes avant une mise à jour iPhone. Bien souvent, ces mises à jours iTunes embarquent des fonctionnalités nécessaires à l’exploitation des nouvelles fonctionnalités de l’iPhone. Vouloir sauter cette étape ne me parait pas être un bon calcul : vous vous exposez à vous retrouver bloqué au milieu du gué.

Télécharger la mise à jour

Lorsque que vous connectez votre iPhone à l’ordinateur, il vous avertit qu’une nouvelle version de iOS est disponible. Vous avez la possibilité soit de la télécharger soit de la télécharger et de l’installer.

Personnellement, je choisis systématiquement le téléchargement seul. Cela permet de découper la mise à jour en tâches interruptibles simplement et de dissocier les problèmes.

Les nouvelles versions sont volumineuses généralement entre 700 et 900 Mo et cela peut prendre un certain temps sur une connexion bas débit. Un téléchargement s’interrompt facilement s’il prend trop de temps. Si vous faites les deux en même temps, il sera plus difficile de savoir à quelle étape vous en êtes.

Synchroniser votre iPhone avant la mise à jour

L’avantage de ne faire que le téléchargement et de permettre une synchronisation de l’iPhone avec votre PC.

Vous avez également tout le loisir de régler d’éventuels problèmes de synchronisation dans le cas où vous ne synchronisez que très rarement votre iPhone.

N’hésitez pas à relancer plusieurs synchronisations. Cela va vous permettre de disposer d’une copie de sauvegarde de votre iPhone.

Mettre à jour iOS

Une fois téléchargée la mise à jour et synchronisé votre iPhone, vous pouvez commencer la mise à jour. Cette opération prend plus ou moins de temps en fonction de l'âge de votre PC : il est néanmoins recommandé de prévoir d’une à deux heures pour cette opération qui ne pourra pas être interrompue.

Avant de commencer cette opération, il vous faut vous souvenir de votre Code SIM : celui-ci est indispensable pour ré-activer votre iPhone à la fin de l’installation.

Quand votre iPhone est branché, si vous le sélectionnez dans la barre latérale gauche, vous pouvez choisir l’onglet Info. Vous devez avoir un bouton “Mettre à jour l’iPhone” qui s’affiche. Cliquez dessus pour démarrer la mise à jour.

Lisez avec attention les messages d’avertissement afin de vérifier qu’ils ne vous concernent pas.

La mise à jour démarre. Cela commence par une sauvegarde de votre iPhone, cela enchaine avec l’installation de iOS.

Au bout d’un certain temps, votre iPhone affiche le message : “Veuillez saisir votre code SIM pour déverrouiller votre iPhone”.

Attention ! la Slider en bas affiche un message Configurer en diverses langues. Il ne faut surtout pas l’utiliser ! Il lance une configuration Standalone de votre iPhone : si vous suivez cette démarche, il configure un iPhone vierge et vous fait perdre toutes vos données..

Il faut cliquer sur le message demandant le déverrouillage de votre iPhone et saisir votre code SIM.

Récupérer vos informations

Une fois cette opération faite, il faut débrancher et rebrancher l’iPhone à votre ordinateur. Lors du rebranchement, il finit la mise à jour en recopiant toutes les informations sauvegardées en début de synchronisation. Cette opération peut durer une bonne heure en fonction de votre PC et de la quantité d’informations stockées sur l’iPhone : Musique et Apps principalement.

Lorsque l’opération est terminée : vous devriez avoir la totalité de vos données Musiques, Apps, Contacts et Calendrier qui se retrouve sur votre iPhone.

Configuration iCloud

Cette étape est nouvelle avec iOS 5. Pour terminer la mise à jour, il faut configurer iCloud. Le premier message vous demande si vous souhaitez activer la localisation (personnellement je coche Activer). L’écran suivant vous propose d’activer iCloud : il existe un petit lien en bas de l’écran “Ignorer cette étape”. N’étant pas intéressé par iCloud j’ai cliqué dessus afin d’éviter son activation.

Si vous souhaitez l’activer, l’identifiant Apple qui vous est demandé, est celui de votre compte iTunes que vous avez du créer auparavant pour activer votre iPhone et qu’il vous réclame à chaque chargement d’une nouvelle application depuis l’AppStore.

Il vous demandera ensuite les services que vous souhaitez utiliser : mais pour cette étape, vous comprendrez que je ne suis pas d’une grande aide.

Conclusion

Normalement, votre iPhone est maintenant en iOS 5 et vous avez retrouvé la totalité des données. Si vous faites bien attention d’utiliser pour la mise à jour le PC de synchronisation de votre iPhone vous ne devriez rien perdre.

Les personnes que j’ai rencontré qui avez perdu des données lors de la mise à jour avaient toutes comme point commun de synchroniser rarement leur iPhone et pas toujours avec le même PC. Si vous êtes dans ce cas, je ne peux que vous encourager à rétablir un PC de référence pour la synchronisation de votre iPhone avant de tenter la mise à jour.

Effacer son mot de passe ou son login de la liste de suggestion d'un navigateur

2010-12-16T19:52:00.001+02:00

Il arrive que lorsqu’on saisisse son nom utilisateur ou son login pour se connecter (par exemple à Gmail, Yahoo, Facebook, Hotmail ou tout autre service), on se trompe et on saisisse son mot de passe. Si par malheur on a appuyé sur la touche Entrée, cette information réapparaitra à chaque fois que l'on commence à taper la première lettre dans la liste de suggestion : dévoilant ainsi le mot de passe.

Il faut noter que cette liste de suggestion dépend du site : si vous utilisez myyahoo sur www.yahoo.fr, il n’apparaitra pas dans la liste de suggestion sur le site www.gmail.com.

Néanmoins cette information reste "éternellement" présente pour un site donné : effacer les cookies du site n'y fait rien (ce n'est pas le site qui conserve l’information mais votre navigateur).

Ce problème existe pour Chrome et Firefox (je n'ai pas testé sous IE). Pour faire disparaitre une suggestion de la liste des comptes ou utilisateurs fournie par Firefox ou Chrome, le processus est simple et identique :

Ouvrir la page de connexion du site concerné
Se positionner sur le champ Utilisateur, Compte ou login
Taper la première lettre du mot
Lorsque la liste s'affiche, utiliser les flèches de son clavier pour sélectionner la ligne que vous voulez supprimer.
Une fois la sélection faite, appuyer sur la touche Suppr.

La ligne est supprimée de la liste et n’apparaitra plus jusqu'à la prochaine erreur de saisie.

J'espère que cela vous aura rendu service car il est toujours délicat de laisser son mot de passe apparaitre en clair dans la liste de suggestion des utilisateurs d'un site.

Comme la majorité des personnes utilise le même mot de passe sur différents sites, la faille de sécurité est d'autant plus importante.

Couverture de code : Mise en œuvre de Cobertura pour une application Web

2010-11-05T16:14:00.001+02:00

Ce billet présente la mise en œuvre de Cobertura pour une application Web. Vous y trouverez une rapide présentation de Cobertura, suivie d’un tutorial pour son utilisation dans le cadre des tests d’une application Web s’exécutant sur un serveur Tomcat.

Présentation de Cobertura

Cobertura est un outil qui permet de mesurer la couverture de code d’un jeu de tests. Il ne permet pas de réaliser les tests, ni de les automatiser : Cobertura mesure juste la pertinence et la complétude de ces tests.

Les outils qui mesurent la couverture de votre code Java fonctionnent tous de la même manière :

il n’est pas nécessaire de modifier le code Java : les solutions ne sont pas intrusives.
il y a tout d’abord une phase d’instrumentalisation des fichiers compilés (class, jar ou war) : cette phase qui a lieu après la compilation semble construire une couche de proxies sur les binaires existant afin d’intercepter tous les appels.
on exécute les tests avec les binaires instrumentalisés en ajoutant un jar nécessaire au bon fonctionnement de la couche de proxy.
on termine le test par une sortie violente (Ctrl C souvent) afin que la couche de proxy reprenne la main est crée le fichier de compte rendu
hors exécution, on transforme le fichier de compte rendu en pages HTML : on obtient un site qui montre pour chaque classe java : le pourcentage de code exécuté, le nombre de branches conditionnelles exécutées et le détail du code exécuté ou non.

Le résultat du processus est donc un rapport qui indique si la totalité du code a été testé et qui permet la détection du code non exécuté.

Ci dessous, un exemple de la page index.html qui est la synthèse du rapport est le point de départ des différentes pages d’analyse.

On constate que pour chaque package, on a une synthèse du code couvert :

on a le nombre de classes composant le package
on a le pourcentage de lignes de code exécutées (les lignes de commentaire ne sont pas comptabilisées)
on a le nombre de lignes exécutées et le nombre total de lignes de code de ce package (toutes classes confondues)
ce que Cobertura appelle branch est tout branchement conditionnel (if ,else…) : il mesure si pour chaque test, on a eu à le cas du true et du false. Si vous n’avez eu que le cas du true, vous ne serez qu’à 50% du test de couverture des branchs.
la dernière colonne est la complexité “cyclotimique” du code (j’avoue ne pas avoir utilisé cette information)

Pour une classe, il est possible d’avoir le détail. Ce point peut être très utile quand on essaie d’améliorer ses tests : il faut comprendre quelle partie du code n’a pas été testé afin de construire le test qui la couvrira.

On constate que l’on a en haut, une synthèse de la couverture de la classe avec son pourcentage et le nombre de lignes testées sur le nombre de lignes totales de la classe.

On a ensuite le code, en vert les lignes exécutées avec le nombre de fois, en rouge les lignes qui ne l’ont pas été : dans l’exemple ci-dessus seuls le constructeur et la méthode getSolde ont été exécuté.

Mise en œuvre de Cobertura pour une application Web

La majorité des documentations présente l’utilisation de Cobertura dans les phases de tests unitaires jUnit. La mise en œuvre avec une application Web déployée sur un serveur d’application JEE comme Tomcat est plus délicate : le bon fonctionnement de Cobertura repose sur la bonne gestion du fichier de données (appelé datafile et dont le nom par défaut est cobertura.ser). Or cette gestion repose sur ce que le serveur d’application considère comme le point de départ de son système de fichiers et ce paramètre change énormément d’une configuration à l’autre et d’un serveur à l’autre.

Configuration du serveur Tomcat 6.0

Le test a été fait sur un serveur Tomcat 6.0. Le serveur est lancé avec le startup.bat et non pas comme service Windows : cela a un impact important sur l’endroit ou doit se trouver le fichier cobertura.ser.

Pour ma part, j’ai téléchargé depuis le site http://tomcat.apache.org/download-60.cgi la version core pour Windows 32 bits : 32-bits Windows.zip.

Le répertoire obtenu lors du unzip : apache-tomcat-6.0.29 a été copié dans un nouveau dossier placé sur mon bureau TestCouverture créé pour l’occasion. J’ai donc un environnement dédié pour mes tests.

J’ouvre le Catalina.bat qui se trouve dans Bin et j’ajoute en tout début de fichier la ligne suivante :

Set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_18

L’avantage de cette solution est de m’affranchir d’éventuelles restrictions de droits sur les répertoires : par défaut, Tomcat est souvent installé dans Program Files qui est soumis pour les versions récentes de Windows (Vista et Seven) a une politique de droits restrictive qui peut empêcher la mise à jour par Cobertura du fichier de données cobertura.ser.

Installation de Cobertura

J’ai utilisé la dernière version disponible (au moment de mes tests), la version 1.9.4.1.

Elle peut être téléchargée depuis le site suivant : http://cobertura.sourceforge.net/download.html

Il suffit de la dézipper dans un répertoire, dans mon cas le même dossier TestCouverture du bureau.

Instrumentalisation des classes avec Cobertura

Avant d’instrumentaliser mes classes de mon projet JEE Eclipse TestCobertura, je génère depuis Eclipse le war.

Je le déploie dans mon serveur Tomcat configuré pour le test : Bureau\apache-tomcat-6.0.29\webapps. Pensez aux éventuels jar qui doivent être installés dans Tomcat/lib comme ceux des drivers base de données.

J’exécute l’application après lancement du serveur Tomcat avec le startup.bat. Cela explose le fichier war TestCobertura. On arrête le serveur.

Pour instrumentaliser les classes java, on va partir du répertoire build du projet Eclipse qui contient les class et on va écraser ces mêmes class du répertoire explosé TestCobertura du serveur Tomcat (d’où l’importance de l’exécution de l’application) :

Le répertoire de mon projet Eclispe est dans Mes Documents\eclipsewsp, les fichiers class sont donc dans : C:\Users\MONCOMPTEWINDOWS\Documents\eclipsewsp\TestCobertura\build\classes.
Le répertoire du war explosé dans Tomcat est : C:\Users\MONCOMPTEWINDOWS\Desktop\TestCouverture\apache-tomcat-6.0.29\webapps\TestCobertura.
Le fichier de données cobertura.ser devra être créé dans le répertoire bin de Tomcat : C:\Users\MONCOMPTEWINDOWS\Desktop\TestCouverture\apache-tomcat-6.0.29\bin

Pensez que :

MONCOMPTEWINDOWS doit être remplacé par la chaine de caractères correspondant à votre configuration.
TestCobertura est le nom de mon projet Eclipse.
eclipsewsp est le nom de mon répertoire workspace Eclipse.

On ouvre un fichier Commande DOS. on se positionne dans le répertoire Cobertura :

cd C:\Users\MONCOMPTEWINDOWS\Desktop\TestCouverture\cobertura-1.9.4.1

On tape la commande suivante :

cobertura-instrument.bat --datafile "C:\Users\MONCOMPTEWINDOWS\Desktop\TestCouverture\apache-tomcat-6.0.29\bin\cobertura.ser" --destination "C:\Users\MONCOMPTEWINDOWS\Desktop\TestCouverture\apache-tomcat-6.0.29\webapps\TestCobertura\WEB-INF\classes" "C:\Users\MONCOMPTEWINDOWS\Documents\eclipsewsp\TestCobertura\build\classes"

Attention à bien utiliser les guillemets “ pour éviter les problèmes d’espaces dans d’éventuels noms longs. Le résultat devrait être :

Cobertura 1.9.4.1 - GNU GPL License (NO WARRANTY) - See COPYRIGHT file

Instrumenting 1 file to C:\Users\MONCOMPTEWINDOWS\Desktop\TestCouverture\apache-tomcat-6.0.29\webapps\TestCobertura\WEB-INF\classes

Cobertura: Saved information on 131 classes.

Instrument time: 4129ms

Dans le répertoire bin de votre serveur Tomcat, vous devriez trouver un fichier cobertura.ser. Ce fichier est nécessaire au bon fonctionnement de Cobertura : il indique la liste des classes qu’il doit instrumentaliser ainsi que le résultat des tests. Ce fichier devra être accessible en lecture/écriture durant l’exécution du test.

Si on souhaite pouvoir recommencer les tests à zéro, il est possible de sauvegarder cette version du fichier qui contient les classes instrumentalisées avec un compteur d’utilisation à zéro.

Les fichiers .class du répertoire WEB-INF\classes ont été modifié (leur date a été modifié).

Les classes sont instrumentalisées.

Test de l’application instrumentalisée

Si vous essayez de relancer l’application, vous allez avoir une erreur dans la log localhost :

Caused by: java.lang.NoClassDefFoundError: net/sourceforge/cobertura/coveragedata/HasBeenInstrumented
    at java.lang.ClassLoader.defineClass1(Native Method)
    at java.lang.ClassLoader.defineClassCond(ClassLoader.java:632)
    at java.lang.ClassLoader.defineClass(ClassLoader.java:616)
    at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:141)
    at org.apache.catalina.loader.WebappClassLoader.findClassInternal(WebappClassLoader.java:2733)
    at org.apache.catalina.loader.WebappClassLoader.findClass(WebappClassLoader.java:1124)
    at org.apache.catalina.loader.WebappClassLoader.loadClass(WebappClassLoader.java:1612)
    at org.apache.catalina.loader.WebappClassLoader.loadClass(WebappClassLoader.java:1491)
    at java.lang.Class.forName0(Native Method)
    at java.lang.Class.forName(Class.java:169)
    at org.hibernate.util.ReflectHelper.classForName(ReflectHelper.java:192)
    at org.hibernate.cfg.AnnotationConfiguration.parseMappingElement(AnnotationConfiguration.java:647)
    ... 57 more
Caused by: java.lang.ClassNotFoundException: net.sourceforge.cobertura.coveragedata.HasBeenInstrumented
    at org.apache.catalina.loader.WebappClassLoader.loadClass(WebappClassLoader.java:1645)
    at org.apache.catalina.loader.WebappClassLoader.loadClass(WebappClassLoader.java:1491)
    ... 69 more

Cette erreur signifie qu’il manque le jar cobertura qui est utilisé par les classes instrumentalisées.

Dans la mesure, où l’on a construit un serveur Tomcat pour ses tests, il suffit d’ajouter cobertura.jar dans le répertoire bin de Tomcat.

Le jar cobertura se trouve dans le répertoire TestCouverture\cobertura-1.9.4.1. Il suffit de le copier dans TestCouverture\apache-tomcat-6.0.29\lib.

Vous pouvez redémarrer Tomcat avec Startup.bat et exécuté votre test.

A la fin de votre test, vous arrêtez Tomcat en vous mettant dans la console qu’il aura ouverte et tapez Ctrl C. Tomcat s’arrête et met à jour le fichier cobertura.ser avec les logs de votre utilisation.

Génération du rapport HTML

La phase finale est la génération du rapport au format HTML.

Le rapport utilise le fichier cobertura.ser mis à jour lors de votre utilisation. Pour que cela fonctionne, il faut que lors de l’exécution de votre application, Tomcat ait bien trouvé le fichier cobertura.ser créé lors de l’instrumentalisation. S’il ne le trouve pas, il créera un fichier cobertura.ser dans apache-tomcat-6.0.29\bin mais il ne contiendra aucune information.

L’emplacement de ce fichier dépend du mécanisme de lancement de tomcat : avec startup.bat, il se trouve dans apache-tomcat-6.0.29\bin.

Attention à ce que Tomcat puisse modifier ce fichier : cela sera probablement un problème si Tomcat s’exécute en service ou s’il se trouve dans un répertoire Program Files. C’est pour toutes ces raisons que je vous ai encouragé au début à installer votre propre version de test Tomcat.

Pour que le rapport est le maximum de détail, il faut disposer des sources.

Dans mon exemple, elles se trouvent dans le projet Eclipse sous : C:\Users\MONCOMPTEWINDOWS\Documents\eclipsewsp\TestCobertura\src.

On va générer le rapport dans le sous répertoire rapportCobertura du répertoire TestCouverture. Pour cela on crée le sous répertoire rapportCobertura

On se replace dans le répertoire TestCouverture\cobertura-1.9.4.1 et on tape la commande suivante :

cobertura-report.bat –source "C:\Users\MONCOMPTEWINDOWS\Documents\eclipsewsp\TestCobertura\src" --datafile "C:\Users\MONCOMPTEWINDOWS\Desktop\TestCouverture\apache-tomcat-6.0.29\bin\cobertura.ser" --destination "C:\Users\MONCOMPTEWINDOWS\Desktop\TestCouverture\rapportCobertura" "C:\Users\MONCOMPTEWINDOWS\Documents\eclipsewsp\TestCobertura\build\classes"

Pour information, les différentes options utilisées sont :

source : le répertoire contenant les sources
datafile : emplacement du fichier cobertura.ser
destination : répertoire dans lequel on génère le rapport

Le dernier paramètre est l’emplacement des fichiers classes d’origine.

Attention à bien utiliser les guillemets “ pour éviter les problèmes d’espaces dans d’éventuels noms longs. Le résultat devrait être :

Cobertura 1.9.4.1 - GNU GPL License (NO WARRANTY) - See COPYRIGHT file
Cobertura: Loaded information on 23 classes.
Report time: 569ms

Dans le répertoire TestCouverture\rapportCobertura vous devriez voir une série de fichier html dont le fichier index.html.

Si le répertoire est vide, vérifiez le nom et le chemin de vos différents fichiers et répertoire. Le message est malheureusement le même entre un succès et un échec.

Pour consulter le rapport, double cliquer sur index.html.

Si quand vous consultez le détail d’une classe, vous n’avez pas le code de la classe mais le message

Unable to locate fr/natsystem/demonatjet/gettingstarted/DemoNatJet40.java. Have you specified the source directory?

C’est que vous avez oublié de spécifier l’option source de la commande ou bien que le nom du répertoire contenant vos sources est incorrect.

Cobertura et Spring et AspectJ

Cobertura et le module AspectJ de spring utilisent tous les deux des mécanismes de proxy qui entrent en collision. Il peut donc arriver, que lors de l’exécution d’une classe instrumentalisée, vous obteniez le message suivant (alors que cette même classe non instrumentalisée fonctionne parfaitement) :

org.springframework.beans.ConversionNotSupportedException: Failed to convert property value of type '$Proxy17 implementing net.sourceforge.cobertura.coveragedata.HasBeenInstrumented,org.springframework.aop.SpringProxy,org.springframework.aop.framework.Advised' to required type 'fr.j2ltho.impression.ImpressionManager' for property 'impressionManager';

nested exception is java.lang.IllegalStateException: Cannot convert value of type [$Proxy17 implementing net.sourceforge.cobertura.coveragedata.HasBeenInstrumented,org.springframework.aop.SpringProxy,org.springframework.aop.framework.Advised] to required type [fr.j2ltho.impression.ImpressionManager] for property 'impressionManager': no matching editors or conversion strategy found
org.springframework.beans.BeanWrapperImpl.convertForProperty(BeanWrapperImpl.java:462)

Dans mes fichiers de configuration Spring j’avais la déclaration suivante :

<context:annotation-config/>

Pour Spring cela correspond à l’utilsation d’aspectJ avec le défaut suivant <aop:aspectj-autoproxy/>.

Pour résoudre le problème j’ai juste ajouté la ligne suivante en gras :

<context:annotation-config/>

<aop:aspectj-autoproxy proxy-target-class="true" />

Cela a fait disparaitre mon erreur et j’ai pu continuer mes tests.

Conclusion

Nous avons fait un rapide tour de l’utilisation de Cobertura dans un contexte JEE. Vous pouvez maintenant valider si vos tests couvrent la totalité de votre code.

Le bon fonctionnement de ces tests reposent sur la capacité du serveur d’application à trouver le bon fichier cobertura.ser et à le mettre à jour. L’emplacement où un serveur d’application cherche se fichier reste pour moi un grand mystère. Dans le cas d’un serveur Tomcat démarré avec startup.bat il se trouve dans le répertoire Tomcat/bin. Dans les autres as, je vous laisse découvrir son emplacement. Une solution consiste à lancer votre serveur sur des classes instrumentalisées sans ajouter le fichier cobertura.ser. Il créera à la fin de l’exécution un nouveau fichier cobertura.ser vide mais qui vous indiquera son emplacement.

L’autre difficulté de l’utilisation avec un serveur d’application est le mécanisme de terminaison qui doit être utilisé. Cobertura semble placer une sorte de hook sur un certain type de sortie violente (le Ctrl C notamment). Il faut passer par ce hook, pour qu’il mette à jour le fichier cobertura.ser. Pour certaine configuration et certain serveur, l’arrêter en déclenchant ce hook peut être difficile à mettre en œuvre. Pour Tomcat, il suffit de démarrer avec Startup.bat et de l’arrêter avec Ctrl C.

Je prévois d’écrire rapidement, un second billet qui se concentrera sur l’opportunité et l'intérêt d’utiliser Cobertura dans un projet.

Perte d’accès à Google Sites suite à abonnement à Google Apps

2010-04-18T22:22:00.001+02:00

Nous utilisons depuis déjà un peu plus d’un an Google Sites comme outil de travail collaboratif. Il y a quelques jours nous avons lancé une expérimentation avec Google Apps afin de remplacer notre serveur Exchange. Surprise, je n’arrive plus à me connecter à Google Sites. Il se trouve que le compte utilisé comme login à Google Sites n’est pas un compte GMAIL mais mon email professionnel : le même que celui qui a est passé dans Google Apps.

Le symptôme est très particulier : quand je me connecte à Google Sites, il me redirige vers la mire de connexion Google Apps. Si j’utilise mon mot de passe Google Apps, je me connecte mais je ne vois pas le site.

On dirait que j’ai deux comptes qui correspondent à la même adresse email :

le premier en tant qu’un indivu isolé : c’est celui qui autorise l’accès à mon Google Sites
le second en tant que membre d’une société dont le compte est géré par Google Apps

Google Sites semble vérifier s’il existe un compte Google Apps correspondant et bascule vers ce dernier s’il existe.

Google Docs sépare les deux environnements, les urls pour Google Docs personnels et Google Docs pour Google Apps diffèrent : il est donc possible de séparer les deux connexions. Je n’ai donc pas de problème sous Google Docs.

Pour résoudre le problème Google Sites, j’ai utilisé la procédure suivante qui ma permis de changer le login personnel qui correspondait à mon adresse professionnel (disons prenomnom@masociete.com)

Pour cela, il faut une autre adresse email personnel qui ne soit pas affectée à Google (disons alias@yahoo.fr pour faciliter la compréhension de la manœuvre).

On se connecte à https://www.google.com/accounts/ManageAccount pour accéder aux informations de son compte prenomnom@masociete.com. On utilise son login personnel avec son email professionnel (prenomnom@masociete.com).

On arrive sur la page Google comptes. Dans la rubrique Sécurité, il y a un lien “Modifier l’adresse e-mail”. Cliquez dessus.

La page Modifier l’adresse e-mail (URL https://www.google.com/accounts/EditEmail) s’affiche.

Dans nouvelle adresse e-mail vous avez votre adresse email professionnelle qui correspond à votre compte (prenomnom@masociete.com). Il faut taper une autre adresse email (alias @yahoo.fr). Saisir un mot de passe. Et appuyer sur “Enregistrer l’adresse e-mail”

Vous allez recevoir un email qui vous demandera de confirmer l’adresse en cliquant sur le lien. Cliquer sur le lien de confirmation dans l’email.

Une fois la confirmation faite, vous pouvez vous reconnecter au compte en utilisant la nouvelle adresse email (alias @yahoo.fr) et le mot de passe spécifié.

Attention ! ce changement affecte également Google Docs, iGoogle et tout les autres services. Il est maintenant possible de se reconnecter à Google Sites avec le nouvel email (alias @yahoo.fr).

J’espère que ce billet aura permis à d’autre de résoudre la mésaventure qui m’est arrivé. Notez que cette procédure permet de changer son login pour un compte Google.

Installation de JBoss 5.1 sur Windows 7 64 bits

2010-03-05T14:48:00.001+02:00

JBoss nécessite un JDK 5 ou 6. Le JDK n’est pas installé par défaut sur une machine. Seul la JRE est installé.

Installation d’un JDK 6 pour Windows 7 64 bits

Sur le site http://developers.sun.com/downloads/ on choisit le nœud Java SE de la liste des téléchargement puis on clique sur Java SE (JDK) 6.

Ensuite je choisis la version JDK 6 update 18 et non pas le Development Kit Bundle.

Il existe un installeur spécifique à Windows 64 bits : jdk-6u18-windows-x64.exe.

On exécute l’exe téléchargé. Le UAC demande l’acceptation des modifications faites par le programme.

Personnellement, j’ai supprimé le Source code.

On appuie sur Next > ce qui lance une première partie de l’installation.

A la fin, une nouvelle dialogue apparaît :

L’apparition de cette dialogue doit correspondre au choix de l’option Public JRE du premier setup.

Je confirme l’installation de la JRE. L’installation se poursuit.

J’ai maintenant dans mon répertoire C:\Program Files\Java deux sous répertoires :

jdk1.6.0_18 : le jdk. C’est nécessaire pour compiler des classes java ou des JSP.
jre6 : le runtime java. Ce répertoire existait déjà

Installation de JBoss 5.1

Le téléchargement d’un serveur JBoss commence à la page suivante : http://www.jboss.org/jbossas/downloads/

Il faut choisir Download pour le serveur 5.1. Un message d’avertissement s’affiche en indiquant qu’ils’agit d’une version Community ne disposant pas de support. Il faut continuer.

Sur la page suivante, on choisit la ligne jboss-5.1.0.GA-jdk6.zip.

Attention ! il y a deux versions différentes de JBoss 5.1 : une version pour le jdk 1.5 et une version pour le jdk 1.6. Ne vous trompez pas !

Le téléchargement commence.

Je dezippe le fichier téléchargé jboss-5.1.0.GA-jdk6.zip et le copie directement sous C:\ de façon à avoir : C:\jboss-5.1.0.GA.

Modification de run.bat

Dans le répertoire C:\jboss-5.1.0.GA\bin j’ouvre en modification le fichier run.bat.

On ajoute en première ligne du bat :

Set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_18

Il s’agit a priori de l’emplacement de votre jdk 1.6 64 bits. Sous Windows 7, un JDK 64 bits s’installe sous C:\Program Files.

Personnellement, je ne positionne pas la variable d’environnement JBOSS_HOME. Le bat run.bat semble être capable de la positionner correctement tant qu’on le lance depuis son répertoire d’installation.

Rappel de l’organisation des répertoires

Si vous avez installé JBoss dans le répertoire C:\jboss-5.1.0.GA, voici un rapide tour d’horizon des quelques répertoires les plus importants pour le développement.

C:\jboss-5.1.0.GA\bin : répertoire dans lequel se trouve run.bat qui permet de lancer le serveur
C:\jboss-5.1.0.GA\common\lib : répertoire permettant d’ajouter un jar qui sera commun à toutes vos applications et toutes vos configurations. C’est là qu’on ajoute généralement les jar permettant l’accès à la base de données.
C:\jboss-5.1.0.GA\server\default\lib : répertoire commun à toutes vos applications de la configuration “default”
C:\jboss-5.1.0.GA\server\default\tmp : répertoire temporaire qui semble être utilisé par le déploiement. Il peut être supprimé sans problème en phase de développement. Il sera recréé au prochain lancement du serveur.
C:\jboss-5.1.0.GA\server\default\log : répertoire contenant la log du serveur quand on utilise la configuration “default”. Le fichier server.log contient la log Log4j de votre application.
C:\jboss-5.1.0.GA\server\default\deploy : répertoire de déploiement de vos war pour la configuration “default”. Glisser/déposer un war dans ce répertoire est la seule opération à faire pour déployer une application sur un serveur JBoss.

Pour finir, il reste

C:\jboss-5.1.0.GA\lib : auquel il ne faut pas toucher. Il contient les jar du serveur. Ce répertoire ne doit plus être utilisé, il faut favoriser (a priori) le répertoire C:\jboss-5.1.0.GA\server\default\lib qui n’affectera que la configuration par default.

Rappel sur les configurations de JBoss

Par défaut, JBoss livre 5 configurations :

all
default : celle qui est utilisé quand on lance run.bat sans paramètre
minimal
standard : c’est la config JavaEE de JBoss
web : cela semble être une configuration légère.

Personnellement je n’utilise que default car elle semble contenir ce dont j’ai besoin et elle possède l’avantage d’être simple à lancer.

Test de l’installation

Pour lancer le serveur JBoss, on double clique sur le bat : run.bat qui se trouve dans C:\jboss-5.1.0.GA\bin. Un message vous demande de confirmer son exécution, il faut l’acquitter.

Windows 7 affiche un message d’alerte du parefeu : il faut l’accepter.

Quand le lancement du serveur est terminé, la boite de commande affiche une ligne :

2010-03-05 13:19:49,240 INFO [org.jboss.bootstrap.microcontainer.ServerImpl] (main) JBoss (Microcontainer) [5.1.0.GA (build: SVNTag=JBoss_5_1_0_GA date=200905221634)] Started in 1m:7s:671ms

Votre serveur JBoss s’exécute avec la configuration par défaut : default.

Taper dans un navigateur : http://localhost:8080/

Vous devriez voir apparaître dans votre navigateur :

Si vous cliquez sur le lien JBoss Web Console, vous obtenez un second écran :

Dans la partie JVM Hardware vous pouvez vérifier la JVM utilisée :

JVM Name : Java HotSpot(TM) 64 bits Server VM

Cela indique que vous utilisez bien le JDK 64 bits.

Vous pouvez également ouvrir le Gestionnaire de tâches Windows : tapez Processus et sélectionnez “Affichez les processus en cours d’exécution avec le Gestionnaire de tâche”.

Le gestionnaire de tâches indique si le processus java.exe est ou non en 32 bits :

java.exe *32 : s’il s’agit d’un process 32 bits
java.exe : s’il s’agit d’un process 64 bits.

Pour arrêter le serveur JBoss, il suffit de taper Ctrl C dans la console DOS.

Conclusion

L’installation de JBoss 5.1 demande de faire particulièrement attention au JDK utilisé (5 ou 6) : en fonction de ce dernier il faudra télécharger le bon zip de JBoss.

JBoss étant un processus Java, c’est la JVM utilisée qui fera ou non fonctionner JBoss 5.1 en 32 ou 64 bits.

Pour finir, l’installation décrite dans ce billet correspond à une installation pour un poste développeur : elle ne prend pas en compte la problématique de la sécurité et ne sera de toute façon pas visible depuis un autre poste. Seule l’adresse localhost fonctionnera (c’est la cas depuis au moins la 4.2).

Petit guide de survie MySql pour le développeur

2010-03-03T16:22:00.001+02:00

Dans ce billet, je vais essayer de faire un tour rapide des différentes fonctions de MySql dont un développeur peut avoir besoin. Cela va comprendre :

le démarrage et arrêt d’un serveur MySql
la création/destruction d’une base MySql
l’import/export d’une base MySql
la consultation du contenu d’une base MySQL en mode commande
la configuration d’hibernate pour accéder à une base MySQL

Ces mécanismes ont été testé sur un serveur MySql 5.0 sous XP ou 5.1 sous Windows 7 64 bits.

MySql pour Windows 7 64 bits

Avant de commencer, je tiens à indiquer l’existence d’une version 64 bits de MySql pour Windows 7. Le msi porte le nom de “mysql-5.1.43-winx64.msi”.

Il s’installe correctement dans le répertoire “C:\Program Files\MySQL\MySQL Server 5.1” qui correspond à l’emplacement pour les process 64 bits.

Je l’ai installé en tant que service que je démarre manuellement.

Cette dernière version ne semble plus accepter un mot de passe vide pour root.

Démarrage et arrêt d’un serveur MySql

Le démarrage et l’arrêt dépendent de votre installation du serveur MySql entant que service ou non.

MySql n’est pas un service

Pour démarrer est arrêter MySql s’il n’est pas installé en tant que service, je crée deux fichiers BAT mais les lignes qu’ils contiennent peuvent être tapés directement en ligne de commande :

Pour démarrer le serveur :

"C:\Program Files\MySQL\MySQL Server 5.0\bin\mysqld" --console

Pour arrêter le serveur :

"C:\Program Files\MySQL\MySQL Server 5.0\bin\mysqladmin" -u root shutdown

Attention les doubles quotes (“) servent à prendre en compte les espaces et doivent se terminer impérativement à la fin de la commande (avant ses paramètres).

Vérifiez bien le répertoire d’installation de votre MySQL, celui-ci a un impact sur la commande donnée ci dessus.

MySql est un service

J’utilise l’interface de service de Windows : dans Windows 7, j’ai “Epinglé le programme dans la barre de tâche”. Pour cela, il suffit de cliquer droit sur son icône une fois qu’il a été lancé et de choisir “Epingler ce programme dans la barre de tâche”. Pour le relancer, il vous suffit de cliquer une fois dessus.

Pour le démarrer sous Windows 7, si on n’a pas fait un raccourci, je tape Services dans la zone de saisie et je sélectionne le programmes Services (et non pas services.exe).

Il est également possible de passer par le panneau de configuration, puis "outils d’administration” et Services.

Une fois la fenêtre “Service” ouverte, il suffit de sélectionner le Services (local) MySQL dans la liste puis d’appuyer sur le lien Démarrer pour le démarrer ou Arrêter pour l’arrêter.

Créer ou détruire une base MySQL

Par défaut il existe une base test. Vous pouvez avoir besoin de créer une base particulière pour une démo ou un développement particulier si vous travaillez sur plusieurs projets.

Avec ce mécanisme les données des différentes bases sont isolées. Vous pouvez sans risque non seulement ajouter des données à une base sans impacter l’autre mais vous pouvez même créer des tables avec un même nom et des structures différentes dans deux bases différentes.

Pour commencer, il est impératif que le serveur MySQL fonctionne (Voir comment démarrer le serveur MySQL dans le chapitre précédent).

Ensuite, nous allons lancer une console de commande sur MySQL. Pour cela, on ouvre une console DOS, en tapant par exemple cmd.exe.

Au prompt, on se déplace dans le répertoire contenant le binaire MySQL :

cd C:\Program Files\MySQL\MySQL Server 5.0\bin

Puis on tape :

mysql –uroot –pmonmotdepasse

Où root est l’utilisateur et monmotdepasse le mot de passe de cet utilisateur root.

Pour créer la base, on tape :

create database nombase;

Où nombase est le nom que vous voulez donner à votre base (évitez test qui est déjà utilisé).

Pour utiliser la base, il faut faire ensuite :

use nombase;

ce qui permet de se mettre dans la base concernée.

Pour détruire une base, il suffit de taper :

drop database nombase;

Attention ! aucun message de confirmation n’est affiché. Vous perdez tout : donnée et structure de la base.

Export/Import d’une base de données MySQL

Pour faire ces opérations, il faut que la base de départ de l’export fonctionne ainsi que celle d’arrivée pour l’import. Pour démarrer une base MySQL voir le chapitre précédent.

Exporter une base MySQL

L’opération est réalisé à partir du mode ligne de commande de MySQL. Il faut démarrer une console DOS grâce à cmd.exe. Ensuite, on doit réaliser les étapes suivantes :

Se positionner sur le répertoire bin de MySQL
Faire le dump.

cd C:\Program Files\MySQL\MySQL Server 5.0\bin

mysqldump nombase –uroot –pmonmotdepasse > nomfichier.log

Où :

nombase est le nom de la base MySQL
root est le nom de l”utilisateur (dans un contexte de développement, on utilise souvent l’administrateur par défaut)
monmotdepasse est le mot de passe de l’utilisateur root
nomfichier.log est le nom du fichier d’export. Il sera créé dans le répertoire où l’on se trouve. En l’occurrence “C:\Program Files\MySQL\MySQL Server 5.0\bin”.

Le fichier créé était dans mon cas au format ANSI. Ma base était au format ANSI.

Importer une base MySQL

L’opération est réalisé à partir du mode ligne de commande de MySQL. Le fichier a été exporté avec le mécanisme précédemment décrit. Il faut démarrer une console DOS grâce à cmd.exe. Ensuite, on doit réaliser les étapes suivantes :

Se positionner sur le répertoire bin de MySQL
Se connecter au serveur MySQL
Créer la base MySQL dans laquelle l’import va être réalisé
Se positionner sur la base
Importer (commande source)

cd C:\Program Files\MySQL\MySQL Server 5.1\bin

mysql –uroot –pmonmotdepasse

create database nombase;

use nombase;

source c:/nomfichier.log

Où :

nombase est le nom de la base MySQL
root est le nom de l”utilisateur (dans un contexte de développement, on utilise souvent l’administrateur par défaut)
monmotdepasse est le mot de passe de l’utilisateur root
nomfichier.log est le nom du fichier d’export. Il avait été placé dans le répertoire C:\. Notez que j’utilise la syntaxe C:/ au lieu de C:\ car l’antislash est un caractère d’échappement pour MySQL.

Dans mon cas, le fichier créé était au format ANSI. Ma base destination était quant à elle au format UTF-8. En faisant simplement l’import, les caractères accentués ne sont plus affichés au bon format. Pour résoudre le problème, j’ai utilisé PSPad pour passer le format de mon fichier en UTF-8. Il suffit juste dans le menu Format de sélectionner UTF-8 au lieu de ANSI.

Consulter les données d’une base MySQL

Avant toute chose, le serveur MySQL doit être démarré (voir pour cela le second chapitre de ce billet).

L’opération est réalisé à partir du mode ligne de commande de MySQL.Il faut démarrer une console DOS grâce à cmd.exe. Ensuite, on doit réaliser les étapes suivantes :

Se positionner sur le répertoire bin de MySQL
Se connecter au serveur MySQL
Se positionner sur la base
Taper les commandes SQL

cd C:\Program Files\MySQL\MySQL Server 5.1\bin

mysql –uroot –pmonmotdepasse

use test;

Où :

test est le nom de la base MySQL
root est le nom de l”utilisateur (dans un contexte de développement, on utilise souvent l’administrateur par défaut)
monmotdepasse est le mot de passe de l’utilisateur root

Les commandes SQL les plus classiques sont :

show tables; : liste les tables de la base
desc nomtable; : donne la description de la structure de la table nomtable
select * from nomtable where …; : liste les données d’une table. Attention à préciser une where clause si vous ne voulez pas parcourir toutes les données d’une table
select count(*) from nomtable where…; : compte le nombre d’enregistrement de la table qui vérifie la where clause. Il peut être judicieux d’utiliser cette commande avant d’utiliser la précédente.
show variables like ‘character_set%’; permet de connaitre le charset de la base.

Pour quitter, il suffit de taper :

exit

Configuration d’hibernate.cfg.xml pour MySQL

Pour utiliser hibernate, il faut définir un fichier hibernate.cfg.xml (généralement placé sous src) qui contient les informations nécessaires à hibernate pour se connecter à la base MySQL.

<session-factory >
    <property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
    <property name="hibernate.connection.url">jdbc:mysql://localhost/test</property>
    <property name="hibernate.connection.username">root</property>
    <property name="hibernate.connection.password">monmotdepasse</property>
    <property name="hibernate.dialect">org.hibernate.dialect.MySQL5InnoDBDialect</property>

</session-factory>

Où :

test est le nom de la base MySQL
root est le nom de l”utilisateur (dans un contexte de développement, on utilise souvent l’administrateur par défaut)
monmotdepasse est le mot de passe de l’utilisateur root

Il faut également un jar MySQL. Ce jar MySQL “mysql-connector-java-5.0.8-bin.jar” peut se placer en deux endroits :

directement dans le répertoire lib de votre installation Tomcat : Par exemple : “C:\Program Files\Apache Software Foundation\Tomcat 6.0\lib”. dans ce cas, le jar MySQL sera disponible pour toutes les applications Web de ce serveur Tomcat
soit dans le répertoire WebContent/WEB-INF/lib de votre projet. Dans ce cas, il faudra répéter l’opération autant de fois que nécessaire (pour chaque projet)

La seconde solution n’a de sens que dans le cas de demo ou d’exemples qui ne rentre pas dans un processus normal d’exploitation : on recherche l’autonomie et la facilité sans aucun besoin de traçabilité. C’est pour cela qu’on va intégrer le driver MySQL dans son package de déploiement.

La philosophie de JEE correspond à la première solution : installation dans les librairies du serveur JEE. La base de donnée est quelque chose de suffisamment sérieux pour que l’exploitation soit concernée par le sujet et doive établir une traçabilité des versions utilisées.

Conclusion

Ce billet a pour vocation de donner à un développeur le minimum nécessaire pour se sentir à l’aise dans la manipulation de MySQL. Les informations de ce billet ne doivent être en aucun cas utilisées comme ligne de conduite pour l’installation et le déploiement d’une base MySQL en production.

Pour compléter les aspects développements, vous pouvez lire mon billet sur les types de données JPA et Hibernate qui montre les relations entre les types MySQL et les annotations JPA.

Fichier invisible dans l’explorateur Windows 7 64 bits

2010-02-25T18:09:00.001+02:00

Ce billet est un nouvel épisode dans ma tentative de prise de contrôle de ma nouvelle machine Windows 7 64 bits.

Windows 7 64 bits (mais cela est probablement déjà le cas en Vista 64 bits) possède une notion de VirtualStore qui est susceptible de poser quelques problèmes surprenants. J’en ai détecté deux :

le fichier que j’ai créé avec un programme 32 bits (en l’occurrence Eclipse) dans un répertoire (en l’occurrence un sous répertoire de ProgramFiles) n’apparait pas quand je passe par l’explorateur.
depuis une application 32 bits (NS-DK ou NatStar en l’occurrence) les valeurs que je lis dans un fichier (en l’occurrence dans un sous répertoire de ProgramFiles(x86)) ne sont pas celles que je peux lire quand j’ouvre le même fichier par l’explorateur.
depuis une application 32 bits (la même que précédemment) j’arrive à lire un fichier (en l’occurrence dans un sous répertoire de ProgramFiles(x86)) qui n’est pas visible dans l’explorateur alors que j’affiche les fichiers cachés (c’est en fait un doublon du premier cas)

L’explication de ce phénomène est la création par le système d’un VirtualStore. Le signe visuel que vous avez qu’un VirtualStore qui correspond à votre répertoire a été créé est la présence d’un bouton “Fichiers de compatibilité” dans la barre d’outil de l’explorateur.

Remarquez dans l’exemple ci-dessus, la présence de deux fichiers :

DemoNatJetCompleted.war le 18/02/2010 à 11:20
NatJxt3DemoMultiPannel.war le 30/05/2008

On est dans le répertoire “C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps”. Les deux fichiers présents on été copié à la main par l’explorateur. Le processus Tomcat 64 bits détecte correctement ces deux fichiers.

Si on appuie sur le bouton “Fichiers de compatibilité”, on bascule vers le répertoire “C:\Users\jltho.NATSYSTEM\AppData\Local\VirtualStore\Program Files\Apache Software Foundation\Tomcat 6.0\webapps” du VirtualStore.

On a maintenant deux fichiers :

DemoNatJetCompleted.war du 17/02/2010 à 18:41 : sa date indique qu’il est plus ancien que celui qu’on voyait plus haut.
NatVie30WF

Ces deux fichiers ont été créé directement depuis un Eclipse 32 bits par la fonction Export/War… Le processus Tomcat ne voit pas ces deux fichiers. Eclipse lui les voit.

Dans le cas de mon application NatStar/NS-DK (il s’agit d’un binaire 32 bits à base de C), le problème était encore plus surprenant : le fichier du VirtualStore a été créé par un autre mécanisme (mon application consulte le fichier exclusivement en lecture). Mon application lisait pourtant ce fichier du VirtualStore. Quand je modifie le fichier dans le répertoire d’origine en passant par l’explorateur, les modifications que je réalise ne sont pas visibles par l’application : elle continue de lire les anciennes valeurs. Si je supprime le fichier dans le répertoire d’origine (ProgramFiles(x86)), l’application continue d’être capable de lire les données alors que depuis l’explorateur je ne vois rien.

Pour info, nous avons détecté le problème grâce à l’utilisation de Process Monitor qui nous a permis de constater que le process ne lisait pas dans le répertoire ProgramFiles(x86) mais dans un autre répertoire.

Une fois dans le VirtualStore (grâce au bouton), vous pouvez surprimer les fichiers. Dans le cas de mon application NatStar/NS-DK, elle s’est mise à lire le bon fichier et ne l’a pas recréé dans le VirtualStore. J’ai modifié ce fichier par l’explorateur depuis, sans que le VirtualStore ne soit recréé.

La règle que l’on peut déduire est la suivante :

si un process 32 bits écrit dans certains répertoires (a priori ProgramFiles(x86) et ProgramFiles), le système redirige son écriture dans un autre répertoire physique : le VirtualStore
si une application 32 bits lit un fichier dans un répertoire possédant un VirtualStore, elle lit en premier lieu le fichier s’il existe dans le VirtualStore. Si le fichier n’existe pas dans le VirtualStore et seulement dans ce cas, il va lire le fichier dans le répertoire d’origine.

On constate que pour un processus 32 bits, c’est le fichier dans le VirtualStore qui prévaut.

Pour un processus 64 bits, il ne voit que le répertoire d’origine.

Comment savoir pourquoi un fichier a été virtualisé ?

Cela est possible en utilisant l’Observateur d’événements de Windows 7. Il s’ouvre en tapant dans la zone de commande : Obs puis en sélectionnant ce dernier dans la liste qui apparait.

La rubrique qui nous intéresse est : “Journaux des applications et des services” puis “Microsoft” puis “Windows” puis “UAC-FileVirtualization”. On clique sur le nœud Opérationnel, une liste apparait. Les événements d’ID 4000 indiquent les création de fichiers de virtualisation.

En cliquant sur l’onglet détail, il est possible de savoir qui a créé le fichier concerné :

On voit ainsi qu’un fichier war temporaire a été créé dans le VirtualStore par un process javaw.exe lancé depuis un répertoire C:\NatJet3.0.2\thirdparty\jdk1.5.0_15\bin.

C’est grâce à cela que j’ai compris comment pour mon application NatStar, les fichiers de Virtualisation avaient été créé : il s’agissait de la procédure d’installation de mon application qui lançait un processus 32 bits (switch.exe) pour faire des substitutions dans les fichiers installés dans ProgramFiles(x86).

Conclusion

Ce mécanisme de virtualisation est très surprenant : la volonté de Microsoft semble avoir été d’augmenter la compatibilité des nombreuses applications qui ne respectent pas les droits sur les répertoires ProgramFiles. Cela afin de faciliter la migration lors du passage à Vista : avant Vista les applications avaient les privilèges d’un administrateur, depuis elles tournent avec els droits d’un simple utilisateur : elles n’ont plus le droit d’écrire n’importe où.

Vous trouverez plus d’information sur le sujet dans les deux pages suivantes :

http://support.microsoft.com/kb/927387 : elle présente d’autres problèmes liés à la virtualisation
http://windowsteamblog.com/blogs/developers/archive/2009/08/04/user-account-control-data-redirection.aspx : un très bon article en anglais qui explique le fonctionnement de la virtualisation et ses raisons. Il décrit également l’utilisation de Proc Monitor pour détecter les applications qui déclenche la virtualisation.

Problème pour définir une variable d’environnement utilisant ProgramFiles(x86)

2010-02-23T14:57:00.001+02:00

Je fais ce rapide billet suite à un problème de configuration dans un fichier cmd sous Windows 7 64 bits.

Windows 7 64 bits définit deux variables d’environnement et deux répertoires :

ProgramFiles(x86) qui pointe vers C:\Program Files (x86) : c’est là que sont installés normalement les programmes 32 bits.
ProgramFiles qui pointe vers C:\Program Files qui s’appelle dans l’explorateur Programmes : c’est le répertoire qui contient les programmes 64 bits.

Cette distinction devait déjà exister sous Vista 64 bits. Elle n’est visible que si l’OS est 64 bits. Sur une version 32 bits, il n’existe que ProgramFiles.

Pour savoir si l’OS est 32 ou 64 bits, la variable d’environnement PROCESSOR_ARCHITECTURE peut être utilisée : elle prend les valeurs :

AMD64 pour du 64 bits
x86 pour du 32 bits

Cette variable existe déjà sous Windows XP et elle prend bien x86 sous un environnement 32 bits.

Les applications qui m’intéressent utilisent un cmd qui positionne les variables d’environnement à son exécution (un mécanisme commun pour les applications NS-DK ou NatStar), le répertoire de base de mon application est sous %ProgramFiles% en 32 bits. Lors du passage sous 64 bits, le binaire restant un binaire 32 bits, il s’installe sous %ProgramFiles(x86)% j’ai donc cherché à redéfinir mes différentes variables d’environnement pour le cas du 64 bits. Je passe par une variable d’environnement local au cmd et temporaire PRGROOT afin d’éviter de modifier toutes les définitions.

J’ai commencé par faire :

if "%PROCESSOR_ARCHITECTURE%" == "AMD64" (
SET PRGROOT=%programfiles(x86)%
)
if "%PROCESSOR_ARCHITECTURE%" == "x86" (
SET PRGROOT=%programfiles%
)

Et là bizarrement, PRGROOT prend la valeur C:\Program Files (x86 sans la parenthèse fermante.

Après de nombreux essais, j’ai essayé la syntaxe (notez l’utilisation de guillemet autour de l’affectation complète)

if "%PROCESSOR_ARCHITECTURE%" == "AMD64" (
SET "PRGROOT=%programfiles(x86)%"
)
if "%PROCESSOR_ARCHITECTURE%" == "x86" (
SET PRGROOT=%programfiles%
)

Et là, tout se passe bien : je retrouve ma parenthèse fermante.

J’espère que ce billet sera utile à d’autres. On dirait qu’il y a un petit bug dans le cas du IF : il remplace %programfiles(x86)% par sa valeur puis, il fait l’affectation. Il prend la parenthèse fermante pour la fin du IF et non pas comme faisant partie de la valeur qu’il doit affecter. Les guillemet le force à considérer la parenthèse fermante comme faisant partie de l’affectation.

Problème de connexion Wifi avec une FreeBox

2010-02-21T19:52:00.001+02:00

Ceci est un rapide billet pour éviter que d'autres restent bloquer par le problème que j'ai rencontré avec ma FreeBox.

Le symptôme est plus ou moins simple : impossibilité de rejoindre le réseau Wifi de sa propre FreeBox. Le réseau est effectivement visible mais quand on tape la clé WEP/WAP que l'on a sur l'interface de sa FreeBox HD, la connexion est refusée. Il peut même arriver que l'on saisisse une clé trop longue supérieure aux 63 caractères attendus (mais là, suivant l'interface utilisée on sera ou non prévenu).

Il se trouve que mon réseau Wifi fonctionne, j'ai un autre PC connecté qui l'atteste.

La cause du problème est l'interface de la FreeBox HD : j'ai préféré utiliser celle-ci plutôt que d'utiliser l'interface Web de la FreeBox. L'interface de la FreeBox HD est accessible sur la télé après l'appuie sur le touche FreeBox de la télécommande puis on va dans Paramètres. La rubrique Wifi, indique la clé du réseau. La version actuel du FirmWare possède un bug pour les caractères > mais je suppose que c'est également vrai pour < : il ne les affichent pas correctement, il les remplace par leur code html : &gt et j'imagine &lt.

Le résultat des courses : vous saisissez une clé erronée qui sera trop longue (supérieure à la limite de 63 caractères).

La bonne solution est définitivement de passer par l'interface Web de votre FreeBox : http://subscribe.free.fr/login/. Cela nécessite au préalable de se connecter par un câble Ethernet à la freebox. Tapez l'adresse, puis cliquez sur Internet et pour finir choisissez le lien "Configurer mon réseau Wifi".

La valeur de votre clé WAP se trouve tout en bas de votre page. Il suffit de la copier/coller dans le mot de passe demandé pour votre réseau Wifi. une fois l'opération terminée vous pouvez débrancher le câble Ethernet.

J'espère que ce rapide billet aura aidé d'autres freenautes. Et dire que j'ai failli accuser Windows 7 !!!

Windows 7 et un serveur Samba

2010-02-16T12:00:00.001+02:00

Comme je viens de recevoir un nouveau portable Dell XT2 sous Windows, il s’agit probablement du premier billet d’une série sur Windows 7 que je compléterai au grés de mes problèmes ou découvertes.

J’ouvre la série avec un problème. Voilà qu’il m’est impossible de me connecter à un disque Samba. J’ai beau essayer différents comptes utilisateurs rien n’y fait. La même erreur revient.

Une petite recherche google, nous amène directement sur des articles qui indiquent une configuration minimum de Samba 3.4 pour une connectivité avec Windows 7 :

Alors que notre vieux serveur Samba est en 3.0.

Non content de cette réponse, je continue de chercher ce qui a pu être modifié entre XP et Seven. J’ai finis par comprendre que cela devait être la stratégie de sécurité. Que ce soit sous XP ou Windows 7, vous pouvez définir cette stratégie dans l’écran “Stratégie de sécurité locale” accessible depuis : Panneau de configuration –> Outils d'administration –> Stratégie de sécurité locale.

Dans cet écran, il faut ensuite choisir “Stratégies locales” puis “Options de sécurité”. Une série d’options apparait.Celles qui nous intéressent sont :

Sécurité réseau : niveau d'authentification LAN Manager : Non défini
Sécurité réseau : sécurité de session minimale pour les clients basés sur NTLM SSP (y compris RPC sécurisé) : Exiger un niveau de chiffrement à 128 bits.
Sécurité réseau : sécurité de session minimale pour les serveurs basés sur NTLM SSP (y compris RPC sécurisé) : Exiger un niveau de chiffrement à 128 bits.

Une comparaison avec un poste XP ainsi que la lecture de l’aide Microsoft, indique que le défaut de ces valeurs a été modifié entre XP/Vista d’un coté et Windows 7 de l’autre.

Alors que “Sécurité réseau : niveau d'authentification LAN Manager” vaut “Non défini en Seven, il valait “Envoyer les réponses LM et NTLM”.

De même les deux “Sécurité réseau : sécurité de session minimale pour les XXXXX basés sur NTLM SSP (y compris RPC sécurisé)” valent “Pas de minimum” sous XP et Vista alors qu’on a “Exiger un niveau de chiffrement à 128 bits” sous Windows 7.

NTLM SSP (NT Lan Manager Security Support Provider) est le mécanisme utilisé par Samba pour vérifier les authentifications avec les clients Windows. Le support des différents paramètres de configuration dépend une double cohérence entre les serveurs et les clients.

LM (Stimulation/réponse LAN Manager) est le protocole le plus ancien assurant la compatibilité avec les postes Windows 95 et 98
NTLM offre une sécurité accrue à partir de NT.
NTLM version 2 offre une sécurité encore accrue mais exclue les postes sous Windows 95 et nécessite l’installation d’une extension du client Active Directory pour 98.

Dans notre cas, Samba 3.0 doit être capable de supporter NTLM version 2, je pense que mon problème était principalement du à l’encryption 128 bits.

Bizarrement, si je revient en

Sécurité réseau : niveau d'authentification LAN Manager : Envoyer LM et NTLM – utiliser la sécurité de session NTLM2 si négociée
et “Exiger un niveau de chiffrement à 128 bits” pour les deux autres,

ma connexion reste établie même après un reboot. cela voudrait dire que l’authentification est négociée une fois pour toute.

iPad innovation et monde de l’entreprise

2010-01-30T20:59:00.001+02:00

Il y a deux jours, Apple lançait son nouveau produit et on retrouve les mêmes remarques qu’à la sortie de l’iPhone :

ce n’est pas une innovation , il n’y a rien de nouveau c’est juste du marketing…
il manque le flash
il n’y a pas de caméra
Il n’est pas multitâche

Il est surprenant que la mémoire des gens soit aussi courte : la sortie de l’iphone n’a que deux ans et demi et aujourd’hui plus personne ne remet en cause le coté innovateur de l’iPhone.

Un rapide retour en arrière : Invention et innovation de l’iPhone

Les deux mots recouvrent des choses différentes :

L’essentiel des inventions de l’iPhone concerne le logiciel : sa nouvelle interface homme-machine même si la gestuelle utilisée n’avait rien de neuf (voir Surface de MicroSoft) son interface ne correspond à rien qui existait auparavant. Il fallait inventer une solution qui rentre sur un écran de 3,5” là où tout le monde travailler sur des écrans mur du type Minority Report

Coté Hardware, l’invention principal de l’iPhone est un grand écran (3,5” à une époque où grand voulait dire 2,8”) tactile, multipoint et capacitif. L’importance de cet écran a été sous-estimé : sans sa qualité l’interface aurait été inefficace et réunir les 4 paramètres dans un même écran reste encore assez rare : le dernier produit phare de Google le Nexus One ne possède d’ailleurs pas le multipoint.

Pour moi, l’innovation dépasse la capacité technique d’un appareil : il faut aller au delà du fait qu’une personne bien formée soit capable d’utiliser une fonctionnalité, il faut la rendre accessible et utilisée par le grand public. Prenons l’exemple de l’Internet et de l’iPhone, cette fonctionnalité était déjà disponible sur d’autres téléphones bien avant l’iPhone mais cette fonctionnalité était peu utilisée : entre la sortie de l’iPhone et aujourd’hui le trafic data sur le réseau américain a cru de 7000%.

L’iPhone a grâce à son interface tactile permis d’augmenter la mobilité des smartphones : avant, le smartphone était un appareil mobile mais dont l’utilisation demandé d’être arrêté : le stylet est précis mais demande du calme et de l’attention. Avec l’iPhone, on voit apparaître de plus en plus de personnes utiliser leur iPhone en se déplaçant. De plus l’iPhone est plus accessible qu’un appareil avec stylet, on l’allume puis on appuie sur l’action qu’on veut faire : on n’a pas besoin de sortir un stylet ou d’utiliser un joystick pour se déplacer. Ce point est très important pour les petites actions : s’il vous faut 4-5 s vous le faites, s’il vous faut 10 à 30s vous ne faites pas l’effort.

L’iPhone est une innovation car il a changé la façon dont les gens utilisent leur “smartphone” : ils l’utilisent dans le métro, en marchant, pour s’orienter, pour lire le journal…

L’iPad

Il s’agit en tout point d’un gros iPhone : forme, OS et absence du multitâche. Sur ce point, il diffère des tablet PC et des NetPc qui sont plus des petits PC portables. Ce n’est peut être pas une innovation mais c’est au moins un sacré pari.

Je pense que cela inverse complètement le point de vu de l’analyse de l’intérêt de l’iPad : on ajoute à l’iPhone et non pas on retire au portable.

L’iPhone est un appareil extrêmement mobile : petit, on peut l’avoir toujours sur soi, facilement accessible il est toujours disponible. Quelles sont ses limites ? L’écran et le partage :

L’écran car pour consulter des sites internet ou lire des journaux ou des livres un écran plus grand serait certainement plus confortable.
Le partage : avez vous essayer de montrer quelque chose sur votre iPhone, c’est difficile (à cause de l’écran). Il faut le passer à son interlocuteur et là, ça ne rate jamais, un doigt effleure l’écran, et ce que vous souhaitez montrer a disparu.

De mon point de vu, l’iPad remplit parfaitement ces deux objectifs : un écran plus spacieux qui répond aux deux points, mais même cette énorme marge décriée par de nombreux commentateurs y trouve son intérêt.

Certes on y perd en mobilité, il ne rentre plus dans une poche de chemise, mais on y gagne en confort d’utilisation.

Des inventions ? A part un écran tactile multi-point de grande taille, il y a peut-être la nouvelle puce A4 : il faudra voir ce point et tout particulièrement son équilibre entre puissance et consommation.

Une innovation ? Je pense que oui, le marché est mur pour un appareil permettant de lire son journal dans son fauteuil. Le public est habitué à la lecture de site internet. Les lecteurs sont matures : ils sont devenus sensibles à la fois au temps de démarrage d’un PC et au confort d’une lecture bien confortablement installé dans un fauteuil.

Les succès du Kindle d’Amazon et des NetPC sont deux bons indicateurs de l’existence d’un besoin :

la lecture sur un livre électronique pour le kindle
le PC est bien trop complet pour un grand nombre d’utilisateurs : l’utilisateur du NetPC se limite à la consultation d’internet et à la rédaction d’emails, de blogs ou de sites. Peut-être regarde-t-il ses photos et quelques video dessus mais on ne va pas beaucoup plus loin.

A priori, l’iPad répond parfaitement à ces deux tranches d’utilisateur pour un prix sensiblement identique et il offre toute une nouvelle gamme d’applications ludiques que l’on a déjà sur l’iPhone.

Beaucoup de commentateurs considèrent que le kindle 2 DX à 480$ est mort. Et les personnes qui attendaient de voir l’iPad avant d’opter pour le kindle 2, semblent décider majoritairement d’attendre la sortie de l’iPad.

L’iPad devrait être capable de capter tout ce segment d’utilisateurs qui n’ont pas réellement besoin de toute la puissance d’un PC et de les amener vers un nouveau type d’utilisation et d’application comme a su si bien le faire l’iPhone. S’il réussit, on dira dans un ou deux ans que l’iPad aura été une nouvelle innovation d’Apple.

Facteur de succès pour l’iPad

Contrairement à la majorité des commentateurs, je ne pense pas que le support du Flash ou le multi-tâche seront des éléments importants pour l’iPad.

La première inconnue et probablement la plus importante est pour moi l’accueil qui sera fait à son clavier tactile : on l’a vu plus haut, je considère qu’un des segments d’utilisateurs les plus important de l’iPad est la clientèle actuelle des NetPC dont une de leur activité principale est la saisie de documents. Ces utilisateurs seront de gros consommateur du clavier tactile et leur retour d’expérience sera très important dans le succès ou non de l’iPad.

La seconde inconnue majeure est pour moi l’autonomie de l’iPad : non pas l’autonomie de sa batterie mais le besoin ou non d’utiliser un Mac ou PC. Pourra-t-on posséder un iPad sans posséder un Mac ou PC ? Je pense que certains utilisateurs de NetPC ne possèdent pas d’autre ordinateur. J’ai du mal pour le moment à déterminer si l’iPad nécessite un autre ordinateur. Je ne vois qu’éventuellement l’activation de l’iPad qui nécessiteraient impérativement un PC. Mais sans PC, remplir l’iPad de musique ou de Photo risque d’être compliqué. Il ne semble pas non plus prévu de synchroniser un iPhone à partir d’un iPad. De manière générale, l’absence de port USB semble réduire grandement les possibilités d’indépendance de l’iPad.

Coté photo, Apple annonce déjà deux connecteurs pour l’iPad : un lecteur de carte SD pour récupérer les photos et un connecteur de type USB pour l’import des photo et video directement à partir de l’appareil. On a vu précédemment que je considérai la photo comme une des activités majeures que devraient être capable de traiter l’iPad afin de capter la clientèle des NetPC, on constate qu’Apple a pris les devant. Pour le reste, l’excellent iPhoto permettra de jouer avec ses photo dans l’iPad.

Toujours dans l’image, l’absence d’une camera video pour chatter risque de décevoir quelques utilisateurs potentiels : mais l’eco système Apple ne manquera pas de palier à cet absence qui pourra être corrigé par Apple dans une seconde version.

Personnellement le Flash ne m’a jamais manqué sur l’iPhone et je pense que le multi-tâche n’est pas nécessaire pour établir l’appareil sur le marché. Peut-être que ce dernier deviendra disponible dans les versions futures mais je ne pense pas qu’il manquera aux utilisateurs que l’iPad vise.

l’IPad en entreprise

L’iPhone n’a pas encore supplanté le BlackBerry dans l’entreprise, mais il a fait une percée du coté de nombreux administrateurs Systèmes et on commence à voir (même en France) les premières entreprises qui l’adopte.

L’iPad bénéficiera dès sa sortie d’une connectivité avec MS Exchange contrairement à l’iPhone ainsi qu’une suite d’applications iPhone dédiées à l’entreprise comme SalesForce par exemple.

Pourtant, l’iPad est un appareil dont la totalité de la présentation a concerné exclusivement les loisirs. Est-ce pour autant que l’iPad n’a pas de rôle à jouer dans l’entreprise ?

Personnellement, je pense que la population des commerciaux itinérants est une cible de choix pour l’iPad : il s’agit d’une solution légère susceptible de supporter les modes connectés et déconnectés permettant une synchronisation a posteriori. L’écran est suffisamment grand pour permettre la saisie d’un contrat ou montrer quelque chose à un client.

En usine ou atelier, il peut être utilisé pour suivre des travaux, commander des pièces ou consulter une documentation. Il faudra pour cela, que l’iPad montre de la robustesse aux éléments de ces environnements agressifs.

L’iPad avec 10h d’autonomie (si elle est réelle) permettra aux personnels médicales de faire une tournée complète. Ils pourront consulter et compléter un dossier simplement : l’interface tactile qui permet d’éviter l’utilisation d’un stylet pourrait être un plus. L’iPhone possède déjà un certain nombre d’applications professionnelles dédiées aux secteurs de la santé.

On le voit, l’iPad pourrait être un superbe appareil pour un certain nombre d’utilisations professionnelles. Cela peut être d’autant plus intéressant qu’il devrait profiter des solutions d’administration qui ont été mise au point pour l’iPhone. Pour finir, le coté ludique de l’appareil pourrait éviter la traditionnelle résistance au changement.

Dans ces différents cas, on constatera que la force de l’iPad reposera sur

une capacité à être disponible immédiatement : absence de temps de démarrage.
une grande autonomie, supérieure à la journée de travail

Conclusion

En bref, je pense que l’iPad a un fabuleux potentiel dans différents cadres d’utilisations : loisirs personnels ou professionnels itinérants.

Il deviendra une innovation majeure s’il réussit à agréger les différentes communautés disparates : lecteur d’ebook, utilisateur de NetPC… et à créer de nouvelles applications comme par exemple cet exemple de la Major BaseBall League : une application iPad entre le site internet et la télé qui permet de regarder un match tout en consultant les statistiques d’un joueur ou d’une équipe.

Une innovation ne se décrète pas : ceux sont les utilisateurs par leur adoption d’une solution qui font d’un nouveau produit une innovation. C’est eux qui décideront si l’iPad en est une. Je pense que l’appareil possède de nombreux atouts pour réussir, mais seul le marché sera le juge.

Récupérer un SID ou un login Windows depuis NatStar

2010-01-13T18:10:00.001+02:00

J’ai du récemment pour un projet ajouter une authentification intégrée à une application NatStar : l’objectif étant d’éviter à l’utilisateur de saisir un mot de passe si l’utilisateur Windows connecté est autorisé à utiliser l’application.

L’utilisateur “Windows” peut recouvrir des informations techniques différentes, dans ce billet j’en traiterai deux :

le login Windows : le nom du compte Windows utilisé pour se connecter
le SID de l’utilisateur : il s’agit d’une notion MicroSoft qui permet l’identification unique d’un utilisateur (Security ID)

La récupération de ces informations et leur utilisation depuis NatStar n’étant pas très simple, je vous propose dans ce billet une description détaillée du mécanisme.

L’exercice est fait dans le cadre de NatStar, il ne doit pas être très compliqué de l’adapter au cas NS-DK.

Les fonctions MicroSoft

Nous allons utiliser 5 fonctions MicroSoft depuis NatStar :

advapi32.GetUserNameA : Cette fonction est le point de départ du mécanisme, elle retourne le login de l’utilisateur connecté.
advapi32.LookupAccountNameA : cette fonction permet à partir du login récupéré grâce à la fonction précédente de récupérer un pointeur sur la structure SID.
Advapi32.ConvertSidToStringSidA : cette fonction permet d’obtenir à partir du SID récupéré par la fonction précédente une chaine de caractère correspondant au SID.
KERNEL32.GetLastError : cette fonction permet de récupérer le dernier message d’erreur levé par Windows. Les 3 fonctions précédentes positionnent en cas de problème cette erreur.
KERNEL32.LocalFree : cette fonction permet de libérer certaines ressources allouées par Windows. Elle permettra de libérer l’information renvoyée par ConvertSidToStringSidA.

Les 3 premières fonctions retournent 0 en cas d’erreur et une valeur différente de 0 si tout se passe bien.

LookupAccountNameA

Cette fonction a un mode opératoire peu commun : il faut l’appeler deux fois :

une première fois avec une taille à 0 et un pointeur SID à 0 : la fonction retourne alors la taille du SID. Il faut allouer alors l’espace nécessaire pour le SID.
le second appel prend l’adresse de l’espace alloué et la taille du buffer pour le remplir. On dispose alors d’un SID.

Pour corser le tout, dans le premier cas, il ne faut pas tenir compte de la valeur retournée : il y a une erreur si la taille est nulle.

Mapping des fonctions MicroSoft dans NatStar

Pour pouvoir utiliser les fonctions précédemment définies depuis NatStar nous avons du définir des fonctions Externes. Pour ce faire, nous avons créé une librairie de service dans laquelle nous avons ajouter 5 fonctions.

Pour ces 5 fonctions, le radio bouton External de la définition devra être coché.

MSGETLASTERROR% pour GetLastError

Nous commençons par la plus simple. Nous éditons la définition de la fonction. Dans la dialogue “Modify Definition for Function or Instruction MSGETLASTERROR%” on précise :

Result Type : INT (4)
External : KERNEL32.GetLastError

Cette fonction ne prenant pas paramètre, il n’y a rien d’autre à faire.

MSLOCALFREE pour LocalFree

Nous continuons par un peu plus compliqué. Nous éditons la définition de la fonction. Dans la dialogue “Modify Definition for Function or Instruction MSLOCALFREE” on précise :

Result Type : POINTER
External : KERNEL32.LocalFree

Cette fonction possède un paramètre, on ajoute donc dans l’onglet Parameters le paramètre suivant :

Name : HMEM
On coche : In
Type : POINTER
Size : vide

Pensez à appuyer sur Append puis Ok afin de ne pas perdre vos modifications.

MSGETUSERNAME% pour GetUserNameA

Nous continuons par un peu plus compliqué. Nous éditons la définition de la fonction. Dans la dialogue “Modify Definition for Function or Instruction MSGETUSERNAME%” on précise :

Result Type : INT (4)
External : advapi32.GetUserNameA

Cette fonction possède 2 paramètres, on ajoute donc dans l’onglet Parameters les paramètres suivant :

Name : LPBUFFER$
On coche : Out
Type : CSTRING
Size : 255

Pensez à appuyer sur Append puis Ok afin de ne pas perdre vos modifications, puis ajoutez le second :

Name : NSIZE%
On coche : In et Out
Type : INT
Size : 4

C’est le premier paramètre LPBuffer$ qui contiendra le nom du compte Windows de l’utilisateur.

MSGETUSERSID% pour LookupAccountNameA

Nous continuons par un peu plus compliqué. Nous éditons la définition de la fonction. Dans la dialogue “Modify Definition for Function or Instruction MSGETUSERSID%” on précise :

Result Type : INT (4)
External : advapi32.LookupAccountNameA

Cette fonction possède 7 paramètres, on ajoute donc dans l’onglet Parameters les paramètres suivant :

Name : LPSYSTEMNAME
On coche : In
Type : CSTRING
Size : 255

Pensez à appuyer sur Append puis Ok afin de ne pas perdre vos modifications, puis ajoutez le second :

Name : LPACCOUNTNAME
On coche : In
Type : CSTRING
Size : 255

Passons au troisième :

Name : SID
On coche : In
Type : POINTER
Size : vide

Passons au quatrième :

Name : CBSID
On coche : In et Out
Type : INT
Size : 4

Passons au cinquième :

Name : REFERENCEDDOMAINNAME
On coche : Out
Type : CSTRING
Size : 255

Passons au sixième :

Name : CCHREFERENCEDDOMAINNAME
On coche : In et Out
Type : INT
Size : 4

Passons au septième :

Name : PEUSE
On coche : Out
Type : INT
Size : 4

C’est le 3ieme paramètre SID qui correspond au pointeur SID de Windows. C’est cette valeur qui sera utilisée avec MSCONVERTSIDTOSTRINGSID% pour récupérer la chaine de caractères correspondante.

MSCONVERTSIDTOSTRINGSID% pour ConvertSidToStringSidA

Nous finissons par la plus compliquée. Avant d’éditer la définition de cette fonction,nous allons créer un nouveau segment PSTRSID qui sera utilisé pour récupérer la valeur qui contient la chaine de caractère.

Il faut savoir que la fonction MicroSoft, déclare ce paramètre en C++ comme :

BOOL ConvertSidToStringSid(

__in PSID Sid,

__out LPTSTR *StringSid

);

Le StringSid est donc un pointeur sur un pointeur d’une chaine. Pour faire la même chose, nous avons besoin d’un segment intermédiaire.

Ce segment est très simple, il ne possède qu’un seul Field :

Name : STRINGSID$
Type : CSTRING
Size : 255
On coche la case Reference (attention ce point est très important)

Nous pouvons maintenant éditer la définition de la fonction. Dans la dialogue “Modify Definition for Function or Instruction MSCONVERTSIDTOSTRINGSID%” on précise :

Result Type : INT (4)
External : advapi32.ConvertSidToStringSidA

Cette fonction possède 2 paramètres, on ajoute donc dans l’onglet Parameters les paramètres suivant :

Name : SID
On coche : In
Type : POINTER
Size : vide

Pensez à appuyer sur Append puis Ok afin de ne pas perdre vos modifications, puis ajoutez le second :

Name : STRINGSID
On coche : Out
Type : PSTRSID (c’est le segment créé précédemment il apparait dans la partie qui est en ordre alphabétique)
Size : vide

C’est le 1er paramètre SID qui correspond au pointeur SID de Windows récupéré dans la fonction précédente.

Le second paramètre permettra de récupérer la chaine de caractère grâce à : L_SID_USER_WINDOWS.STRINGSID$ si L_SID_USER_WINDOWS est la valeur récupérée comme second paramètre.

Utilisation des fonctions

Nous avons définis les fonctions externes qui permettent l’appel des services MicroSoft, nous allons maintenant utiliser ces services.

Récupération du login Windows

Cette première étape est simple :

On initialise les variables
On appelle la fonction MSGETUSERNAME%
On vérifie qu’il n’y a pas eu d’erreur

Ce qui donne en NCL :

LOCAL CSTRING Buffer$
LOCAL int SizeBuffer%
LOCAL int Retour%

Local Cstring USER_WINDOWS$(255)

USER_WINDOWS$ = ''
L_LPBUFFER$ = ''
SizeBuffer% = 255 ; taille du buffer
Retour% = 0

Retour% = MSGETUSERNAME%(Buffer$, SizeBuffer%)

; Si le retour est différent de 0 alors tout est OK
If Retour% <> 0
USER_WINDOWS$ = skip L_LPBUFFER$

Endif

La valeur récupérée dans la variable USER_WINDOWS$ est le login Windows de l’utilisateur. Il peut être utilisé pour vérifier en base de données si cet utilisateur a le droit de se connecter à votre application.

Récupération du SID Windows

Le login Windows est simple à récupérer, il possède une signification fonctionnelle pour les utilisateurs mais il est moins permanent que le SID : si l’utilisateur change de login suite à un mariage par exemple, le compte Windows est modifié mais pas son SID. Son inconvénient est que le SID est un numéro incompréhensible sans aucun sens fonctionnel.

Il peut être également intéressant de récupérer le SID pour interroger d’autres services de sécurité, mais nous n’aborderons pas ce point.

Pour utiliser le SID, il faut d’abord récupérer le USER_WINDOWS$. On ajoute ensuite le code suivant :

Retour% = 0
L_LPSYSTEMNAME$ = ''
SizeBuffer% = 0 ; taille du buffer
L_LPSYSTEMNAME$ = ''
L_CCHREFERENCEDDOMAINNAME% = 255 ; taille du buffer

; Le premier appel de la fonction avec un 3eme paramètre à 0, renvoie la taille de la structure PSID (SizeBuffer%)
Retour% = MSGETUSERSID%(L_LPSYSTEMNAME$, USER_WINDOWS$, 0, SizeBuffer%, L_REFERENCEDDOMAINNAME$, L_CCHREFERENCEDDOMAINNAME%, L_PSID_NAME_USE%)
things_trace "1ere appel SizeBuffer%= " & SizeBuffer%

If (SizeBuffer%<=0)
    things_trace "ERREUR lors du 1er MSGETUSERSID% GetLastError%="& String(MsGetLastError%, 16)
Else
    New SizeBuffer%, L_PSID
    ; Récupère le pointer de la structure SID du USER Windows
    Retour% = MSGETUSERSID%(L_LPSYSTEMNAME$, USER_WINDOWS$, L_PSID, SizeBuffer%, L_REFERENCEDDOMAINNAME$, L_CCHREFERENCEDDOMAINNAME%, L_PSID_NAME_USE%)

    if (Retour%=0)
        things_trace "ERREUR lors du 2nd MSGETUSERSID% GetLastError%="& String(MsGetLastError%, 16)
    Else
        ; Convertie le pointer de la structure SID du USER Windows en chaîne
        Retour% = MSCONVERTSIDTOSTRINGSID%(L_PSID, L_SID_USER_WINDOWS)
        if (Retour%=0)
            things_trace "ERREUR lors du MSCONVERTSIDTOSTRINGSID% GetLastError%="& String(MsGetLastError%, 16)
        Else
            SID_USER_WINDOWS$ = L_SID_USER_WINDOWS.STRINGSID$
            things_trace "SID_USER_WINDOWS$=" & SID_USER_WINDOWS$

            ; Il faut liberer la chaine récupérée
            P = MSLocalFree(@L_SID_USER_WINDOWS.STRINGSID$)
            things_trace "Resultat LocalFree="& P && String(MsGetLastError%, 16)
        Endif

Endif
dispose L_PSID
Endif

Pour qu’il fonctionne, il faut ajouter au début les déclarations suivantes :

LOCAL pointer L_PSID, pointer P
Local int L_PSID_NAME_USE%
Local int L_CCHREFERENCEDDOMAINNAME%
Local CSTRING L_LPSYSTEMNAME$
Local CSTRING L_REFERENCEDDOMAINNAME$
Local PSTRSID L_SID_USER_WINDOWS

La valeur récupérée dans SID_USER_WINDOWS$ est la chaine de caractères correspondant à l’identifiant du SID.

On notera l’utilisation de la syntaxe : String(MsGetLastError%, 16). Le GetLastError renvoie un code d’erreur. Ce code d’erreur est un numérique mais apparait généralement dans la documentation sous forme hexadécimal. cette syntaxe permet de tracer directement le code hexadécimal.

Paramètre de compilation

La compilation du code ci-dessus demande d’être capable de se linker avec la librairie advapi32.dll. Cette DLL système est disponible sur tous les postes et ne nécessite aucun déploiement supplémentaire.

La compilation nécessite d’avoir accès à son LIB. Pour que cela soit possible, il faut modifier la variable d’environnement LIB et ajouter les deux répertoires suivants (dans le cas de MSVC 8) :

C:\Program Files\Microsoft Visual Studio 8\VC\PlatformSDK\Lib
C:\Program Files\Microsoft Visual Studio 8\VC

Si vous utilisez NatStar directement (sans NsaConfig) cela suffit.

Dans le cadre d’une utilisation de NsaConfig où le lancement et l’environnement de travail de NatStar dépend de la configuration de NsaConfig, il est nécessaire de modifier le fichier C:\NSAC\INI\wspmgr.ini en :

ajoutant dans la déclaration EnvVar les deux variables suivantes MsSdklib et COMPPATH (c’est indispensable pour que les définitions qui suivent soient prises en compte.
puis en ajoutant les deux lignes de définition suivantes dans la partie qui suit la déclaration de EnvVar

MsSdklib=C:\Program Files\Microsoft Visual Studio 8\VC\PlatformSDK\Lib
COMPPATH=C:\Program Files\Microsoft Visual Studio 8\VC

puis en modifiant la déclaration de LIB qui devient :

LIB=%NS-GLOB%\CLASSES\LIB;%NS-GLOB%\SERVICES\LIB;%COMPPATH%\LIB;%MsSdklib%;%NATSTARPATH%\LIB;%LIB%

Conclusion

J’espère que ce billet vous aura été utile. Il montre qu’il est possible de mettre en œuvre une authentification intégrée dans une application NatStar ou NS-DK même si cela n’a rien d’évident. On notera au passage que la complexité provient principalement des API MicroSoft mise à disposition (Je sais, je suis directeur technique de Nat System et donc probablement un peu partial).

Type de données JPA et Hibernate

2009-09-22T23:21:00.001+02:00

L'efficacité du développement d'une application de gestion et l'efficacité de cette même application (les temps de réponse) repose grandement sur la construction d'un modèle de données "efficace".
Dans ce billet nous allons nous concentrer sur un choix "efficace" des types simples pour une application Java reposant sur JPA et Hibernate.

Cette article complète une série d'autres billets sur JPA de ce même Blog :

Faut-il utiliser les EJB 3.0 et la Java Persistence API : Il s'agit d'une réflexion sur l'opportunité d'utiliser les EJB 3.0 et JPA
Tutorial sur le mapping par annotation JPA : un tutorial d'introduction sur les annotations JPA
Réalisation d'une application Web Ajax et JPA : un tutorial qui met en oeuvre JPA dans une application Web Ajax

Si le mot "efficace" a été mis à plusieurs reprises entre guillemets, c'est que ce mot peut prendre des aspects contradictoires suivant le point de vu :

l'efficacité d'un modèle de données pour le DBA (Database Administrateur) va reposer sur l'espace de stockage et la rapidité d'exécution des requêtes,
pour un développeur cela reposera en grande partie sur la facilité qu'il a à écrire les requêtes qui correspondent au besoin fonctionnel
pour l'utilisateur ce sera les temps de réponses de l'application

Mon soucis dans ce billet, est de proposer un certain équilibre, une sorte de compromis entre ces différentes aspirations sans perdre de vu, le besoin pragmatique auquel nous devons tous faire face, développer une application au meilleur prix pour un client exigeant.
Dans un premier temps, nous énoncerons un certain nombre de règles simples permettant de choisir rapidement les types de données de ses propriétés. Dans un second temps nous expliquerons avec différents exemples les raisons de ces choix. Cette seconde partie devrait permettre une meilleure compréhension du comportement d'Hibernate et des limites de la portabilité des différentes solutions.

Contraintes pour l'efficacité d'un modèle de données

Nous nous concentrons dans ce billet aux seuls aspects du typage des propriétés et colonnes simples.

Pour pouvoir choisir efficacement un type de données il faut :

comprendre les nuances entre les différents types
être capable pour une donnée du monde réel (la valeur que l'on veut stocker) de distinguer les différentes nuances associées aux différents types

Par exemple, un double et un BigDecimal représentent tout les deux un nombre décimal. Alors que le double ne connaît pas de limite à sa précision : la même variable peut contenir un nombre précis à 2 ou 10 chiffres après la virgule, ce n'est pas le cas d'un BigDecimal, cet objet possède un attribut précision qui indique le nombre de chiffres après la virgule. Pour changer sa précision il faut faire appel à une méthode.

Pour un float, 1,23 et 1,230 sont identiques, ce n'est pas le cas pour un BigDecimal car l'attribut précision n'est pas le même.

De même, si l'on sait aujourd'hui, qu'une valeur en euro sera inférieure disons à 1 000 000 €, on ne peut que difficilement savoir la limite qu'il faudra prendre en compte dans une dizaine d'années surtout s'il faut prendre en compte un changement de monnaie.

En conséquence, vouloir pour chaque montant définir des limites différentes en fonction de l'information n'est pas nécessairement pertinent : cela augmente la difficulté du choix et on n'a pas toujours la possibilité de prévoir les évolutions (on augmente le risque d'erreur en voulant être précis).

Pour que ces choix restent pertinents et efficaces sur la durée de vie de l'application (souvent plusieurs années), il faut que les différents développeurs manipulant ces données sachent les manipuler efficacement. On a donc bien souvent intérêt à :

se limiter à un ensemble de types restreint : une trop grande précision peu provoquer dans certain cas des effets de bords néfastes par exemple dans la taille des Strings : à la fin, on ne sait jamais quelle est la taille d'un champ et du coup la probabilité d'un développeur pressé de se tromper dans le contrôle est plus grande.
utiliser des types bien connus et maîtrisés par l'ensemble de l'équipe : si un type est mal maîtrisé, son utilisation peut être catastrophique car un des premiers réflexes est bien souvent de revenir à un type connu, ce qui a le double effet de rajouter une surcharge de travail ainsi que des risques d'apparition d'effets de bord lors des conversions. Les effets de bords sont bien évidemment ceux là même qu'on souhaitait éviter avec le choix de ce type.

Mon expérience acquise à travers l'audit de projets montre que bien souvent le mieux est l'ennemi du bien. Une optimisation trop poussée qui force à sortir des sentiers balisés a souvent des effets bien plus pervers pour un projet qu'une optimisation plus raisonnable.

Pour finir, le typage d'une "information" n'est pas intrinsèque à son contenu. Son utilisation a également son importance. Prenant pas exemple un numéro composé exclusivement de chiffres, cela ne veut pas dire qu'il devra être stocké sous forme d'un entier en base. Dans de nombreux cas, il est préférable de le stocker sous forme d'une chaîne de caractères. Cela va dépendre des contrôles que l'on souhaite faire, des recherches que l'on souhaite réaliser...

D'autre part, si une information doit être stockée en base, elle doit également être manipulée en Java et affichée dans un écran. Pour un développement efficace, il faut que le passage d'une représentation à l'autre et les contrôles soient rapides et efficaces. Hibernate et JPA facilitent ce travail, encore ne faut-il pas lui mettre trop de bâtons dans les roues en le forçant à utiliser des types incompatibles.

Les règles retenues sont :

limitation du nombre de types
des types connus
une certaine portabilité à travers les bases de données
un typage cohérent de la base à l'affichage en passant par la représentation mémoire en Java

Typage des données

Nous avons cinq grands types de données que nous subdivisons en des types plus proches des utilisations :

Les types numériques
- Les montants monétaires : il s'agit des valeurs dans une monnaies comme les prix, soldes, montant, commissions...
- Les mesures : il s'agit d'une valeur décimale qui correspond à la mesure d'un objet qu'il s'agissent d'une distance, d'un poids...
- Les taux et pourcentages : il s'agit de valeurs décimales faibles (inférieur à 100) et nécessitant parfois une précision un peu plus grande (certains taux possèdent 4 chiffres après la virgule)
- Les quantités : il s'agit de valeurs entières permettant de donner un nombre d'unités d'un produit.
Les valeurs alphanumériques
- Les chaînes de caractères : les chaînes de caractères classiques qui stockent une information en claire (non codée)
- Les codes : il s'agit d'une information courte (moins d'une dizaine de caractères) qui est codé.
- Les commentaires : il s'agit d'un texte composé de plusieurs mots.
Les valeurs énumérées
- Les valeurs Vrai-Fausse : cela correspond aux cases à cocher
- Les listes déroulantes et énumérations : il s'agit d'information dont la sélection se fait dans une liste déroulante. on stocke en base un code et on affiche un libellé grâce à une table de paramètre qui assure la correspondance.
Les dates et timestamp
- Les dates traditionnelles précises au jour près
- les heures : une heure dans la journée indépendante de la date
- les tags horaires (TimeStamp) qui permettent de conserver la trace de l'heure précise d'un événement. Ceux sont des dates précises à la milliseconde
Les identifiants
- les numéro de dossier
- les séquences

Type Montant Monétaire

Les montants monétaires ont une particularité : le nombre de chiffres après la virgule est une constante (souvent 2). Les problèmes d'arrondis doivent toujours être résolu avec cette contrainte : il n'est pas possible d'augmenter temporairement le nombre de chiffres après la virgule.

D'autre part, le BigDecimal est d'une précision absolue dans les comparaisons de nombre décimaux ce qui est impératif pour les montants monétaires.

Pour plus de détail sur l'intérêt de l'utilisation des BigDecimal vous pouvez lire mon billet : Tutorial sur les BigDecimal

Le stockage par hibernate d'un BigDecimal est un Number de 19 chiffres avec 2 chiffres après la virgule. Nous utiliserons ce format pour tous les montants.

Le nombre de chiffres (19) peut paraître excessif si on compte en Euro, mais en Yen cela se réduit et encore plus pour d'autres monnaies.

Il me parait donc plus sage de rester sur la taille par défaut.

Exemple de définition d'un montant :

@Column(name="JLTS_AMOUNT", precision=19, scale=2)
private BigDecimal amountDefault;

Le BigDecimal étant un objet, il peut être Null comme les colonnes correspondantes en base. Il n'aura donc aucun problème à s'adapter au cas où la valeur peut être Null.

Base de données	Type Base	Remarque
Oracle	NUMBER(19,2)	Le nombre est tronqué si la précision est plus grande
MySql	decimal(19,2)	Une exception est envoyée si la précision est plus grande
HSqlDb	numeric	Le stockage ne connaît ni précision ni contrôle on stocke exactement ce que l'on a reçu
Sql Server	numeric(19,2)	Le nombre est tronqué si la précision est plus grande, le nombre est complété pour respecter la précision

Type Mesure

Une mesure ressemble à un Montant monétaire, à une différence près : la précision des chiffres après la virgule n'est pas d'une grande importance (il ne faut pas oublier que la précision d'une mesure physique est rarement supérieure à 1%).

Il peut donc être judicieux de stocker une mesure dans un double ou Double, ce qui facilite la programmation.

Exemple de définition d'un montant :

@Column(name="JLTS_MESURE", nullable=false)

private double mesure;

Base de données	Type Base	Remarque
Oracle	double precision
MySql	double precision
HsqlDb	double
Sql Server	double precision

Type Taux et Pourcentage

Les taux et pourcentage sont généralement associés aux données de type monétaire. Il s'agit souvent de réaliser des multiplications d'un montant monétaire afin d'obtenir une nouvelle somme. Généralement, un taux pourcentage peut être stockées avec 2 ou 4 chiffres après la virgule et ne dépasse pas les 3 chiffres avant la virgule. Afin de simplifier la modélisation, on utilisera donc la définition suivante :

@Column(name="JLTS_TAUX", precision=7, scale=4, nullable=false)
private BigDecimal taux;

Notez l'attribut nulllable positionné à false par défaut : il est fort probable que par défaut, un taux soit positionné à 0 et non pas laissé à Null. La valeur Null rend délicat les opérations réalisée par défaut alors qu'avec la valeur 0, le résultat serait fonctionnellement correct dans de nombreux cas.

Base de données	Type Base	Remarque
Oracle	NUMBER(7,4)	Le nombre est tronqué si la précision est plus grande
MySql	decimal(7,4)	Une exception est envoyée si la précision est plus grande
HsqlDb	numeric
Sql Server	numeric(7,4)	Le nombre est tronqué si la précision est plus grande, le nombre est complété pour respecter la précision

Type Quantité entière

Il s'agit de valeurs entières comme le nombre d'articles achetés. On optera pour un type Long si la valeur peut être Null autrement on optera pour un long. Attention ! dans ce cas, il faut préciser l'attribut nullable à false. Il est fort probable que dans de nombreux cas, le défaut d'une quantité soit la valeur 0 : Dans ce cas, le long sera plus approprié.

@Column(name="JLTS_QUANTITY", nullable=false)
private long longNumeric;

ou bien

@Column(name="JLTS_QUANTITYNULL")
private Long longObject;

Base de données	Type Base	Remarque
Oracle	NUMBER(19,0)	Le nombre est tronqué si la précision est plus grande
MySql	bigint
HsqlDb	bigint
Sql Server	numeric(19,0)	Le nombre est tronqué si la précision est plus grande

Type Chaîne de caractères

Il s'agit de toutes les chaînes de caractères classiques qui correspondent à une information relativement structurée comme un nom, un prénom, un nom de rue... Ces chaînes sont d'une taille raisonnable : inférieure à 250 caractères. Au delà, ce sera probablement une donnée de type Commentaire.

Le stockage d'une chaîne de caractères est des plus simples : une String.

@Column(name="JLTS_NAME", length=40)

private String name;

Base de données	Type Base	Remarque
Oracle	varchar2(40 char)	Où 40 est la length. Oracle ne distingue pas les chaînes vide des chaînes Null. Il ne stocke que des chaînes Null. L'attribut char après la longueur indique la prise en compte des caractères UTF-8.
MySql	varchar(40)	MySql fait la différence entre une chaîne vide et une chaîne Null.
HsqlDb	varchar(40)	Il n'envoie aucune exception en cas de chaine trop grande
Sql Server	varchar(40)

Type Code

Certaines informations sont stockées sous la forme d'un code :

code postaux
code monnaie
code d'un état
code d'une banque
Siren
Siret

En règle général les codes ont une longueur fixe et relativement courte (inférieur à 10 caractères). Ils peuvent être alphanumériques ou numériques.

Ils peuvent également correspondre au type "Liste déroulante" décris plus loin. Les distinguer n'a pas d'intérêt car le résultat sera le même. On utilise un type String.

@Column(name="JLTS_SHORTCODE", nullable=true, length=2)
private String ShortCode;

Base de données	Type Base	Remarque
Oracle	varchar2(2 char)
MySql	varchar(2)
HsqlDb	varchar(2)
Sql Server	varchar(2)

Type Commentaire

Il y a de forte chance que toute information qui dépasse la centaine de caractères soit un champ de type commentaire. Même s'il est confortable de limiter ce champ à un type String et un stockage en base limité à un ou deux milles caractères, cette approche à de forte chance de ne pas résister aux besoins futures des utilisateurs. Il est donc préférable d'utiliser une représentation sous forme de CLOB.

@Lob

@Column(name="JLTS_COMMENT")

private String commentaire;

Base de données	Type Base	Remarque
Oracle	CLOB
MySql	longtext
HsqlDb	longvarchar
Sql Server	text

Type Booléen Vrai-Faux

Il s'agit des informations qui sont affichées généralement sous forme de case à cocher (CheckBox). La valeur peut être Vrai ou Fausse.

Toutes les bases mais surtout la plus connue et la plus employée (Oracle) ne possèdent pas de type Booléen. L'information devra être stockée sous forme d'un caractère (Y,N par exemple) ou d'un nombre (0,1).

L'annotation standard JPA est celle là.

@Column(name="JLTS_BOOLEAN")
private boolean booleanType;

Base de données	Type Base	Remarque
Oracle	number(1,0)	0 pour false et 1 pour true
MySql	bit	correspondance directe avec true et false
HsqlDb	bit
Sql Server	tinyint	0 pour false et 1 pour true

Il existe une annotation propre à Hibernate (non JPA) qui permet d'indiquer le stockage en base :

@Type(type="yes_no")
@Column(name="JLTS_YESNO")
public boolean yesNo;

@Type(type="true_false")
@Column(name="JLTS_TF")
public boolean trueFalse;

Base de données	Type Base	Remarque
Oracle	char(1 char)	Stockage sous forme de lettre Y et N pour yes_no
MySql	CHAR(1)	T et F pour true_false,
HsqlDb
Sql Server	char(1)

Type Liste déroulante et énumération

Il s'agit du cas représenté généralement par une liste déroulante (ComboBox ou composant SELECT HTML). Il y a une série de libellés qui correspondent à un code.

Le stockage en base est un code.

Généralement le code appartient à une autre colonne (notion de Foreign Key).

Le stockage aura lieu sous forme de chaîne de caractère classique :

@Column(name="JLTS_COMBOBOX", nullable=true, length=2)
private String selection;

Je ne recommande pas l'utilisation de many-to-one pour ce type de relation : ce type de relation alourdit l'affichage quand il s'agit d'une information qui correspond à une table de paramètre. Le many-to-one doit être réservé aux liaisons entre véritables objets.

Base de données	Type Base	Remarque
Oracle	varchar2(2 char)
MySql	varchar(2)
HsqlDb	varchar(2)
Sql Server	varchar(2)

Type Date précise au jour

Le cas des dates est très particulier, le type Date est d'une précision bien supérieure au besoin de stockage des dates qui se limite à une précision au jour près.

JPA définit une annotation Temporal qui permet de limiter la précision au jour (DATE), à l'heure (TIME) où une précision extrême et complète (TIMESTAMP)

La précision est importante au niveau des dates : il est souhaitable qu'une recherche sur les enregistrements ayant une colonne Date qui correspond à la date du jour 22/09/2009 renvoie tous les enregistrements en passant par une égalité.

Si la précision est trop grande (au niveau de la seconde) cela ne fonctionnera pas.

@Temporal(TemporalType.DATE)
@Column(name="JLTS_DATE", nullable=true)
private Date dayDate;

Base de données	Type Base	Remarque
Oracle	date	Le stockage est sous une précision dd/MM/yyyy. L'égalité au niveau jour fonctionne dans les requêtes Oracle (en utilisant To_Date)
MySql	date	L'égalité au niveau jour fonctionne dans les requêtes MySql (en utilisant str_to_date)
HsqlDb	date
Sql Server	datetime	Le stockage est sous une précision dd/MM/yyyy. L'égalité au niveau jour fonctionne dans les requêtes Sql Server(en utilisant Cast)

Type Heure

Il s'agit d'une heure dans la journée, indépendante du jour. Ce type est rarement utilisé. Son manque de portabilité me pousse à préférer le TimeStamp.

@Temporal(TemporalType.TIME)

@Column(name="JLTS_TIME", nullable=true)

private Date time;

Base de données	Type Base	Remarque
Oracle	date	Ce format ne fonctionne pas en Oracle
MySql	time
HsqlDb	time
Sql Server	datetime

Type TimeStamp

Il s'agit d'une date précise souvent à la milliseconde qui permet de conserver une trace d'un événement. Ce type de colonne est souvent dans des tables d'historiques ou d'audit qui conservent une trace des modifications faites par les utilisateurs.

Ce type de trace sert principalement au besoin d'audit et de traçabilité de l'information.

Sa précision à la seconde ne permet pas de rechercher simplement les enregistrements dont la valeur du TimeStamp est égale à une date.

@Temporal(TemporalType.TIMESTAMP)
@Column(name="JLTS_TIMESTAMP", nullable=true)
private Date timeStampAudit;

Base de données	Type Base	Remarque
Oracle	timestamp
MySql	datetime	La précision de ce format est plus faible qu'en Oracle
HsqlDb	timestamp
Sql Server	datetime	La précision de ce format est plus faible qu'en Oracle

Type Identifiant Séquence

L'identifiant le plus simple est une clé numérique automatique. Oracle possède la notion de séquence pour cela. Dans d'autre cas, il faut passer par une autre table qui permet de stocker le compteur.

Pour la portabilité, il est souhaitable d'utiliser le type automatique suivant : GenerationType.AUTO.

GenerationType.SEQUENCE fonctionne bien avec Oracle mais pas avec MySql.

GenerationType.IDENTITY : fonctionne bien avec MySql mais pas avec Oracle.

@Id

@GeneratedValue(strategy=GenerationType.AUTO)

@Column(name="LONG_ID", nullable=false)

private long id=0;

Cela correspond à une séquence

Base de données	Type Base	Remarque
Oracle	number(19,0)	Il y a création est utilisation d'une Séquence Oracle hibernate_sequence.
MySql	bigint
HsqlDb	bigint generated by default as identity (start with 1)
Sql Server	numeric(19,0) identity

Type Numéro de dossier

Il existe des informations qui sous une apparence numérique (elles ne sont composées que de chiffres) sont plus souvent manipulées comme une chaîne de caractères que comme un nombre.

Par exemple, on ne fait pas d'opération arithmétique sur un numéro de dossier ou le numéro de sécurité sociale : additionner un nombre, le multiplier, le diviser ou le comparer non pas de sens.

Il est plus courant de faire des concaténations de chaînes : le code sexe, le code département pour un numéro de sécurité sociale.

Pour un numéro de dossier, on peut trouver pratique de faire une recherche en ne tapant qu'une partie du numéro en utilisant un Like.

Pour ces champs, il est souhaitable d'utiliser un type String.

@Column(name="JLTS_NUMERO", nullable=true, length=10)
private String NumeroDossier;

Base de données	Type Base	Remarque
Oracle	varchar2(10 char)
MySql	varchar(10)
HsqlDb	varchar(10)
Sql Server	varchar(10)

Nullité d'une colonne

Une colonne peut être nulle ce qui est différent de la valeur 0 pour un nombre et d'une chaîne vide "" pour une String. Oracle est une exception notoire pour les String : Oracle insère un Null dans une colonne quand on lui passe une chaîne vide. Ce point est encore d'actualité avec un Oracle 10G et le driver ojdc14.jar.

Les types Java acceptent s'ils sont d'un type objets (BigDecimal, Double, Long...) la valeur Null ce qui n'est pas le cas des types natifs (double, long, integer...). Le type String accepte la valeur Null.

D'un point de vu technique, il n'est pas judicieux d'utiliser un type natif si la colonne ne possède pas l'attribut Not Null : on risque des problèmes ou des incohérences si on récupère une valeur Null.

D'un point de vu fonctionnel, le Null doit servir à distinguer une valeur non saisie des autres : On utilisera le Null s'il est pertinent de distinguer 0 de l'absence de saisie.

Par exemple, il n'est pas souhaitable que la note d'un enfant soit par défaut 0. Il est important d'être capable de distinguer l'absence de notation (le Null) d'une note nulle (0).

Dans le cas, d'un rabais, c'est probablement l'inverse, on souhaite que par défaut la valeur soit 0. Cela permet de faire simplement les calculs. La valeur peut rester à 0 sans grand impact. En règle générale, le changement de cette valeur nécessite des attributions spéciales (par exemple être manager).

Pour les chaînes de caractères on évitera de distinguer le cas des null des chaînes vides afin de conserver la portabilité vers Oracle. Cela n'est pas nécessairement un problème important. Le statut d'un objet (qui peut être détecté par la différence entre un champ Null et vide) peut également et probablement mieux rendu par une colonne spécifique STATUT/ETAT (il s'agit du type Code).

Pour les nombres, le choix est plus délicat :

l'absence de null facilite les calculs : le calcul n'a pas beson de tester l'existence d'un Null
le 0 peut souvent être pris comme une valeur par défaut
il existe des cas (comme pour une note) ou le 0 ne peut être considéré comme une valeur par défaut, dans ce cas, le Null est indispensable.

Il ne faut pas perdre de vu que le créateur de l'objet métier n'a pas nécessairement tous les droits pour saisir toutes les valeurs. il peut s'agir d'un opérateur de saisi qui n'a pas les habilitations pour remplir certaines valeurs sensibles. Dans ce type de process, il peut être important que la personne qui possède les droits pour compléter le dossier puisse distinguer d'un rapide coup d'oeil les informations qui lui reste à saisir. Dans ce cas, les Null peuvent être utiles même si dans d'autres cas, la valeur 0 sera très pertinente.

Dans notre exemple précédent, le rabais pourra rester à 0.

S'il faut une règle simple : je donnerai la règle suivante : Le null est utile si la valeur par défaut du champ ne peut pas être 0, dans les autres cas, il sera préférable de ne pas utiliser de Null.

Conclusion

La phase de conception du modèle de données peut être grandement simplifiée en limitant la définition des types à la liste précédemment donnée :

Type	Notation JPA	Oracle	Mysql	HsqlDb	Sql Server
Montant monétaires	@Column(name="JLTS_AMOUNT", nullable=true, precision=19, scale=2) private BigDecimal amount;	NUMBER(19,2)	decimal(19,2)	numeric	numeric(19,2)
Mesure	@Column(name="JLTS_MESURE", nullable=false) private double mesure;	double precision	double precision	double	double precision
Taux et pourcentages	@Column(name="JLTS_TAUX", nullable=true, precision=7, scale=4) private BigDecimal taux;	NUMBER(7,4)	decimal(7,4)	numeric	numeric(7, 4)
Quantité	@Column(name="JLTS_LONG", nullable=false) private long longNumeric;	NUMBER(19,0)	bigint	bigint	numeric(19,0)
Chaînes de caractères	@Column(name="JLTS_STRING", length=40) private String textString;	VARCHAR2(40 CHAR)	varchar(40)	varchar(40)	varchar(40)
Code	@Column(name="JLTS_SHORTCODE", nullable=true, length=2) private String shortCode;	VARCHAR2(2 CHAR)	varchar(2)	varchar(2)	varchar(2)
Commentaire	@Lob @Column(name="JLTS_COMMENT") private String commentaire;	CLOB	longtext	longvarchar	text
Vrai-Fausse et Booléen	@Column(name="JLTS_BOOLEAN") private boolean booleanType;	NUMBER(1,0)	bit	bit	tinyint
Liste déroulante	@Column(name="JLTS_SHORTCODE", nullable=true, length=2) private String shortCode;	VARCHAR2(2 CHAR)	varchar(2)	varchar(2)	varchar(2)
Date	@Temporal(TemporalType.DATE) @Column(name="JLTS_DATE", nullable=true) private Date dayDate;	DATE	date	date	datetime
Heure	@Temporal(TemporalType.TIME) @Column(name="JLTS_TIME", nullable=true) private Date time;	DATE	time	time	datetime
Tags horaires (TimeStamp)	@Temporal(TemporalType.TIMESTAMP) @Column(name="JLTS_TIMESTAMP", nullable=true) private Date timeStampAudit;	TIMESTAMP	datetime	timestamp	datetime
Numéro de dossier	@Column(name="JLTS_NUMERO", nullable=true, length=10) private String numero;	VARCHAR2(10 CHAR)	varchar(10)	varchar(10)	varchar(10)
Séquence	@Id @GeneratedValue(strategy=GenerationType.AUTO) @Column(name="LONG_ID", nullable=false) private long id=0;	NUMBER(19,0)	bigint	bigint	numeric(19,0) identity

Dans le cas d'une phase de ré-ingénierie d'un modèle de données existant, il sera probablement possible de se baser sur les mêmes types en changeant peut être leur représentation JPA afin de l'adapter à l'existant en base.

Par exemple, si en base les montants sont des NUMBER(11,2), le type montant pourra être de type

@Column(name="JLTS_MONTANT", precision=11, scale=2, nullable=false)
private BigDecimal montant;

Dans la pratique, on ne devrait pas voir apparaître plus de deux déclinaisons d'un même type dans un modèle existant.

J'espère que ce tutorial simplifiera la conception de vos prochains modèles de données. Un prochain billet présentera un projet de test permettant de mieux appréhender les différents comportements.

Tutorial sur les montants et l'utilisation des BigDecimal en Java :

2009-07-07T16:55:00.001+02:00

L'objectif de ce billet est double. Premièrement, il s'agit d'une sensibilisation au besoin impérieux d'utiliser des BigDecimal à la place des double dans les applications de gestion.

Secondement, nous allons donner quelques recommandations pour l'utilisation efficace des BigDecimal.

Pourquoi utiliser des BigDecimal et non des double

La manipulation de montant en programmation s'est souvent heurtée à quelques problèmes de comparaison : deux chiffres censés être égaux sont testés comme différents : par exemple 7273.27x10 est différent de 72732.7.

Le mécanisme de stockage traditionnel des nombres en binaire : une somme de puissance de 2, est responsable de ce problème.

Des nombres aussi simple que 0,1 ne peuvent pas être stockés précisément sous cette forme. En conséquence 0,1 n'est jamais exactement égale à 0,1. Donc 0,1x10 n'est pas exactement égale à 1. Hors 1 = 2^0, donc 1 possède lui une représentation exacte. Si on faisait 0,1x10 une comparaison avec 1 donne dans ce cas un résultat erronée.

N.B. Il semble que le cas du 0,1 soit mieux traité maintenant puisqu'en Java, si on utilise des double, on a bien 0,1x10=1.0.

Dans les applications de gestion, les nombres sont souvent des montants ou des pourcentages : le nombre de chiffres après la virgule est généralement connu (entre 2 et 4 voir 6 ou 8 pour certaines applications financières).

En cas de division, il existe des règles d'arrondies et il n'est pas souhaitable de modifier le stockage pour gagner en "précision". Ces applications ne connaissent pas les réels : 1/3 va être égale à 0,33.

Le BigDecimal en Java

En Java, il existe un type BigDecimal qui permet de prendre en compte ce type de problématique : il repose sur le fait qu'un entier possède une représentation binaire exacte.

Pour un montant, il suffit de définir le nombre de chiffres après la virgule et de stocker le nombre sous forme entière : par exemple on stockera 7273.27 sous la forme d'une valeur de 727327 possédant 2 chiffres après la virgule. Le nombre de chiffres après la virgule correspond à la propriété scale du BigDecimal.

L'utilisation de BigDecimal entraîne une petite contrainte : il ne s'agit pas d'un type natif mais d'un objet. Il n'est donc pas possible d'utiliser les opérateurs +, -, * et /.

Par exemple

7273.27*10.0 qui avec des doubles s'écrit :

double doubleApproche=7273.27;
double resultat=10*doubleApproche;

devient en BigDecimal :

BigDecimal doubleApproche=new BigDecimal("7273.27");
BigDecimal resultat=doubleApproche.multiply(new BigDecimal(10));

Exemple de projet

Nous allons créer un projet Eclipse simple afin d'illustrer les différents cas.

Dans le menu : File -> New Project

Choisir ensuite dans le noeud Java : Java Project.

Le nom du projet sera TestBigDecimal.

Appuyer sur le bouton Finish.

Sur le noeud src, clique droit et choisir New -> New Junit Test Case

Chosir le radio button New JUnit 4 test.

Package : fr.j2ltho.test.bigdecimal

Name : TestDifferences

Puis appuyer sur le bouton Finish.

Une boite de dialogue apparaît : "JUnit 4 is not on the build path. Do you want to add it ?".

Choisir le radio bouton : Perform the following action:

Et vérifier qu'il y a bien : Add JUnit 4 library to the build path.

Valider en appuyant sur le bouton OK.

On ajoute le code suivant :

package fr.j2ltho.test.bigdecimal;

import static org.junit.Assert.assertEquals;

import java.math.BigDecimal;

import org.junit.Test;

public class TestDifferences {
    @Test(timeout=1000)
    public void testProblemeDouble() {
        double doubleApproche=7273.27;
        double resultat=10*doubleApproche;
        assertEquals("Double fois 10", 72732.7, resultat);
        if (resultat==72732.7) {
            System.out.println("Egale: " + resultat);
        }
        else {
            System.out.println("Ecart: " + (resultat-72732.7));
        }
    }
    @Test(timeout=1000)
    public void testProblemeBigDecimal() {
        BigDecimal doubleApproche=new BigDecimal("7273.27");
        BigDecimal resultat=doubleApproche.multiply(new BigDecimal(10));
        assertEquals("BigDecimal fois 10", new BigDecimal("72732.7"), resultat);
        if (resultat.compareTo(new BigDecimal("72732.7")) ==0){
            System.out.println("Egale: " + resultat);
        }
        else {
            System.out.println("Ecart: " + (resultat.subtract(new BigDecimal("72732.7"))));
        }
    }
    @Test(timeout=1000)
    public void testDixiemeDouble() {
        double doubleApproche=0.1;
        double resultat=10*doubleApproche;
        assertEquals("Double fois 10", 1.0, resultat);
        if (resultat==1.0) {
            System.out.println("Egale: " + resultat);
        }
        else {
            System.out.println("Ecart: " + (resultat-1.0));
        }
    }
    @Test(timeout=1000)
    public void testCentiemeDouble() {
        double doubleApproche=0.01;
        double resultat=10*doubleApproche;
        assertEquals("Double fois 10", 0.10, resultat);
        if (resultat==0.10) {
            System.out.println("Egale: " + resultat);
        }
        else {
            System.out.println("Ecart: " + (resultat-0.10));
        }
    }
    @Test(timeout=1000)
    public void testDixiemmeCentiemeDouble() {
        double doubleApproche=0.11;
        double resultat=10*doubleApproche;
        assertEquals("Double fois 10", 1.10, resultat);
        if (resultat==1.10) {
            System.out.println("Egale: " + resultat);
        }
        else {
            System.out.println("Ecart: " + (resultat-1.10));
        }
    }
}

L'éxécution du test : Run As -> JUnit Test donne un test réussi à 100% mais avec le résultat suivant dans la Console :

Ecart: 1.4551915228366852E-11
Egale: 72732.70
Egale: 1.0
Egale: 0.1
Egale: 1.1

On constate donc que la comparaison JUnit assertEquals : assertEquals("Double fois 10", 72732.7, resultat); renvoie un résultat juste alors que la comparaison des doubles renvoient une erreur et que la différence renvoie un écart.

Si on manipule des doubles Java, il faut se méfier de assertEquals qui semblent prendre en compte un écart d'arrondi.

Création d'un BigDecimal

Le BigDecimal est un objet, il est créé avec un new. Son constructeur accepte une String, un long ou un double.

Il ne faut jamais utiliser le constructeur du double car on réintroduit le problème de l'arrondie.

Le test suivant illustre le problème :

@Test(timeout=1000)
public void testProblemeConstructeurDouble() {
    BigDecimal doubleApproche=new BigDecimal(7273.27);
    BigDecimal stringApproche=new BigDecimal("7273.27");
    assertEquals("BigDecimal fois 10", doubleApproche, stringApproche);
    if (doubleApproche.compareTo(stringApproche) ==0){
        System.out.println("Egale: " + doubleApproche);
    }
    else {
        System.out.println("Ecart: " + (doubleApproche.subtract(stringApproche)));
    }
}

La console affiche :

Ecart: 4.3655745685100555419921875E-13

Là encore, on constate que le assertEquals pour les BigDecimals n'est pas fiable puisqu'il indique une égalité qui n'est pas réelle.

Pour les entiers, il est préférable d'utiliser la méthode static valueOf() qui est plus lisible :

BigDecimal.valueOf(40)

Il existe trois méthodes statiques pour créer un BigDecimal de valeur 1 ou 0 ou 10.

BigDecimal.ONE
BigDecimal.ZERO
BigDecimal.TEN

En bref, on recommande d'utiliser :

Pour un montant, un taux ou un pourcentage, le constructeur avec un paramètre String : BigDecimal stringApproche=new BigDecimal("7273.27");
Pour un nombre d'unités, la méthode static valueOf : BigDecimal.valueOf(40)
Pour les valeurs remarquables 0, 1 et 10 : on utilise les méthodes statics : BigDecimal.ZERO, BigDecimal.ONE et BigDecimal.TEN

Addition et soustraction avec BigDecimal.

L'addition et la soustraction ne présentent pas de particularité en dehors de l'obligation d'utiliser une méthode :

subtract
add

On aura par exemple

    BigDecimal valeur=new BigDecimal("70.36")
    // resAddition = valeur + 1
    BigDecimal resAddition = valeur.add(BigDecimal.ONE);
    // resSoustraction = valeur -10
    BigDecimal resSoustraction = valeur.subtract(BigDecimal.TEN);

Multiplication et Division de BigDecimal

La multiplication répond au même principe que l'addition et la soustraction avec la méthode : multiply.

BigDecimal pricePerShare=new BigDecimal("70.36");
// coutTotal = pricePerShare * 3
BigDecimal coutTotal =pricePerShare.multiply(BigDecimal.valueOf(3));

Pour la division, c'est plus compliqué car il faut indiquer :

le nombre par lequel on divise
mais surtout le nombre de chiffre après la virgule que l'on souhaite conserver pour le résultat (une division ne tombe pas toujours juste)
et pour finir le mécanisme d'arrondi : nous utiliserons généralement BigDecimal.ROUND_HALF_UP

Par exemple, le nombre de parts achetées :

BigDecimal pricePerShare=new BigDecimal("70.36");
BigDecimal purchaseAmount=BigDecimal.valueOf(200);
// nbPart = purchaseAmount/pricePerShare
BigDecimal nbPart = purchaseAmount.divide(pricePerShare, 4, BigDecimal.ROUND_HALF_UP);

Il existe deux méthodes qui permettent de simplifier les multiplications et les divisions par des multiples de 10 :

movePointLeft(2) on déplace la virgule de 2 vers la gauche ce qui correspond à une division par 100.
movePointRight(1) on déplace la virgule de 1 vers la droite ce qui correspond à une multiplication par 10.

Ces deux méthodes sont particulièrement utiles lorsqu'on calcule des taux ou des pourcentages.

BigDecimal total=BigDecimal.valueOf(950);
BigDecimal percentage=BigDecimal.valueOf(20);
// On veut 20% de 950
// montant = (total*percentage)/100
BigDecimal montant = total.multiply(percentage).movePointLeft(2);

Comparaison

il faut favoriser la méthode : compareTo qui fait abstraction du nombre de chiffres après la virgule. compareTo considère que 15.2 et 15.200 sont identiques. Ce n'est pas le cas avec equals().

La méthode compareTo renvoie un entier et non pas un booléen :

0 si la valeur est identique
1 si la valeur est supérieure à celle du paramètre
-1 si la valeur est inférieure à celle du paramètre

Dans le cadre de l'utilisation de JUnit nous recommandons d'utiliser :

assertEquals("Comparaison", 0, doubleApproche.compareTo( stringApproche));

à la place de :

assertEquals("Comparaison imprécise", doubleApproche, stringApproche);

En effet dans certain cas (petit écart) : la première indiquera bien une différence alors que la seconde indiquera une égalité.

Affichage

Pour afficher un BigDecimal, il existe deux méthodes :

plainString
toString

Nous recommandons l'utilisation d'une troisième solution : l'utilisation du formatage avec DecimalFormat. ce mécanisme permet de forcer la représentation du BigDecimal suivant un format défini.

L'exemple suivant est significatif : nous avons volontairement utilisé le constructeur double pour montrer la différence.

BigDecimal doubleApproche=new BigDecimal(7273.27);

System.out.println("7273.27 toPlainString: " + doubleApproche.toPlainString());
System.out.println("7273.27 toString : " + doubleApproche.toString());

DecimalFormat decimalFormat = new DecimalFormat("##,###,###,##0.00");
System.out.println("7273.27 DecimalFormat : " + decimalFormat.format(doubleApproche));

Conclusion

L'utilisation de BigDecimal est un peu plus lourde que celle de double. Mais on retrouve un ensemble de méthodes qui simplifie le travail et surtout l'assurance de ne pas avoir de problème d'arrondi à la fin.

Cela nous force à lever l'ambiguïté du choix des arrondis très tôt : Cela permet d'éviter des déconvenues avec les équipes métiers lors des phases de recette. Les équipes métiers connaissent parfaitement ces règles, elles leur sont tellement naturelles qu'ils en oublient de les spécifier. L'utilisation de BigDecimal nous force à déterminer dés le début de la programmation ce qu'il faut faire.

AppStore : Analyse d'un succès

2009-05-25T23:08:00.001+02:00

Ce billet fait parti d'une réflexion plus large sur les aspects révolutionnaires de l'iPhone. Il se concentre sur l'AppStore dont le succès dépasse les simples chiffres fournis par Apple : 35 000 applications et 1 milliard de téléchargements en date de mai 2009 (le communiqué de presse d'Apple : http://www.apple.com/fr/pr/library/2009/04/24appstore.html?sr=hotnews).

Cette approche de place de marché a été reprise depuis par Google, Nokia, Microsoft et RIM (pour les BlackBerry). Le concept semble être suffisamment novateur et intéressant pour être repris par la concurrence.

Depuis avril 2009, les publicités pour l'iPhone se concentre exclusivement sur les applications disponibles sur l'AppStore et non plus sur l'iPhone lui-même. C'est un signe de l'importance de l'écosystème iPhone dans la décision d'achat. Et qui mieux que l'AppStore symbolise cet écosystème.

L'AppStore

Commençant par présenter rapidement l'AppStore surtout pour les lecteurs qui ne sont pas familier avec l'iPhone. L'AppStore est un super marché d'applications pour iPhone et iPod Touch. On y trouve des applications payantes et des applications gratuites.

L'AppStore est un département du fameux iTunes Store (leader mondial de la vente de musique). Il est accessible à partir du logiciel iTunes : Pour naviguer à travers l'AppStore, il n'est donc pas nécessaire de posséder un iPhone, il suffit d'utiliser iTunes. Il existe une version de l'AppStore pour iPhone, il est donc possible de consulter et charger des applications directement depuis l'iPhone.

L'AppStore possède différent classement des applications : en règle générale il existe deux classements séparés : un pour les applications gratuites et un pour les applications payantes. Les applications gratuites ne sont ni cachées ni enterrées au fond du site : elles disposent de la même visibilité que les applications payantes.

Ampleur du succès de l'AppStore

Apple annonce 35 000 applications dans le monde, 10 000 disponibles pour la France. Le chiffre est éloquent et il est difficile de ne pas trouver l'application dont on a besoin.

Sur les 10 000 applications on va trouver dans la rubrique Actualité une application par journal et cela pour l'ensemble de la presse mondiale. On y trouvera donc une application permettant :

la lecture du Monde
la lecture du New York Times
la lecture d'El Pais (Espagne)

Et bien d'autres encore. On notera que cela fait trois applications différentes.

L'iPhone peut également servir de lecteur de livre : il est possible d'acheter des livres au format éléctronique : dans ce cas, un livre est une application.

Ces exemples sont donnés pour montrer que le nombre effectif d'applications est dans la pratique inférieur à 10 000. Néanmoins, il reste très important et dépasse probablement ce qui est disponible sur les plates-formes concurrentes.

Apple annonce un milliard de téléchargements : on peut estimer le nombre d'iPhones vendus aux alentours de 20 millions. On aurait donc en moyenne 50 téléchargement par iPhone. Cela me parait excessif. Je pense qu'Apple compte un téléchargement par mise à jour. Par exemple, le lecteur du New York Times que j'utilise a du être mis à jour une dizaine de fois : Apple compte probablement 10 téléchargements.

Ceci étant dit, toutes les applications n'ont pas plusieurs versions et qui plus est : un utilisateur n'est pas obligé de faire la mise à jour. L'un dans l'autre, j'estime qu'un utilisateur a du chargé en moyenne une petite vingtaine d'applications différentes. Ce chiffre reste très important si l'on considère qu'il s'agit d'une moyenne pour un produit grand public composé majoritairement de non informaticien.

A l'époque sur mon Palm j'avais chargé 4 ou 5 applications en 4 années d'utilisation. Sur l'iPhone et grâce à l'AppStore, un utilisateur moyen a téléchargé une vingtaine d'applications en 9 mois d'utilisation.

Une telle augmentation (facteur 4) sur une population aussi large ne peut être le fait que d'un changement majeur, révolutionnaire. C'est ce ou ces changements que nous allons identifier.

Mes Applications

Avant d'aller plus loin dans l'analyse, je vais lister les 29 applications que j'ai installé sur mon iPhone : cela permettra d'illustrer les différents types d'application.

Les sites actualités :
- ElPais.com : l'application du journal El Pais (Espagne)
- Le Monde.fr : l'application du Monde. Elle permet une lecture Hors connexion des articles du site. Attention les articles sont plus courts que ceux de journal papier.
- NYTimes : l'application du journal New York Times (Etats-Unis). Les articles semblent complets (ils sont beaucoup plus longs que ceux du Monde) mais le mode Hors Connexion fonctionne moins bien.
- Sports.fr : Un journal sportif avec un mode Live qui permet de suivre les événements sportifs (comme une journée de championnat de foot) en direct.
Les Jeux
- Crash Bandicoot Nitro : Une sorte de Mario Kart qui utilise l'accéléromètre. Pour moi du niveau de Mario Kart pour Nintendo DS à l'exception du mode multi-joueur qui n'est pas disponible.
- Hanoi : le casse tête des tours de Hanoï
- iChess (Free) : un jeux d'échec
- Mastermind : le jeux du MasterMind
- TouchMines : une version du démineur. Un peu difficile à jouer car les cases sont trop petites.
- Virtual Pool Lite : un très bon jeu de billard américain qui rend très bien les sensations du véritable billard.
Les applications de productivité
- SimpleMind Xpress : Une application de brainstorming
- Evernote : une très bonne application de prise de notes quelles soient vocales, écrites ou également des photo prises avec l'iPhone. Il existe également un pendant Windows ainsi qu'un plug-in Firefox pour noter des morceaux de site Internet.
Les références et dictionnaires
- Dictionnaire Littré : une version très ancienne et un peu passé du dictionnaire Littré que j'utilise pour expliquer des mots aux enfants
- PagesJaunes : cette application étend le site Web en rendant disponible l'utilisation de la localisation.
- Wapedia - Wiki mobile : Une version très conviviale de Wikipedia pour iPhone.
- 160 000 Recipes : Un site de recette de cuisines (en anglais)
Aide aux déplacements
- Wikango : un excellent avertisseur de Radar
- PanameTraffic : Permet de visualiser l'état du trafic sur la région parisienne, devenu un peu moins utile depuis que le trafic est également disponible directement sur l'application Plan (Google Map)
- GoVelib : Permet de connaître les stations Velib autour de vous et leur disponibilité en vélo.
- Locly : permet de connaître quelques types de commerces ou services (comme les guichets carte bleu) autour de vous.
Divertissements
- Liveradio d'Orange : permet d'écouter des stations radio à travers internet.
- Première : les dernières critiques de cinéma avec les séances près de chez vous.
- Stanza : un lecteur de livres pour iPhone. L'application permet le téléchargement d'une grande quantité de livres français ou anglais (tous anciens).
Utilitaires
- Orange spot'finder : Permet de connaître les Hot Spot Wifi autour de vous.
- Speedtest : Permet de mesurer le débit de votre connexion internet. Une des applications qui a permis en août/septembre 2009 de mettre en évidence le bridage de la 3G par Orange.
- 9 - Toolbox (Free Event) : une série de petits utilitaires qui va du convertisseur d'unités au niveau à bulle
Réseaux sociaux
- LinkedIn : l'application qui permet de se connecter au site social professionnel LinkedIn
Les applications ludiques
- LightSaber Unleashed : un sabre laser Star War. Idéal pour épater les jeunes enfants.
Les applications publicitaires
- Angoulême 2009 : Application créé pour le festival de la BD d'Angoulême qui permet de feuilleter une série de BD.

De cette liste d'applications seule Crash Bandicoot Nitro Kart 3D est payante : au tarif de 5 € son prix est très compétitif par rapport à un jeu Nintendo DS à 35 €.

Avantages du concept AppStore

L'AppStore peut être considérée comme une déclinaison de l'iTunes Store : une place de marché pour des applications. On bénéficie des mêmes avantages :

simplifie la recherche : il n'est pas nécessaire de rechercher dans plusieurs magasins ou sur différents sites quelles applications est la meilleure ou quelle application est disponible. Il suffit d'aller sur l'AppStore et regarder s'il y a une nouvelle application susceptible de nous intéresser.

Mais l'AppStore ajoute une caractéristique propre aux marchés des applications :

la confiance dans les applications : les applications sont "validées" par Apple. Même si on ne sait pas ce que cela sous entend réellement, on a la certitude que cela exclu les virus.
La création d'une place de marché a eu un autre effet bénéfique pour les utilisateurs : la concurrence entre producteurs d'applications à provoquer une baisse des prix significatives : la majorité des éditeurs de jeux ont lancé leurs jeux à des prix proches des 17$, quelques jours plus tard ont retrouvé les mêmes jeux autour des 7$. Du coup, on retrouve de nombreuses applications à des prix significativement plus faibles sur l'iPhone que sur les plate-formes concurrentes. Dans ma liste Crash Bandicoot Nitro Kart est un excellent exemple : pour 5 € on a un jeu qui vaudrait 35 € sur Nintendo DS.

Ces trois points expliquent certainement le milliard de téléchargements réalisés en moins d'un an.

L'AppStore comme un lien social

La confiance et la simplicité poussent aux téléchargements "ludiques" : j'entends par là, le téléchargement d'applications (bien souvent gratuites) juste pour voir ce qu'elles font. On ne cherche pas forcément l'utilité mais le coté "ludique" : un mélange de surprise et de "fun", voir un certain décalage. Ceux sont des applications que l'on va montrer qui vont servir à amorcer une discussion : elle serve à créer un lien social entre deux personnes comme on utilise parfois un article de journal, un événement où plus systématiquement un événement sportif.

Parmi ces applications on retrouvera l'emblématique Shazam qui permet de reconnaître un morceau de musique et qui est régulièrement utilisée dans les pub Apple. Dans ma liste, on trouvera Light Saber qui permet de lier la conversation avec des enfants. Certains petits jeux sont également idéals pour peu qu'ils soient simples courts et drôles.

Dans la liste des applications farfelues on retrouvera une boite à meuh (qui fait meuh quand on la retourne), un coussin péteur, des aquariums...

Ces téléchargements "ludiques" constituent un véritable phénomène parmi les utilisateurs d'iPhone et peuvent facilement compter pour un bon tiers des téléchargements. Ce phénomène est d'autant plus fort que grâce à la version iPhone de l'AppStore, le spectateur conquis peut s'empresser de télécharger la nouvelle application immédiatement et cela en toute confiance car hébergée sur un site contrôlé par Apple.

Ce type de comportement ne pourrait pas être aussi important (une demi-douzaine de téléchargement par personne en moyenne) sans le sentiment de confiance qu'inspire l'AppStore : c'est le coup de génie d'Apple. Il s'agit d'une véritable révolution du comportement des utilisateurs même si j'en convient son utilité me parait limité.

Au delà de cet aspect ludique, le choix d'un lot d'applications doit également constituer une certaine affirmation identitaire du possesseur de l'iPhone : le choix d'un journal n'est pas neutre par exemple. On retrouve un équivalent moderne des bibliothèques familiales qui permet d'afficher à travers le choix des livres disposés bien en vue sur les étagères un statut social. Il en est des applications comme pour les livres : ce n'est pas parce qu'elle est présente sur un iPhone qu'elle est utilisée.

Conclusion

L'AppStore est un élément révolutionnaire de l'offre iPhone par les changements de comportements qu'il a provoqué. Ce changement n'a été possible que parce que les utilisateurs se sont sentis en confiance grâce à l 'existence d'une place de marché sous le contrôle du constructeur.

Ce qui est également révolutionnaire, c'est l'attention et l'importance que porte Apple à son écosystème : de nombreux analystes ont expliqué la défaite du MacOs sur Windows par le peu d'attention qu'Apple avaient porter aux développeurs alors que ceux-ci ont toujours été choyé par Microsoft. La leçon semble avoir bien été retenue par Steve Jobs et le milliers de nouvelle API attendue avec le firmware 3.0 de l'iPhone ne devrait pas démentir ce revirement.

Initialisation d'une propriété de type Date ou Enum avec Spring

2009-02-25T15:32:00.001+02:00

Le framework Spring permet de construire des objets par configuration. Les objets sont créés et peuvent être initialisés.

Cela marche bien et simplement pour des types simples String ou int par exemple quand il s'agit d'Enum c'est simple mais il faut savoir quand il s'agit de date c'est bien plus difficile.

Je me propose d'expliquer rapidement comment faire pour ces deux cas.

Le cas des Enum dans Spring

L'exemple fonctionne pour la version 2.5.6 de Spring avec un JDK 1.5. Je pense que la version 2.0 ou 2.5 ont apporté des simplifications que j'utilise dans cette exemple.

Pour une propriété simple d'un bean. Si cette propriété est de type RoleStatAppel qui est une énumération qui prend les valeurs : RoleStatAppel.ECOUTANT ou RoleStatAppel.ADMINISTRATEUR. Pour définir, la valeur de cette propriété roleUtilisateur, il suffit d'ajouter dans la définition du Bean :

Spring prend tout en charge, il connaît le type de la propriété et il est capable de faire la correspondance avec la valeur indiquée dans value.

La même règle est applicable pour un objet créé avec des arguments dans son constructeur :

Le code initial est :

new NsGUIFactory(NsGUIFactory.NsImplementationMode.GuiEcho2);

Où

NsGUIFactory est un singleton que l'on souhaite créé
GuiEcho2 est une valeur de l'énumération NsImplementationMode qui est prise en paramètre du constructeur.

La solution pour créer cet objet via Spring est tout simplement :

<bean id="FactoryBean" class="fr.natsystem.natjet.application.NsGUIFactory">
<constructor-arg><value>GuiEcho2</value></constructor-arg>
</bean>

Pour information, dans le dernier exemple, il s'agissait dans mon cas d'une énumération définie dans la classe NsGUIFactory.

Le cas des Date dans Spring

Pour les dates, le problème est un peu plus compliqué :

Spring n'est pas capable de convertir automatiquement une valeur 01/02/2009 dans une propriété de type Date
il existe un format. C'est d'ailleurs pour cette raison que Spring n'est pas capable de faire la conversion tout seul.
il peut être intéressant de récupérer la date du jour sans avoir besoin de modifier son fichier de configuration.

Pour résoudre le problème des valeurs de types complexes pour lesquelles la conversion d'une String simple n'est pas immédiate ou ambiguë, Spring met à disposition ce qu'il appelle une bean factory post-processor qui permet de compléter les mécanismes standards pour ces types.

C'est cette solution que nous allons étudier pour traiter le cas des dates. La factory Spring CustomEditorConfigurer va être paramétrée grace à une interface dans le fichier de configuration Spring applicationContext.xml.

Le tag map permet de lister, si nécessaire, plusieurs conversion pour différents types. Il s'agit une liste de Entry.

Le entry possède une clé : key qui indique le type Java qui sera concerné par la conversion : dans notre cas, c'est le type java.util.Date. cela veut dire que dès que Spring rencontre une propriété de type Date, il appellera automatiquement notre PropertyEditor.
Le PropertyEditor pour ce type est défini dans le tag bean en indiquant la classe utilisée. Spring met à disposition une classe pour les Date. Cet objet prend deux arguments en entrée, un SimpleDateFormat qui permet de définir le format à utiliser pour la conversion et un second argument qui prend la valeur true. je ne sais pas à quoi correspond cette avleur (il s'agit peut être de la propriété lenient qui permet de forcer ou non une erreur sur une date invalide)

On choisit le format que l'on souhaite utilisé dans <constructor-arg><value>dd/MM/yyyy</value></constructor-arg>.

Je rappelle que mm en java fait référence aux minutes alors que MM fait référence aux mois.

Une fois cette déclaration ajoutée dans le fichier applicationContext.xml, il suffit de définir la valeur comme cela :

Maintenant si je souhaite utiliser automatqiuement la valeur du jour, il est possible de définir un bean dateJour de la façon suivante :

Puis d'utiliser cet objet comme valeur de la propriété, ce qui donne dans notre cas :

Microsoft TechDays 2009

2009-02-23T15:35:00.001+02:00

Du 10 au 12 février, se tenait au palais des Congrès de Paris, la troisième édition des Microsoft Techdays.
Vous pouvez consulter mes comptes rendus des versions précédentes :

Cette année nous avons eu droit à moins de superlatif pour qualifier les TechDays : les années passées il s'agissait de l'événement Microsoft le plus important dans le monde. Cette année on parlait d'événement le plus important pour l'Europe.

Le format

Il n'a pas changé, je reprends en grande partie mes commentaires de l'année dernière : Il s'agit d'une série de conférences sur 3 jours, ouvertes chaque jour par une conférence plénières.

Chaque plénière possède son propre thème qui donne une connotation aux sessions de la journée :

1ère : le Développement
2nde : IT
3ème : R&D

Les sessions

Les conférences ou sessions durent chacune une heure. Plusieurs ont lieu en parallèle : il y avait une vingtaine de salles plus trois amphi (le nombre de sessions est constant par rapport à l'année dernière). Il n'est donc absolument pas envisageable d'assister à toutes les conférences. Mais celles-ci sont enregistrées et devrait être disponibles en webcast sur le site Microsoft.

Lors de l'inscription en ligne (gratuite), il était possible de s'inscrire aux différents sessions. Ces inscriptions ne donnent aucune garantie d'avoir une place. Les places sont servies aux premiers arrivés. On note une nette amélioration par rapport aux années précédentes : l'attribution des salles semble avoir pris en compte les pré-inscriptions, on a pu constaté qu'afin de faire face aux 3000 pré-inscriptions à la présentation de Windows 7, celle-ci a été programmée deux fois par jours en grand amphi. Cette année je n'ai pas eu l'impression qu'il y ait eu des gens refoulés à l'entrée, et je n'ai assisté qu'à une seule session dans laquelle il y a eu quelques personnes debout.

Chaque conférence dure une heure. Le niveau technique des intervenants est très élevé. Le discours n'est pas pollué par le marketing : c'est de la technique brute. De toute manière, l'auditoire est également très technique et ne laisserait pas passer le moindre déviation marketting.
Une heure c'est court pour faire une présentation technique d'un produit : chaque présentation est donc accès sur un aspect technique d'un produit. Il ne faut pas s'attendre à une formation sur cet aspect du produit : en revanche il est tout a fait possible de savoir ce que le produit est capable de faire, ses limites et le travail à fournir pour l'utiliser.
Pour moi, cette possibilité de bien comprendre à la fois l'adaptation d'un produit à un besoin et les efforts nécessaires à leur mise en oeuvre font des techdays un événement extrêmement intéressant.
Au vu du succès persistant des séances (y compris encore lors du troisième jour), j'en déduis que cet avis était partagé par le grand nombre.

Cette année les séances de questions/réponses à la fin des sessions ont quasiment disparu : la salle se vide rapidement à la fin de l'exposé, et ne reste que quelques irréductibles.

Les stands

Il y a avait un grand espace stands (sur un seul niveau). Les stands partenaires étaient moins nombreux cette année. J'ai pu constater le bon niveau des interlocuteurs sur les stands.

J'ai l'impression que l'espace qui permettait de manipuler les différents produits a disparu.

Affluence

C'est sans aucun doute un succès indéniable de Microsoft : un monde impressionnant et des sessions pleines. Le second jour, Microsoft annonçait 6000 participants à la séance plénière initiale (à comparer au 5400 de l'année précédente et aux 4500 de la première édition). De fait l'amphi a été les 3 jours plein.

L'organisation étant en nette amélioration et Microsoft tirant profit des deux premières années a mieux calibré les salles et les sessions. L'impression de fouillis et de trop grande affluence a complètement disparu.

Thèmes

Les thèmes couverts sont très nombreux : cela va de la production à la méthodologie. On va des produits de développement jusqu'aux produits d'exploitation. Il m'a semblé cette année, il n'y avait pas de sessions de R&D

La variété est grande et une session n'aborde qu'un aspect du produit. Un produit est généralement couvert par une série de plusieurs sessions.

Les produits en vogue cette année :

Windows 7 et Internet Explorer 8.
WPF et Silverlight
Windows Azure : l'OS pour le Cloud Computing de Microsoft

Ces trois produits ont retenu mon attention car ils apparaissent quasi systématiquement dans chaque session. Bien sur, on parle de Visual Studio, SharePoint, Biztalk... mais ces trois premiers produits semblent être omniprésents.

WPF et Silverlight

Le choix d'une techno pour développer une interface utilisateur parait un grand challenge avec Microsoft. On dispose de pas moins de 4 solutions différents :

WindowsForm
WPF et sa déclinaison WPF Browser Application
ASP.net avec ou sans Ajax
Silverlight

Dans tous les cas, il faudra probablement utiliser Visual Studio (qui aurait 60% de part de marché) pour le développement des règles de gestion. On peut être amené à utiliser des solutions de la gamme Expression si on souhaite faire ses propres contrôles ou faire des animations. Ma compréhension est que pour un développement d'une application de gestion standard Visual Studio suffit quelle que soit la solution.

Les critères influant le choix sont :

Le contrôle de l' environnement client : accès aux ressources du poste
Le besoin du mode déconnecté et la possibilité d'une synchronisation
Le degré d'interactivité
Le besoin d'utiliser des animations et des transformations
L'expérience des équipes de développement
Les contraintes de déploiement : type de poste et possibilité d'installation en local

Le critère le plus discriminant est le besoin de déploiement :

Asp.Net peut être déployé sur tout poste possédant un navigateur web. Le développement est susceptible de tourner dans un mobile.
Silverlight : il nécessite l'installation d'un plug-in dans le navigateur (sa taille est de 4 à 5 Mo). Un plug-in existe pour IE, Firefox et Safari. Il tourne sur Windows et MacOs. Un portage est en cours pour Linux. A priori un développement SilverLight ne tournera pas sur un iPhone ou un Blackberry. Le portage sous Windows Mobile est en cours de route.
WindowsForm : Il faut déployer l'application et se limiter aux postes windows
WPF : il faut également déployer l'application ainsi que le framework .Net
WPF Browser Application tourne dans un navigateur web mais nécessite l'installation du framework .Net en local. Cela exclu donc la plateforme MacOs.

De mon point de vu, si vous n'avez pas besoin d'accéder aux ressources locales du poste (fichier ou autres applications par exemple) j'opterai pour une solution web.

Silverlight permet d'avoir des animations très puissantes, de faire du temps réel mais le temps de chargement d'une application m'a paru long. Je ne suis pas sur que cette solution soit viable à travers un réseau bas débit (genre Edge). Silverlight depuis la v2, semble plus mature : il possède plus de contrôles.

ASP.Net enrichi par Ajax permet de construire une application HTML Javascript avec du fenétrage et du drag & drop. Je suis surpris de voir que pour ASP.Net on découvre l'intérêt du MVC.

Dans le cas contraire, la solution que pousse actuellement Microsoft est WPF (les WindowsForm ne sont plus censées évoluer). Malheureusement la solution semble manquer de maturité même s'il y a eu une grosse amélioration depuis la sortie de Visual Studio 2008 SP1. Par exemple, il manque le DataGrid et le DatePicker même s'ils sont disponibles sur CodePlex.

WPF nécessite le framework 3.0 de .NET. Il repose sur DirectX et permet un affichage vectoriel. C'est cette solution qui permet de construire des présentations à base de carrousel.

Travaillant principalement sous Java, le pattern MVC est pour moi un acquis, j'ai donc été fort surpris de voir plusieurs sessions insister sur ce pattern pour les développements ASP.Net ou Silverlight.

Silverlight avancée

Il s'agit d'une série de trucs pour la programmation avancée de Silverlight. Ces aspects sont liés à une approche MVC et la volonté de conserver un historique et du deeplinking (possibilité d'accéder directement à une page par son url).

On a deux services ASPX :

une page qui contient l'application Silverlight. Cette page contient un code Javascript et le code HTML. Le code Javascript cache le code HTML.
un service REST qui renvoie les données à l'application Silverlight

La correspondance entre les noms des urls permet de passer de l'un à l'autre sans difficulté.

Un autre élément est le framework Unity qui permet de faire de l'injection de dépendances. Son mécanisme associé à la notion de Weak Event permet de faire du bootstrapping et donc du chargement de modules à la demande. Il est également possible de remplacer un service ce qui permet de faire des tests unitaires.

Cette solution ressemble beaucoup dans les objectifs au framework J2EE Spring. Néanmoins l'approche de Unity est moins configurable que celle de Spring. Avec Unity tout se passe par programmation, là où Spring fonctionne par fichier de configuration.

Internet Explorer 8

L'élément le plus important de IE 8 pour un développeur est son nouveau moteur de rendu : le parsing et le rendu ont été modifié afin de respecter les standards et l'amélioration de la rapidité.

Cette évolution qui permet à IE 8 de passer le test ACID2 casse la compatibilité des nombreux sites conçues pour IE 6. Un mode de compatibilité a été prévu il est activable à plusieurs niveaux :

Il est possible d'activer le mode compatibilité en cliquant sur un bouton au bout de l'url. Cela rétablit le rendu du moteur IE 6.
Il est possible d'ajouter un tag X-UA-compatible dans la page afin d'indiquer à IE 8 d'utiliser le moteur de rendu d'IE 6.
Il est possible d'ajouter le tag pour toutes les pages du site en modifiant le web.config de IIS. Cette opération est également possible dans Apache.
Microsoft maintient une liste des sites non compatibles, il est possible d'indiquer au navigateur d'utiliser cette liste et de compléter cette liste.

IE 8 rejoint l'approche de Google Chrome avec l'isolation des onglets dans des processus distincts.

il est possible d'avoir une authentification séparée pas onglet
le crash d'un onglet n'a pas d'impact sur les autres onglets

Autre nouveauté de IE 8 pour les développeurs : une toolbar de profiling et déboggage.

Cette toolbar reprend la MS Dev Toolbar de IE 7.0 mais est cette fois directement intégrée dans IE 8. Elle ajoute des fonctionnalités de profiling et déboggage.

Pour les utilisateurs IE 8.0 introduit deux nouvelles fonctionnalités :

WebSlice : permet de définir comme favori un morceau de page. Le navigateur traite le WebSlice comme un flux RSS en allant vérifier la présence d'une mise à jour.
Accelerator : permet de déclencher des actions sur une sélection comme afficher une adresse sur une carte. Cette fonctionnalité permet d'éviter le copier/coller.

Ces fonctionnalités ne peuvent apparaître que si le site met à disposition le service des utilisateurs, ce service nécessitant du développement :

WebSlice : il faut modifier la page HTML en ajoutant l'attribut Class HSLICE. Il existe deux autres attributs de class qui vont permettre la définition du titre et du contenu. L'activation pourra être réalisé en modifiant un attribut de class en ajoutant les nouveaux attributs ou en ajoutant de nouveaux tags class.
Accelerator : il faut définir le service dans un fichier xml Open Service. Ce fichier disponible au niveau du navigateur permet l'apparition du menu sur le clic droit et indique au navigateur le service qu'il va devoir appeler avec la sélection.

Ces deux services ont donc tous les deux la particularité de nécessiter des développement spécifiques qui ne pourront être utilisés que par des utilisateurs de IE 8.0

Windows 7

C'est le thème qui a connu le plus fort engouement : 6 sessions en grand amphi.

Pour Microsoft les 3 thèmes principaux de cette nouvelle version qu'ils appellent Windows Sept (le marketing a frappé) sont :

Expérience utilisateur
Sécurité et le contrôle
Gestion des postes de travail

Coté expérience utilisateur, Microsoft est parti de la constatation que 75% des utilisateurs avaient 5 à 9 fenêtres ouvertes en même temps. La refonte de la barre des taches doit permettre de résoudre cette problématique tout comme la possibilité de docker une fenêtre sur un coté de l'écran.

Honnêtement ces deux fonctionnalités doivent pouvoir amener des gains de productivité intéressant dans l'utilisation de windows.

Autre élément pour l'expérience utilisateur, la recherche "unifiée" avec la Desktop Search de Vista. La présentation de cette fonctionnalité ne m'a pas paru d'une grande clarté et je n'ai pas très bien compris son principe au delà de la soupe marketing.

Pour finir le coté expérience utilisateur, Windows 7 est tactile sans programmation. J'ai pu jouer sur le stand Dell avec le Latitude XT2 (un tablet PC tactile présenté sous Windows 7) : c'est très agréable et efficace : la réactivité est bonne et on retrouve des sensations proches de l'iPhone.

Néanmoins, au delà de l'aspect tactile, l'interface n'a pas été pensé pour cela : les menus et boutons continuent d'avoir leur bonne vieille taille adaptée à une souris mais pas du tout en accord avec un doigt. Microsoft gagnerait à lire les conseils d'Apple pour le développement d'application iPhone : la taille d'un doigt étant globalement connu, cela amène un certain nombre de contraintes immédiates qu'énumère le document Apple.

Peut-être faut-il prévoir au niveau de Windows une modification de l'interface dès qu'elle perçoit qu'on est passé en mode tactile.

Pour le moment, je pense que pour un tablet PC comme le altitude XT2 de Dell, l'aspect tactile de Windows 7 est quelque chose de génial : on peut le prendre chez soi comme un livre et parcourir le web du doigt (l'iPhone se montre redoutablement efficace dans cette tâche). Pour d'autres utilisations comme la prise de note, le bon vieux stylets (également disponible sur le XT2) reste supérieur.

Pour la gestion du poste de travail, on notera tout d'abord une meilleure gestion de l'énergie qui permet un accroissement de 15% de l'autonomie. Les personnes de Dell, semblait très surprise (agréablement) de l'autonomie du XT2. Windows 7 réalise cette prouesse en désactivant les services inutiles.

il faut noter que Windows 7 tourne sur un netbook et que le démarrage semblait rapide : certe il s'agit d'une machine de démonstration avec 1 Go de RAM. on sait que les temps de démarrage des différents Windows se dégradent au fur et à mesure des installations et de son utilisation. Donc le test de démarrage ne peut pas être considéré comme significatif en dehors du fait que Windows 7 tourne sur un Netbook.

Pour les déploiements, Microsoft indique que les mêmes outils de déploiement et d'administration qui marchent avec Vista (pas avec XP) fonctionneront avec Seven. Microsoft compte également sur 3 autres solutions (qui m'ont paru nécessiter un petit supplément financier) pour faciliter la phase de transition et de déploiement :

App-V : Les applications sont virtualisées et déployer en central. L'application tourne sur le poste Windows 7 normalement.
MED-V on ouvre une machine virtuelle pour lancer l'application. Cette machine virtuelle peut être de type XP. Cette solution permet de réduire les problèmes de compatibilité entre une application et le système d'exploitation. L'utilisateur ne se rend compte de rien : il ne passe par sur un bureau XP. Il voit son application comme tout autre application Windows 7.
VDI (Virtual Desktop Infrastructure) : Le PC est juste un terminal graphique comme avec Citrix.

Pour la sécurité, Windows 7 amène 4 nouveautés :

Amélioration de User account control : mais je n'ai pas vu quelles améliorations
Bitlocker : il permet d'encrypter le contenu d'une clé USB
AppLocker : élimine les applications interdites en permettant la définition d'une liste d'applications autorisées ou interdites. Il est possible de se limiter à une version ou de l'étendre à toutes les application d'un éditeur
IE 8 permet d'autoriser un activex a un site

Du coté de la mobilité

J'ai assisté à deux présentations sur le sujet toutes les deux fort décevantes. Microsoft est très en retard sur Apple (c'est l'utilisateur d'iPhone qui parle).

Une des présentations essayait de montrer différentes applications pour Mobile toute de pale clone de version existante sur l'iPhone.

Le plus gros reproche que l'on peut faire à Microsoft est de ne pas comprendre les enjeux du tactiles : certes toutes les applications et terminaux étaient tactiles et cela semble être une direction irrémédiable du monde mobile, mais leur interface est inadaptée : un pouce à une certaine taille et il faut accepter de faire tout les boutons d'une certaine taille, tout comme les menus et les listes clicables. C'est la règle. On a l'impression que Blackberry et Palm ont fait évoluer leur OS afin de prendre cela en considération (il suffit somme toute de copier Apple) mais Microsoft reste à la traîne obligeant les constructeur à rhabiller l'OS afin de le rendre utilisable.

Windows Azure et le cloud computing

Il s'agit d'un des sujets phare de ces TechDays et l'affluence était au rendez-vous.

Le Cloud Computing c'est globalement faire héberger ses applications dans un gros datacenter chez un fournisseur d'infrastructure. Cela diffère de l'hébergement classique par l'accent qui est mis sur la virtuallisation : il ne s'agit pas d'espace partagé ou d'une machine physique dédiée mais d'un environnement virtuel. On voit la boucle de la virtualisation se fermer avec l'intéret majeur que représente la virtuallisation pour le cloud computing.

Le Cloud Computing est marketé en mettant l'accent sur le on-demand cher à IBM : je ne sais pas de quelle puissance je vais avoir besoin ou si j'ai besoin d'une forte puissance ponctuelle, le cloud computing est la solution adaptée car l'allocation est dynamique et l'on paye à la consommation.

Le Cloud computing rejoint pour Microsoft leur slogan Software + Service qui reste pour moi une vaste fumisterie du Marketing Microsoft : vous pouvez tout faire, où plutôt tout nous acheter : acheter de bon vieux logiciel comme Windows, Word, SharePoint ou bien nous acheter des services comme Azure mais également Microsoft Live ou Microsoft Live Office dans laquelle on retrouvera SharePoint en service. N'ayez pas peur Monsieur le client, tout est légitime et stratégique.

En langage marketing S+S c'est mélanger les différentes approches : se faire héberger et payer un service dans certain cas (offre Windows Live pour les particuliers et Office Live pour les entreprises) et acheter ses propres logiciels dans d'autres cas.

Un point récurrent des présentations d'Azure, c'est l'importance que Microsoft accorde et met en avant sur son savoir faire en gestion de très grosses infrastructures :

240 milliard de messages MS Messenger envoyés par mois
10 milliard de page MSM consultés par mois
10 000 serveurs ajoutés par mois à son infrastructure

On apprend que Microsoft prévoit l'ouverture de 3 nouveaux datacenter (500 M$ chacun d'investissement) et que Microsoft est maintenant capable de construire en 3 mois un DataCenter, là ou il y a deux ans il leur fallait 18 mois.

Microsoft veut être perçu comme un acteur majeur de l'hébergement avec en ligne de mire Google et Amazon. Pour ceux qui ne le savent pas, Amazon avec son offre Amazon ec2 est probablement le premier arrivé dans ce domaine du Cloud Computing.

Le Cloud Computing est un secteur à gros investissement (un datacenter de l'ordre de 500 M$) qui nécessite un savoir faire dans l'administration et la gestion de ce type d'infrastructure.

Windows Azure est une offre en construction : ce que l'on peut dire c'est qu'il s'agit de service car c'est Microsoft qui héberge vos applications. Microsoft prend à sa charge les coûts d'exploitation et d'administration. L'approche est de permettre grâce à la virtuallisation des gains d'échelle sur l'exploitation grâce à un meilleur savoir faire notamment en gestion de l'énergie.

Le service comprend à la fois l'hébergement physique mais également ce qui conviendrait d'appeler un "système d'exploitation virtuel" : c'est probablement ce qu'il convient d'appeler Azure. Au dessus de ce système d'exploitation, il y a une série de services techniques (comme le stockage de données) qui s'appelle Azure Services Platform.

Contrairement à de l'hébergement dédié où l'on doit gérer sa plate-forme et ses mises à jour, là tout est compris mais il n'est pas possible d'espérer rester sur une version antérieur : on retrouve le principe de la beta permanente du Web 2.0. Il faudra donc bien gérer ses différentes interfaces.

Aujourd'hui Azure est en beta, il est possible de demander un jeton qui donne droit à un projet et 50 Go de stockage. Attention, il faut des jetons pour chaque service comme l'identification ou le stockage.

Nous allons maintenant nous concentrer sur Azure l'OS pour le cloud et le développement d'application.

Un projet correspond à une machine virtuelle dont la création a été pris en charge par Microsoft : vous disposez de deux environnement : production et pré-production avec pour ce dernier une url temporaire.

La programmation est pour l'heure exclusivement en .Net : il existe des templates de projet dans Visual Studio qui sont dédié à Azure. Microsoft fait miroiter l'ouverture dans le futur au développement PHP, Ruby ou même Java. Il est vrai qu'un hébergeur se doit d'être "ouvert" et beaucoup d'intervenants (je ne parle pas que de Azure) ont pris soin de montrer que certaines solutions Microsft s'interfacer parfaitement avec d'autres technologies. Il sera peut-être même possible d'héberger grâce à la virtuallisation des applications en code non-managé.

Néanmoins aujourd'hui pour développer pour Azure, se sera avec Visual Studio en .Net sous Vista. XP n'est pas et ne sera pas supporté : il est possible de tester le développement en local mais cela nécessite IIS 7 qui ne tourne pas sous XP.

Les API de Azure sont orientées Cloud computing on retrouve notamment les services suivants :

Stockage : même si cela repose sur une version de SQL server, il ne s'agit pas de SQL. On retrouve des tables et des blobs.
Identification : on utilise la connexion Windows Live. Il travaille actuellement sur le support de la norme OpenId
Communication par messages avec des services de queue
Des services pour le déploiement avec la production et préproduction
Des services d'administrations avec notamment un service de log. Les logs sont stockées comme un BLOB qu'il est ensuite facile de récupérer pour analyse.
Data Sync : un service pour utilisateur occasionnel
Workflow qui assure le support de scénario
ESB qui est une sorte de bus dans le cloud.

Tous les services sont accessibles à travers un service REST (il est donc possible de les appeler depuis du Java) y compris le service de stockage.

La programmation doit tenir compte d'un premier aspect primordial : on doit travailler en mode medium trust (le mode de mutualisation des applications web). Il faudra ensuite faire très attention à la Retry Policies : c'est le comportement d'une application quand un utilisateur plus ou moins patient clique plusieurs fois sur un même bouton. Ce point est très important en Web et donc sur le cloud.

Azure distingue 2 rôles :

Rôles web aspx : création d'une interface web
Rôle worker .cs batch : création d'un traitement

L'offre Azure semble être quelque chose de très intéressant : on sent toute la puissance et la cohérence des investissements de Microsoft. Il s'agit probablement pour Microsoft d'un enjeux majeur voir de l'enjeux majeur et identifier comme tel.

La Programmation fonctionnelle

La programmation fonctionnelle est un des axes de réflexion de la R&D de Microsoft. Sa déclinaison "commerciale" est le langage F#.

Les langages classiques sont des langages impératifs : on donne des ordres explicites à la machine. On programme la machine : on lui dit ce qu'elle doit faire et dans quel ordre. Cette approche nécessite de déclarer les variables. Cette approche est difficilement parallelisable : on pilote la machine étape par étape.

La programmation fonctionnelle se veut déclarative : le compilateur ou la machine virtuelle pourra plus facilement optimiser la parallelisation des traitements. Je pense que l'importance que revêt pour Microsoft cette approche repose principalement sur cette possibilité de parallélisation accrue : pour Microsoft, il n'est plus possible de pousser le cadencement des processeurs, il faut s'orienter vers des approches multi-coeur ou multi-processeurs : dans ces deux cas, la parallélisation est importante pour profiter pleinement des nouvelles architectures. C'est pour cette raison que la programmation focntionnelle a besoin de définir de l'asynchronisme et des points de rencontre/synchronisation.

Microsoft semble considérer linq (solution de mapping objet/relationnel proche de hibernate et de jpa) comme une approche de type déclarative alors que le SQL repose sur une approche impérative.

Le F# est loin de me paraître plus compréhensible que le C# (sachant que je ne connais ni l'un ni l'autre et qu'ils sont très proche en terme de syntaxe). De mon point de vu, le F# est un projet de long haleine pour Microsoft qui n'a pas réellement d'utilité immédiate aujourd'hui.

La présentation a mis l'accent sur la possibilité et les intérêts de ne pas typer en F# : le var du C# (solution qui permet de ne pas définir le type d'une variable en lui disant de prendre le type du coté gauche de l'expression).

Le typage en F# permet une approche générique qui permet de travailler avec un type inconnu qui est résolu plus tard dans le code ou ailleurs. Attention ! le type est connu par l'éditeur, l'intellisense fonctionne !

Dans cette perspective de typage, le Let doit être vu comme un binding permettant de résoudre un typage et non pas comme une affectation simple.

Conclusion

les Techdays ont été comme les années précédentes à la hauteur de mes attentes. Microsoft a su améliorer son organisation rendant moins sensible la grande affluence de cet événement.

Les deux axes futures à moyen terme qui m'ont paru intéressant sont : Silverlight et Azure. La programmation fonctionnelle est quelque chose qui reste pour moi très lointain et Windows 7 est du présent.

StreetView de l'iPhone 2.2

2008-11-22T22:18:00.002+02:00

La dernière mise à jour (au 22/11/2008) du firmware de l'iPhone inclus une évolution majeure du logiciel de cartographie Google Map : Plans.

La fonctionnalité StreetView de Google a été ajouté. Cette fonctionnalité est réellement surprenante et permet de visualiser la rue, un rond point comme si on y était.

L'utilisation de StreetView n'est pas des plus intuitives c'est pourquoi je vous propose un rapide tutorial illustré.

La première étape est d'ouvrir l'application Plan. On se place sur le lieux qui nous intéresse : disons par exemple la place de l'Etoile à Paris

StreetView est accessible depuis le mode Plan ou le mode Satellite (c'est au choix). Pour l'activer, il faut placer un repère. Pour cela, il faut que le lieux visé soit si possible au centre de l'écran. On appuie sur l'image en bas à droite de la page qui se soulève.

On appuie sur Replacer le repère et on obtient :

Notez, le petit icône orange à gauche de Faite glisser le repère. Si vous attendez quelques secondes, le nom du lieu apparaît sous Faite glisser le repère.

Si vous appuyez sur l'icone Orange vous basculer en mode StreetView (j'imagine que le petit bonhomme blanc symbolise le piéton qui se promène pour nous dans les rues de Paris).

Le mode StreetView nécessite de tenir l'iPhone en mode paysage. Le petit cercle en bas à droite indique notre position sur le plan. La zone plus clair indique notre angle de vue.

Vous pouvez utiliser votre doigt pour faire tourner la vue et découvrir l'arc de Triomphe :

Par moment quand vous tourner vous voyez apparaître une ligne au sol avec des flèches.

Ceux sont les axes que vous pouvez parcourir avec StreetView : vous allez pouvoir avancer en le suivant. Il y a également le nom de la rue qui est inscrit : cela nécessite de regarder vers le bas : Utilisez pour cela votre doigt (un mouvement du haut vers le bas).

Pour avancer, appuyer sur la flèche que vous voyez au loin. Attention, on avance doucement et il faut patienter un petit peu entre chaque coup.

Si vous voulez avancer plus vite n'attendez pas que l'image s'affiche et appuyez de nouveau sur la flèche. Vous pouvez appuyer plusieurs fois d'affilées et progresser ainsi plus rapidement. Le petit cercle est mise à jour, vous pouvez ainsi surveiller votre progression.

Pour sortir du mode StreetView il suffit d'appuyer sur le cercle. On revient à la vue du Plan.

Et voila, on a fait un tour de la fonctionnalité StreetView du firmware 2.2 de l'iPhone.

Comment desimlocker légalement son iPhone v1 ?

2008-08-29T22:44:00.005+02:00

Un grand nombre d'iPhone v1 ont été acheté il y a plus de 6 mois. Si c'est votre cas vous pouvez le déverrouiller en toute légalité. Une fois déverrouillé vous pourrez utiliser votre iPhone avec une autre carte SIM d'un autre opérateur.

La procédure est relativement simple :

elle commence par un appel au service client d'Orange : le 700 depuis votre mobile ou 3970 depuis une ligne fixe. Tapez le 9 pour parler à un conseiller.
Le conseiller va vous demander le numéro de la ligne et le code IMEI de l'iPhone. Il est accessible dans Réglage -> Générale -> Informations et IMEI ou tout simplement au dos de votre iPhone.
Après vérification que cela fait bien plus de 6 mois que l'iPhone est en votre possession, il demande un email. C'est à cet email qu'Apple enverra la procédure pour déverrouiller l'iPhone
Quelques jours après cet appel (1 jour dans mon cas) vous recevrez un email décrivant la procédure.

Avant de suivre la procédure, il est souhaitable de faire une synchronisation avec votre PC. Il peut être utile au préalable de vous assurer d'avoir installé la dernière version du Firmware de l'iPhone. Je ne l'avais pas fait et la procédure a différé de celle décrite dans l'email et je n'ai pu éviter l'installation de la 2.0.2.

La procédure de synchronisation consiste :

Connecter son PC à Internet. Cela est fondamentale car je pense que iTunes va vérifier sur un site d'Apple qu'il peut bien desimlocker voter iPhone.
Il faut brancher son iPhone au PC.
Il faut appuyer sur le bouton Restaurer
Si comme moi la version de l'iPhone est ancienne, il affiche le message ci-dessous, vous n'avez que le choix d'opter pour une Restauration et mise à jour. Il va installer la nouvelle version.

A la fin du processus, il indique que la SIM est Locked. Il faut la déverrouiller en tapant votre code.

A la fin du processus, vous devriez voir apparaître le message suivant :

Vous n'aurez que le choix de continuer, il propose de reconfigurer votre iPhone :

Pour ma part, j'ai choisi l'option Restaurer à partir de la sauvegarde.

Après quelques minutes, votre iPhone est enfin déverrouillé.

Maintenant si vous éteignez votre iPhone vous pouvez changer de carte SIM et mettre celle d'un autre opérateur. Vous pouvez le rallumer, vous pouvez utiliser pour appeler, votre carnet d'adresse et votre calendrier son toujours présent. En fait seul le réseau a changé.

Vous pouvez synchroniser et mettre à jour votre iPhone avec iTunes sans problème.

En conclusion, la procédure est simple même si elle peut être un peu longue. J'ai été fort surpris de la bonne volonté du conseiller Orange. Il suffit juste de demander.

Attention ! La procédure peut laisser penser qu'on peut déverrouiller son iPhone en faisant un Restaurer. Ce n'est pas le cas, la procédure, doit vérifier dans une base de données qu'il est possible de le déverrouiller.

Dans la série iPhone, vous pouvez consulter ces autres billets :

Se préparer pour l'iPhone et la synchronisation Outlook
Retour d'expérience de l'iPhone
Utilisation du Wifi avec l'iPhone : que ce soit sa box personnel ou d'un hotspot Wifi
Comment synchroniser son iPhone avec un nouvel ordinateur ?