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  
27  package org.apache.http.conn.params;
28  
29  import org.apache.http.impl.conn.DefaultHttpResponseParser;
30  
31  /**
32   * Parameter names for HTTP client connections.
33   *
34   * @since 4.0
35   */
36  @Deprecated
37  public interface ConnConnectionPNames {
38  
39      /**
40       * Defines the maximum number of ignorable lines before we expect
41       * a HTTP response's status line.
42       * <p>
43       * With HTTP/1.1 persistent connections, the problem arises that
44       * broken scripts could return a wrong Content-Length
45       * (there are more bytes sent than specified).
46       * Unfortunately, in some cases, this cannot be detected after the
47       * bad response, but only before the next one.
48       * So HttpClient must be able to skip those surplus lines this way.
49       * </p>
50       * <p>
51       * This parameter expects a value of type {@link Integer}.
52       * 0 disallows all garbage/empty lines before the status line.
53       * Use {@link java.lang.Integer#MAX_VALUE} for unlimited number.
54       * </p>
55       *
56       * @deprecated Use custom {@link DefaultHttpResponseParser} implementation
57       */
58      public static final String MAX_STATUS_LINE_GARBAGE = "http.connection.max-status-line-garbage";
59  
60  
61  }