ozonebranch.java

Java的面向对象数据库系统的源代码

package org.ozoneDB.xml.dom4j;

import org.dom4j.Branch;
import org.dom4j.Element;
import org.dom4j.Node;
import org.ozoneDB.OzoneRemote;
import org.ozoneDB.xml.dom4j.o3impl.BackedList;

import java.util.List;

/**
 * $Id: OzoneBranch.java,v 1.1 2003/07/07 10:30:29 per_nyfelt Exp $
 */
public interface OzoneBranch extends Branch, OzoneRemote {

    /** @return the text value of the given content object
     * as text which returns the text value of CDATA, Entity or Text nodes
     */
    String getContentAsText(Object content);

    /** @return the XPath defined string-value of the given content object
     */
    String getContentAsStringValue(Object content);

    String getTextTrim();

    /** @return the ID of the given <code>Element</code>
     */
    String elementID(Element element);

    /** @return the internal List used to manage the content */
    List contentList();

    /** A Factory Method pattern which creates
     * a List implementation used to store content
     */
    List createContentList();

    /** A Factory Method pattern which creates
     * a List implementation used to store content
     */
    List createContentList(int size);


    /** A Factory Method pattern which creates
     * a BackedList implementation used to store results of
     * a filtered content query.     */
    BackedList createResultList();

    /** A Factory Method pattern which creates
     * a BackedList implementation which contains a single result
     */
    List createSingleResultList(Object result);

    /** A Factory Method pattern which creates an empty
     * a BackedList implementation
     */
    List createEmptyList();

    void addNode(Node node);

    void addNode(int index, Node node);

    boolean removeNode(Node node);


    /** Called when a new child node has been added to me
     * to allow any parent relationships to be created or
     * events to be fired.
     */
    void childAdded(Node node);

    /** Called when a child node has been removed
     * to allow any parent relationships to be deleted or
     * events to be fired.
     */
    void childRemoved(Node node);

    /** Called when the given List content has been removed so
     * each node should have its parent and document relationships
     * cleared
     */
    void contentRemoved();

    /** Called when an invalid node has been added.
     * Throws an {@link org.dom4j.IllegalAddException}.
     */
    void invalidNodeTypeAddException(Node node);
}