Module is.codion.swing.framework.ui

Package is.codion.swing.framework.ui

Interface EntityApplication<M extends SwingEntityApplicationModel,P extends EntityApplicationPanel<M>>

Type Parameters:

M - the application model type

P - the application panel type

public interface EntityApplication<M extends SwingEntityApplicationModel,P extends EntityApplicationPanel<M>>

Builds a and starts an application.

See Also:

• builder(Class, Class)
• start()

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	EntityApplication.DomainStep<M extends SwingEntityApplicationModel,P extends EntityApplicationPanel<M>>	Specifies the application domain model type.

Field Summary

Fields

Modifier and Type	Field	Description
static final PropertyValue<Boolean>	CONNECTION_INFO_UPPER_CASE	Specifies whether the connection information displayed in the frame title is automatically converted to upper case.
static final PropertyValue<Boolean>	SAVE_DEFAULT_USERNAME	Specifies whether the client saves the last successful login username, which is then displayed as the default username the next time the application is started Value type: Boolean Default value: true
static final PropertyValue<Boolean>	STARTUP_DIALOG	Specifies whether a startup dialog should be shown Value type: Boolean Default value: true
static final PropertyValue<String>	USER	Specifies the user for logging into the application on the form user:password.

Method Summary

Modifier and Type	Method	Description
static <M extends SwingEntityApplicationModel, P extends EntityApplicationPanel<M>> EntityApplication.DomainStep<M,P>	builder(Class<M> applicationModelClass, Class<P> applicationPanelClass)
EntityApplication<M,P>	connectionInfoUpperCase(boolean connectionInfoUpperCase)
EntityApplication<M,P>	connectionProvider(EntityConnectionProvider connectionProvider)	Overrides connectionProvider(Function)
EntityApplication<M,P>	connectionProvider(Function<User,EntityConnectionProvider> connectionProvider)
EntityApplication<M,P>	defaultFrameSize(@Nullable Dimension defaultFrameSize)
EntityApplication<M,P>	defaultLookAndFeel(Class<? extends LookAndFeel> defaultLookAndFeelClass)	Sets the default look and feel class, used in case no look and feel settings are found in user preferences.
EntityApplication<M,P>	defaultLookAndFeel(String defaultLookAndFeelClassName)	Sets the default look and feel classname, used in case no look and feel settings are found in user preferences.
EntityApplication<M,P>	defaultUser(@Nullable User defaultUser)
EntityApplication<M,P>	displayFrame(boolean displayFrame)
EntityApplication<M,P>	frame(Supplier<JFrame> frame)
EntityApplication<M,P>	frameSize(@Nullable Dimension frameSize)
EntityApplication<M,P>	frameTitle(Observable<String> frameTitle)	For a dynamic frame title.
EntityApplication<M,P>	frameTitle(String frameTitle)
EntityApplication<M,P>	icon(ImageIcon icon)
EntityApplication<M,P>	loginPanelSouthComponent(Supplier<JComponent> loginPanelSouthComponentSupplier)	Note that this does not apply when a custom user(Supplier) has been specified.
EntityApplication<M,P>	lookAndFeel(Class<? extends LookAndFeel> lookAndFeelClass)	Sets the look and feel class, overrides any look and feel settings found in user preferences.
EntityApplication<M,P>	lookAndFeel(String lookAndFeelClassName)	Sets the look and feel classname, overrides any look and feel settings found in user preferences.
EntityApplication<M,P>	mainMenu(boolean mainMenu)
EntityApplication<M,P>	maximizeFrame(boolean maximizeFrame)
EntityApplication<M,P>	model(Function<EntityConnectionProvider,M> model)
EntityApplication<M,P>	name(String name)	Sets the application name, used as frame title and client type identifier when using remote connnections.
EntityApplication<M,P>	onStarted(@Nullable Consumer<P> onStarted)
EntityApplication<M,P>	onStarting(@Nullable Runnable onStarting)	Runs as the application is starting, but after Look and Feel initialization.
EntityApplication<M,P>	panel(Function<M,P> panel)
EntityApplication<M,P>	saveDefaultUsername(boolean saveDefaultUsername)
void	start()	Starts the application on the Event Dispatch Thread.
void	start(boolean onEventDispatchThread)	Starts the application.
EntityApplication<M,P>	startupDialog(boolean startupDialog)
EntityApplication<M,P>	uncaughtExceptionHandler(boolean uncaughtExceptionHandler)	Specifies whether to set the default uncaught exception handler when starting the application, true by default.
EntityApplication<M,P>	user(@Nullable User user)	The User to use to connect to the database, this user is propagated to connectionProvider(Function).
EntityApplication<M,P>	user(Supplier<User> userSupplier)	Supplies the User to use to connect to the database, this user is then propagated to connectionProvider(Function).
EntityApplication<M,P>	version(Version version)

