1 /*
2 * $HeadURL: https://svn.apache.org/repos/asf/httpcomponents/oac.hc3x/trunk/src/test/org/apache/commons/httpclient/server/HttpRequestHandler.java $
3 * $Revision: 1425331 $
4 * $Date: 2012-12-22 18:29:41 +0000 (Sat, 22 Dec 2012) $
5 *
6 * ====================================================================
7 *
8 * Licensed to the Apache Software Foundation (ASF) under one or more
9 * contributor license agreements. See the NOTICE file distributed with
10 * this work for additional information regarding copyright ownership.
11 * The ASF licenses this file to You under the Apache License, Version 2.0
12 * (the "License"); you may not use this file except in compliance with
13 * the License. You may obtain a copy of the License at
14 *
15 * http://www.apache.org/licenses/LICENSE-2.0
16 *
17 * Unless required by applicable law or agreed to in writing, software
18 * distributed under the License is distributed on an "AS IS" BASIS,
19 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20 * See the License for the specific language governing permissions and
21 * limitations under the License.
22 * ====================================================================
23 *
24 * This software consists of voluntary contributions made by many
25 * individuals on behalf of the Apache Software Foundation. For more
26 * information on the Apache Software Foundation, please see
27 * <http://www.apache.org/>.
28 *
29 * [Additional notices, if required by prior licensing conditions]
30 *
31 */
32
33 package org.apache.commons.httpclient.server;
34
35 import java.io.IOException;
36
37 /***
38 * Defines an HTTP request handler for the SimpleHttpServer
39 *
40 * @author Christian Kohlschuetter
41 * @author Oleg Kalnichevski
42 */
43 public interface HttpRequestHandler {
44 /***
45 * The request handler is asked to process this request.
46 *
47 * If it is not capable/interested in processing it, this call should
48 * be simply ignored.
49 *
50 * Any modification of the output stream (via <code>conn.getWriter()</code>)
51 * by this request handler will stop the execution chain and return the output
52 * to the client.
53 *
54 * The handler may also rewrite the request parameters (this is useful in
55 * {@link HttpRequestHandlerChain} structures).
56 *
57 * @param conn The Connection object to which this request belongs to.
58 * @param request The request object.
59 * @return true if this handler handled the request and no other handlers in the
60 * chain should be called, false otherwise.
61 * @throws IOException
62 */
63 public boolean processRequest(
64 final SimpleHttpServerConnection conn,
65 final SimpleRequest request) throws IOException;
66 }