Mercurial > hg > AnnotationManager

comparison libs/httpcomponents-client-4.0-beta1/javadoc/httpclient/org/apache/http/client/HttpClient.html @ 5:0be9d53a6967

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
editor for annotations
author dwinter
date Tue, 13 Dec 2011 17:43:46 +0100
parents
children
comparison
equal deleted inserted replaced
4:c32080f364c6 5:0be9d53a6967
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <!--NewPage-->
3 <HTML>
4 <HEAD>
5 <!-- Generated by javadoc (build 1.5.0_11) on Sat Aug 23 11:49:48 GMT+01:00 2008 -->
6 <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
7 <TITLE>
8 HttpClient (HttpClient 4.0-beta1 API)
9 </TITLE>
10
11 <META NAME="keywords" CONTENT="org.apache.http.client.HttpClient interface">
12
13 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
14
15 <SCRIPT type="text/javascript">
16 function windowTitle()
17 {
18 parent.document.title="HttpClient (HttpClient 4.0-beta1 API)";
19 }
20 </SCRIPT>
21 <NOSCRIPT>
22 </NOSCRIPT>
23
24 </HEAD>
25
26 <BODY BGCOLOR="white" onload="windowTitle();">
27
28
29 <!-- ========= START OF TOP NAVBAR ======= -->
30 <A NAME="navbar_top"><!-- --></A>
31 <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
32 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
33 <TR>
34 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
35 <A NAME="navbar_top_firstrow"><!-- --></A>
36 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
37 <TR ALIGN="center" VALIGN="top">
38 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
39 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
40 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
41 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/HttpClient.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
42 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
43 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
44 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
45 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
46 </TR>
47 </TABLE>
48 </TD>
49 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
50 </EM>
51 </TD>
52 </TR>
53
54 <TR>
55 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
56 &nbsp;<A HREF="../../../../org/apache/http/client/CredentialsProvider.html" title="interface in org.apache.http.client"><B>PREV CLASS</B></A>&nbsp;
57 &nbsp;<A HREF="../../../../org/apache/http/client/HttpRequestRetryHandler.html" title="interface in org.apache.http.client"><B>NEXT CLASS</B></A></FONT></TD>
58 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
59 <A HREF="../../../../index.html?org/apache/http/client/HttpClient.html" target="_top"><B>FRAMES</B></A> &nbsp;
60 &nbsp;<A HREF="HttpClient.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
61 &nbsp;<SCRIPT type="text/javascript">
62 <!--
63 if(window==top) {
64 document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
65 }
66 //-->
67 </SCRIPT>
68 <NOSCRIPT>
69 <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
70 </NOSCRIPT>
71
72
73 </FONT></TD>
74 </TR>
75 <TR>
76 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
77 SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
78 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
79 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
80 </TR>
81 </TABLE>
82 <A NAME="skip-navbar_top"></A>
83 <!-- ========= END OF TOP NAVBAR ========= -->
84
85 <HR>
86 <!-- ======== START OF CLASS DATA ======== -->
87 <H2>
88 <FONT SIZE="-1">
89 org.apache.http.client</FONT>
90 <BR>
91 Interface HttpClient</H2>
92 <DL>
93 <DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../../org/apache/http/impl/client/AbstractHttpClient.html" title="class in org.apache.http.impl.client">AbstractHttpClient</A>, <A HREF="../../../../org/apache/http/impl/client/DefaultHttpClient.html" title="class in org.apache.http.impl.client">DefaultHttpClient</A></DD>
94 </DL>
95 <HR>
96 <DL>
97 <DT><PRE>public interface <B>HttpClient</B></DL>
98 </PRE>
99
100 <P>
101 Interface for an HTTP client.
102 HTTP clients act as a facade to a number of objects required to
103 execute HTTP requests while handling cookies, authentication,
104 connection management, and other features.
105 Thread safety of HTTP clients depends on the implementation
106 and configuration of the specific client.
107 <p/>
108 The usual execution flow can be demonstrated by the
109 code snippet below:
110 <PRE>
111 HttpClient httpclient = new DefaultHttpClient();
112
113 // Prepare a request object
114 HttpGet httpget = new HttpGet("http://www.apache.org/");
115
116 // Execute the request
117 HttpResponse response = httpclient.execute(httpget);
118
119 // Examine the response status
120 System.out.println(response.getStatusLine());
121
122 // Get hold of the response entity
123 HttpEntity entity = response.getEntity();
124
125 // If the response does not enclose an entity, there is no need
126 // to worry about connection release
127 if (entity != null) {
128 InputStream instream = entity.getContent();
129 try {
130
131 BufferedReader reader = new BufferedReader(
132 new InputStreamReader(instream));
133 // do something useful with the response
134 System.out.println(reader.readLine());
135
136 } catch (IOException ex) {
137
138 // In case of an IOException the connection will be released
139 // back to the connection manager automatically
140 throw ex;
141
142 } catch (RuntimeException ex) {
143
144 // In case of an unexpected exception you may want to abort
145 // the HTTP request in order to shut down the underlying
146 // connection and release it back to the connection manager.
147 httpget.abort();
148 throw ex;
149
150 } finally {
151
152 // Closing the input stream will trigger connection release
153 instream.close();
154
155 }
156 }
157 </PRE>
158 <P>
159
160 <P>
161 <DL>
162 <DT><B>Since:</B></DT>
163 <DD>4.0</DD>
164 <DT><B>Version:</B></DT>
165 <DD>$Revision: 679523 $</DD>
166 <DT><B>Author:</B></DT>
167 <DD><a href="mailto:rolandw at apache.org">Roland Weber</a>
168
169
170 <!-- empty lines to avoid svn diff problems --></DD>
171 </DL>
172 <HR>
173
174 <P>
175
176 <!-- ========== METHOD SUMMARY =========== -->
177
178 <A NAME="method_summary"><!-- --></A>
179 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
180 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
181 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
182 <B>Method Summary</B></FONT></TH>
183 </TR>
184 <TR BGCOLOR="white" CLASS="TableRowColor">
185 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
186 <CODE>&nbsp;org.apache.http.HttpResponse</CODE></FONT></TD>
187 <TD><CODE><B><A HREF="../../../../org/apache/http/client/HttpClient.html#execute(org.apache.http.HttpHost, org.apache.http.HttpRequest)">execute</A></B>(org.apache.http.HttpHost&nbsp;target,
188 org.apache.http.HttpRequest&nbsp;request)</CODE>
189
190 <BR>
191 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Executes a request to the target using the default context.</TD>
192 </TR>
193 <TR BGCOLOR="white" CLASS="TableRowColor">
194 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
195 <CODE>&nbsp;org.apache.http.HttpResponse</CODE></FONT></TD>
196 <TD><CODE><B><A HREF="../../../../org/apache/http/client/HttpClient.html#execute(org.apache.http.HttpHost, org.apache.http.HttpRequest, org.apache.http.protocol.HttpContext)">execute</A></B>(org.apache.http.HttpHost&nbsp;target,
197 org.apache.http.HttpRequest&nbsp;request,
198 org.apache.http.protocol.HttpContext&nbsp;context)</CODE>
199
200 <BR>
201 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Executes a request to the target using the given context.</TD>
202 </TR>
203 <TR BGCOLOR="white" CLASS="TableRowColor">
204 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
205 <CODE>
206 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
207 <TR ALIGN="right" VALIGN="">
208 <TD NOWRAP><FONT SIZE="-1">
209 <CODE>&lt;T&gt; T</CODE></FONT></TD>
210 </TR>
211 </TABLE>
212 </CODE></FONT></TD>
213 <TD><CODE><B><A HREF="../../../../org/apache/http/client/HttpClient.html#execute(org.apache.http.HttpHost, org.apache.http.HttpRequest, org.apache.http.client.ResponseHandler)">execute</A></B>(org.apache.http.HttpHost&nbsp;target,
214 org.apache.http.HttpRequest&nbsp;request,
215 <A HREF="../../../../org/apache/http/client/ResponseHandler.html" title="interface in org.apache.http.client">ResponseHandler</A>&lt;? extends T&gt;&nbsp;responseHandler)</CODE>
216
217 <BR>
218 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Executes a request to the target using the default context and
219 processes the response using the given response handler.</TD>
220 </TR>
221 <TR BGCOLOR="white" CLASS="TableRowColor">
222 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
223 <CODE>
224 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
225 <TR ALIGN="right" VALIGN="">
226 <TD NOWRAP><FONT SIZE="-1">
227 <CODE>&lt;T&gt; T</CODE></FONT></TD>
228 </TR>
229 </TABLE>
230 </CODE></FONT></TD>
231 <TD><CODE><B><A HREF="../../../../org/apache/http/client/HttpClient.html#execute(org.apache.http.HttpHost, org.apache.http.HttpRequest, org.apache.http.client.ResponseHandler, org.apache.http.protocol.HttpContext)">execute</A></B>(org.apache.http.HttpHost&nbsp;target,
232 org.apache.http.HttpRequest&nbsp;request,
233 <A HREF="../../../../org/apache/http/client/ResponseHandler.html" title="interface in org.apache.http.client">ResponseHandler</A>&lt;? extends T&gt;&nbsp;responseHandler,
234 org.apache.http.protocol.HttpContext&nbsp;context)</CODE>
235
236 <BR>
237 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Executes a request to the target using the given context and
238 processes the response using the given response handler.</TD>
239 </TR>
240 <TR BGCOLOR="white" CLASS="TableRowColor">
241 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
242 <CODE>&nbsp;org.apache.http.HttpResponse</CODE></FONT></TD>
243 <TD><CODE><B><A HREF="../../../../org/apache/http/client/HttpClient.html#execute(org.apache.http.client.methods.HttpUriRequest)">execute</A></B>(<A HREF="../../../../org/apache/http/client/methods/HttpUriRequest.html" title="interface in org.apache.http.client.methods">HttpUriRequest</A>&nbsp;request)</CODE>
244
245 <BR>
246 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Executes a request using the default context.</TD>
247 </TR>
248 <TR BGCOLOR="white" CLASS="TableRowColor">
249 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
250 <CODE>&nbsp;org.apache.http.HttpResponse</CODE></FONT></TD>
251 <TD><CODE><B><A HREF="../../../../org/apache/http/client/HttpClient.html#execute(org.apache.http.client.methods.HttpUriRequest, org.apache.http.protocol.HttpContext)">execute</A></B>(<A HREF="../../../../org/apache/http/client/methods/HttpUriRequest.html" title="interface in org.apache.http.client.methods">HttpUriRequest</A>&nbsp;request,
252 org.apache.http.protocol.HttpContext&nbsp;context)</CODE>
253
254 <BR>
255 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Executes a request using the given context.</TD>
256 </TR>
257 <TR BGCOLOR="white" CLASS="TableRowColor">
258 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
259 <CODE>
260 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
261 <TR ALIGN="right" VALIGN="">
262 <TD NOWRAP><FONT SIZE="-1">
263 <CODE>&lt;T&gt; T</CODE></FONT></TD>
264 </TR>
265 </TABLE>
266 </CODE></FONT></TD>
267 <TD><CODE><B><A HREF="../../../../org/apache/http/client/HttpClient.html#execute(org.apache.http.client.methods.HttpUriRequest, org.apache.http.client.ResponseHandler)">execute</A></B>(<A HREF="../../../../org/apache/http/client/methods/HttpUriRequest.html" title="interface in org.apache.http.client.methods">HttpUriRequest</A>&nbsp;request,
268 <A HREF="../../../../org/apache/http/client/ResponseHandler.html" title="interface in org.apache.http.client">ResponseHandler</A>&lt;? extends T&gt;&nbsp;responseHandler)</CODE>
269
270 <BR>
271 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Executes a request using the default context and processes the
272 response using the given response handler.</TD>
273 </TR>
274 <TR BGCOLOR="white" CLASS="TableRowColor">
275 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
276 <CODE>
277 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
278 <TR ALIGN="right" VALIGN="">
279 <TD NOWRAP><FONT SIZE="-1">
280 <CODE>&lt;T&gt; T</CODE></FONT></TD>
281 </TR>
282 </TABLE>
283 </CODE></FONT></TD>
284 <TD><CODE><B><A HREF="../../../../org/apache/http/client/HttpClient.html#execute(org.apache.http.client.methods.HttpUriRequest, org.apache.http.client.ResponseHandler, org.apache.http.protocol.HttpContext)">execute</A></B>(<A HREF="../../../../org/apache/http/client/methods/HttpUriRequest.html" title="interface in org.apache.http.client.methods">HttpUriRequest</A>&nbsp;request,
285 <A HREF="../../../../org/apache/http/client/ResponseHandler.html" title="interface in org.apache.http.client">ResponseHandler</A>&lt;? extends T&gt;&nbsp;responseHandler,
286 org.apache.http.protocol.HttpContext&nbsp;context)</CODE>
287
288 <BR>
289 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Executes a request using the given context and processes the
290 response using the given response handler.</TD>
291 </TR>
292 <TR BGCOLOR="white" CLASS="TableRowColor">
293 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
294 <CODE>&nbsp;<A HREF="../../../../org/apache/http/conn/ClientConnectionManager.html" title="interface in org.apache.http.conn">ClientConnectionManager</A></CODE></FONT></TD>
295 <TD><CODE><B><A HREF="../../../../org/apache/http/client/HttpClient.html#getConnectionManager()">getConnectionManager</A></B>()</CODE>
296
297 <BR>
298 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Obtains the connection manager used by this client.</TD>
299 </TR>
300 <TR BGCOLOR="white" CLASS="TableRowColor">
301 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
302 <CODE>&nbsp;org.apache.http.params.HttpParams</CODE></FONT></TD>
303 <TD><CODE><B><A HREF="../../../../org/apache/http/client/HttpClient.html#getParams()">getParams</A></B>()</CODE>
304
305 <BR>
306 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Obtains the parameters for this client.</TD>
307 </TR>
308 </TABLE>
309 &nbsp;
310 <P>
311
312 <!-- ============ METHOD DETAIL ========== -->
313
314 <A NAME="method_detail"><!-- --></A>
315 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
316 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
317 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
318 <B>Method Detail</B></FONT></TH>
319 </TR>
320 </TABLE>
321
322 <A NAME="getParams()"><!-- --></A><H3>
323 getParams</H3>
324 <PRE>
325 org.apache.http.params.HttpParams <B>getParams</B>()</PRE>
326 <DL>
327 <DD>Obtains the parameters for this client.
328 These parameters will become defaults for all requests being
329 executed with this client, and for the parameters of
330 dependent objects in this client.
331 <P>
332 <DD><DL>
333
334 <DT><B>Returns:</B><DD>the default parameters</DL>
335 </DD>
336 </DL>
337 <HR>
338
339 <A NAME="getConnectionManager()"><!-- --></A><H3>
340 getConnectionManager</H3>
341 <PRE>
342 <A HREF="../../../../org/apache/http/conn/ClientConnectionManager.html" title="interface in org.apache.http.conn">ClientConnectionManager</A> <B>getConnectionManager</B>()</PRE>
343 <DL>
344 <DD>Obtains the connection manager used by this client.
345 <P>
346 <DD><DL>
347
348 <DT><B>Returns:</B><DD>the connection manager</DL>
349 </DD>
350 </DL>
351 <HR>
352
353 <A NAME="execute(org.apache.http.client.methods.HttpUriRequest)"><!-- --></A><H3>
354 execute</H3>
355 <PRE>
356 org.apache.http.HttpResponse <B>execute</B>(<A HREF="../../../../org/apache/http/client/methods/HttpUriRequest.html" title="interface in org.apache.http.client.methods">HttpUriRequest</A>&nbsp;request)
357 throws java.io.IOException,
358 <A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></PRE>
359 <DL>
360 <DD>Executes a request using the default context.
361 <P>
362 <DD><DL>
363 <DT><B>Parameters:</B><DD><CODE>request</CODE> - the request to execute
364 <DT><B>Returns:</B><DD>the response to the request. This is always a final response,
365 never an intermediate response with an 1xx status code.
366 Whether redirects or authentication challenges will be returned
367 or handled automatically depends on the implementation and
368 configuration of this client.
369 <DT><B>Throws:</B>
370 <DD><CODE>java.io.IOException</CODE> - in case of a problem or the connection was aborted
371 <DD><CODE><A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></CODE> - in case of an http protocol error</DL>
372 </DD>
373 </DL>
374 <HR>
375
376 <A NAME="execute(org.apache.http.client.methods.HttpUriRequest, org.apache.http.protocol.HttpContext)"><!-- --></A><H3>
377 execute</H3>
378 <PRE>
379 org.apache.http.HttpResponse <B>execute</B>(<A HREF="../../../../org/apache/http/client/methods/HttpUriRequest.html" title="interface in org.apache.http.client.methods">HttpUriRequest</A>&nbsp;request,
380 org.apache.http.protocol.HttpContext&nbsp;context)
381 throws java.io.IOException,
382 <A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></PRE>
383 <DL>
384 <DD>Executes a request using the given context.
385 The route to the target will be determined by the HTTP client.
386 <P>
387 <DD><DL>
388 <DT><B>Parameters:</B><DD><CODE>request</CODE> - the request to execute<DD><CODE>context</CODE> - the context to use for the execution, or
389 <code>null</code> to use the default context
390 <DT><B>Returns:</B><DD>the response to the request. This is always a final response,
391 never an intermediate response with an 1xx status code.
392 Whether redirects or authentication challenges will be returned
393 or handled automatically depends on the implementation and
394 configuration of this client.
395 <DT><B>Throws:</B>
396 <DD><CODE>java.io.IOException</CODE> - in case of a problem or the connection was aborted
397 <DD><CODE><A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></CODE> - in case of an http protocol error</DL>
398 </DD>
399 </DL>
400 <HR>
401
402 <A NAME="execute(org.apache.http.HttpHost, org.apache.http.HttpRequest)"><!-- --></A><H3>
403 execute</H3>
404 <PRE>
405 org.apache.http.HttpResponse <B>execute</B>(org.apache.http.HttpHost&nbsp;target,
406 org.apache.http.HttpRequest&nbsp;request)
407 throws java.io.IOException,
408 <A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></PRE>
409 <DL>
410 <DD>Executes a request to the target using the default context.
411 <P>
412 <DD><DL>
413 <DT><B>Parameters:</B><DD><CODE>target</CODE> - the target host for the request.
414 Implementations may accept <code>null</code>
415 if they can still determine a route, for example
416 to a default target or by inspecting the request.<DD><CODE>request</CODE> - the request to execute
417 <DT><B>Returns:</B><DD>the response to the request. This is always a final response,
418 never an intermediate response with an 1xx status code.
419 Whether redirects or authentication challenges will be returned
420 or handled automatically depends on the implementation and
421 configuration of this client.
422 <DT><B>Throws:</B>
423 <DD><CODE>java.io.IOException</CODE> - in case of a problem or the connection was aborted
424 <DD><CODE><A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></CODE> - in case of an http protocol error</DL>
425 </DD>
426 </DL>
427 <HR>
428
429 <A NAME="execute(org.apache.http.HttpHost, org.apache.http.HttpRequest, org.apache.http.protocol.HttpContext)"><!-- --></A><H3>
430 execute</H3>
431 <PRE>
432 org.apache.http.HttpResponse <B>execute</B>(org.apache.http.HttpHost&nbsp;target,
433 org.apache.http.HttpRequest&nbsp;request,
434 org.apache.http.protocol.HttpContext&nbsp;context)
435 throws java.io.IOException,
436 <A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></PRE>
437 <DL>
438 <DD>Executes a request to the target using the given context.
439 <P>
440 <DD><DL>
441 <DT><B>Parameters:</B><DD><CODE>target</CODE> - the target host for the request.
442 Implementations may accept <code>null</code>
443 if they can still determine a route, for example
444 to a default target or by inspecting the request.<DD><CODE>request</CODE> - the request to execute<DD><CODE>context</CODE> - the context to use for the execution, or
445 <code>null</code> to use the default context
446 <DT><B>Returns:</B><DD>the response to the request. This is always a final response,
447 never an intermediate response with an 1xx status code.
448 Whether redirects or authentication challenges will be returned
449 or handled automatically depends on the implementation and
450 configuration of this client.
451 <DT><B>Throws:</B>
452 <DD><CODE>java.io.IOException</CODE> - in case of a problem or the connection was aborted
453 <DD><CODE><A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></CODE> - in case of an http protocol error</DL>
454 </DD>
455 </DL>
456 <HR>
457
458 <A NAME="execute(org.apache.http.client.methods.HttpUriRequest, org.apache.http.client.ResponseHandler)"><!-- --></A><H3>
459 execute</H3>
460 <PRE>
461 &lt;T&gt; T <B>execute</B>(<A HREF="../../../../org/apache/http/client/methods/HttpUriRequest.html" title="interface in org.apache.http.client.methods">HttpUriRequest</A>&nbsp;request,
462 <A HREF="../../../../org/apache/http/client/ResponseHandler.html" title="interface in org.apache.http.client">ResponseHandler</A>&lt;? extends T&gt;&nbsp;responseHandler)
463 throws java.io.IOException,
464 <A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></PRE>
465 <DL>
466 <DD>Executes a request using the default context and processes the
467 response using the given response handler.
468 <P>
469 <DD><DL>
470 <DT><B>Parameters:</B><DD><CODE>request</CODE> - the request to execute<DD><CODE>responseHandler</CODE> - the response handler
471 <DT><B>Returns:</B><DD>the response object as generated by the response handler.
472 <DT><B>Throws:</B>
473 <DD><CODE>java.io.IOException</CODE> - in case of a problem or the connection was aborted
474 <DD><CODE><A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></CODE> - in case of an http protocol error</DL>
475 </DD>
476 </DL>
477 <HR>
478
479 <A NAME="execute(org.apache.http.client.methods.HttpUriRequest, org.apache.http.client.ResponseHandler, org.apache.http.protocol.HttpContext)"><!-- --></A><H3>
480 execute</H3>
481 <PRE>
482 &lt;T&gt; T <B>execute</B>(<A HREF="../../../../org/apache/http/client/methods/HttpUriRequest.html" title="interface in org.apache.http.client.methods">HttpUriRequest</A>&nbsp;request,
483 <A HREF="../../../../org/apache/http/client/ResponseHandler.html" title="interface in org.apache.http.client">ResponseHandler</A>&lt;? extends T&gt;&nbsp;responseHandler,
484 org.apache.http.protocol.HttpContext&nbsp;context)
485 throws java.io.IOException,
486 <A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></PRE>
487 <DL>
488 <DD>Executes a request using the given context and processes the
489 response using the given response handler.
490 <P>
491 <DD><DL>
492 <DT><B>Parameters:</B><DD><CODE>request</CODE> - the request to execute<DD><CODE>responseHandler</CODE> - the response handler
493 <DT><B>Returns:</B><DD>the response object as generated by the response handler.
494 <DT><B>Throws:</B>
495 <DD><CODE>java.io.IOException</CODE> - in case of a problem or the connection was aborted
496 <DD><CODE><A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></CODE> - in case of an http protocol error</DL>
497 </DD>
498 </DL>
499 <HR>
500
501 <A NAME="execute(org.apache.http.HttpHost, org.apache.http.HttpRequest, org.apache.http.client.ResponseHandler)"><!-- --></A><H3>
502 execute</H3>
503 <PRE>
504 &lt;T&gt; T <B>execute</B>(org.apache.http.HttpHost&nbsp;target,
505 org.apache.http.HttpRequest&nbsp;request,
506 <A HREF="../../../../org/apache/http/client/ResponseHandler.html" title="interface in org.apache.http.client">ResponseHandler</A>&lt;? extends T&gt;&nbsp;responseHandler)
507 throws java.io.IOException,
508 <A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></PRE>
509 <DL>
510 <DD>Executes a request to the target using the default context and
511 processes the response using the given response handler.
512 <P>
513 <DD><DL>
514 <DT><B>Parameters:</B><DD><CODE>target</CODE> - the target host for the request.
515 Implementations may accept <code>null</code>
516 if they can still determine a route, for example
517 to a default target or by inspecting the request.<DD><CODE>request</CODE> - the request to execute<DD><CODE>responseHandler</CODE> - the response handler
518 <DT><B>Returns:</B><DD>the response object as generated by the response handler.
519 <DT><B>Throws:</B>
520 <DD><CODE>java.io.IOException</CODE> - in case of a problem or the connection was aborted
521 <DD><CODE><A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></CODE> - in case of an http protocol error</DL>
522 </DD>
523 </DL>
524 <HR>
525
526 <A NAME="execute(org.apache.http.HttpHost, org.apache.http.HttpRequest, org.apache.http.client.ResponseHandler, org.apache.http.protocol.HttpContext)"><!-- --></A><H3>
527 execute</H3>
528 <PRE>
529 &lt;T&gt; T <B>execute</B>(org.apache.http.HttpHost&nbsp;target,
530 org.apache.http.HttpRequest&nbsp;request,
531 <A HREF="../../../../org/apache/http/client/ResponseHandler.html" title="interface in org.apache.http.client">ResponseHandler</A>&lt;? extends T&gt;&nbsp;responseHandler,
532 org.apache.http.protocol.HttpContext&nbsp;context)
533 throws java.io.IOException,
534 <A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></PRE>
535 <DL>
536 <DD>Executes a request to the target using the given context and
537 processes the response using the given response handler.
538 <P>
539 <DD><DL>
540 <DT><B>Parameters:</B><DD><CODE>target</CODE> - the target host for the request.
541 Implementations may accept <code>null</code>
542 if they can still determine a route, for example
543 to a default target or by inspecting the request.<DD><CODE>request</CODE> - the request to execute<DD><CODE>responseHandler</CODE> - the response handler<DD><CODE>context</CODE> - the context to use for the execution, or
544 <code>null</code> to use the default context
545 <DT><B>Returns:</B><DD>the response object as generated by the response handler.
546 <DT><B>Throws:</B>
547 <DD><CODE>java.io.IOException</CODE> - in case of a problem or the connection was aborted
548 <DD><CODE><A HREF="../../../../org/apache/http/client/ClientProtocolException.html" title="class in org.apache.http.client">ClientProtocolException</A></CODE> - in case of an http protocol error</DL>
549 </DD>
550 </DL>
551 <!-- ========= END OF CLASS DATA ========= -->
552 <HR>
553
554
555 <!-- ======= START OF BOTTOM NAVBAR ====== -->
556 <A NAME="navbar_bottom"><!-- --></A>
557 <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
558 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
559 <TR>
560 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
561 <A NAME="navbar_bottom_firstrow"><!-- --></A>
562 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
563 <TR ALIGN="center" VALIGN="top">
564 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
565 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
566 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
567 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/HttpClient.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
568 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
569 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
570 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
571 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
572 </TR>
573 </TABLE>
574 </TD>
575 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
576 </EM>
577 </TD>
578 </TR>
579
580 <TR>
581 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
582 &nbsp;<A HREF="../../../../org/apache/http/client/CredentialsProvider.html" title="interface in org.apache.http.client"><B>PREV CLASS</B></A>&nbsp;
583 &nbsp;<A HREF="../../../../org/apache/http/client/HttpRequestRetryHandler.html" title="interface in org.apache.http.client"><B>NEXT CLASS</B></A></FONT></TD>
584 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
585 <A HREF="../../../../index.html?org/apache/http/client/HttpClient.html" target="_top"><B>FRAMES</B></A> &nbsp;
586 &nbsp;<A HREF="HttpClient.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
587 &nbsp;<SCRIPT type="text/javascript">
588 <!--
589 if(window==top) {
590 document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
591 }
592 //-->
593 </SCRIPT>
594 <NOSCRIPT>
595 <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
596 </NOSCRIPT>
597
598
599 </FONT></TD>
600 </TR>
601 <TR>
602 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
603 SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
604 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
605 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
606 </TR>
607 </TABLE>
608 <A NAME="skip-navbar_bottom"></A>
609 <!-- ======== END OF BOTTOM NAVBAR ======= -->
610
611 <HR>
612 Copyright © 1999-2008 <a href="http://www.apache.org/">Apache Software Foundation</a>. All Rights Reserved.
613 </BODY>
614 </HTML>