com.logicaldoc.util.config

Class XMLBean

java.lang.Object

com.logicaldoc.util.config.XMLBean

Direct Known Subclasses:

WebConfigurator

public class XMLBean
extends Object

Class for using xml-files.

Version:

1.0

Author:

Michael Scholz

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.slf4j.Logger	log

Constructor Summary

Constructors

Constructor and Description
XMLBean(InputStream is) Creates new XMLBean from an input stream; XMLBean is read-only!!!
XMLBean(String docname) Creates new XMLBean.
XMLBean(URL docname) Creates new XMLBean.

Method Summary

Methods

Modifier and Type	Method and Description
List	getAllAttribute(org.jdom.Element elem) Returns a list of all attributes from an element.
List	getAllChild(String elemname) Returns a list of all elements with the given elementname.
List	getAllChild(String elemname, String attribute, String value) Returns a list of all children with the specific name and the specific attribute value;
String	getAllChildText(String elemname, String attribute, String value, String separator1, String separator2) This method returns the text of all children in the format childnamechildtext.
org.jdom.Attribute	getAttribute(org.jdom.Element elem, String attrib) Returns an elementattribute.
String	getAttributeValue(org.jdom.Element elem, String attrib) Returns the value of an elementattribute.
org.jdom.Element	getChild(String elemname) Returns a child element.
org.jdom.Element	getChild(String elemname, String attribute, String value) This method finds a child by name and attribute.
String	getChildText(String elemname, String childname, String attribute, String value) This method returns the text of a child element characterized by elementname and attribute.
List	getRootChild() This method returns all direct children of the root element.
org.jdom.Element	getRootElement() Returns the root element.
String	getText(org.jdom.Element elem) This returns the text between a begining and an ending tag.
String	getText(String elemname, String attrname, String attrvalue)
boolean	removeChild(String elemname) Removes an element.
void	setAttributeValue(org.jdom.Element elem, String attrib, String value) This method set the value of an elementattribute.
void	setText(org.jdom.Element elem, String text)
boolean	writeXMLDoc() This method saves the xml-file connected by XMLBean.

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static org.slf4j.Logger log

Constructor Detail

XMLBean

public XMLBean(String docname)

Creates new XMLBean.

Parameters:

docname - Path of xml-file.

XMLBean

public XMLBean(URL docname)

Creates new XMLBean.

Parameters:

docname - URL of xml-file.

XMLBean

public XMLBean(InputStream is)

Creates new XMLBean from an input stream; XMLBean is read-only!!!

Method Detail

getRootElement

public org.jdom.Element getRootElement()

Returns the root element.

getChild

public org.jdom.Element getChild(String elemname)

Returns a child element.

Parameters:

elemname - Name of the child.

Returns:

Child

getChild

public org.jdom.Element getChild(String elemname,
                        String attribute,
                        String value)

This method finds a child by name and attribute.

Parameters:

elemname - Name of the child.

attribute - Name of the child attribute.

value - Value of the attribute.

Returns:

Child

getText

public String getText(org.jdom.Element elem)

This returns the text between a begining and an ending tag.

Parameters:

elem - Name of the element.

Returns:

Text of the element.

getText

public String getText(String elemname,
             String attrname,
             String attrvalue)

getChildText

public String getChildText(String elemname,
                  String childname,
                  String attribute,
                  String value)

This method returns the text of a child element characterized by elementname and attribute.

Parameters:

elemname - Name of the element.

childname - Name of the child.

attribute - Name of the attribute which must element have.

value - Value of the attribute.

Returns:

Text of the child.

getAllChildText

public String getAllChildText(String elemname,
                     String attribute,
                     String value,
                     String separator1,
                     String separator2)

This method returns the text of all children in the format childnamechildtext.

Parameters:

elemname - Name of the root element.

attribute - Name of the attribute which must root element have.

value - Value of the attribute.

getAttribute

public org.jdom.Attribute getAttribute(org.jdom.Element elem,
                              String attrib)

Returns an elementattribute.

Parameters:

elem - Name of the element.

attrib - Name of the attribute.

Returns:

Attribute

getAttributeValue

public String getAttributeValue(org.jdom.Element elem,
                       String attrib)

Returns the value of an elementattribute.

Parameters:

elem - Name of the element.

attrib - Name of the attribute.

Returns:

Value of the attribute.

setAttributeValue

public void setAttributeValue(org.jdom.Element elem,
                     String attrib,
                     String value)

This method set the value of an elementattribute.

Parameters:

elem - Name of the element.

attrib - Attribute of the element.

value - New value of the attribute.

setText

public void setText(org.jdom.Element elem,
           String text)

writeXMLDoc

public boolean writeXMLDoc()

This method saves the xml-file connected by XMLBean. NOTE: only call this on an XMLBean _NOT_ created from an InputStream!

getRootChild

public List getRootChild()

This method returns all direct children of the root element.

Returns:

Childrenlist

getAllAttribute

public List getAllAttribute(org.jdom.Element elem)

Returns a list of all attributes from an element.

Parameters:

elem - Name of the element.

Returns:

Attributelist

getAllChild

public List getAllChild(String elemname)

Returns a list of all elements with the given elementname.

getAllChild

public List getAllChild(String elemname,
               String attribute,
               String value)

Returns a list of all children with the specific name and the specific attribute value;

removeChild

public boolean removeChild(String elemname)

Removes an element.

Parameters:

elemname - Tag name of the element.

Returns: