View Javadoc

1   /*
2    * $Id: Interceptor.java,v 1.2 2004/05/23 10:26:57 eelco12 Exp $
3    * $Revision: 1.2 $
4    * $Date: 2004/05/23 10:26:57 $
5    *
6    * ====================================================================
7    * Copyright (c) 2003, Open Edge B.V.
8    * All rights reserved.
9    * Redistribution and use in source and binary forms, with or without 
10   * modification, are permitted provided that the following conditions are met:
11   * Redistributions of source code must retain the above copyright notice, 
12   * this list of conditions and the following disclaimer. Redistributions 
13   * in binary form must reproduce the above copyright notice, this list of 
14   * conditions and the following disclaimer in the documentation and/or other 
15   * materials provided with the distribution. Neither the name of OpenEdge B.V. 
16   * nor the names of its contributors may be used to endorse or promote products 
17   * derived from this software without specific prior written permission.
18   * 
19   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
20   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
21   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 
22   * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
23   * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
24   * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
25   * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
26   * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
27   * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
28   * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 
29   * THE POSSIBILITY OF SUCH DAMAGE.
30   */
31  package nl.openedge.baritus.interceptors;
32  
33  /***
34   * Tagging interface for interceptors. Clients should use one or more of the specific
35   * interfaces to actually intercept on something.
36   * 
37   * Interceptors provide a means to encapsulate cross-cutting code that is 
38   * executed on pre-defined points in the line of execution.
39   * 
40   * Interceptors can be used to decorate the normal execution. Also, by throwing FlowExceptions, interceptors can
41   * alter the flow of execution. An interceptor can throw a FlowException if it wants Baritus to stop
42   * normal processing and go to the given declared view (using ReturnNowFlowException) such as 'error', 
43   * or dispatch to an arbitrary - non declared - URL (using DispatchNowFlowException) location.
44   *  
45   * @author Eelco Hillenius
46   */
47  public interface Interceptor
48  {
49  
50  }