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: *
23: * Free Software Foundation, Inc.
24: * 59 Temple Place, Suite 330
25: * Boston, MA 02111-1307 USA
26: *
27: * @author Scott Ferguson
28: */
29:
30: package com.caucho.servlet.comet;
31:
32: import java.io.*;
33: import javax.servlet.*;
34:
35: /**
36: * Servlet to handle comet requests.
37: */
38: abstract public class GenericCometServlet extends GenericServlet
39: implements CometServlet {
40: /**
41: * Services the initial request.
42: *
43: * @param request the servlet request object
44: * @param response the servlet response object
45: * @param controller the controller to be passed to application code
46: *
47: * @return true for keepalive, false for the end of the request
48: */
49: abstract public boolean service(ServletRequest request,
50: ServletResponse response, CometController controller)
51: throws IOException, ServletException;
52:
53: /**
54: * Resumes service the initial request.
55: *
56: * @param request the servlet request object
57: * @param response the servlet response object
58: * @param controller the controller to be passed to application code
59: *
60: * @return true for keepalive, false for the end of the request
61: */
62: public boolean resume(ServletRequest request,
63: ServletResponse response, CometController controller)
64: throws IOException, ServletException {
65: return false;
66: }
67:
68: /**
69: * Implementation of the servlet's request.
70: */
71: public final void service(ServletRequest request,
72: ServletResponse response) throws IOException,
73: ServletException {
74: throw new IllegalStateException(getClass().getName()
75: + " should never have its service() called.");
76: }
77: }
|