SWT : Standard Widget Toolkit. La bibliotheque SWT utilise les composants natif du système d’exploitation pour la gestion des interfaces graphiques par l’intermédiaire de JNI (Site officiel).

JFace : C’est un toolkit de manipulation de SWT.

Suite a cette série de test j’ai décidé d’utiliser Swing pour la partie graphique de ce micro projet car :

• Le besoin de performance n’est pas vital.
• La compatibilité est un plus.
• L’interface reste identique sur tous les systèmes.
• Permet d’utiliser le modèle MVC.

• AWT
• Swing
• SWT
• JFace
• JavaFX

AWT : Abstract Windowing Toolkit cette api est  totalement indépendante du matériel. Elle est moins utilisée actuellement au profit de Swing.

Hello World avec AWT sous windows XP et Debian

SWING : C’est une surcouche s’appuyant sur AWT et java2D. Les performances sont un peu moins bonnes que celle d’AWT, ce qui parait logique puisque Swing s’appuie dessus. Les interfaces graphiques créées sont très similaire pour tous les systèmes d’exploitation.

Hello World avec SWING sous windows XP et Debian

• Collection (non ordonnée)
• List (utilise un index, permet les doublons)
• Map (utilise une clé)
• Queue (Fonctionnement de type FIFO ou LIFO)
• Set (pas de doublon, peut etre ordonnée)

Dans ce cas nous utiliserons des HashSet car :

• pas de doublon a gerer
• parcour linéare
• pas de besoin d’index

Le Constructeur est charger d’initialiser la collection d’Hiragana de référence. Pour ce faire il initialise un document DOM avec la méthode initDoc,et le parcours à l’aide de la méthode privé nextHiragana. A chaque noeud hiragana rencontré il instancie un objet Hiragana grâce à la méthode getCurrentHiragana puis l’ajoute à la collection hiraganaFullCollection. Enfin la méthode getHiraganaFullCollection permet de récuperer La Collection complète des Hirigana présent dans le ficher xml.

import java.util.HashSet;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import org.w3c.dom.Document;
import org.w3c.dom.Node;
import java.io.File;
import java.io.FileNotFoundException;

public class Hiraganas {
  private HashSet hiraganaFullCollection;
  private final String myXmlFilePath="hiragana.xml";
  private Document myXmlDoc=null;
  private DocumentBuilder docBuilder;
  private DocumentBuilderFactory docFactory;
  private Node iteratorNode;

  public Hiraganas() throws Exception {
    hiraganaFullCollection = new HashSet();
    myXmlDoc = initDoc(new File(myXmlFilePath));
    this.iteratorNode = nextHiragana(myXmlDoc.getFirstChild());
    while (!(this.iteratorNode == null)) {
      hiraganaFullCollection.add(getCurrentHiragana(this.iteratorNode));
      this.iteratorNode = nextHiragana(this.iteratorNode);
    }//end while
  }// end constructor

  private Document initDoc(File xmlFile) throws Exception {
    if (!xmlFile.canRead()) {
      throw new Exception("File " + xmlFile.getName() + " no readable");
    }//end if
    docFactory = DocumentBuilderFactory.newInstance();
    docBuilder = docFactory.newDocumentBuilder();
    return docBuilder.parse(xmlFile);
  }//end initDoc

  private Hiragana getCurrentHiragana(Node currentNode) throws Exception {
    return new Hiragana(currentNode);
  }// end getCurrentHiragana

  private Node nextHiragana(Node currentNode) {
    Node nextNode = null;
    if (currentNode == null) { return nextNode; }

    if (currentNode.getNodeName().equals("hiragana")) {
      nextNode = currentNode.getNextSibling();
    }//end if

    if (currentNode.getNodeName().equals("hiraganas")) {
      nextNode = currentNode.getFirstChild();
    }//end if

    while (!(nextNode == null) && !(nextNode.getNodeName().equals("hiragana"))) {
      nextNode = nextNode.getNextSibling();
    }//end while
    return nextNode;
  }//end nextHiragana

