|
|
|
|
|
|
Overview
|
IntroductionThis document provides a brief guide to handling cross host redirects
with HttpClient. In future versions, it is anticipated that
this will be handled by the There are also a few types of redirect that HttpClient can't handle automatically either because they require user interaction or are outside of the scope of HttpClient. These status codes are listed below . Handling RedirectsWhen a server returns a redirect instruction to HttpClient that requires connecting to a different host, HttpClient will simply return the redirect status code as the response status. All response codes between 300 and 399 inclusive are redirect resonses of some form. The most common redirect response codes are:
Note: there are a number of response codes in the 3xx range which do not simply indicate a different URI to send the request to. These response codes are listed below and the manner they are handled will be application specific. When your application receives one of the "simple" redirect responses, it should extract the new URL from the HttpMethod object and retry downloading from that URL. Additionally, it is usually a good idea to limit the number of redirects that will be followed in case the redirects form a recursive loop. The URL to connect to can be extracted from the Location header.
String redirectLocation;
Header locationHeader = method.getResponseHeader("location");
if (locationHeader != null) {
redirectLocation = locationHeader.getValue();
} else {
// The response is invalid and did not provide the new location for
// the resource. Report an error or possibly handle the response
// like a 404 Not Found error.
}
Once you have determined the new location, you can reattempt the connection as normal. See the Tutorial for more information on this. Special Redirect CodesThe HTTP specification defines a number of somewhat unusual redirect response codes that will likely need to be handled in a different manner to the codes above. In particular these are:
|