ValueToXmlHelper (org.faktorips.runtime.java5 3.13.0-SNAPSHOT API)

java.lang.Object
- org.faktorips.runtime.internal.ValueToXmlHelper

```
public class ValueToXmlHelper
extends Object
```
Helper class to write values to XML and retrieve them from XML.

Author:

Jan Ortmann

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`XML_ATTRIBUTE_ATTRIBUTE`
`static String`	`XML_ATTRIBUTE_CONTAINS_NULL`
`static String`	`XML_ATTRIBUTE_IS_NULL`
`static String`	`XML_ATTRIBUTE_STRUCTURE_USAGE`
`static String`	`XML_TAG_ALL_VALUES`
`static String`	`XML_TAG_ATTRIBUTE_VALUE`
`static String`	`XML_TAG_CONFIG_ELEMENT`
`static String`	`XML_TAG_DATA`
`static String`	`XML_TAG_ENUM`
`static String`	`XML_TAG_LOWER_BOUND`
`static String`	`XML_TAG_RANGE`
`static String`	`XML_TAG_STEP`
`static String`	`XML_TAG_TABLE_CONTENT_NAME`
`static String`	`XML_TAG_TABLE_CONTENT_USAGE`
`static String`	`XML_TAG_UPPER_BOUND`
`static String`	`XML_TAG_VALUE` Used for both the value of a config element and the values of an enum value set.
`static String`	`XML_TAG_VALUE_SET`

Method Summary

Methods
Modifier and Type	Method and Description
`static void`	`addCDataValueToElement(String value, Element el, String tagName)` Adds the value to the given xml element.
`static void`	`addInternationalStringToElement(org.faktorips.values.DefaultInternationalString value, Element el, String tagName)` Adds the `DefaultInternationalString` to the given xml element.
`static Element`	`addValueAndReturnElement(String value, Element el, String tagName)` Adds the value to the given xml element as does `addValueToElement(String, Element, String)`.
`static void`	`addValueToElement(String value, Element el, String tagName)` Adds the value to the given xml element.
`static Element`	`createValueElement(String value, String tagName, Document ownerDocument, boolean useCDataSection)`
`static EnumValues`	`getEnumValueSetFromElement(Element el, String tagName)`
`static org.faktorips.values.DefaultInternationalString`	`getInternationalStringFromElement(Element el)` Returns the `DefaultInternationalString` stored in the given element.
`static org.faktorips.values.DefaultInternationalString`	`getInternationalStringFromElement(Element el, String tagName)` Returns the `DefaultInternationalString` stored in the child element of the given element with the indicated name.
`static Range`	`getRangeFromElement(Element el, String tagName)`
`static String`	`getValueFromElement(Element valueEl)` Returns the string representation of the value stored in given value element.
`static String`	`getValueFromElement(Element el, String tagName)` Returns the string representation of the value stored in the child element of the given element with the indicated name.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - XML_TAG_VALUE
```
public static final String XML_TAG_VALUE
```
    Used for both the value of a config element and the values of an enum value set.
    
    See Also:
    Constant Field Values
  - XML_TAG_VALUE_SET
```
public static final String XML_TAG_VALUE_SET
```
    See Also:
    Constant Field Values
  - XML_TAG_DATA
```
public static final String XML_TAG_DATA
```
    See Also:
    Constant Field Values
  - XML_TAG_CONFIG_ELEMENT
```
public static final String XML_TAG_CONFIG_ELEMENT
```
    See Also:
    Constant Field Values
  - XML_TAG_ATTRIBUTE_VALUE
```
public static final String XML_TAG_ATTRIBUTE_VALUE
```
    See Also:
    Constant Field Values
  - XML_ATTRIBUTE_ATTRIBUTE
```
public static final String XML_ATTRIBUTE_ATTRIBUTE
```
    See Also:
    Constant Field Values
  - XML_TAG_ALL_VALUES
```
public static final String XML_TAG_ALL_VALUES
```
    See Also:
    Constant Field Values
  - XML_TAG_ENUM
```
public static final String XML_TAG_ENUM
```
    See Also:
    Constant Field Values
  - XML_TAG_RANGE
```
public static final String XML_TAG_RANGE
```
    See Also:
    Constant Field Values
  - XML_TAG_STEP
```
public static final String XML_TAG_STEP
```
    See Also:
    Constant Field Values
  - XML_TAG_UPPER_BOUND
```
public static final String XML_TAG_UPPER_BOUND
```
    See Also:
    Constant Field Values
  - XML_TAG_LOWER_BOUND
```
public static final String XML_TAG_LOWER_BOUND
```
    See Also:
    Constant Field Values
  - XML_TAG_TABLE_CONTENT_NAME
```
public static final String XML_TAG_TABLE_CONTENT_NAME
```
    See Also:
    Constant Field Values
  - XML_TAG_TABLE_CONTENT_USAGE
```
public static final String XML_TAG_TABLE_CONTENT_USAGE
```
    See Also:
    Constant Field Values
  - XML_ATTRIBUTE_STRUCTURE_USAGE
