Die Anleitung zu Java XStream

Was ist XStream?
Die Bibliothek XStream
Einige Klasse zur Teilnahme an die Beispiele
Das Java Objekt zur XML umwandeln
Alias benutzen (Das Pseudonym)
XStream Annotation
XStream Converter

1. Was ist XStream?

XStream ist eine Java Open Source Code Library. Es wandelt ein Java Objekt zu einem XML Dokument um und umgekehrt

2. Die Bibliothek XStream

Sie können die Bibliothek XStream bei ... herunterladen:

http://mvnrepository.com/artifact/com.thoughtworks.xstream/xstream

Oder melden Sie die Anwendung von der Bibliothek XStream mit Maven an

<!-- http://mvnrepository.com/artifact/com.thoughtworks.xstream/xstream -->
<dependency>
    <groupId>com.thoughtworks.xstream</groupId>
    <artifactId>xstream</artifactId>
    <version>1.4.8</version>
</dependency>

3. Einige Klasse zur Teilnahme an die Beispiele

Address.java

package org.o7planning.xstreamtutorial.beans;

public class Address {
   
   private String street;
   private String city;

   public Address() {

   }

   public Address(String street, String city) {
       this.street = street;
       this.city = city;
   }

   public String getStreet() {
       return street;
   }

   public void setStreet(String street) {
       this.street = street;
   }

   public String getCity() {
       return city;
   }

   public void setCity(String city) {
       this.city = city;
   }

   @Override
   public String toString() {
       return street + ", " + city;
   }
   
}

Company.java

package org.o7planning.xstreamtutorial.beans;

public class Company {

   private int id;
   private String name;
   private String[] websites;
   private Address address;

   public int getId() {
       return id;
   }

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

   public String getName() {
       return name;
   }

   public void setName(String name) {
       this.name = name;
   }

   public String[] getWebsites() {
       return websites;
   }

   public void setWebsites(String[] websites) {
       this.websites = websites;
   }

   public Address getAddress() {
       return address;
   }

   public void setAddress(Address address) {
       this.address = address;
   }

   @Override
   public String toString() {
       StringBuilder sb = new StringBuilder();

       sb.append("\n id:" + this.id);
       sb.append("\n name:" + this.name);
       if (this.websites != null) {
           sb.append("\n website: ");
           for (String website : this.websites) {
               sb.append(website + ", ");
           }
       }
       if (this.address != null) {
           sb.append("\n address:" + this.address.toString());
       }
       return sb.toString();
   }

}

DataDAO.java

package org.o7planning.xstreamtutorial;

import org.o7planning.xstreamtutorial.beans.Address;
import org.o7planning.xstreamtutorial.beans.Company;

public class DataDAO {

   
   
   public static Company createCompany() {

       Company company = new Company();
       company.setId(111);
       company.setName("Microsoft");

       String[] websites = { "http://microsoft.com",
               "http://msn.com", "http://hotmail.com" };
       company.setWebsites(websites);

       Address address = new Address();
       address.setCity("Redmond");
       address.setStreet("1 Microsoft Way");

       company.setAddress(address);

       return company;
   }
   
}

4. Das Java Objekt zur XML umwandeln

Änders als JAXB kann XStream ein Java Objekt zum XML ohne eine Abbildung (mapping) umwandeln. Es benutzt eine standardmäßige Abbildung. Sehen Sie bitte das folgende Beispiel

JavaObject2Xml.java

package org.o7planning.xstreamtutorial;

import org.o7planning.xstreamtutorial.beans.Company;

import com.thoughtworks.xstream.XStream;

public class JavaObject2Xml {

   public static void main(String[] args) {
       
       Company company = DataDAO.createCompany();
       
       XStream xs = new XStream();
       
       
       // JAVA OBJECT --> XML
       String xml = xs.toXML(company);
       
       System.out.println(xml);
   }
   
   
}

Starten Sie das Beispiel

