/*
  Copyright (C) 2006 Helge Hess

  This file is part of JOPE.

  JOPE is free software; you can redistribute it and/or modify it under
  the terms of the GNU Lesser General Public License as published by the
  Free Software Foundation; either version 2, or (at your option) any
  later version.

  JOPE is distributed in the hope that it will be useful, but WITHOUT ANY
  WARRANTY; without even the implied warranty of MERCHANTABILITY or
  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
  License for more details.

  You should have received a copy of the GNU Lesser General Public
  License along with JOPE; see the file COPYING.  If not, write to the
  Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  02111-1307, USA.
*/

package org.opengroupware.jope.appserver.core;

import org.opengroupware.jope.foundation.NSObject;

/*
 * WOElement
 * 
 * This is the superclass of either dynamic elements or components. Both types
 * share the same API and can be used together in a template.
 * 
 * Dynamic elements are reentrant rendering objects which do not keep own
 * processing state while components do have processing state and most often
 * an associated (own) template.
 * 
 * Walking.
 * Walking is basically a superset of the predefined takeValues/invoke/append
 * methods. It allows you to do arbitary things with the template structure.
 * Any element which has a subtemplate (a container) should implement the
 * walkTemplate method.
 */
public abstract class WOElement extends NSObject {

  /* responder */
  
  public void takeValuesFromRequest(WORequest _rq, WOContext _ctx) {
  }
  
  public Object invokeAction(WORequest _rq, WOContext _ctx) {
    return null;
  }
  
  public void appendToResponse(WOResponse _r, WOContext _ctx) {
  }
  
  /* walking the template */
  
  public void walkTemplate(WOElementWalker _walker, WOContext _ctx) {
  }
}