Java Language
XOM - Modèle d'objet XML
Recherche…
Lecture d'un fichier XML
Pour charger les données XML avec XOM, vous devez créer un Builder
partir duquel vous pouvez le créer dans un Document
.
Builder builder = new Builder();
Document doc = builder.build(file);
Pour obtenir l'élément racine, le parent le plus élevé du fichier xml, vous devez utiliser la getRootElement()
sur l'instance du Document
.
Element root = doc.getRootElement();
Maintenant, la classe Element a beaucoup de méthodes pratiques qui facilitent la lecture de XML. Certains des plus utiles sont énumérés ci-dessous:
-
getChildElements(String name)
- Retourne une instanceElements
qui agit comme un tableau d'éléments -
getFirstChildElement(String name)
- renvoie le premier élément enfant avec cette balise. -
getValue()
- Retourne la valeur dans l'élément. -
getAttributeValue(String name)
- Retourne la valeur d'un attribut avec le nom spécifié.
Lorsque vous appelez la getChildElements()
vous obtenez une instance Elements
. De là, vous pouvez parcourir et appeler la méthode get(int index)
pour récupérer tous les éléments à l'intérieur.
Elements colors = root.getChildElements("color");
for (int q = 0; q < colors.size(); q++){
Element color = colors.get(q);
}
Exemple: Voici un exemple de lecture d'un fichier XML:
Fichier XML:
Code pour le lire et l'imprimer:
import java.io.File;
import java.io.IOException;
import nu.xom.Builder;
import nu.xom.Document;
import nu.xom.Element;
import nu.xom.Elements;
import nu.xom.ParsingException;
public class XMLReader {
public static void main(String[] args) throws ParsingException, IOException{
File file = new File("insert path here");
// builder builds xml data
Builder builder = new Builder();
Document doc = builder.build(file);
// get the root element <example>
Element root = doc.getRootElement();
// gets all element with tag <person>
Elements people = root.getChildElements("person");
for (int q = 0; q < people.size(); q++){
// get the current person element
Element person = people.get(q);
// get the name element and its children: first and last
Element nameElement = person.getFirstChildElement("name");
Element firstNameElement = nameElement.getFirstChildElement("first");
Element lastNameElement = nameElement.getFirstChildElement("last");
// get the age element
Element ageElement = person.getFirstChildElement("age");
// get the favorite color element
Element favColorElement = person.getFirstChildElement("fav_color");
String fName, lName, ageUnit, favColor;
int age;
try {
fName = firstNameElement.getValue();
lName = lastNameElement.getValue();
age = Integer.parseInt(ageElement.getValue());
ageUnit = ageElement.getAttributeValue("unit");
favColor = favColorElement.getValue();
System.out.println("Name: " + lName + ", " + fName);
System.out.println("Age: " + age + " (" + ageUnit + ")");
System.out.println("Favorite Color: " + favColor);
System.out.println("----------------");
} catch (NullPointerException ex){
ex.printStackTrace();
} catch (NumberFormatException ex){
ex.printStackTrace();
}
}
}
}
Cela va imprimer dans la console:
Name: Smith, Dan
Age: 23 (years)
Favorite Color: green
----------------
Name: Autry, Bob
Age: 3 (months)
Favorite Color: N/A
----------------
Écrire dans un fichier XML
L'écriture dans un fichier XML à l'aide de XOM est très similaire à la lecture, sauf dans ce cas, nous créons les instances au lieu de les extraire de la racine.
Pour créer un nouvel élément, utilisez l' Element(String name)
constructeur Element(String name)
. Vous voudrez créer un élément racine pour pouvoir l’ajouter facilement à un Document
.
Element root = new Element("root");
La classe Element
contient des méthodes pratiques pour éditer les éléments. Ils sont énumérés ci-dessous:
-
appendChild(String name)
- cela définira essentiellement la valeur de l'élément à nommer. -
appendChild(Node node)
- cela fera dunode
le parent des éléments. (Les éléments sont des nœuds pour que vous puissiez analyser les éléments). -
addAttribute(Attribute attribute)
- ajoutera un attribut à l'élément.
La classe d' Attribute
a deux constructeurs différents. Le plus simple est Attribute(String name, String value)
.
Une fois que tous vos éléments sont ajoutés à votre élément racine, vous pouvez le transformer en Document
. Document
prendra un Element
comme argument dans son constructeur.
Vous pouvez utiliser un Serializer
pour écrire votre XML dans un fichier. Vous devrez créer un nouveau flux de sortie à analyser dans le constructeur de Serializer
.
FileOutputStream fileOutputStream = new FileOutputStream(file);
Serializer serializer = new Serializer(fileOutputStream, "UTF-8");
serializer.setIndent(4);
serializer.write(doc);
Exemple
Code:
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import nu.xom.Attribute;
import nu.xom.Builder;
import nu.xom.Document;
import nu.xom.Element;
import nu.xom.Elements;
import nu.xom.ParsingException;
import nu.xom.Serializer;
public class XMLWriter{
public static void main(String[] args) throws UnsupportedEncodingException,
IOException{
// root element <example>
Element root = new Element("example");
// make a array of people to store
Person[] people = {new Person("Smith", "Dan", "years", "green", 23),
new Person("Autry", "Bob", "months", "N/A", 3)};
// add all the people
for (Person person : people){
// make the main person element <person>
Element personElement = new Element("person");
// make the name element and it's children: first and last
Element nameElement = new Element("name");
Element firstNameElement = new Element("first");
Element lastNameElement = new Element("last");
// make age element
Element ageElement = new Element("age");
// make favorite color element
Element favColorElement = new Element("fav_color");
// add value to names
firstNameElement.appendChild(person.getFirstName());
lastNameElement.appendChild(person.getLastName());
// add names to name
nameElement.appendChild(firstNameElement);
nameElement.appendChild(lastNameElement);
// add value to age
ageElement.appendChild(String.valueOf(person.getAge()));
// add unit attribute to age
ageElement.addAttribute(new Attribute("unit", person.getAgeUnit()));
// add value to favColor
favColorElement.appendChild(person.getFavoriteColor());
// add all contents to person
personElement.appendChild(nameElement);
personElement.appendChild(ageElement);
personElement.appendChild(favColorElement);
// add person to root
root.appendChild(personElement);
}
// create doc off of root
Document doc = new Document(root);
// the file it will be stored in
File file = new File("out.xml");
if (!file.exists()){
file.createNewFile();
}
// get a file output stream ready
FileOutputStream fileOutputStream = new FileOutputStream(file);
// use the serializer class to write it all
Serializer serializer = new Serializer(fileOutputStream, "UTF-8");
serializer.setIndent(4);
serializer.write(doc);
}
private static class Person {
private String lName, fName, ageUnit, favColor;
private int age;
public Person(String lName, String fName, String ageUnit, String favColor, int age){
this.lName = lName;
this.fName = fName;
this.age = age;
this.ageUnit = ageUnit;
this.favColor = favColor;
}
public String getLastName() { return lName; }
public String getFirstName() { return fName; }
public String getAgeUnit() { return ageUnit; }
public String getFavoriteColor() { return favColor; }
public int getAge() { return age; }
}
}
Ce sera le contenu de "out.xml":