util4serializer.java

Fire-Workflow-Engine-All-In-One-20090208 包含全部文档

/*--

 Copyright (C) 2002-2003 Anthony Eden.
 All rights reserved.

 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions
 are met:

 1. Redistributions of source code must retain the above copyright
    notice, this list of conditions, and the following disclaimer.

 2. Redistributions in binary form must reproduce the above copyright
    notice, this list of conditions, and the disclaimer that follows
    these conditions in the documentation and/or other materials
    provided with the distribution.

 3. The names "OBE" and "Open Business Engine" must not be used to
    endorse or promote products derived from this software without prior
    written permission.  For written permission, please contact
    [e-mail].

 4. Products derived from this software may not be called "OBE" or
    "Open Business Engine", nor may "OBE" or "Open Business Engine"
    appear in their name, without prior written permission from
    Anthony Eden ([e-mail]).

 In addition, I request (but do not require) that you include in the
 end-user documentation provided with the redistribution and/or in the
 software itself an acknowledgement equivalent to the following:
     "This product includes software developed by
      Anthony Eden (http://www.anthonyeden.com/)."

 THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
 WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT,
 INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
 IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 POSSIBILITY OF SUCH DAMAGE.

 For more information on OBE, please see <http://www.openbusinessengine.org/>.

 */

package org.fireflow.model.io;

import java.net.MalformedURLException;
import java.net.URL;
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.List;
import java.util.Map;
import java.util.Date;

import org.dom4j.QName;
import org.dom4j.Element;
import org.dom4j.CDATA;
import org.fireflow.model.Duration;


/** Dom4J XPDL Serializer utility class.

    @author Anthony Eden
*/

class Util4Serializer{

    /* ISO standard date format. */
    private static final DateFormat STANDARD_DF = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssz");

    /** Noop constructor. */

    private Util4Serializer(){
        // no op
    }

    /** Add a child element with the specific name to the given parent
        element and return the child element.  This method will use the
        namespace of the parent element for the child element's namespace.

        @param parent The parent element
        @param name The new child element name
        @return The child element
    */

    static Element addElement(Element parent, String name){
        return parent.addElement(new QName(name, parent.getNamespace()));
    }

    /** Add a child element with the specific name and the given value to
        the given parent element and return the child element.  This method
        will use the namespace of the parent element for the child element's
        namespace.

        @param parent The parent element
        @param name The new child element name
        @param value The value
        @return The child element
    */

    static Element addElement(Element parent, String name, Date value){
        return addElement(parent, name, value, null);
    }

    /** Add a child element with the specific name and the given value to
        the given parent element and return the child element.  This method
        will use the namespace of the parent element for the child element's
        namespace.  If the given value is null then the default value is
        used.  If the value is null then this method will not add the child
        element and will return null.

        @param parent The parent element
        @param name The new child element name
        @param value The value
        @param defaultValue The default value (if the value is null)
        @return The child element
    */

    static Element addElement(Element parent, String name, Date value,
    Date defaultValue){
        Element child = null;

        if(value == null){
            value = defaultValue;
        }

        if(value != null){
            child = addElement(parent, name);
            child.addText(STANDARD_DF.format(value));
        }

        return child;
    }

    /** Add a child element with the specific name and the given value to
        the given parent element and return the child element.  This method
        will use the namespace of the parent element for the child element's
        namespace.

        @param parent The parent element
        @param name The new child element name
        @param value The value
        @return The child element
    */

    static Element addElement(Element parent, String name, String value){
        return addElement(parent, name, value, null);
    }

    static Element addElement(Element parent,String name,CDATA value){

      Element child = null;

      child = addElement(parent, name);
      child.add(value);

      return child;

    }

    /** Add a child element with the specific name and the given value to
        the given parent element and return the child element.  This method
        will use the namespace of the parent element for the child element's
        namespace.  If the given value is null then the default value is
        used.  If the value is null then this method will not add the child
        element and will return null.

        @param parent The parent element
        @param name The new child element name
        @param value The value
        @param defaultValue The default value (if the value is null)
        @return The child element
    */

    static Element addElement(Element parent, String name, String value,
    String defaultValue){
        Element child = null;

        if(value == null){
            value = defaultValue;
        }

        if(value != null){
            child = addElement(parent, name);
            child.addText(value);
        }

        return child;
    }

    /** Add a child element with the specific name and the given value to
        the given parent element and return the child element.  This method
        will use the namespace of the parent element for the child element's
        namespace.

        @param parent The parent element
        @param name The new child element name
        @param value The value
        @return The child element
    */

