com.vaadin.ui
Class LoginForm

java.lang.Object
  com.vaadin.server.AbstractClientConnector
      com.vaadin.ui.AbstractComponent
          com.vaadin.ui.AbstractSingleComponentContainer
              com.vaadin.ui.LoginForm

All Implemented Interfaces:

ContextClickEvent.ContextClickNotifier, MethodEventSource, ClientConnector, Sizeable, com.vaadin.shared.Connector, Component, HasComponents, HasComponents.ComponentAttachDetachNotifier, SingleComponentContainer, java.io.Serializable, java.lang.Iterable<Component>

public class LoginForm
extends AbstractSingleComponentContainer

Login form with auto-completion and auto-fill for all major browsers. You can derive from this class and implement the createContent(com.vaadin.ui.TextField, com.vaadin.ui.PasswordField, com.vaadin.ui.Button) method to build the layout using the text fields and login button that are passed to that method. The supplied components are specially treated so that they work with password managers.

If you need to change the URL as part of the login procedure, call setLoginMode(LoginMode) with the argument LoginForm.LoginMode.DEFERRED in your implementation of createContent.

To customize the fields or to replace them with your own implementations, you can override createUserNameField(), createPasswordField() and createLoginButton(). These methods are called automatically and cannot be called by your code. Captions can be reset by overriding #getUserNameFieldCaption(), #getPasswordFieldCaption() and getLoginButtonCaption().

See Also:

Serialized Form

Nested Class Summary

static class	LoginForm.LoginEvent This event is sent when login form is submitted.
static interface	LoginForm.LoginListener Login listener is a class capable to listen LoginEvents sent from LoginBox
static class	LoginForm.LoginMode Determines the way in which the login form reacts to a login on the server side.

Nested classes/interfaces inherited from interface com.vaadin.ui.HasComponents

HasComponents.ComponentAttachDetachNotifier, HasComponents.ComponentAttachEvent, HasComponents.ComponentAttachListener, HasComponents.ComponentDetachEvent, HasComponents.ComponentDetachListener

Nested classes/interfaces inherited from interface com.vaadin.ui.Component

Component.ErrorEvent, Component.Event, Component.Focusable, Component.Listener

Nested classes/interfaces inherited from interface com.vaadin.server.ClientConnector

ClientConnector.AttachEvent, ClientConnector.AttachListener, ClientConnector.ConnectorErrorEvent, ClientConnector.DetachEvent, ClientConnector.DetachListener

Nested classes/interfaces inherited from interface com.vaadin.server.Sizeable

Sizeable.Unit

Field Summary

Fields inherited from class com.vaadin.ui.AbstractComponent

DESIGN_ATTR_PLAIN_TEXT

Fields inherited from interface com.vaadin.server.Sizeable

SIZE_UNDEFINED, UNITS_CM, UNITS_EM, UNITS_EX, UNITS_INCH, UNITS_MM, UNITS_PERCENTAGE, UNITS_PICAS, UNITS_PIXELS, UNITS_POINTS

Constructor Summary

LoginForm()

Method Summary

void	addListener(LoginForm.LoginListener listener) Deprecated. As of 7.0, replaced by addLoginListener(LoginListener)
void	addLoginListener(LoginForm.LoginListener listener) Adds LoginListener to handle login logic
void	attach() Notifies the connector that it is connected to a VaadinSession (and therefore also to a UI).
protected Component	createContent(TextField userNameField, PasswordField passwordField, Button loginButton) Create the content for the login form with the supplied user name field, password field and the login button.
protected Button	createLoginButton() Customize the login button.
protected PasswordField	createPasswordField() Customize the password field.
protected TextField	createUserNameField() Customize the user name field.
java.lang.String	getLoginButtonCaption()
LoginForm.LoginMode	getLoginMode() Returns the LoginForm.LoginMode for this login form.
java.lang.String	getPasswordCaption()
protected com.vaadin.shared.ui.loginform.LoginFormState	getState() Returns the shared state bean with information to be sent from the server to the client.
java.lang.String	getUsernameCaption()
void	removeListener(LoginForm.LoginListener listener) Deprecated. As of 7.0, replaced by removeLoginListener(LoginListener)
void	removeLoginListener(LoginForm.LoginListener listener) Removes LoginListener
void	setLoginButtonCaption(java.lang.String cap)
void	setLoginMode(LoginForm.LoginMode loginMode) Set the LoginForm.LoginMode for this login form.
void	setPasswordCaption(java.lang.String cap)
void	setUsernameCaption(java.lang.String cap)

Methods inherited from class com.vaadin.ui.AbstractSingleComponentContainer

addComponentAttachListener, addComponentDetachListener, fireComponentAttachEvent, fireComponentDetachEvent, getComponentCount, getContent, iterator, readDesign, readDesignChildren, removeComponentAttachListener, removeComponentDetachListener, removeFromParent, setContent, setHeight, setWidth, writeDesign

Methods inherited from class com.vaadin.ui.AbstractComponent

addContextClickListener, addListener, addShortcutListener, addStyleName, beforeClientResponse, detach, findAncestor, fireComponentErrorEvent, fireComponentEvent, focus, getActionManager, getCaption, getComponentError, getCustomAttributes, getData, getDebugId, getDescription, getErrorMessage, getExplicitImmediateValue, getHeight, getHeightUnits, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getState, getStyleName, getWidth, getWidthUnits, isCaptionAsHtml, isConnectorEnabled, isEnabled, isImmediate, isOrHasAncestor, isReadOnly, isResponsive, isVisible, removeContextClickListener, removeListener, removeShortcutListener, removeStyleName, setCaption, setCaptionAsHtml, setComponentError, setData, setDebugId, setDescription, setEnabled, setHeight, setHeightUndefined, setIcon, setId, setImmediate, setLocale, setParent, setPrimaryStyleName, setReadOnly, setResponsive, setSizeFull, setSizeUndefined, setStyleName, setStyleName, setVisible, setWidth, setWidthUndefined

