An HTTP connection for use on the client side. More...
It is used for sending requests and receiving responses.
The following notice applies to the original API on which this API is based, and to its documentation. The documentation of this API has been revised from the original.
/* * Copyright (C) 2006 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */
Public Member Functions | |
boolean | isResponseAvailable (int timeout) throws IOException |
Checks if response data is available from the connection. More... | |
void | sendRequestHeader (HttpRequest request) throws HttpException, IOException |
Sends the request line and all headers over the connection. More... | |
void | sendRequestEntity (HttpEntityEnclosingRequest request) throws HttpException, IOException |
Sends the request entity over the connection. More... | |
HttpResponse | receiveResponseHeader () throws HttpException, IOException |
Receives the request line and headers of the next response available from this connection. More... | |
void | receiveResponseEntity (HttpResponse response) throws HttpException, IOException |
Receives the next response entity available from this connection and attaches it to an existing HttpResponse object. More... | |
void | flush () throws IOException |
Writes out all pending buffered data over the open connection. More... | |
Public Member Functions inherited from HttpConnection | |
void | close () throws IOException |
Closes this connection gracefully. More... | |
boolean | isOpen () |
Checks if this connection is open. More... | |
boolean | isStale () |
Checks whether this connection has gone down. More... | |
void | setSocketTimeout (int timeout) |
Sets the socket timeout value. More... | |
int | getSocketTimeout () |
Returns the socket timeout value. More... | |
void | shutdown () throws IOException |
Force-closes this connection. More... | |
HttpConnectionMetrics | getMetrics () |
Returns a collection of connection metrcis. More... | |
boolean isResponseAvailable | ( | int | timeout | ) | throws IOException |
May wait for the specified time until some data becomes available. Note that some implementations may completely ignore the timeout parameter.
timeout | the maximum time in milliseconds to wait for data |
timeout
milliseconds. IOException | if an error happens on the connection |
Implemented in AbstractClientConnAdapter.
void sendRequestHeader | ( | HttpRequest | request | ) | throws HttpException, IOException |
request | the request whose headers to send. |
HttpException | |
IOException |
Implemented in AbstractClientConnAdapter, and DefaultClientConnection.
void sendRequestEntity | ( | HttpEntityEnclosingRequest | request | ) | throws HttpException, IOException |
request | the request whose entity to send. |
HttpException | |
IOException |
Implemented in AbstractClientConnAdapter.
HttpResponse receiveResponseHeader | ( | ) | throws HttpException, IOException |
The caller should examine the HttpResponse object to find out if it should try to receive a response entity as well.
HttpException | |
IOException |
Implemented in AbstractClientConnAdapter, and DefaultClientConnection.
void receiveResponseEntity | ( | HttpResponse | response | ) | throws HttpException, IOException |
response | the response to attach the entity to |
HttpException | |
IOException |
Implemented in AbstractClientConnAdapter.
void flush | ( | ) | throws IOException |
IOException |
Implemented in AbstractClientConnAdapter.