com.haulmont.cuba.web

Class App

java.lang.Object

com.haulmont.cuba.web.App

Direct Known Subclasses:

DefaultApp

public abstract class App
extends java.lang.Object

Central class of the web application. An instance of this class is created for each client's session and is bound to VaadinSession.
Use getInstance() static method to obtain the reference to the current App instance.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	APP_THEME_COOKIE_PREFIX
protected AppLog	appLog
protected BackgroundTaskManager	backgroundTaskManager
protected BeanLocator	beanLocator
protected Connection	connection
static java.lang.String	COOKIE_LOCALE
protected AppCookies	cookies
protected Events	events
protected ExceptionHandlers	exceptionHandlers
protected GlobalConfig	globalConfig
protected LinkHandler	linkHandler
protected MessageTools	messageTools
static java.lang.String	NAME
protected SettingsClient	settingsClient
protected ThemeConstants	themeConstants
protected ThemeConstantsRepository	themeConstantsRepository
static java.lang.String	USER_SESSION_ATTR
protected UserSessionService	userSessionService
protected UserSessionSource	userSessionSource
protected WebAuthConfig	webAuthConfig
protected WebConfig	webConfig
protected WindowConfig	windowConfig

Constructor Summary

Constructors

Constructor and Description
App()

Method Summary

Modifier and Type	Method and Description
void	addBackgroundTask(java.util.concurrent.Future task)
void	addCookie(java.lang.String name, java.lang.String value)
void	addCookie(java.lang.String name, java.lang.String value, int maxAge)
protected void	applyTheme(java.lang.String appWindowTheme)
void	cleanupBackgroundTasks()
protected void	clearSettingsCache()
protected Connection	createConnection()
void	createTopLevelWindow()
void	createTopLevelWindow(AppUI ui) Called on each browser tab initialization.
protected void	forceLogout()
AppLog	getAppLog()
AppUI	getAppUI() Deprecated. Use AppUI.getCurrent() instead.
java.util.List<AppUI>	getAppUIs()
Connection	getConnection()
int	getCookieMaxAge(java.lang.String name)
java.lang.String	getCookieValue(java.lang.String name)
ExceptionHandlers	getExceptionHandlers()
static App	getInstance()
java.util.Locale	getLocale()
ThemeConstants	getThemeConstants()
RootWindow	getTopLevelWindow() Deprecated. Use AppUI.getTopLevelWindow() instead
WebScreens	getWindowManager() Deprecated. Get screens API from AppUI instead.
protected void	init(java.util.Locale requestLocale) Called when the first UI of the session is initialized.
protected void	initExceptionHandlers(boolean isConnected) Initializes exception handlers immediately after login and logout.
static boolean	isBound()
protected ThemeConstants	loadTheme()
abstract void	loginOnStart()
OperationResult	logout() Try to perform logout.
void	logout(java.lang.Runnable runWhenLoggedOut) Deprecated. Use logout() instead.
void	navigateTo(java.lang.String topLevelWindowId) Deprecated. Use Screens.create(Class, Screens.LaunchMode) with OpenMode.ROOT
void	onHeartbeat() Called from heartbeat request.
protected void	performStandardLogout(AppUI ui)
void	recreateUi(AppUI ui) Sets UserSession from Connection.getSession() and re-initializes the given ui.
void	removeAllWindows() Removes all windows from all UIs.
protected void	removeAllWindows(java.util.List<AppUI> uis) Removes all windows in the given uis.
void	removeBackgroundTask(java.util.concurrent.Future task)
void	removeCookie(java.lang.String name)
protected java.util.Locale	resolveLocale(java.util.Locale requestLocale)
protected abstract java.lang.String	routeTopLevelWindowId()
void	setLocale(java.util.Locale locale)
void	setUserAppTheme(java.lang.String themeName)

Methods inherited from class java.lang.Object

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

Field Detail

NAME

public static final java.lang.String NAME

See Also:

Constant Field Values

USER_SESSION_ATTR

public static final java.lang.String USER_SESSION_ATTR

See Also:

Constant Field Values

APP_THEME_COOKIE_PREFIX

public static final java.lang.String APP_THEME_COOKIE_PREFIX

See Also:

Constant Field Values

COOKIE_LOCALE

public static final java.lang.String COOKIE_LOCALE

See Also:

Constant Field Values

appLog

protected AppLog appLog

connection

protected Connection connection

exceptionHandlers

protected ExceptionHandlers exceptionHandlers

globalConfig

@Inject
protected GlobalConfig globalConfig

webConfig

@Inject
protected WebConfig webConfig

webAuthConfig

@Inject
protected WebAuthConfig webAuthConfig

windowConfig

@Inject
protected WindowConfig windowConfig

themeConstantsRepository

@Inject
protected ThemeConstantsRepository themeConstantsRepository

userSessionService

@Inject
protected UserSessionService userSessionService

userSessionSource

@Inject
protected UserSessionSource userSessionSource