```
public static final String XML_ATTRIBUTE_STRUCTURE_USAGE
```
    See Also:
    Constant Field Values
  - XML_ATTRIBUTE_IS_NULL
```
public static final String XML_ATTRIBUTE_IS_NULL
```
    See Also:
    Constant Field Values
  - XML_ATTRIBUTE_CONTAINS_NULL
```
public static final String XML_ATTRIBUTE_CONTAINS_NULL
```
    See Also:
    Constant Field Values
- Method Detail
  - addValueToElement
```
public static void addValueToElement(String value,
                     Element el,
                     String tagName)
```
    Adds the value to the given xml element. Takes care of proper null handling. By value we mean a value of a datatype, e.g. 42EUR is a value of the datatype money.
    
    Parameters:
    value - the string representation of the value
    el - the xml element.
    tagName - the tag name for the element that stored the value
  - addInternationalStringToElement
```
public static void addInternationalStringToElement(org.faktorips.values.DefaultInternationalString value,
                                   Element el,
                                   String tagName)
```
    Adds the DefaultInternationalString to the given xml element. Takes care of proper null handling.
    
    Parameters:
    value - the DefaultInternationalString to be added.
    el - the xml element.
    tagName - the tag name for the element that stored the value.
  - addCDataValueToElement
```
public static void addCDataValueToElement(String value,
                          Element el,
                          String tagName)
```
    Adds the value to the given xml element. The value is inserted inside a CDATA section.
    
    Parameters:
    value - the string representation of the value
    el - the xml element.
    tagName - the tag name for the element that stored the value
  - createValueElement
```
public static Element createValueElement(String value,
                         String tagName,
                         Document ownerDocument,
                         boolean useCDataSection)
```
  - addValueAndReturnElement
```
public static Element addValueAndReturnElement(String value,
                               Element el,
                               String tagName)
```
    Adds the value to the given xml element as does addValueToElement(String, Element, String). The created element then is returned.
    
    Parameters:
    value - the string representation of the value
    el - the XML element to add the value to.
    tagName - the tag name for the element that stored the value
    
    Returns:
    the created element with the given tag name, that contains the given value.
  - getValueFromElement
```
public static String getValueFromElement(Element el,
                         String tagName)
```
    Returns the string representation of the value stored in the child element of the given element with the indicated name. Returns null if the value is null or no such child element exists.
```
     <Parent>
         <Property isNull="false">42</Property>
     </Parent>
 
```
    Parameters:
    el - The xml element that is the parent of the element storing the value.
    tagName - The name of the child
  - getInternationalStringFromElement
```
public static org.faktorips.values.DefaultInternationalString getInternationalStringFromElement(Element el,
                                                                                String tagName)
```
    Returns the DefaultInternationalString stored in the child element of the given element with the indicated name. Returns an empty DefaultInternationalString if the value is null or no such child element exists.
    
    Parameters:
    el - The xml element that is the parent of the element storing the international string.
    tagName - The name of the child
  - getValueFromElement
```
public static String getValueFromElement(Element valueEl)
```
    Returns the string representation of the value stored in given value element. Returns null if the value is null, the attribute isNull is true or no such child element exists.
```
         <Property isNull="false">42</Property>
 
```
    Parameters:
    valueEl - The xml value element containing the value.
  - getInternationalStringFromElement
```
public static org.faktorips.values.DefaultInternationalString getInternationalStringFromElement(Element el)
```
    Returns the DefaultInternationalString stored in the given element. Returns an empty DefaultInternationalString if the value is null.
    
    Parameters:
    el - The xml element storing the international string.
  - getRangeFromElement
```
public static Range getRangeFromElement(Element el,
                        String tagName)
```
  - getEnumValueSetFromElement
```
public static EnumValues getEnumValueSetFromElement(Element el,
                                    String tagName)
```

Class ValueToXmlHelper

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

XML_TAG_VALUE

XML_TAG_VALUE_SET

XML_TAG_DATA

XML_TAG_CONFIG_ELEMENT

XML_TAG_ATTRIBUTE_VALUE

XML_ATTRIBUTE_ATTRIBUTE

XML_TAG_ALL_VALUES

XML_TAG_ENUM

XML_TAG_RANGE

XML_TAG_STEP

XML_TAG_UPPER_BOUND

XML_TAG_LOWER_BOUND

XML_TAG_TABLE_CONTENT_NAME

XML_TAG_TABLE_CONTENT_USAGE

XML_ATTRIBUTE_STRUCTURE_USAGE

XML_ATTRIBUTE_IS_NULL

XML_ATTRIBUTE_CONTAINS_NULL

Method Detail

addValueToElement

addInternationalStringToElement

addCDataValueToElement

createValueElement

addValueAndReturnElement

getValueFromElement

getInternationalStringFromElement

getValueFromElement

getInternationalStringFromElement

getRangeFromElement

getEnumValueSetFromElement