ConnectionReuseStrategy Interface Reference

Interface for deciding whether a connection should be kept alive. More...

Description

Author

Oleg Kalnichevski

Version

Revision

496070

Since

4.0

Notice

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	keepAlive (HttpResponse response, HttpContext context)
	Decides whether a connection can be kept open after a request. More...

Member Function Documentation

keepAlive()

boolean keepAlive	(	HttpResponse	response,
		HttpContext	context
	)

If this method returns false, the caller MUST close the connection to correctly implement the HTTP protocol. If it returns true, the caller SHOULD attempt to keep the connection open for reuse with another request.
One can use the HTTP context to retrieve additional objects that may be relevant for the keep-alive strategy: the actual HTTP connection, the original HTTP request, target host if known, number of times the connection has been reused already and so on.
If the connection is already closed, false is returned. The stale connection check MUST NOT be triggered by a connection reuse strategy.

Parameters

response	The last response received over that connection.
context	the context in which the connection is being used.

Returns

true if the connection is allowed to be reused, or false if it MUST NOT be reused