package org.litesoft.core.hierarchicaldata;

public interface HierarchicalDataSink
{
    public interface Node extends AttributesNameValueMutator
    {
        /**
         * addAttribute may ONLY be called until 'createChildNode' or 'done' is called!
         *
         * @param pAttributeName must start with a letter and the rest may consist of alphaNumeric + '.' + '_'
         */
        void setAttribute( String pAttributeName, String pValue );

        /**
         * createChildNode may ONLY be called until 'done' is called!
         *
         * @param pName must start with a letter and the rest may consist of alphaNumeric + '.' + '_'
         */
        Node createChildNode( String pName );

        /**
         * done MUST only be called once and there after the Node is "done"!
         */
        void done();
    }

    /**
     * createRootNode may only be called once!
     *
     * @param pName must start with a letter and the rest may consist of alphaNumeric + '.' + '_'
     */
    Node createRootNode( String pName );
}