org.imixs.workflow.util

Class XMLParser

java.lang.Object

org.imixs.workflow.util.XMLParser

public class XMLParser
extends java.lang.Object

XMLParser provides helper methods to parse xml strings

Author:

rsoika

Constructor Summary

Constructors

Constructor and Description
XMLParser()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	findAttribute(java.lang.String content, java.lang.String name) This method parses a xml tag for a single named attribute.
static java.util.Map<java.lang.String,java.lang.String>	findAttributes(java.lang.String content) This method parses a xml tag for attributes.
static java.util.List<java.lang.String>	findNoEmptyTags(java.lang.String content, java.lang.String tag) This method find not-empty tags inside a string and returns a list with all tags.
static java.util.List<java.lang.String>	findTags(java.lang.String content, java.lang.String tag) This method find specific tags inside a string and returns a list with all tags.
static java.lang.String	findTagValue(java.lang.String content, java.lang.String tag) This method returns the tag value of a single tag.
static java.lang.String	findTagValueOld(java.lang.String content, java.lang.String tag) Deprecated.
static java.util.List<java.lang.String>	findTagValues(java.lang.String content, java.lang.String tag) This method returns all tag values within a string with multiple xml tags.
static ItemCollection	parseItemStructure(java.lang.String xmlContent) This method parses the xml content of a item element and returns a new ItemCollection containing all item values.
static ItemCollection	parseTag(java.lang.String xmlContent, java.lang.String tag) This method parses the xml content of a XML tag and returns a new ItemCollection containing all embedded tags.

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLParser

public XMLParser()

Method Detail

findAttributes

public static java.util.Map<java.lang.String,java.lang.String> findAttributes(java.lang.String content)

This method parses a xml tag for attributes. The method returns a Map with all attributes found in the content string e.g. returns Map: {field=a, number=1}

Parameters:

content -

Returns:

findAttribute

public static java.lang.String findAttribute(java.lang.String content,
                                             java.lang.String name)

This method parses a xml tag for a single named attribute. The method returns the value of the attribute found in the content string e.g. returns "abc"

Parameters:

content -

Returns:

findTags

public static java.util.List<java.lang.String> findTags(java.lang.String content,
                                                        java.lang.String tag)

This method find specific tags inside a string and returns a list with all tags.

e.g. an empty tag:

or a tag with content:

Note: In case of complex XML with not empty tags use the method 'findNoEmptyTags'

Parameters:

content - - XML data

tag - - XML tag

Returns:

findNoEmptyTags

public static java.util.List<java.lang.String> findNoEmptyTags(java.lang.String content,
                                                               java.lang.String tag)

This method find not-empty tags inside a string and returns a list with all tags.

e.g.:

Note: To fine also empty tags use 'findTags'

Parameters:

content - - XML data

tag - - XML tag

Returns:

findTagValues

public static java.util.List<java.lang.String> findTagValues(java.lang.String content,
                                                             java.lang.String tag)

This method returns all tag values within a string with multiple xml tags. E.g.

returns

2016-12-31|2016-12-31

Parameters:

content - - XML data

tag - - XML tag

Returns:

findTagValue

public static java.lang.String findTagValue(java.lang.String content,
                                            java.lang.String tag)

This method returns the tag value of a single tag. The method returns the first match! Use findTagValues to parse all tag values in a string with multiple tags.

E.g.

returns

2016-12-31

Parameters:

content - - XML data

tag - - XML tag

Returns:

See Also:

findTagValues

findTagValueOld

@Deprecated
public static java.lang.String findTagValueOld(java.lang.String content,
                                                           java.lang.String tag)

Deprecated.

parseItemStructure

public static ItemCollection parseItemStructure(java.lang.String xmlContent)
                                         throws PluginException

This method parses the xml content of a item element and returns a new ItemCollection containing all item values. Each tag is evaluated as the item name. MultiValues are currently not supported. Example:

 
 <item>	  
    <modelversion>1.0.0</modelversion>
    <task>1000</task>
    <event>10</event>
 </item>
 
 

Parameters:

evalItemCollection -

Throws:

PluginException

parseTag

public static ItemCollection parseTag(java.lang.String xmlContent,
                                      java.lang.String tag)
                               throws PluginException

This method parses the xml content of a XML tag and returns a new ItemCollection containing all embedded tags. Each tag is evaluated as the item name. The tag value is returned as a item value.

MultiValues are currently not supported.

Example:

The tag 'code' of:

 
 <code>	  
    <modelversion>1.0.0</modelversion>
    <task>1000</task>
    <event>10</event>
 </code>
 
 

Returns an ItemCollection with 3 items (modelversion, task and event)

Parameters:

evalItemCollection -

Throws:

PluginException