  public HashSet getHiraganaFullCollection() {
    return hiraganaFullCollection;
  }//end getHiraganaFullCollection
}

import org.w3c.dom.Node;
import java.lang.Exception;

//classe Hiragana
public class Hiragana {
  private Integer id;
  private String image;
  private String romanji;
  private String sound;
  private Integer level;

  //constructeur
  public Hiragana(Node nH) throws Exception {
    if (nH == null) {
      throw (new Exception("Null Node"));
    }// end if
    if (!nH.getNodeName().equals("hiragana"))
    {
      throw (new Exception("Bad Node"));
    }// end if

    id = Integer.getInteger(nH.getAttributes().getNamedItem("id").getNodeValue());
    Node child = nH.getFirstChild();

    while (!(child.getNextSibling() == null)) {

      if (child.getNodeName().equals("image")) {
        image = child.getAttributes().getNamedItem("uri").getNodeValue();
      }//end if

      if (child.getNodeName().equals("romanji")) {
        romanji = child.getFirstChild().getNodeValue();
      }//end if

      if (child.getNodeName().equals("level")) {
        level = Integer.getInteger(child.getFirstChild().getNodeValue());
      }//end if

      if (child.getNodeName().equals("son")) {
        sound = child.getAttributes().getNamedItem("uri").getNodeValue();
      }// end if

      child = child.getNextSibling();
    }//end while
  }//end constructeur

  //getters
  public Integer getId(){ return this.id; }
  public String getImage(){ return this.image; }
  public String getSound(){ return this.sound; }
  public String getRomanji(){ return this.romanji; }
  public Integer getLevel(){ return this.level; }
}

Un appel de myDoc.getFirstChild() permet de récupérer le 1er noeud enfant du document, à savoir dans notre cas “hiraganas”. On le stock dans currentNode puis on récupère aussi son premier noeud enfant. Contrairement à ce que l’on pourrait croire le noeud récupérer n’est pas “hiragana” mais un noeud de type Text contenant “nt” qui correspond au retour a la ligne et la tabulation utilisé après la balise. Avec childNode.getNextSibling() nous allons enfin pouvoir récupérer le premier noeud “hiragana”. On effectue un test pour déterminer si le noeud possède des attributs si c’est le cas on récupère une liste des attributs. Dans notre cas nous allons afficher le nom et la valeur de l’attribut id.

Nous venons de faire le tour des fonctions primaire de navigation dans un document xml ce qui devrait nous permettre de construire une collection d’hiraganas.

import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import org.w3c.dom.Document;
import org.w3c.dom.NamedNodeMap;
import org.w3c.dom.Node;
import java.io.File;

public class xmlReader {

  public static void main(String[] args) {
    Document myDoc=null;
    DocumentBuilder docBuilder;
    DocumentBuilderFactory docFactory;
    Node currentNode,childNode,nextChildNode;
    docFactory = DocumentBuilderFactory.newInstance();

    try {
      docBuilder = docFactory.newDocumentBuilder();
      myDoc = docBuilder.parse(new File("hiragana.xml"));
    } catch (Exception e) {
      System.out.println("Exception : " + e.getLocalizedMessage());
    }//end try catch

    //first
    currentNode = myDoc.getFirstChild();
    System.out.println("node name : " + currentNode.getNodeName());

    //child
    childNode = currentNode.getFirstChild();
    System.out.println("first child node name : " + childNode.getNodeName());

    //nextChildNode
    nextChildNode = childNode.getNextSibling();
    System.out.println("next child node name : " + nextChildNode.getNodeName());

    //getAttributes
    if (nextChildNode.hasAttributes()) {
      NamedNodeMap attributeList;
      attributeList = nextChildNode.getAttributes();
      System.out.println("name : " + attributeList.getNamedItem("id").getNodeName());
      System.out.println("id : " + attributeList.getNamedItem("id").getNodeValue());
    }//end if

  }//end main
}//end xmlReader