Field Details

USER

static final PropertyValue<String> USER

Specifies the user for logging into the application on the form user:password. If one is specified no login dialog is presented.

Initialized with the value of the CODION_CLIENT_USER environment variable.

Warning: System properties are visible in process listings. Use only for development/testing. In production, use secure credential management.

• Value type: String
• Default value: System.getenv("CODION_CLIENT_USER")

See Also:

• User.parse(String)

SAVE_DEFAULT_USERNAME

static final PropertyValue<Boolean> SAVE_DEFAULT_USERNAME

Specifies whether the client saves the last successful login username, which is then displayed as the default username the next time the application is started

• Value type: Boolean
• Default value: true

STARTUP_DIALOG

static final PropertyValue<Boolean> STARTUP_DIALOG

Specifies whether a startup dialog should be shown

• Value type: Boolean
• Default value: true

CONNECTION_INFO_UPPER_CASE

static final PropertyValue<Boolean> CONNECTION_INFO_UPPER_CASE

Specifies whether the connection information displayed in the frame title is automatically converted to upper case.

If not, the username as input via the login dialog is used along with the connection description as provided by the underlying EntityConnectionProvider. This may result in "Scott@DevDb" or "scott@DEVSERVER@hostname" instead of the default "SCOTT@DEVDB" or "SCOTT@DEVSERVER@HOSTNAME".

• Value type: Boolean
• Default value: true

Method Details

name

EntityApplication<M,P> name(String name)

Sets the application name, used as frame title and client type identifier when using remote connnections.

If no application name is set, DomainType.name() is used or applicationPanelClass.getSimpleName() in case of no domain model.

Parameters:

name - the application name

Returns:

this EntityApplication instance

icon

EntityApplication<M,P> icon(ImageIcon icon)

Parameters:

icon - the application icon

Returns:

this EntityApplication instance

version

EntityApplication<M,P> version(Version version)

Parameters:

version - the application version

Returns:

this EntityApplication instance

defaultLookAndFeel

EntityApplication<M,P> defaultLookAndFeel(Class<? extends LookAndFeel> defaultLookAndFeelClass)

Sets the default look and feel class, used in case no look and feel settings are found in user preferences.

Parameters:

defaultLookAndFeelClass - the default look and feel class

Returns:

this EntityApplication instance

See Also:

• LookAndFeelProvider

defaultLookAndFeel

EntityApplication<M,P> defaultLookAndFeel(String defaultLookAndFeelClassName)

Sets the default look and feel classname, used in case no look and feel settings are found in user preferences.

Parameters:

defaultLookAndFeelClassName - the default look and feel classname

Returns:

this EntityApplication instance

See Also:

• LookAndFeelProvider

lookAndFeel

EntityApplication<M,P> lookAndFeel(Class<? extends LookAndFeel> lookAndFeelClass)

Sets the look and feel class, overrides any look and feel settings found in user preferences.

Parameters:

lookAndFeelClass - the look and feel class

Returns:

this EntityApplication instance

See Also:

• LookAndFeelProvider

lookAndFeel

EntityApplication<M,P> lookAndFeel(String lookAndFeelClassName)

Sets the look and feel classname, overrides any look and feel settings found in user preferences.

Parameters:

lookAndFeelClassName - the look and feel classname

Returns:

this EntityApplication instance

See Also:

• LookAndFeelProvider

connectionProvider

EntityApplication<M,P> connectionProvider(EntityConnectionProvider connectionProvider)

Overrides connectionProvider(Function)

Parameters:

connectionProvider - the connection provider

Returns:

this EntityApplication instance

connectionProvider

EntityApplication<M,P> connectionProvider(Function<User,EntityConnectionProvider> connectionProvider)

Parameters:

connectionProvider - initializes the connection provider, receives the user provided by user(Supplier)

Returns:

this EntityApplication instance

model

EntityApplication<M,P> model(Function<EntityConnectionProvider,M> model)

Parameters:

model - the application model factory

Returns:

this EntityApplication instance

panel

EntityApplication<M,P> panel(Function<M,P> panel)

Parameters:

panel - the application panel factory

Returns:

this EntityApplication instance

user

EntityApplication<M,P> user(@Nullable User user)

The User to use to connect to the database, this user is propagated to connectionProvider(Function).

If this user is null, user(Supplier) is used to fetch a user.

Parameters:

user - the application user

Returns:

this EntityApplication instance

See Also:

• USER

user

EntityApplication<M,P> user(Supplier<User> userSupplier)

