← Back to branch summary

~ubuntu-branches/ubuntu/trusty/httpcomponents-core/trusty

« back to all changes in this revision

Viewing changes to httpcore-nio/src/main/java/org/apache/http/nio/protocol/EventListener.java

  • Committer: Bazaar Package Importer
  • Author(s): David Paleino
  • Date: 2010-06-12 08:37:34 UTC
  • Revision ID: james.westby@ubuntu.com-20100612083734-1y8kp6qm4sjk60az
Tags: upstream-4.0.1
Import upstream version 4.0.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
httpcore-nio/src/main/java/org/apache/http/nio/protocol/EventListener.java
 
1
/*
 
2
 * $HeadURL: https://svn.apache.org/repos/asf/httpcomponents/httpcore/tags/4.0.1/httpcore-nio/src/main/java/org/apache/http/nio/protocol/EventListener.java $
 
3
 * $Revision: 744543 $
 
4
 * $Date: 2009-02-14 18:30:41 +0100 (Sat, 14 Feb 2009) $
 
5
 *
 
6
 * ====================================================================
 
7
 * Licensed to the Apache Software Foundation (ASF) under one
 
8
 * or more contributor license agreements.  See the NOTICE file
 
9
 * distributed with this work for additional information
 
10
 * regarding copyright ownership.  The ASF licenses this file
 
11
 * to you under the Apache License, Version 2.0 (the
 
12
 * "License"); you may not use this file except in compliance
 
13
 * with 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,
 
18
 * software distributed under the License is distributed on an
 
19
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 
20
 * KIND, either express or implied.  See the License for the
 
21
 * specific language governing permissions and limitations
 
22
 * under the License.
 
23
 * ====================================================================
 
24
 *
 
25
 * This software consists of voluntary contributions made by many
 
26
 * individuals on behalf of the Apache Software Foundation.  For more
 
27
 * information on the Apache Software Foundation, please see
 
28
 * <http://www.apache.org/>.
 
29
 *
 
30
 */
 
31
 
 
32
package org.apache.http.nio.protocol;
 
33
 
 
34
import java.io.IOException;
 
35
 
 
36
import org.apache.http.HttpException;
 
37
import org.apache.http.nio.NHttpConnection;
 
38
 
 
39
/**
 
40
 * Event listener used by the HTTP protocol layer to report fatal exceptions 
 
41
 * and events that may need to be logged using a logging toolkit.
 
42
 * 
 
43
 * @since 4.0
 
44
 */
 
45
public interface EventListener {
 
46
 
 
47
    /**
 
48
     * Triggered when an I/O error caused a connection to be terminated.
 
49
     * 
 
50
     * @param ex the I/O exception. 
 
51
     * @param conn the connection.
 
52
     */
 
53
    void fatalIOException(IOException ex, NHttpConnection conn);
 
54
 
 
55
    /**
 
56
     * Triggered when an HTTP protocol error caused a connection to be 
 
57
     * terminated.
 
58
     * 
 
59
     * @param ex the protocol exception. 
 
60
     * @param conn the connection.
 
61
     */
 
62
    void fatalProtocolException(HttpException ex, NHttpConnection conn);
 
63
 
 
64
    /**
 
65
     * Triggered when a new connection has been established.
 
66
     * 
 
67
     * @param conn the connection.
 
68
     */
 
69
    void connectionOpen(NHttpConnection conn);
 
70
 
 
71
    /**
 
72
     * Triggered when a connection has been terminated.
 
73
     * 
 
74
     * @param conn the connection.
 
75
     */
 
76
    void connectionClosed(NHttpConnection conn);
 
77
 
 
78
    /**
 
79
     * Triggered when a connection has timed out.
 
80
     * 
 
81
     * @param conn the connection.
 
82
     */
 
83
    void connectionTimeout(NHttpConnection conn);
 
84
    
 
85
}