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 
32 package 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
47 public 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