messageTools

@Inject
protected MessageTools messageTools

settingsClient

@Inject
protected SettingsClient settingsClient

events

@Inject
protected Events events

beanLocator

@Inject
protected BeanLocator beanLocator

cookies

protected AppCookies cookies

linkHandler

protected LinkHandler linkHandler

backgroundTaskManager

protected BackgroundTaskManager backgroundTaskManager

themeConstants

protected ThemeConstants themeConstants

Constructor Detail

App

public App()

Method Detail

loadTheme

protected ThemeConstants loadTheme()

applyTheme

protected void applyTheme(java.lang.String appWindowTheme)

initExceptionHandlers

protected void initExceptionHandlers(boolean isConnected)

Initializes exception handlers immediately after login and logout. Can be overridden in descendants to manipulate exception handlers programmatically.

Parameters:

isConnected - true after login, false after logout

getTopLevelWindow

@Deprecated
public RootWindow getTopLevelWindow()

Deprecated. Use AppUI.getTopLevelWindow() instead

Returns:

currently displayed top-level window

getAppUI

@Nullable
 @Deprecated
public AppUI getAppUI()

Deprecated. Use AppUI.getCurrent() instead.

Returns:

current UI

getThemeConstants

public ThemeConstants getThemeConstants()

getAppUIs

public java.util.List<AppUI> getAppUIs()

loginOnStart

public abstract void loginOnStart()
                           throws LoginException

Throws:

LoginException

createConnection

protected Connection createConnection()

init

protected void init(java.util.Locale requestLocale)

Called when the first UI of the session is initialized.

resolveLocale

protected java.util.Locale resolveLocale(@Nullable
                                         java.util.Locale requestLocale)

createTopLevelWindow

public void createTopLevelWindow(AppUI ui)

Called on each browser tab initialization.

routeTopLevelWindowId

protected abstract java.lang.String routeTopLevelWindowId()

createTopLevelWindow

public void createTopLevelWindow()

navigateTo

@Deprecated
public void navigateTo(java.lang.String topLevelWindowId)

Deprecated. Use Screens.create(Class, Screens.LaunchMode) with OpenMode.ROOT

Initialize new TopLevelWindow and replace current.

Parameters:

topLevelWindowId - target top level window id

onHeartbeat

public void onHeartbeat()

Called from heartbeat request.
Used for ping middleware session and show session messages

getInstance

public static App getInstance()

Returns:

Current App instance. Can be invoked anywhere in application code.

Throws:

java.lang.IllegalStateException - if no application instance is bound to the current VaadinSession

isBound

public static boolean isBound()

Returns:

true if an App instance is currently bound and can be safely obtained by getInstance()

getConnection

public Connection getConnection()

Returns:

Current connection object

getWindowManager

@Deprecated
public WebScreens getWindowManager()

Deprecated. Get screens API from AppUI instead.

Returns:

WindowManagerImpl instance or null if the current UI has no MainWindow

getAppLog

public AppLog getAppLog()

getExceptionHandlers

public ExceptionHandlers getExceptionHandlers()

getCookieValue

public java.lang.String getCookieValue(java.lang.String name)

getCookieMaxAge

public int getCookieMaxAge(java.lang.String name)

addCookie

public void addCookie(java.lang.String name,
                      java.lang.String value,
                      int maxAge)

addCookie

public void addCookie(java.lang.String name,
                      java.lang.String value)

removeCookie

public void removeCookie(java.lang.String name)

getLocale

public java.util.Locale getLocale()

setLocale

public void setLocale(java.util.Locale locale)

setUserAppTheme

public void setUserAppTheme(java.lang.String themeName)

addBackgroundTask

public void addBackgroundTask(java.util.concurrent.Future task)

removeBackgroundTask

public void removeBackgroundTask(java.util.concurrent.Future task)

cleanupBackgroundTasks

public void cleanupBackgroundTasks()

removeAllWindows

public void removeAllWindows()

Removes all windows from all UIs.

removeAllWindows

protected void removeAllWindows(java.util.List<AppUI> uis)

Removes all windows in the given uis.

Parameters:

uis - AppUI instances

recreateUi

public void recreateUi(AppUI ui)

Sets UserSession from Connection.getSession() and re-initializes the given ui.

clearSettingsCache

protected void clearSettingsCache()

logout

@Deprecated
public void logout(@Nullable
                               java.lang.Runnable runWhenLoggedOut)

Deprecated. Use logout() instead.

Try to perform logout. If there are unsaved changes in opened windows then logout will not be performed and unsaved changes dialog will appear.

Parameters:

runWhenLoggedOut - runnable that will be invoked if user decides to logout

logout

public OperationResult logout()

Try to perform logout. If there are unsaved changes in opened windows then logout will not be performed and unsaved changes dialog will appear.

Returns:

operation result object

performStandardLogout

protected void performStandardLogout(AppUI ui)

forceLogout

protected void forceLogout()