1/*
2 * $HeadURL: http://svn.apache.org/repos/asf/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/params/CoreProtocolPNames.java $
3 * $Revision: 576077 $
4 * $Date: 2007-09-16 04:50:22 -0700 (Sun, 16 Sep 2007) $
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
32package org.apache.http.params;
33
34
35/**
36 * Defines parameter names for protocol execution in HttpCore.
37 *
38 * @version $Revision: 576077 $
39 *
40 * @since 4.0
41 *
42 * @deprecated Please use {@link java.net.URL#openConnection} instead.
43 *     Please visit <a href="http://android-developers.blogspot.com/2011/09/androids-http-clients.html">this webpage</a>
44 *     for further details.
45 */
46@Deprecated
47public interface CoreProtocolPNames {
48
49    /**
50     * Defines the {@link org.apache.http.ProtocolVersion protocol version}
51     * used per default.
52     * <p>
53     * This parameter expects a value of type
54     * {@link org.apache.http.ProtocolVersion}.
55     * </p>
56     */
57    public static final String PROTOCOL_VERSION = "http.protocol.version";
58
59    /**
60     * Defines the charset to be used for encoding HTTP protocol elements.
61     * <p>
62     * This parameter expects a value of type {@link String}.
63     * </p>
64     */
65    public static final String HTTP_ELEMENT_CHARSET = "http.protocol.element-charset";
66
67    /**
68     * Defines the charset to be used per default for encoding content body.
69     * <p>
70     * This parameter expects a value of type {@link String}.
71     * </p>
72     */
73    public static final String HTTP_CONTENT_CHARSET = "http.protocol.content-charset";
74
75    /**
76     * Defines the content of the <tt>User-Agent</tt> header.
77     * <p>
78     * This parameter expects a value of type {@link String}.
79     * </p>
80     */
81    public static final String USER_AGENT = "http.useragent";
82
83    /**
84     * Defines the content of the <tt>Server</tt> header.
85     * <p>
86     * This parameter expects a value of type {@link String}.
87     * </p>
88     */
89    public static final String ORIGIN_SERVER = "http.origin-server";
90
91    /**
92     * Defines whether responses with an invalid <tt>Transfer-Encoding</tt> header should be
93     * rejected.
94     * <p>
95     * This parameter expects a value of type {@link Boolean}.
96     * </p>
97     */
98    public static final String STRICT_TRANSFER_ENCODING = "http.protocol.strict-transfer-encoding";
99
100    /**
101     * <p>
102     * Activates 'Expect: 100-continue' handshake for the
103     * entity enclosing methods. The purpose of the 'Expect: 100-continue'
104     * handshake to allow a client that is sending a request message with
105     * a request body to determine if the origin server is willing to
106     * accept the request (based on the request headers) before the client
107     * sends the request body.
108     * </p>
109     *
110     * <p>
111     * The use of the 'Expect: 100-continue' handshake can result in
112     * noticable peformance improvement for entity enclosing requests
113     * (such as POST and PUT) that require the target server's
114     * authentication.
115     * </p>
116     *
117     * <p>
118     * 'Expect: 100-continue' handshake should be used with
119     * caution, as it may cause problems with HTTP servers and
120     * proxies that do not support HTTP/1.1 protocol.
121     * </p>
122     *
123     * This parameter expects a value of type {@link Boolean}.
124     */
125    public static final String USE_EXPECT_CONTINUE = "http.protocol.expect-continue";
126
127    /**
128     * <p>
129     * Defines the maximum period of time in milliseconds the client should spend
130     * waiting for a 100-continue response.
131     * </p>
132     *
133     * This parameter expects a value of type {@link Integer}.
134     */
135    public static final String WAIT_FOR_CONTINUE = "http.protocol.wait-for-continue";
136
137}
138