org.xembly

Class Directives

java.lang.Object

org.xembly.Directives

All Implemented Interfaces:

Iterable<Directive>

public final class Directives
extends Object
implements Iterable<Directive>

Collection of Directives, instantiable from String.

For example, to fetch directives from a string and apply to the DOM document:

 Document dom = DocumentBuilderFactory.newInstance()
   .newDocumentBuilder().newDocument();
 dom.appendChild(dom.createElement("root"));
 new Xembler(
   new Directives("XPATH 'root'; ADD 'employee';")
 ).apply(dom);

Directives can be used as a builder of Xembly script:

 Document dom = DocumentBuilderFactory.newInstance()
   .newDocumentBuilder().newDocument();
 dom.appendChild(dom.createElement("root"));
 new Xembler(
   new Directives()
     .xpath("/root")
     .addIf("employees")
     .add("employee")
     .attr("id", 6564)
     .up()
     .xpath("employee[@id='100']")
     .strict(1)
     .remove()
 ).apply(dom);

The class is mutable and thread-safe.

Since:

0.1

Version:

$Id$

Author:

Yegor Bugayenko ([email protected])

Constructor Summary

Constructors

Constructor and Description
Directives() Public ctor.
Directives(Iterable<Directive> dirs) Public ctor.
Directives(String text) Public ctor.

Method Summary

Methods

Modifier and Type	Method and Description
<K,V> Directives	add(Map<K,V> nodes) Add multiple nodes and set their text values.
Directives	add(String name) Add node to all current nodes.
Directives	addIf(String name) Add node if it's absent.
Directives	append(Iterable<Directive> dirs) Append all directives.
Directives	attr(String name, String value) Set attribute.
static Iterable<Directive>	copyOf(Node node) Create a collection of directives, which can create a copy of provided node.
Iterator<Directive>	iterator()
Directives	pi(String target, String data) Add processing instruction.
Directives	pop() Pop pointer to stack and replace current pointer with it.
Directives	push() Push current pointer to stack.
Directives	remove() Remove all current nodes and move cursor to their parents.
Directives	set(String text) Set text content.
Directives	strict(int number) Check that there is exactly this number of current nodes.
String	toString()
Directives	up() Go one node/level up.
Directives	xpath(String path) Go to XPath.
Directives	xset(String text) Set text content.

Methods inherited from class java.lang.Object

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

Constructor Detail

Directives

public Directives()

Public ctor.

Directives

public Directives(@NotNull(message="xembly script can\'t be NULL")
          String text)
           throws SyntaxException

Public ctor.

Parameters:

text - Xembly script

Throws:

SyntaxException - If syntax is broken

Directives

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

Public ctor.

Parameters:

dirs - Directives

Method Detail

toString

public String toString()

Overrides:

toString in class Object

iterator

public Iterator<Directive> iterator()

Specified by:

iterator in interface Iterable<Directive>

copyOf

public static Iterable<Directive> copyOf(@NotNull(message="node can\'t be NULL")
                         Node node)

Create a collection of directives, which can create a copy of provided node.

For example, you already have a node in an XML document, which you'd like to add to another XML document:

 Document target = parse("<root/>");
 Node node = parse("<user name='Jeffrey'/>");
 new Xembler(
   new Directives()
     .xpath("/*")
     .add("jeff")
     .append(Directives.copyOf(node))
 ).apply(target);
 assert print(target).equals(
   "<root><jeff name='Jeffrey'></root>"
 );
 

Parameters:

node - Node to analyze

Returns:

Collection of directives

Since:

0.13

append

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

Append all directives.

Parameters:

dirs - Directives to append

Returns:

This object

Since:

0.11

add

public Directives add(@NotNull(message="name can\'t be NULL")
             String name)

Add node to all current nodes.

Parameters:

name - Name of the node to add

Returns:

This object

Since:

0.5

add

public <K,V> Directives add(@NotNull(message="map can\'t be NULL")
                   Map<K,V> nodes)

Add multiple nodes and set their text values.

Every pair in the provided map will be treated as a new node name and value. It's a convenient utility method that simplifies the process of adding a collection of nodes with pre-set values. For example:

 new Directives()
   .add("first", "hello, world!")
   .add(
     new ArrayMap<String, Object>()
       .with("alpha", 1)
       .with("beta", "2")
       .with("gamma", new Date())
   )
   .add("second");
 

If a value provided contains illegal XML characters, a runtime exception will be thrown. To avoid this, it is recommended to use Xembler.escape(String).

Type Parameters:

K - Type of key

V - Type of value

Parameters:

nodes - Names and values of nodes to add

Returns:

This object

Since:

0.8

addIf

public Directives addIf(@NotNull(message="name can\'t be NULL")
               String name)

Add node if it's absent.

Parameters:

name - Name of the node to add

Returns:

This object

Since:

0.5

remove

public Directives remove()

Remove all current nodes and move cursor to their parents.

Returns:

This object

Since:

0.5

attr

public Directives attr(@NotNull(message="attr name can\'t be NULL")
              String name,
              @NotNull(message="value can\'t be NULL")
              String value)

Set attribute.

If a value provided contains illegal XML characters, a runtime exception will be thrown. To avoid this, it is recommended to use Xembler.escape(String).

Parameters:

name - Name of the attribute

value - Value to set

Returns:

This object

Since:

0.5

pi

public Directives pi(@NotNull(message="target can\'t be NULL")
            String target,
            @NotNull(message="data can\'t be NULL")
            String data)

Add processing instruction.

If a value provided contains illegal XML characters, a runtime exception will be thrown. To avoid this, it is recommended to use Xembler.escape(String).

Parameters:

target - PI name

data - Data to set

Returns:

This object

Since:

0.9

set

public Directives set(@NotNull(message="content can\'t be NULL")
             String text)

Set text content.

If a value provided contains illegal XML characters, a runtime exception will be thrown. To avoid this, it is recommended to use Xembler.escape(String).

Parameters:

text - Text to set

Returns:

This object

Since:

0.5

xset

public Directives xset(@NotNull(message="content can\'t be NULL")
              String text)

Set text content.

Parameters:

text - Text to set

Returns:

This object

Since:

0.7

up

public Directives up()

Go one node/level up.

Returns:

This object

Since:

0.5

xpath

public Directives xpath(@NotNull(message="xpath can\'t be NULL")
               String path)

Go to XPath.

Parameters:

path - Path to go to

Returns:

This object

Since:

0.5

strict

public Directives strict(@NotNull(message="number can\'t be NULL")
                int number)

Check that there is exactly this number of current nodes.

Parameters:

number - Number of expected nodes

Returns:

This object

Since:

0.5

push

public Directives push()

Push current pointer to stack.

Returns:

This object

Since:

0.16

pop

public Directives pop()

Pop pointer to stack and replace current pointer with it.

Returns:

This object

Since:

0.16