Methods inherited from class com.vaadin.server.AbstractClientConnector

addAttachListener, addDetachListener, addExtension, addListener, addListener, addListener, addMethodInvocationToQueue, createState, encodeState, equals, fireEvent, getAllChildrenIterable, getConnectorId, getErrorHandler, getExtensions, getListeners, getResource, getRpcManager, getRpcProxy, getSession, getStateType, getUI, handleConnectorRequest, hashCode, hasListeners, isAttached, isThis, markAsDirty, markAsDirtyRecursive, registerRpc, registerRpc, removeAttachListener, removeDetachListener, removeExtension, removeListener, removeListener, removeListener, removeListener, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler, setResource

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.vaadin.ui.Component

addListener, addStyleName, getCaption, getDescription, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getStyleName, getUI, isEnabled, isReadOnly, isVisible, removeListener, removeStyleName, setCaption, setEnabled, setIcon, setId, setParent, setPrimaryStyleName, setReadOnly, setStyleName, setVisible

Methods inherited from interface com.vaadin.server.ClientConnector

addAttachListener, addDetachListener, beforeClientResponse, detach, encodeState, getErrorHandler, getExtensions, getRpcManager, getStateType, handleConnectorRequest, isAttached, isConnectorEnabled, markAsDirty, markAsDirtyRecursive, removeAttachListener, removeDetachListener, removeExtension, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler

Methods inherited from interface com.vaadin.shared.Connector

getConnectorId

Methods inherited from interface com.vaadin.server.Sizeable

getHeight, getHeightUnits, getWidth, getWidthUnits, setHeight, setHeightUndefined, setSizeFull, setSizeUndefined, setWidth, setWidthUndefined

Constructor Detail

LoginForm

public LoginForm()

Method Detail

getLoginMode

public LoginForm.LoginMode getLoginMode()

Returns the LoginForm.LoginMode for this login form. The default is LoginForm.LoginMode.DIRECT.

Returns:

the login mode

setLoginMode

public void setLoginMode(LoginForm.LoginMode loginMode)

Set the LoginForm.LoginMode for this login form. The default is LoginForm.LoginMode.DIRECT

Parameters:

loginMode - the login mode

createUserNameField

protected TextField createUserNameField()

Customize the user name field. Only for overriding, do not call.

Returns:

the user name field

getUsernameCaption

public java.lang.String getUsernameCaption()

setUsernameCaption

public void setUsernameCaption(java.lang.String cap)

createPasswordField

protected PasswordField createPasswordField()

Customize the password field. Only for overriding, do not call.

Returns:

the password field

getPasswordCaption

public java.lang.String getPasswordCaption()

setPasswordCaption

public void setPasswordCaption(java.lang.String cap)

createLoginButton

protected Button createLoginButton()

Customize the login button. Only for overriding, do not call.

Returns:

the login button

getLoginButtonCaption

public java.lang.String getLoginButtonCaption()

setLoginButtonCaption

public void setLoginButtonCaption(java.lang.String cap)

getState

protected com.vaadin.shared.ui.loginform.LoginFormState getState()

Description copied from class: AbstractComponent

Returns the shared state bean with information to be sent from the server to the client. Subclasses should override this method and set any relevant fields of the state returned by super.getState().

Overrides:

getState in class AbstractComponent

Returns:

updated component shared state

attach

public void attach()

Description copied from interface: ClientConnector

Notifies the connector that it is connected to a VaadinSession (and therefore also to a UI).

The caller of this method is #setParent(ClientConnector) if the parent is itself already attached to the session. If not, the parent will call the ClientConnector.attach() for all its children when it is attached to the session. This method is always called before the connector's data is sent to the client-side for the first time.

The attachment logic is implemented in AbstractClientConnector.

Specified by:

attach in interface ClientConnector

Specified by:

attach in interface Component

Overrides:

attach in class AbstractComponent

createContent

protected Component createContent(TextField userNameField,
                                  PasswordField passwordField,
                                  Button loginButton)

Create the content for the login form with the supplied user name field, password field and the login button. You cannot use any other text fields or buttons for this purpose. To replace these components with your own implementations, override createUserNameField(), createPasswordField() and createLoginButton(). If you only want to change the default captions, override #getUserNameFieldCaption(), #getPasswordFieldCaption() and getLoginButtonCaption(). You do not have to use the login button in your layout.

Parameters:

userNameField - the user name text field

passwordField - the password field

loginButton - the login button

Returns:

addLoginListener

public void addLoginListener(LoginForm.LoginListener listener)

Adds LoginListener to handle login logic

Parameters:

listener -

addListener

@Deprecated
public void addListener(LoginForm.LoginListener listener)

Deprecated. As of 7.0, replaced by addLoginListener(LoginListener)

removeLoginListener

public void removeLoginListener(LoginForm.LoginListener listener)

Removes LoginListener

Parameters:

listener -

removeListener

@Deprecated
public void removeListener(LoginForm.LoginListener listener)

Deprecated. As of 7.0, replaced by removeLoginListener(LoginListener)