org.dmfs.httpclientinterfaces

Interface OnRedirectCallback

All Known Implementing Classes:

FollowSecureRedirectCallback, NeverFollowRedirectCallback

public interface OnRedirectCallback

The interface of a redirection handler that knows how to handle a redirection response.

Author:

Marten Gajda

Method Summary

Modifier and Type	Method and Description
boolean	followRedirect(HttpStatus status, java.net.URI redirectingLocation, java.net.URI newLocation) This is called when a server has sent some sort of redirect.

Method Detail

followRedirect

boolean followRedirect(HttpStatus status,
                       java.net.URI redirectingLocation,
                       java.net.URI newLocation)

This is called when a server has sent some sort of redirect. This method determines whether to follow the redirect or not. In the later case a RedirectionException is thrown by the HttpRequestExecutor.

Parameters:

status - One of HttpStatus.MOVED_PERMANENTLY, HttpStatus.FOUND, HttpStatus.SEE_OTHER, HttpStatus.TEMPORARY_REDIRECT or HttpStatus.PERMANENT_REDIRECT.

redirectingLocation - The absolute URI of the resource that returned the redirect.

newLocation - The absolute URI that was returned by the server as the new location.

Returns:

true to follow that redirect and resent the request to the new location, false to not follow it and throw a RedirectionException instead.