package lrs;

/**
 * Represents the abstract list state. Has a concrete toString () method that
 * uses anynomous inner classes to compute the String representation of the
 * LRStruct owner.
 * @author Dung X. Nguyen  Copyright 2001 - All rights reserved.
 * @since 10/09/01
 * @stereotype abstract state
 */
abstract class ANode {
    /**
     * Uses anonymous visitor class to compute a String representation.
     * Anonymous inner classes will be discussed soon!
     */
    String toString(LRStruct owner) {
        return (String)owner.execute (new IAlgo() {
            public Object emptyCase(LRStruct host, Object inp) {
                return "()";
            }

            public Object nonEmptyCase(LRStruct host, Object inp) {
                return "(" + host.getFirst() + host.getRest().execute(new IAlgo() {
                    public Object emptyCase(LRStruct h, Object i) {
                        return ")";
                    }

                    public Object nonEmptyCase(LRStruct h, Object i) {
                        return " " + h.getFirst() + h.getRest().execute (this, null);
                    }
                }
                , null);
            }
        }
        , null);
   }

    /**
    * Returns the tail LRStruct of the referencing LRStruct.
    * @param owner the LRStruct referencing this ANode.
    * @return the tail LRStruct of owner.
    * @throw java.util.NoSuchElementException if empty.
    */
    abstract LRStruct getRest(LRStruct owner);

    /**
    * Returns the first data object of the referencing LRStruct.
    * @param owner the LRStruct referencing this ANode.
    * @return the tail LRStruct of owner.
    * @throw java.util.NoSuchElementException if empty.
    */
    abstract Object getFirst(LRStruct owner);

    /**
    * Sets a new tail for the referencing LRStruct.
    * @param tail the new tail for the owner LRStruct.
    * @param owner the LRS referencing this ANode.
    * @throw java.util.NoSuchElementException if empty.
    * @return LRStruct owner
    */
    abstract LRStruct setRest(LRStruct tail, LRStruct owner);

    /**
    * Sets a new first data object for the referencing LRStruct.
    * @param first the new data object for this ANode.
    * @param owner the LRS referencing this ANode.
    * @throw java.util.NoSuchElementException if empty.
    * @return LRStruct owner
    */
    abstract LRStruct setFirst(Object dat, LRStruct owner);

    /**
    * Inserts a data object at the front of the LRStruct owner.
    * @param dat the object to be inserted at the front.
    * @param owner the LRS referencing this ANode.
    * @return LRStruct owner
    */
    abstract LRStruct insertFront(Object dat, LRStruct owner);

    /**
    * Removes and returns the first data object for the referencing LRStruct.
    * @param owner the LRS referencing this ANode.
    * @return the front data of the LRStruct owner.
    */
    abstract Object removeFront(LRStruct owner);

    /**
    * Executes a visitor algorithm and returns the output.
    * @param algo the visitor algorithm to be executed.
    * @param inp the input needed by the algorithm.
    * @param owner the LRStruct referencing this ANode.
    */
    abstract Object execute(IAlgo algo, Object inp, LRStruct owner);
}