View Javadoc

1   /*
2    * ====================================================================
3    *
4    *  Licensed to the Apache Software Foundation (ASF) under one or more
5    *  contributor license agreements.  See the NOTICE file distributed with
6    *  this work for additional information regarding copyright ownership.
7    *  The ASF licenses this file to You under the Apache License, Version 2.0
8    *  (the "License"); you may not use this file except in compliance with
9    *  the License.  You may obtain a copy of the License at
10   *
11   *      http://www.apache.org/licenses/LICENSE-2.0
12   *
13   *  Unless required by applicable law or agreed to in writing, software
14   *  distributed under the License is distributed on an "AS IS" BASIS,
15   *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16   *  See the License for the specific language governing permissions and
17   *  limitations under the License.
18   * ====================================================================
19   *
20   * This software consists of voluntary contributions made by many
21   * individuals on behalf of the Apache Software Foundation.  For more
22   * information on the Apache Software Foundation, please see
23   * <http://www.apache.org/>.
24   *
25   */
26  package org.apache.http.client;
27  
28  import org.apache.http.conn.routing.HttpRoute;
29  
30  /**
31   * Represents a controller that dynamically adjusts the size
32   * of an available connection pool based on feedback from
33   * using the connections.
34   *
35   * @since 4.2
36   *
37   */
38  public interface BackoffManager {
39  
40      /**
41       * Called when we have decided that the result of
42       * using a connection should be interpreted as a
43       * backoff signal.
44       */
45      public void backOff(HttpRoute route);
46  
47      /**
48       * Called when we have determined that the result of
49       * using a connection has succeeded and that we may
50       * probe for more connections.
51       */
52      public void probe(HttpRoute route);
53  }