Enterprise Java Development@TOPIC@

Chapter 109. XML Representations

Using JAXB and JAX-RS Marshallers

109.1. XML Payload
109.2. Defining JAXB DTOs
109.2.1. Defining JAXB Attributes
109.2.2. Defining JAXB Elements
109.2.3. Defining JAXB Collections/Sequences
109.3. JAXB Marshalling/Demarshalling
109.3.1. JAXB Marshalling
109.3.2. JAXB Demarshalling
109.4. Marshaling XML to/from Resource Methods
109.4.1. Marshaling XML Requests to Resource Methods
109.4.2. Marshaling XML Response from Resource Methods

109.1. XML Payload




<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<ns2:catageory name="snacks" id="1" version="1" xmlns:ns2="http://webejb.ejava.info/inventory">

    <productCount>1</productCount>

    <products>

        <product id="1" name="chips" version="0"/>

    </products>

</ns2:catageory>

109.2. Defining JAXB DTOs



@XmlRootElement(name="catageory", namespace=InventoryRepresentation.NAMESPACE)

@XmlType(name="Category", namespace=InventoryRepresentation.NAMESPACE)

@XmlAccessorType(XmlAccessType.PROPERTY)

public class Category extends InventoryRepresentation {

    private int id;

    private String name;

    private Integer productCount;

    private List<Product> products=new ArrayList<Product>();


    public Category() {}

    public Category(String name) {

        this.name=name;

    }

...    

}



    @XmlAttribute(required=true)

    public int getId() { return id; }

    public void setId(int id) {

        this.id = id;

    }

    

    @XmlAttribute(required=true)

    public String getName() { return name; }

    public void setName(String name) {

        this.name = name;

    }



    @XmlElement(required=true)

    public int getProductCount() { return productCount!=null ? productCount :products.size();}

    public void setProductCount(int productCount) {

        this.productCount = productCount;

    }



    @XmlElementWrapper(name="products")

    @XmlElement(name="product")

    public List<Product> getProducts() { return products; }

    public void setProducts(List<Product> products) {

        this.products = products;

    }

109.3. JAXB Marshalling/Demarshalling



JAXBContext jbx = JAXBContext.newInstance(object.getClass());

Marshaller marshaller = jbx.createMarshaller();

marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);

StringWriter writer = new StringWriter();

marshaller.marshal(object, writer);

return writer.toString();



JAXBContext jbx = JAXBContext.newInstance(clazz);

Unmarshaller marshaller = jbx.createUnmarshaller();

return (T) marshaller.unmarshal(is);

109.4. Marshaling XML to/from Resource Methods



@POST @Path("")

@Consumes(MediaType.APPLICATION_XML)

public Response addCustomer(Customer customer) {



@POST @Path("")

@Produces(MediaType.APPLICATION_XML)

...

            return Response.created(uri)

                    .entity(c)

                    .build();