Package org.apache.http.impl.client
Class DefaultRedirectStrategy
java.lang.Object
org.apache.http.impl.client.DefaultRedirectStrategy
- All Implemented Interfaces:
RedirectStrategy
- Direct Known Subclasses:
LaxRedirectStrategy
@Contract(threading=IMMUTABLE)
public class DefaultRedirectStrategy
extends Object
implements RedirectStrategy
Default implementation of
RedirectStrategy
. This strategy honors the restrictions
on automatic redirection of entity enclosing methods such as POST and PUT imposed by the
HTTP specification. 302 Moved Temporarily
, 301 Moved Permanently
and
307 Temporary Redirect
status codes will result in an automatic redirect of
HEAD and GET methods only. POST and PUT methods will not be automatically redirected
as requiring user confirmation.
The restriction on automatic redirection of POST methods can be relaxed by using
LaxRedirectStrategy
instead of DefaultRedirectStrategy
.
- Since:
- 4.1
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final DefaultRedirectStrategy
static final String
Deprecated.static final int
-
Constructor Summary
ConstructorsConstructorDescriptionDefaultRedirectStrategy
(String[] redirectMethods) Constructs a new instance to redirect the given HTTP methods. -
Method Summary
Modifier and TypeMethodDescriptionprotected URI
createLocationURI
(String location) getLocationURI
(org.apache.http.HttpRequest request, org.apache.http.HttpResponse response, org.apache.http.protocol.HttpContext context) getRedirect
(org.apache.http.HttpRequest request, org.apache.http.HttpResponse response, org.apache.http.protocol.HttpContext context) Determines the redirect location given the response from the target server and the current request execution context and generates a new request to be sent to the location.protected boolean
isRedirectable
(String method) boolean
isRedirected
(org.apache.http.HttpRequest request, org.apache.http.HttpResponse response, org.apache.http.protocol.HttpContext context) Determines if a request should be redirected to a new location given the response from the target server.
-
Field Details
-
SC_PERMANENT_REDIRECT
public static final int SC_PERMANENT_REDIRECT- See Also:
-
REDIRECT_LOCATIONS
Deprecated.(4.3) useHttpClientContext.REDIRECT_LOCATIONS
.- See Also:
-
INSTANCE
-
-
Constructor Details
-
DefaultRedirectStrategy
public DefaultRedirectStrategy() -
DefaultRedirectStrategy
Constructs a new instance to redirect the given HTTP methods.- Parameters:
redirectMethods
- The methods to redirect.- Since:
- 4.5.10
-
-
Method Details
-
isRedirected
public boolean isRedirected(org.apache.http.HttpRequest request, org.apache.http.HttpResponse response, org.apache.http.protocol.HttpContext context) throws org.apache.http.ProtocolException Description copied from interface:RedirectStrategy
Determines if a request should be redirected to a new location given the response from the target server.- Specified by:
isRedirected
in interfaceRedirectStrategy
- Parameters:
request
- the executed requestresponse
- the response received from the target servercontext
- the context for the request execution- Returns:
true
if the request should be redirected,false
otherwise- Throws:
org.apache.http.ProtocolException
-
getLocationURI
public URI getLocationURI(org.apache.http.HttpRequest request, org.apache.http.HttpResponse response, org.apache.http.protocol.HttpContext context) throws org.apache.http.ProtocolException - Throws:
org.apache.http.ProtocolException
-
createLocationURI
- Throws:
org.apache.http.ProtocolException
- Since:
- 4.1
-
isRedirectable
- Since:
- 4.2
-
getRedirect
public HttpUriRequest getRedirect(org.apache.http.HttpRequest request, org.apache.http.HttpResponse response, org.apache.http.protocol.HttpContext context) throws org.apache.http.ProtocolException Description copied from interface:RedirectStrategy
Determines the redirect location given the response from the target server and the current request execution context and generates a new request to be sent to the location.- Specified by:
getRedirect
in interfaceRedirectStrategy
- Parameters:
request
- the executed requestresponse
- the response received from the target servercontext
- the context for the request execution- Returns:
- redirected request
- Throws:
org.apache.http.ProtocolException
-
HttpClientContext.REDIRECT_LOCATIONS
.