View Javadoc

1   
2   /*
3    * Copyright (C) 2005 by Arno Schumacher
4    *
5    * This file is part of net.sourceforge.servletspy
6    *
7    * net.sourceforge.servletspy is free software; you can redistribute
8    * it and/or modify it under the terms of the GNU General Public 
9    * License as published by the Free Software Foundation; either 
10   * version 2, or (at your option) any later version.
11   *
12   * net.sourceforge.servletspy is distributed in the hope that it will
13   * be useful, but WITHOUT ANY WARRANTY; without even the implied 
14   * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  
15   * See the GNU General Public License for more details.
16   *
17   * You should have received a copy of the GNU General Public License
18   * along with this program; if not, write to the Free Software
19   * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA 
20   */
21  
22  
23  package net.sourceforge.servletspy;
24  
25  /***
26   * The <code>IContextHandler</code> describes an object used to do a subject
27   * to node graph serialization.
28   *
29   * @author arno schumacher
30   */
31  public interface IContextHandler extends ILifecycle {
32      /***
33       * The <code>handle</code> method of the <code>IContextHandler</code> is
34       * called by the engine each time a subject object should be serialized.
35       * The <code>IContextHandler</code> may do the serialization itself using
36       * the operations provided by the <code>IContext</code> or pass the
37       * serialization task to the next <code>IContextHandler</code> by calling
38       * the <code>proceed</code> method on the <code>IContext</code> object.
39       *
40       * @param context
41       *            The current serialization context
42       * @throws Exception
43       *             To signal serialization problems
44       */
45      void handle(IContext context) throws Exception;
46  }