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 }