    static Element addElement(Element parent, String name, URL value){
        return addElement(parent, name, value, null);
    }

    /** Add a child element with the specific name and the given value to
        the given parent element and return the child element.  This method
        will use the namespace of the parent element for the child element's
        namespace.  If the given value is null then the default value is
        used.  If the value is null then this method will not add the child
        element and will return null.

        @param parent The parent element
        @param name The new child element name
        @param value The value
        @param defaultValue The default value (if the value is null)
        @return The child element
    */

    static Element addElement(Element parent, String name, URL value,
    URL defaultValue){
        Element child = null;

        if(value == null){
            value = defaultValue;
        }

        if(value != null){
            child = addElement(parent, name);
            child.addText(value.toString());
        }

        return child;
    }

    /** Add a child element with the specific name and the given value to
        the given parent element and return the child element.  This method
        will use the namespace of the parent element for the child element's
        namespace.

        @param parent The parent element
        @param name The new child element name
        @param value The value
        @return The child element
    */

    static Element addElement(Element parent, String name, Duration value){
        return addElement(parent, name, value, null);
    }

    /** Add a child element with the specific name and the given value to
        the given parent element and return the child element.  This method
        will use the namespace of the parent element for the child element's
        namespace.  If the given value is null then the default value is
        used.  If the value is null then this method will not add the child
        element and will return null.

        @param parent The parent element
        @param name The new child element name
        @param value The value
        @param defaultValue The default value (if the value is null)
        @return The child element
    */

    static Element addElement(Element parent, String name, Duration value,
    Duration defaultValue){
        Element child = null;

        if(value == null){
            value = defaultValue;
        }

        if(value != null){
            child = addElement(parent, name);
            child.addText(value.toString());
        }

        return child;
    }
    public static Element child(Element element, String name) {
        return element.element(new QName(name, element.getNamespace()));
    }

    /** Return the child elements with the given name.  The elements must be in
     the same name space as the parent element.

     @param element The parent element
     @param name The child element name
     @return The child elements
     */

    public static List children(Element element, String name) {
        return element.elements(new QName(name, element.getNamespace()));
    }

    // Conversion

    /** Return the value of the child element with the given name.  The element
     must be in the same name space as the parent element.

     @param element The parent element
     @param name The child element name
     @return The child element value
     */

    public static String elementAsString(Element element, String name) {
        String s = element.elementTextTrim(
            new QName(name, element.getNamespace()));
        return (s == null || s.length() == 0) ? null : s;
    }

    public static Date elementAsDate(Element element, String name) throws
        FPDLParserException {
        String text = elementAsString(element, name);
        if (text == null) {
            return null;
        }

        try {
            return DateUtilities.getInstance().parse(text);
            //return STANDARD_DF.parse(text);
        } catch (ParseException e) {
            throw new FPDLParserException("Error parsing date: " + text, e);
        }
    }

    public static int elementAsInteger(Element element, String name) {
        String text = elementAsString(element, name);
        if (text == null) {
            return 0;
        }

        return Integer.parseInt(text);
    }

    /*
    public static boolean elementAsBoolean(Element element, String name) {
        String text = elementAsString(element, name);
        if (text == null) {
            return false;
        }

        return new Boolean(text).booleanValue();
    }

    public static URL elementAsURL(Element element, String name) throws
        FPDLParserException {
        String text = elementAsString(element, name);
        if (text == null) {
            return null;
        }

        try {
            return new URL(text);
        } catch (MalformedURLException e) {
            throw new FPDLParserException("Invalid URL: " + text, e);
        }
    }

    public static Duration elementAsDuration(Element element, String name)
        throws FPDLParserException {
        String text = elementAsString(element, name);
        if (text == null) {
            return null;
        }

        try {
            return Duration.parse(text);
        } catch (NumberFormatException e) {
            throw new FPDLParserException("Error parsing duration", e);
        }
    }

    public static DurationUnit elementAsDurationUnit(Element element,
        String name) throws FPDLParserException {
        String text = elementAsString(element, name);
        if (text == null) {
            return null;
        }

        try {
            return DurationUnit.fromString(text);
        } catch (NumberFormatException e) {
            throw new FPDLParserException("Error parsing duration unit", e);
        }
    }
    */
    
//    public static boolean isNotEmpty(String s){
//    	if (s==null || s.trim().equals("")){
//    		return false;
//    	}else{
//    		return true;
//    	}
//    }
}