KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > jboss > proxy > Interceptor


1 /*
2 * JBoss, Home of Professional Open Source
3 * Copyright 2005, JBoss Inc., and individual contributors as indicated
4 * by the @authors tag. See the copyright.txt in the distribution for a
5 * full listing of individual contributors.
6 *
7 * This is free software; you can redistribute it and/or modify it
8 * under the terms of the GNU Lesser General Public License as
9 * published by the Free Software Foundation; either version 2.1 of
10 * the License, or (at your option) any later version.
11 *
12 * This software is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this software; if not, write to the Free
19 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
20 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
21 */

22 package org.jboss.proxy;
23
24 import java.io.Externalizable JavaDoc;
25 import java.io.IOException JavaDoc;
26 import java.io.ObjectInput JavaDoc;
27 import java.io.ObjectOutput JavaDoc;
28 import org.jboss.invocation.Invocation;
29
30 /**
31  * The base class for all interceptors.
32  *
33  * @author <a HREF="mailto:marc.fleury@jboss.org">Marc Fleury</a>
34  * @version $Revision: 37459 $
35  */

36 public abstract class Interceptor
37    implements Externalizable JavaDoc
38 {
39    /** The serialVersionUID. @since 1.2 */
40    private static final long serialVersionUID = 4358098404672505200L;
41
42    /** The next interceptor in the chain. */
43    protected Interceptor nextInterceptor;
44  
45    /**
46     * Set the next interceptor in the chain.
47     *
48     * <p>
49     * String together the interceptors
50     * We return the passed interceptor to allow for
51     * interceptor1.setNext(interceptor2).setNext(interceptor3)... constructs.
52     */

53    public Interceptor setNext(final Interceptor interceptor) {
54       // assert interceptor != null
55
nextInterceptor = interceptor;
56       return interceptor;
57    }
58    
59    public Interceptor getNext() {
60       return nextInterceptor;
61    }
62
63    public abstract Object JavaDoc invoke(Invocation mi) throws Throwable JavaDoc;
64    
65    /**
66     * Writes the next interceptor.
67     */

68    public void writeExternal(final ObjectOutput JavaDoc out)
69       throws IOException JavaDoc
70    {
71       out.writeObject(nextInterceptor);
72    }
73
74    /**
75     * Reads the next interceptor.
76     */

77    public void readExternal(final ObjectInput JavaDoc in)
78       throws IOException JavaDoc, ClassNotFoundException JavaDoc
79    {
80       nextInterceptor = (Interceptor)in.readObject();
81    }
82 }
83
Popular Tags