01: /*
02: * Copyright (c) 1998-2008 Caucho Technology -- all rights reserved
03: *
04: * This file is part of Resin(R) Open Source
05: *
06: * Each copy or derived work must preserve the copyright notice and this
07: * notice unmodified.
08: *
09: * 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: * Services the request.
53: *
54: * <pre>
55: * burlap:call ::= (header | require, object)*, method, object*
56: * </pre>
57: *
58: * @param rawIs the raw input stream from the servlet request
59: * @param rawOs the raw output stream to the servlet response
60: */
61: abstract public void _service(InputStream rawIs, OutputStream rawOs)
62: throws Exception;
63:
64: /**
65: * Services the request.
66: *
67: * @param rawIs the raw input stream from the servlet request
68: * @param rawOs the raw output stream to the servlet response
69: */
70: public void _service(InputStream rawIs, OutputStream rawOs,
71: Throwable e) throws Exception {
72: throw new UnsupportedOperationException(getClass().getName());
73: }
74: }
|