<org.o7planning.xstreamtutorial.beans.Company>
  <id>111</id>
  <name>Microsoft</name>
  <websites>
    <string>http://microsoft.com</string>
    <string>http://msn.com</string>
    <string>http://hotmail.com</string>
  </websites>
  <address>
    <street>1 Microsoft Way</street>
    <city>Redmond</city>
  </address>
</org.o7planning.xstreamtutorial.beans.Company>

5. Alias benutzen (Das Pseudonym)

Bei der Umwandlung eines Java Objekt zum XML ändert XStream den Klassename zum Namen eines XML Tag. Das Aliasing ist die Technik zur Anpassung der erstellten XML. Es gibt 5 Aliasingstype

Das Klasse Aliasing (class)
Das Feld Aliasing (field)
Default Aliasing für die Kollection
Das Attribute Aliasing
Das Package Aliasing

das Pseudonym class

ClassAliasingExample.java

package org.o7planning.xstreamtutorial;

import org.o7planning.xstreamtutorial.beans.Company;

import com.thoughtworks.xstream.XStream;

public class ClassAliasingExample {

   public static void main(String[] args) {
       
       Company company = DataDAO.createCompany();
       
       XStream xs = new XStream();
       
       xs.alias("company", Company.class);
       
       // JAVA OBJECT --> XML
       String xml = xs.toXML(company);
       
       System.out.println(xml);
   }
   
}

Starten Sie das Beispiel

<company>
 <id>111</id>
 <name>Microsoft</name>
 <websites>
   <string>http://microsoft.com</string>
   <string>http://msn.com</string>
   <string>http://hotmail.com</string>
 </websites>
 <address>
   <street>1 Microsoft Way</street>
   <city>Redmond</city>
 </address>
</company

Das Pseudonym Feld (field)

FieldAliasingExample.java

package org.o7planning.xstreamtutorial;

import org.o7planning.xstreamtutorial.beans.Company;

import com.thoughtworks.xstream.XStream;

public class FieldAliasingExample {

   public static void main(String[] args) {
       
       Company company = DataDAO.createCompany();
       
       XStream xstream = new XStream();
       
       // Class aliasing.
       xstream.alias("company", Company.class);
       
       // Field aliasing.
       // aliasField(String alias, Class definedIn, String fieldName).
       xstream.aliasField("companyName", Company.class, "name");
       xstream.aliasField("companyId", Company.class, "id");
       
       // JAVA OBJECT --> XML
       String xml = xstream.toXML(company);
       
       System.out.println(xml);
   }
   
}

Starten Sie das Beispiel

<company>
  <companyId>111</companyId>
  <companyName>Microsoft</companyName>
  <websites>
    <string>http://microsoft.com</string>
    <string>http://msn.com</string>
    <string>http://hotmail.com</string>
  </websites>
  <address>
    <street>1 Microsoft Way</street>
    <city>Redmond</city>
  </address>
</company>

Das implizite Kollektion Pseudonym

Normalerweise wird eine Kollection (Array/Collections) im Java bei der Umwandlung zum XML in einen Tag eingepackt. Sie können das Defaul Aliasing für die Kollection zur Beseitigung dieses Tag

ImplicitCollectionsAliasingExample.java

package org.o7planning.xstreamtutorial;

import org.o7planning.xstreamtutorial.beans.Company;

import com.thoughtworks.xstream.XStream;

public class ImplicitCollectionsAliasingExample {

   public static void main(String[] args) {
       
       Company company = DataDAO.createCompany();
       
       XStream xstream = new XStream();
       
       // Class aliasing.
       xstream.alias("company", Company.class);
       
       
       // addImplicitArray(Class ownerType, String fieldName).
       xstream.addImplicitArray(Company.class, "websites", "website");
       
       // JAVA OBJECT --> XML
       String xml = xstream.toXML(company);
       
       System.out.println(xml);

   }

}

Starten Sie das Beispiel

<company>
  <id>111</id>
  <name>Microsoft</name>
  <website>http://microsoft.com</website>
  <website>http://msn.com</website>
  <website>http://hotmail.com</website>
  <address>
    <street>1 Microsoft Way</street>
    <city>Redmond</city>
  </address>
</company>

Das Pseudonym Attribut

AttributeAliasingExample.java

package org.o7planning.xstreamtutorial;

import org.o7planning.xstreamtutorial.beans.Company;

import com.thoughtworks.xstream.XStream;

public class AttributeAliasingExample {

   public static void main(String[] args) {
       
       Company company = DataDAO.createCompany();
       
       XStream xstream = new XStream();
       
       // Class aliasing.
       xstream.alias("company", Company.class);
       
       
       // useAttributeFor(Class definedIn, String fieldName).
       xstream.useAttributeFor(Company.class, "id");        
       
       xstream.useAttributeFor(Company.class, "name");
       xstream.aliasAttribute("companyName", "name");
       
       // JAVA OBJECT --> XML
       String xml = xstream.toXML(company);
       
       System.out.println(xml);

   }

}

Das Beispiel durchführen

<company id="111" companyName="Microsoft">
  <websites>
    <string>http://microsoft.com</string>
    <string>http://msn.com</string>
    <string>http://hotmail.com</string>
  </websites>
  <address>
    <street>1 Microsoft Way</street>
    <city>Redmond</city>
  </address>
</company>

Das Pseudonym Package

PackageAliasingExample.java

package org.o7planning.xstreamtutorial;

import org.o7planning.xstreamtutorial.beans.Address;
import org.o7planning.xstreamtutorial.beans.Company;

import com.thoughtworks.xstream.XStream;

public class PackageAliasingExample {

    public static void main(String[] args) {
        
        Company company = DataDAO.createCompany();
        
        XStream xstream = new XStream();  
        
        String packgeName=  Address.class.getPackage().getName();
        
        // aliasPackage(String name, String pkgName).
        xstream.aliasPackage("com.newcompany", packgeName);          
        
        
        
        // JAVA OBJECT --> XML
        String xml = xstream.toXML(company);
        
        System.out.println(xml);

    }

}

Das Beispiel durchführen

<com.newcompany.Company>
  <id>111</id>
  <name>Microsoft</name>
  <websites>
    <string>http://microsoft.com</string>
    <string>http://msn.com</string>
    <string>http://hotmail.com</string>
  </websites>
  <address>
    <street>1 Microsoft Way</street>
    <city>Redmond</city>
  </address>
</com.newcompany.Company>

6. XStream Annotation

Mit XStream können Sie die Kode benutzen um das aus dem Java Objekt erstellte XML anzupassen. Allerdings können Sie die Annotation verwenden um XStream die Erstellungsweise der XML aus dem Java Objekt zu informieren.

Folgend sind sie die Liste von Annotation

@XStreamAlias
@XStreamAsAttribute
@XStreamImplicit
@XStreamOmitField

Using Code	Using Annotation
xs.alias("dept", Department.class);	@XStreamAlias("dept") public class Department { }
xs.aliasField("no", Department.class, "deptNo");	@XStreamAlias("no") private int deptNo;
xs.useAttributeFor(Department.class, "deptNo")	@XStreamAsAttribute private int deptNo;
xs.omitField(Employee.class, "bonus");	@XStreamOmitField private float bonus;
xs.addImplicitCollection(Department.class, "employees");	@XStreamImplicit private List<Employee> employees;

Department.java

package org.o7planning.xstreamtutorial.beans;

import java.util.List;

import com.thoughtworks.xstream.annotations.XStreamAlias;
import com.thoughtworks.xstream.annotations.XStreamAsAttribute;
import com.thoughtworks.xstream.annotations.XStreamImplicit;

@XStreamAlias("dept")
public class Department {

  @XStreamAlias("no")
  @XStreamAsAttribute
  private int deptNo;

  @XStreamAlias("name")
  private String deptName;

  @XStreamImplicit
  private List<Employee> employees;

  public int getDeptNo() {
      return deptNo;
  }

