- Javax.xml.bind classes
- Home
- Binder
- DatatypeConverter
- JAXB
- JAXBContext
- JAXBElement
- JAXBElement.GlobalScope
- JAXBIntrospector
- Marshaller.Listener
- SchemaOutputResolver
- Unmarshaller.Listener
- Javax.xml.bind.util classes
- JAXBResult
- JAXBSource
- ValidationEventCollector
- Javax.xml.parsers classes
- DocumentBuilder
- DocumentBuilderFactory
- SAXParser
- SAXParserFactory
- Javax.xml.soap classes
- AttachmentPart
- MessageFactory
- MimeHeader
- MimeHeaders
- SAAJMetaFactory
- SOAPConnection
- SOAPConnectionFactory
- SOAPFactory
- SOAPMessage
- SOAPPart
- Javax.xml.validation classes
- Schema
- SchemaFactory
- TypeInfoProvider
- Validator
- ValidatorHandler
- Javax.xml.xpath classes
- XPathConstants
- XPathFactory
- Java Useful Resources
- Java - Quick Guide
- Java - Useful Resources
javax.xml.bind.Binder.updateXML() Method
Description
The Javax.xml.bind.Binder.updateXML(Object jaxbObject, XmlNode xmlNode) method changes in JAXB object tree are updated in its associated XML parse tree.
This operation can be thought of as an "in-place" marshalling. The difference is that instead of creating a whole new XML tree, this operation updates an existing tree while trying to preserve the XML as much as possible.
Declaration
Following is the declaration for javax.xml.bind.Binder.updateXML(Object jaxbObject, XmlNode xmlNode) method
public abstract XmlNode updateXML(Object jaxbObject, XmlNode xmlNode)
Parameters
jaxbObject − the edited JAXB object.
xmlNode − root of update target XML parse tree.
Return Value
Returns the updated XML node.
Exception
JAXBException − If any unexpected problem occurs updating corresponding XML content.
IllegalArgumentException − If the node parameter is null.
Example
The following example shows the usage of javax.xml.bind.Binder.updateXML(Object jaxbObject, XmlNode xmlNode) method. To proceed, consider the following Student class which will be used to have objects for "in-place" marshalling purpose −
package com.tutorialspoint; import javax.xml.bind.annotation.XmlAttribute; import javax.xml.bind.annotation.XmlElement; import javax.xml.bind.annotation.XmlRootElement; @XmlRootElement public class Student{ String name; int age; int id; public String getName(){ return name; } @XmlElement public void setName(String name){ this.name = name; } public int getAge(){ return age; } @XmlElement public void setAge(int age){ this.age = age; } public int getId(){ return id; } @XmlAttribute public void setId(int id){ this.id = id; } }
Now let us create main class which will be used to unmarshal/marshal ie. convert Student XML file to JAXB object and vice versa. Here we will creat Binder object using JAXBContext because we can not create Binder object directly because it is an abstract class. This example unmarshals and marshals the Student.xml to object and vice versa.
package com.tutorialspoint; import javax.xml.bind.JAXBContext; import javax.xml.bind.Marshaller; import javax.xml.bind.Binder; import javax.xml.parsers.DocumentBuilder; import javax.xml.parsers.DocumentBuilderFactory; import javax.xml.transform.Transformer; import javax.xml.transform.TransformerFactory; import javax.xml.transform.dom.DOMSource; import javax.xml.transform.stream.StreamResult; import org.w3c.dom.Document; import org.w3c.dom.Node; public class BinderDemo { public static void main(String[] args) { try { // we need a blank document to store final xml output DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance(); DocumentBuilder docBuilder = dbf.newDocumentBuilder(); Document document = docBuilder.parse("Student.xml"); // create JAXBContext which will be used to create a Binder JAXBContext jc = JAXBContext.newInstance(Student.class); Binder<Node> binder = jc.createBinder(); // set output as formatted one binder.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true); // get xml node from the document Node xmlNode = document.getDocumentElement(); // Returns the updated JAXB object Student st = (Student)binder.updateJAXB(xmlNode); // set age and name st.setAge(11); st.setName("Sania"); // update xml node with new data xmlNode = binder.updateXML(st, xmlNode); // set node value to the document document.setNodeValue(xmlNode.getNodeValue()); // finally print the edited object on stdout TransformerFactory tf = TransformerFactory.newInstance(); Transformer t = tf.newTransformer(); t.transform(new DOMSource(document), new StreamResult(System.out)); }catch(Exception ex) { ex.printStackTrace(); } } }
To create document, an XML file is needed as input. The XML file is named as Student.xml−
<?xml version = "1.0" encoding = "UTF-8" standalone = "no"?> <student id = "10"> <age>10</age> <name>Zara Ali</name> </student>
Before we proceed for compilation, we need to make sure that that we download JAXB2.xxx.jar and put it in our CLASSPATH. Once setup is ready, let us compile and run the above program, this will produce the following result −
<?xml version = "1.0" encoding = "UTF-8" standalone = "no"?> <student id = "10"> <age>11</age> <name>Sania</name> </student>
To Continue Learning Please Login
Login with Google