org.xembly

Class Xembler

java.lang.Object

org.xembly.Xembler

@Immutable
@Loggable(value=1)
public final class Xembler
extends Object

Processor of Xembly directives, main entry point to the package.

For example, to modify a DOM document:

 Document dom = DocumentBuilderFactory.newInstance()
   .newDocumentBuilder().newDocument();
 dom.appendChild(dom.createElement("root"));
 new Xembler(
   new Directives()
     .xpath("/root")
     .addIfAbsent("employees")
     .add("employee")
     .attr("id", 6564)
 ).apply(dom);

You can also convert your Xembly directives directly to XML document:

 String xml = new Xembler(
   new Directives()
     .xpath("/root")
     .addIfAbsent("employees")
     .add("employee")
     .attr("id", 6564)
 ).xml("root");

Since:

0.1

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

Constructor Summary

Constructors

Constructor and Description
Xembler(Iterable<Directive> dirs) Public ctor.

Method Summary

Methods

Modifier and Type	Method and Description
Node	apply(Node dom) Apply all changes to the document/node.
Document	dom() Apply all changes to an empty DOM.
String	xml() Convert to XML document.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Xembler

public Xembler(@NotNull(message="collection of directives can\'t be NULL")
       Iterable<Directive> dirs)

Public ctor.

Parameters:

dirs - Directives

Method Detail

apply

@Loggable(value=1,
          ignore=ImpossibleModificationException.class)
public Node apply(@NotNull(message="DOM can\'t be NULL")
                                                       Node dom)
           throws ImpossibleModificationException

Apply all changes to the document/node.

Parameters:

dom - DOM document/node

Returns:

The same document/node

Throws:

ImpossibleModificationException - If can't modify

dom

@Loggable(value=1,
          ignore=ImpossibleModificationException.class)
public Document dom()
             throws ImpossibleModificationException

Apply all changes to an empty DOM.

Returns:

DOM created

Throws:

ImpossibleModificationException - If can't modify

Since:

0.9

xml

@Loggable(value=1,
          ignore=ImpossibleModificationException.class)
public String xml()
           throws ImpossibleModificationException

Convert to XML document.

Returns:

XML document

Throws:

ImpossibleModificationException - If can't modify

Since:

0.9