Supplies the User to use to connect to the database, this user is then propagated to connectionProvider(Function).

This may be via a login dialog or simply by returning a hardcoded instance.

Startup is silently cancelled in case the Supplier.get() throws a CancelException.

Parameters:

userSupplier - supplies the application user, for example via a login dialog

Returns:

this EntityApplication instance

defaultUser

EntityApplication<M,P> defaultUser(@Nullable User defaultUser)

Parameters:

defaultUser - the default user credentials to display in a login dialog

Returns:

this EntityApplication instance

saveDefaultUsername

EntityApplication<M,P> saveDefaultUsername(boolean saveDefaultUsername)

Parameters:

saveDefaultUsername - true if the username should be saved in user preferences after a successful login

Returns:

this EntityApplication instance

loginPanelSouthComponent

EntityApplication<M,P> loginPanelSouthComponent(Supplier<JComponent> loginPanelSouthComponentSupplier)

Note that this does not apply when a custom user(Supplier) has been specified.

Parameters:

loginPanelSouthComponentSupplier - supplies the component to add to the BorderLayout.SOUTH position of the default login panel

Returns:

this EntityApplication instance

onStarting

EntityApplication<M,P> onStarting(@Nullable Runnable onStarting)

Runs as the application is starting, but after Look and Feel initialization. Throw CancelException in order to cancel the application startup.

Parameters:

onStarting - run before the application is started

Returns:

this EntityApplication instance

onStarted

EntityApplication<M,P> onStarted(@Nullable Consumer<P> onStarted)

Parameters:

onStarted - called after a successful application start

Returns:

this EntityApplication instance

frame

EntityApplication<M,P> frame(Supplier<JFrame> frame)

Parameters:

frame - the supplies the frame to use

Returns:

this EntityApplication instance

frameTitle

EntityApplication<M,P> frameTitle(String frameTitle)

Parameters:

frameTitle - the frame title

Returns:

this EntityApplication instance

frameTitle

EntityApplication<M,P> frameTitle(Observable<String> frameTitle)

For a dynamic frame title.

Parameters:

frameTitle - the observable controlling the frame title

Returns:

this EntityApplication instance

connectionInfoUpperCase

EntityApplication<M,P> connectionInfoUpperCase(boolean connectionInfoUpperCase)

Parameters:

connectionInfoUpperCase - specifies whether the connection information displayed in the frame title is automatically converted to upper case

Returns:

this EntityApplication instance

See Also:

• CONNECTION_INFO_UPPER_CASE

mainMenu

EntityApplication<M,P> mainMenu(boolean mainMenu)

Parameters:

mainMenu - if true then a main menu is included

Returns:

this EntityApplication instance

maximizeFrame

EntityApplication<M,P> maximizeFrame(boolean maximizeFrame)

Parameters:

maximizeFrame - specifies whether the frame should be maximized or use its preferred size

Returns:

this EntityApplication instance

displayFrame

EntityApplication<M,P> displayFrame(boolean displayFrame)

Parameters:

displayFrame - specifies whether the frame should be displayed or left invisible

Returns:

this EntityApplication instance

uncaughtExceptionHandler

EntityApplication<M,P> uncaughtExceptionHandler(boolean uncaughtExceptionHandler)

Specifies whether to set the default uncaught exception handler when starting the application, true by default.

Parameters:

uncaughtExceptionHandler - if true the default uncaught exception handler is set on application start

Returns:

this EntityApplication instance

See Also:

• Thread.setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandler)

startupDialog

EntityApplication<M,P> startupDialog(boolean startupDialog)

Parameters:

startupDialog - if true then a progress dialog is displayed while the application is being initialized

Returns:

this EntityApplication instance

frameSize

EntityApplication<M,P> frameSize(@Nullable Dimension frameSize)

Parameters:

frameSize - the frame size when not maximized

Returns:

this EntityApplication instance

defaultFrameSize

EntityApplication<M,P> defaultFrameSize(@Nullable Dimension defaultFrameSize)

Parameters:

defaultFrameSize - the default frame size when no previous size is available in user preferences

Returns:

this EntityApplication instance

start

void start()

Starts the application on the Event Dispatch Thread.

start

void start(boolean onEventDispatchThread)

Starts the application.

Parameters:

onEventDispatchThread - if true then startup is performed on the Event Dispatch Thread

builder

static <M extends SwingEntityApplicationModel,
P extends EntityApplicationPanel<M>>
EntityApplication.DomainStep<M,P> builder(Class<M> applicationModelClass,
 Class<P> applicationPanelClass)

Type Parameters:

M - the application model type

P - the application panel type

Parameters:

applicationModelClass - the application model class

applicationPanelClass - the application panel class

Returns:

a EntityApplication