  public void setDeptNo(int deptNo) {
      this.deptNo = deptNo;
  }

  public String getDeptName() {
      return deptName;
  }

  public void setDeptName(String deptName) {
      this.deptName = deptName;
  }

  public List<Employee> getEmployees() {
      return employees;
  }

  public void setEmployees(List<Employee> employees) {
      this.employees = employees;
  }

}

Employee.java

package org.o7planning.xstreamtutorial.beans;

import com.thoughtworks.xstream.annotations.XStreamAlias;
import com.thoughtworks.xstream.annotations.XStreamAsAttribute;
import com.thoughtworks.xstream.annotations.XStreamOmitField;

@XStreamAlias("emp")
public class Employee {

    @XStreamAlias("no")
    @XStreamAsAttribute
    private int empNo;
    private String empName;

    private float salary;

    // Ignore this field.
    @XStreamOmitField
    private float bonus;

    public Employee(int empNo, String empName, float salary) {
        this.empNo = empNo;
        this.empName = empName;
        this.salary = salary;
    }

    public int getEmpNo() {
        return empNo;
    }

    public void setEmpNo(int empNo) {
        this.empNo = empNo;
    }

    public String getEmpName() {
        return empName;
    }

    public void setEmpName(String empName) {
        this.empName = empName;
    }

    public float getSalary() {
        return salary;
    }

    public void setSalary(float salary) {
        this.salary = salary;
    }

    public float getBonus() {
        return bonus;
    }

    public void setBonus(float bonus) {
        this.bonus = bonus;
    }

}

XStreamAnnotationExample.java

package org.o7planning.xstreamtutorial;

import java.util.ArrayList;
import java.util.List;

import org.o7planning.xstreamtutorial.beans.Department;
import org.o7planning.xstreamtutorial.beans.Employee;

import com.thoughtworks.xstream.XStream;

public class XStreamAnnotationExample {

    public static void main(String[] args) {
        Department dept = createDepartment();

        XStream xstream = new XStream();
        
        // Using annotations in class Department
        xstream.processAnnotations(Department.class);
        
        // Using annotations in class Employee
        xstream.processAnnotations(Employee.class);
        
        String xml = xstream.toXML(dept);
        
        System.out.println(xml);
    }

    public static Department createDepartment() {
        Department dept = new Department();
        dept.setDeptNo(10);
        dept.setDeptName("ACCOUNTING");

        Employee king = new Employee(7839, "KING", 5000f);
        Employee clark = new Employee(7839, "CLARK", 2450f);
        Employee miller = new Employee(7839, "MILLER", 1300f);

        List<Employee> list = new ArrayList<Employee>();
        list.add(king);
        list.add(clark);
        list.add(miller);
        dept.setEmployees(list);
        return dept;
    }
    
}

Das Beispiel durchführen

<dept no="10">
  <name>ACCOUNTING</name>
  <emp no="7839">
    <empName>KING</empName>
    <salary>5000.0</salary>
  </emp>
  <emp no="7839">
    <empName>CLARK</empName>
    <salary>2450.0</salary>
  </emp>
  <emp no="7839">
    <empName>MILLER</empName>
    <salary>1300.0</salary>
  </emp>
</dept>

7. XStream Converter

XStream Converter ist ein wichtigste Teil im der XStream Bibliothek. Er ist API zum Änderung eines Java Objekt zu XML und umgekehrt. Sie können einen Converter selbst erstellen um die Umsetzung zwischen Java und XML anzupassen

TODO

Die Anleitung zu Java XStream

1. Was ist XStream?

2. Die Bibliothek XStream

3. Einige Klasse zur Teilnahme an die Beispiele

4. Das Java Objekt zur XML umwandeln

5. Alias benutzen (Das Pseudonym)

6. XStream Annotation

7. XStream Converter

TODO

Java API für HTML & XML

Java Open Source Bibliotheken

Java API für HTML & XML

Java Open Source Bibliotheken

Neueste Artikel