Skeleton


1   /*
2    * Copyright (c) 1998-2006 Caucho Technology -- all rights reserved
3    *
4    * This file is part of Resin(R) Open Source
5    *
6    * Each copy or derived work must preserve the copyright notice and this
7    * notice unmodified.
8    *
9    * Resin Open Source is free software; you can redistribute it and/or modify
10   * it under the terms of the GNU General Public License as published by
11   * the Free Software Foundation; either version 2 of the License, or
12   * (at your option) any later version.
13   *
14   * Resin Open Source is distributed in the hope that it will be useful,
15   * but WITHOUT ANY WARRANTY; without even the implied warranty of
16   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
17   * of NON-INFRINGEMENT.  See the GNU General Public License for more
18   * details.
19   *
20   * You should have received a copy of the GNU General Public License
21   * along with Resin Open Source; if not, write to the
22   *   Free SoftwareFoundation, Inc.
23   *   59 Temple Place, Suite 330
24   *   Boston, MA 02111-1307  USA
25   *
26   * @author Scott Ferguson
27   */
28  
29  package com.caucho.ejb.protocol;
30  
31  import com.caucho.log.Log;
32  
33  import java.io.InputStream  ;
34  import java.io.OutputStream  ;
35  import java.util.logging.Logger  ;
36  
37  /**
38   * Base class for any bean skeleton capable of handling an BURLAP-RPC request.
39   *
40   * <p/>Once selected, the calling servlet will dispatch the request through
41   * the <code>_service</code> call.  After parsing the request headers,
42   * <code>_service</code> calls the generated entry <code>_execute</code>
43   * to execute the request.
44   */
45  abstract public class Skeleton {
46    protected static final Logger   log = Log.open(Skeleton.class);
47  
48    public void setDebug(boolean isDebug)
49    {
50    }
51  
52    /**
53     * Services the request.
54     *
55     * <pre>
56     * burlap:call ::= (header | require, object)*, method, object*
57     * </pre>
58     *
59     * @param rawIs the raw input stream from the servlet request
60     * @param rawOs the raw output stream to the servlet response
61     */
62    abstract public void _service(InputStream   rawIs, OutputStream   rawOs)
63      throws Exception  ;
64  
65    /**
66     * Services the request.
67     *
68     * @param rawIs the raw input stream from the servlet request
69     * @param rawOs the raw output stream to the servlet response
70     */
71    public void _service(InputStream   rawIs, OutputStream   rawOs,
72                  Throwable   e)
73      throws Exception  
74    {
75      throw new UnsupportedOperationException  (getClass().getName());
76    }
77  }
78  
79  
80
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags