org.pac4j.http.client.indirect

Class FormClient

java.lang.Object

org.pac4j.core.util.InitializableWebObject

org.pac4j.core.client.BaseClient<C,U>

org.pac4j.core.client.IndirectClient<C,HttpProfile>

org.pac4j.http.client.indirect.IndirectHttpClient<UsernamePasswordCredentials>

org.pac4j.http.client.indirect.FormClient

All Implemented Interfaces:

Cloneable, Client<UsernamePasswordCredentials,HttpProfile>

Direct Known Subclasses:

FormClient

public class FormClient
extends IndirectHttpClient<UsernamePasswordCredentials>

This class is the client to authenticate users through HTTP form.

The login url of the form must be defined through the setLoginUrl(String) method. For authentication, the user is redirected to this login form. The username and password inputs must be posted on the callback url. Their names can be defined by using the setUsernameParameter(String) and setPasswordParameter(String) methods.

It returns a HttpProfile.

Since:

1.4.0

Author:

Jerome Leleu

See Also:

HttpProfile

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_PASSWORD_PARAMETER
static String	DEFAULT_USERNAME_PARAMETER
static String	ERROR_PARAMETER
static String	MISSING_FIELD_ERROR

Fields inherited from class org.pac4j.http.client.indirect.IndirectHttpClient

extractor

Fields inherited from class org.pac4j.core.client.IndirectClient

ATTEMPTED_AUTHENTICATION_SUFFIX, callbackUrl, callbackUrlResolver, NEEDS_CLIENT_REDIRECTION_PARAMETER

Fields inherited from class org.pac4j.core.client.BaseClient

logger

Constructor Summary

Constructors

Constructor and Description
FormClient()
FormClient(String loginUrl)
FormClient(String loginUrl, UsernamePasswordAuthenticator usernamePasswordAuthenticator)
FormClient(String loginUrl, UsernamePasswordAuthenticator usernamePasswordAuthenticator, ProfileCreator profileCreator)

Method Summary

Modifier and Type	Method and Description
protected String	computeErrorMessage(TechnicalException e) Return the error message depending on the thrown exception.
ClientType	getClientType()
String	getLoginUrl()
String	getPasswordParameter()
String	getUsernameParameter()
protected void	initializeClientConfiguration(WebContext context)
protected void	internalInit(WebContext context)
protected boolean	isDirectRedirection()
protected IndirectHttpClient<UsernamePasswordCredentials>	newClient()
protected UsernamePasswordCredentials	retrieveCredentials(WebContext context)
protected RedirectAction	retrieveRedirectAction(WebContext context)
void	setLoginUrl(String loginUrl)
void	setPasswordParameter(String passwordParameter)
void	setUsernameParameter(String usernameParameter)
String	toString()

Methods inherited from class org.pac4j.http.client.indirect.IndirectHttpClient

clone, getAuthenticator, getProfileCreator, retrieveUserProfile, setAuthenticator, setProfileCreator

Methods inherited from class org.pac4j.core.client.IndirectClient

computeFinalCallbackUrl, getAjaxRequestResolver, getCallbackUrl, getCallbackUrlResolver, getCredentials, getRedirectAction, getRedirectionUrl, getStateParameter, isIncludeClientNameInCallbackUrl, redirect, setAjaxRequestResolver, setCallbackUrl, setCallbackUrlResolver, setIncludeClientNameInCallbackUrl

Methods inherited from class org.pac4j.core.client.BaseClient

addAuthorizationGenerator, getAuthorizationGenerators, getName, getUserProfile, setAuthorizationGenerator, setAuthorizationGenerators, setAuthorizationGenerators, setName

Methods inherited from class org.pac4j.core.util.InitializableWebObject

init, reinit

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

ERROR_PARAMETER

public static final String ERROR_PARAMETER

See Also:

Constant Field Values

MISSING_FIELD_ERROR

public static final String MISSING_FIELD_ERROR

See Also:

Constant Field Values

DEFAULT_USERNAME_PARAMETER

public static final String DEFAULT_USERNAME_PARAMETER

See Also:

Constant Field Values

DEFAULT_PASSWORD_PARAMETER

public static final String DEFAULT_PASSWORD_PARAMETER

See Also:

Constant Field Values

Constructor Detail

FormClient

public FormClient()

FormClient

public FormClient(String loginUrl)

FormClient

public FormClient(String loginUrl,
                  UsernamePasswordAuthenticator usernamePasswordAuthenticator)

FormClient

public FormClient(String loginUrl,
                  UsernamePasswordAuthenticator usernamePasswordAuthenticator,
                  ProfileCreator profileCreator)

Method Detail

newClient

protected IndirectHttpClient<UsernamePasswordCredentials> newClient()

Specified by:

newClient in class BaseClient<UsernamePasswordCredentials,HttpProfile>

internalInit

protected void internalInit(WebContext context)

Overrides:

internalInit in class IndirectHttpClient<UsernamePasswordCredentials>

initializeClientConfiguration

protected void initializeClientConfiguration(WebContext context)

retrieveRedirectAction

protected RedirectAction retrieveRedirectAction(WebContext context)

Specified by:

retrieveRedirectAction in class IndirectClient<UsernamePasswordCredentials,HttpProfile>

retrieveCredentials

protected UsernamePasswordCredentials retrieveCredentials(WebContext context)
                                                   throws RequiresHttpAction

Specified by:

retrieveCredentials in class IndirectClient<UsernamePasswordCredentials,HttpProfile>

Throws:

RequiresHttpAction

computeErrorMessage

protected String computeErrorMessage(TechnicalException e)

Return the error message depending on the thrown exception. Can be overriden for other message computation.

Parameters:

e - the technical exception

Returns:

the error message

getLoginUrl

public String getLoginUrl()

setLoginUrl

public void setLoginUrl(String loginUrl)

getUsernameParameter

public String getUsernameParameter()

setUsernameParameter

public void setUsernameParameter(String usernameParameter)

getPasswordParameter

public String getPasswordParameter()

setPasswordParameter

public void setPasswordParameter(String passwordParameter)

toString

public String toString()

Overrides:

toString in class BaseClient<UsernamePasswordCredentials,HttpProfile>

isDirectRedirection

protected boolean isDirectRedirection()

Specified by:

isDirectRedirection in class IndirectClient<UsernamePasswordCredentials,HttpProfile>

getClientType

public ClientType getClientType()

Specified by:

getClientType in class BaseClient<UsernamePasswordCredentials,HttpProfile>