public class Client extends java.lang.Object implements ClientContextI, ClientContainerI, OriginHashProviderI, ClientLoginDialogActivityListenerI, ConnectionEventListenerI, DBManEventListenerI, L10nLocaleChangeListenerI, PreloadL10nCacheFinishedListenerI, SaveBOListenerI, java.awt.event.WindowListener
ClientContextI interface for the application.
This class acts as the central hub for the client environment. It manages the primary client session, asynchronous event subscriptions, server connection state, database operations, UI dialog routing, and transaction building.
| Modifier and Type | Field and Description |
|---|---|
static java.net.URL |
jnlpCodeBase |
static boolean |
jnlpstart |
static java.io.File |
log4jconf |
CANCELED, CONFIRMED, DENIED, TYPE_ERROR, TYPE_INFO, TYPE_PLAIN, TYPE_QUESTION, TYPE_WARNINGENV_DAWN_MACHINE_ID| Constructor and Description |
|---|
Client(java.lang.String _server)
Constructs a new instance.
|
Client(java.lang.String _server,
java.lang.String username) |
Client(java.lang.String _server,
java.lang.String username,
java.lang.String pass) |
Client(java.lang.String _server,
java.lang.String username,
java.lang.String pass,
java.lang.String _pathClientLogTxt) |
Client(java.lang.String _server,
java.lang.String username,
java.lang.String pass,
java.lang.String _pathClientLogTxt,
java.lang.String minHeap) |
Client(java.lang.String _server,
java.lang.String username,
java.lang.String pass,
java.lang.String _pathClientLogTxt,
java.lang.String minHeap,
java.lang.String maxHeap) |
Client(java.lang.String _server,
java.lang.String username,
java.lang.String pass,
java.lang.String _pathClientLogTxt,
java.lang.String minHeap,
java.lang.String maxHeap,
java.lang.String _projectName) |
| Modifier and Type | Method and Description |
|---|---|
void |
action_about() |
boolean |
action_changeGuiThemeToDefault_available()
Indicates whether the action to reset the GUI theme to default is currently available.
|
void |
action_changeGuiThemeToDefault()
Resets the user's configured GUI theme back to the platform default.
|
void |
action_changeLocale() |
void |
action_changePW() |
void |
action_exportSystemObjects() |
void |
action_flatlafDefaults() |
void |
action_flatlafInspector(java.awt.event.ActionEvent event) |
void |
action_flushCaches() |
void |
action_groovyConsole() |
void |
action_importLicense() |
void |
action_importSystemObjects() |
void |
action_installDawn()
Action installDawn will download the binary fitting to the current os/arch and
call it the "-install $codebase/solstice.ds"
|
void |
action_keys() |
void |
action_openL10n() |
void |
action_quit() |
void |
action_reloadProfile() |
void |
action_saveProfile()
Captures current window geometry and persists profile preferences and session state.
|
void |
action_schemaTool() |
void |
action_serverConsole() |
void |
action_showReportIssueForm(BO sourceBO,
Struktur sourceStruktur) |
void |
action_showReportIssueForm(BO sourceBO,
Struktur sourceStruktur,
java.awt.event.ActionEvent ae) |
boolean |
action_switchToMultiWindowDesktopManager_available() |
void |
action_switchToMultiWindowDesktopManager() |
boolean |
action_switchToSingleWindowDesktopManager_available() |
void |
action_switchToSingleWindowDesktopManager() |
void |
action_syncNG() |
void |
action_takeScreenshot()
Takes a screenshot of the active window or the main frame and saves it as a PNG file.
|
void |
action_takeScreenshot(java.awt.event.ActionEvent ae) |
void |
action_toggleBOProperties(FormAction action) |
void |
action_toggleHiddenProperties(FormAction action) |
void |
action_toggleHistory(FormAction action) |
void |
action_zoomIn() |
void |
action_zoomOut() |
void |
action_zoomReset() |
void |
addAction(FormAction fa)
Adds an action to this ClientContextI.
|
void |
addAction(FormAction fa,
MDIElementI mdie)
Adds an action to this ClientContextI, either globally or for a specific "MDIElementI".
|
void |
addSaveBOListener(SaveBOListenerI sbl)
Adds the passed SaveBOListenerI to the list of listeners, wrapped in a WeakReference.
|
void |
addVisualComponent(javax.swing.JComponent c,
java.lang.String position) |
void |
addVisualComponent(java.lang.String container,
javax.swing.JComponent c,
java.lang.String position) |
void |
afterConnectServer()
Initializes necessary state immediately after a successful connection to the server is established.
|
void |
applyDefaults(electric.xml.Element e,
java.lang.Object[] l10nPath) |
void |
authenticate(java.lang.String username,
java.lang.String pass) |
void |
authenticate(java.lang.String username,
java.lang.String pass,
boolean inhibitInitFeatureManager) |
void |
authenticate(java.lang.String username,
java.lang.String pass,
boolean inhibitInitFeatureManager,
java.lang.String originHash) |
void |
bringUsToFront() |
void |
checkActionsEnabledStatus() |
void |
clientLoginActivity(java.awt.AWTEvent e)
Called whenever activity in the login dialogue happens, e.g. focussed or key typed or something was clicked.
|
void |
close()
Closes the client session, unsubscribes from all server and connection events,
and forcibly stops the event notifier thread.
|
void |
close(boolean processLogoffScript)
Closes this client.
|
void |
closeWithConfirmation() |
boolean |
connectionAvailableNow()
Waits for the connRunner and reports if a server-connection is available.
|
javax.swing.JRootPane |
determineRootPane(FormContextI ftx)
Determines the primary JRootPane associated with a given form context.
|
javax.swing.JRootPane |
determineRootPaneViaFallback(FormContextI rootFtx)
Helper method to determine the JRootPane from the root form context or its underlying element.
|
void |
endWaitFeedback()
Lifecycle hook meant to be overridden by UI subclasses to deactivate
visual waiting indicators.
|
java.lang.String |
executeCommand(java.lang.String cmd)
Command interface to client.
|
void |
fireStatusChanged() |
void |
flushCaches() |
void |
forcedClientDisconnectInitiated(int cSecsDelay,
java.lang.String msg)
Lifecycle hook triggered when the server requests a forced client disconnect.
|
void |
forcedClientDisconnectInitiatedDefault(int cSecsDelay)
Convenience overload for
forcedClientDisconnectInitiatedDefault(int, String) without an explicit notice. |
void |
forcedClientDisconnectInitiatedDefault(int cSecsDelay,
java.lang.String msg)
Default UI fallback handler for an initiated forced client disconnect.
|
void |
forcedClientDisconnectStopped()
Lifecycle hook triggered when a forced client disconnect is canceled.
|
void |
forcedClientDisconnectStoppedDefault()
Default UI fallback handler when a forced client disconnect is canceled.
|
java.util.HashMap |
getActions() |
java.util.LinkedHashMap |
getAllActions() |
java.util.HashMap |
getAllToolBars() |
Struktur[] |
getAutomatikContents(Struktur s) |
Struktur |
getAutomatikStrukturForPath(java.lang.String path)
Returns the automatically generated structure element for a given path.
|
Struktur |
getAutomatikStrukturForPath(java.lang.String path,
boolean reload)
Returns the automatically generated structure element for a given path.
|
Struktur |
getAutomatikStrukturForPath(java.lang.String path,
boolean reload,
boolean directOnly)
Returns the automatically generated structure element for a given path.
|
Struktur |
getAutomatikStrukturForPath(java.lang.String path,
boolean reload,
boolean directOnly,
EntityI[] entitiesOnly)
Returns the automatically generated structure element for a given path.
|
BackendConnectionManagerI |
getBackendConnectionManager()
Returns the backend connection manager responsible for remote server communication.
|
byte[] |
getBLOB(java.lang.Long id)
Retrieves binary large object (BLOB) data corresponding to the given ID from the backend.
|
BO |
getBO(java.lang.Long id,
java.lang.Class classTip)
Retrieves a specific Business Object from the backend by its ID and Class.
|
BOLoaderI |
getBOLoader() |
Lesezeichen |
getBookmarkByTid(java.lang.String tid,
java.lang.String entityName)
Retrieves a single
Lesezeichen uniquely identified by its tid and entity name. |
Lesezeichen[] |
getBookmarks(EntityI e)
Returns all
Lesezeichen instances associated with the specified entity from the cache, sorted by priority
in descending order (highest priority first). |
Lesezeichen[] |
getBookmarks(EntityI e,
boolean reload)
Returns all
Lesezeichen instances associated with the specified entity, sorted by priority
in descending order (highest priority first). |
java.lang.String |
getCachedServerDesc() |
FormContextI |
getClientFtx()
Returns the global application-level form context associated with the desktop client.
|
CodebausteinStorageI |
getCodebausteinStorage() |
java.lang.String |
getConfiguredMaxHeap() |
java.lang.String |
getConfiguredMinHeap() |
de.ipcon.swing.WindowManagerType |
getCurrentRunningWindowManagerType()
Resolves the
WindowManagerType corresponding to the currently active desktop manager instance. |
Benutzer |
getCurrentUser()
Deprecated.
|
java.util.Date |
getDateLoggedOn() |
DBManInfo |
getDBManInfo()
Retrieves information about the server.
|
java.awt.Component |
getDefaultDialogParent() |
javax.swing.JComponent |
getDefaultFocusOwner() |
FormattedChoiceDialogI |
getDialogHelper() |
java.awt.Component |
getDialogParent()
Determines the optimal parent component for modal dialogs.
|
DBManEventProviderI |
getEventProvider() |
FeatureManagerI |
getFeatureManager()
Returns the feature manager associated with the current backend connection.
|
Folder |
getFolder(EntityI ent)
Deprecated.
|
Folder |
getFolder(java.lang.String path)
Returns the temporary folder for a given path.
|
Folder[] |
getFolderChildren(Folder parent)
Returns all folders that have the given folder as direct parent
|
java.util.HashMap |
getFolders() |
Formular |
getFormByTid(java.lang.String tid,
java.lang.String entityName)
Retrieves a single
Formular uniquely identified by its tid and entity name. |
FormElementI |
getFormElementForBO(BO bo) |
Formular[] |
getForms(EntityI e)
Returns all
Formular instances associated with the specified entity from the cache, sorted by priority
in descending order (highest priority first). |
Formular[] |
getForms(EntityI e,
boolean reload)
Returns all
Formular instances associated with the specified entity, sorted by priority
in descending order (highest priority first). |
FulltextSearcherI |
getFulltextSearcher()
Checks if Fulltext Search (FTS) is available on the backend and returns the searcher instance if so.
|
java.util.Map |
getGlobalActions(FormContextI ftx) |
java.lang.Object |
getGlobalVar(java.lang.String name)
Deprecated.
|
java.util.Map<java.lang.String,java.lang.Object> |
getGlobalVars()
Deprecated.
|
java.lang.String |
getInstanceName() |
byte[] |
getLocalFile(java.io.File infile) |
java.io.File |
getLog4JConfigFile() |
java.awt.Image |
getLogo() |
javax.swing.JFrame |
getMainFrame() |
MDIElementI |
getMDIElementForBO(BO bo) |
MDIManagerI |
getMDIManager() |
javax.swing.JMenu |
getMenu(java.lang.String s) |
ClientMenuManager |
getMenuManager() |
Transaction |
getNewFormTransaction()
Creates an interactive form transaction initialized with the current user.
|
Transaction |
getNewFormTransaction(java.lang.String desc)
Creates an interactive form transaction initialized with the current user
and an identifying description for auditing and debugging.
|
Transaction |
getNewTransaction() |
Transaction |
getNewTransaction(BOLoaderI loader) |
Transaction |
getNewTransaction(BOLoaderI loader,
SchemaI txSchema) |
Transaction |
getNewTransaction(BOLoaderI loader,
SchemaI txSchema,
java.lang.String desc) |
Transaction |
getNewTransaction(BOLoaderI loader,
SchemaI txSchema,
java.lang.String desc,
TemporaryIdSupplierI tempIdSupplier)
Central internal factory method to create and fully initialize a new database transaction.
|
Transaction |
getNewTransaction(java.lang.String desc) |
Transaction |
getNewTransaction(java.lang.String desc,
TemporaryIdSupplierI tempIdSupplier) |
Transaction |
getNewTransaction(TemporaryIdSupplierI tempIdSupplier) |
Transaction |
getNewTransactionWithInstrumentedSchema() |
Transaction |
getNewTransactionWithInstrumentedSchema(java.lang.String desc) |
Transaction |
getNewTransactionWithInstrumentedSchema(java.lang.String desc,
TemporaryIdSupplierI tempIdSupplier) |
Transaction |
getNewTransactionWithInstrumentedSchema(TemporaryIdSupplierI tempIdSupplier) |
java.lang.String |
getPathClientLogTxt() |
java.util.List<ClientPluginI> |
getPlugins()
Returns a list of all currently registered @see de.ipcon.form.ClientPluginI
|
java.util.Collection<java.lang.String> |
getProjectThemeLocations() |
Report |
getReportByTid(java.lang.String tid,
java.lang.String entityName)
Retrieves a single
Report uniquely identified by its tid and entity name. |
Report[] |
getReports(EntityI e)
Returns all
Report instances associated with the specified entity from the cache, sorted by priority
in descending order (highest priority first). |
Report[] |
getReports(EntityI e,
boolean reload)
Returns all
Report instances associated with the specified entity, sorted by priority
in descending order (highest priority first). |
SchemaI |
getSchema() |
BeanShellScript |
getScript() |
java.lang.String |
getServerName() |
SessionI |
getSession() |
StrukturCache |
getStrukturCache() |
Struktur[] |
getStrukturenForEntity(java.lang.String entityName)
Returns all structures for a given entity-name
|
Struktur[] |
getStrukturenForEntity(java.lang.String entityName,
boolean reload)
Returns all structures for a given entity-name
|
Struktur[] |
getStrukturenForEntity(java.lang.String entityName,
boolean reload,
boolean directOnly)
Returns all structures for a given entity-name
|
Struktur[] |
getStrukturenForEntity(java.lang.String entityName,
boolean reload,
boolean directOnly,
EntityI[] entitiesOnly)
Returns all structures for a given entity-name
|
Struktur[] |
getStrukturenForSearchString(java.lang.String searchString,
int searchType) |
Struktur[] |
getStrukturenForSearchString(java.lang.String searchString,
int searchType,
boolean reload) |
Struktur[] |
getStrukturenForSearchString(java.lang.String searchString,
int searchType,
boolean reload,
boolean directOnly) |
Struktur[] |
getStrukturenForSearchString(java.lang.String searchString,
int searchType,
boolean reload,
boolean directOnly,
EntityI[] entitiesOnly)
Searches entities for a given string and generates/retrieves the structures for them
|
Schablone |
getTemplateByTid(java.lang.String tid,
java.lang.String entityName)
Retrieves a single
Schablone uniquely identified by its tid and entity name. |
Schablone[] |
getTemplates(EntityI e)
Returns all
Schablone instances associated with the specified entity from the cache, sorted by priority
in descending order (highest priority first). |
Schablone[] |
getTemplates(EntityI e,
boolean reload)
Returns all
Schablone instances associated with the specified entity, sorted by priority
in descending order (highest priority first). |
Schablone[] |
getTemplatesForSubEntitiesInAdminsOrdner(EntityI e,
boolean reload,
boolean uniqueEntities,
java.util.Set entitiesToExclude)
Internal specialized lookup for templates across polymorphic sub-entities located in administrator folders.
|
java.lang.String |
getUniquePrefix()
Returns the unique prefix for the window-title, only being applied
for OS-managed windows when using the ClientNativeWindowManager.
|
de.ipcon.swing.WindowManagerType |
getWindowManagerType()
Resolves the configured window manager type from the user profile.
|
java.lang.String |
getWindowTitle(BO bo) |
java.lang.String |
getWindowTitle(BO bo,
java.lang.String explicitDescription) |
java.lang.String |
getWindowTitle(BO bo,
java.lang.String explicitDescription,
boolean skipEntity) |
void |
initLogonSubscriptions()
Subscribes to essential backend server events upon user logon.
|
void |
initScript()
Initializes the internal BeanShell scripting interpreter.
|
boolean |
isClosed() |
boolean |
isConnected() |
boolean |
isConnected(boolean failfast) |
boolean |
isIssueReportFormEnabled() |
boolean |
isLoggingOn() |
boolean |
isMemoryTightClient() |
boolean |
isMemoryTightClient(boolean failfast) |
boolean |
isNotificationSystemActivated() |
boolean |
isServerAuthoritativeSyncServer() |
boolean |
isShowBOProperties() |
boolean |
isShowHiddenProperties() |
boolean |
isShowHistory() |
void |
killEventNotifier()
Forcibly shuts down the internal event notifier thread.
|
void |
loadGlobals()
Loads global session variables and user preferences from the local machine configuration file
and applies them to the current session.
|
void |
logon() |
void |
logonOnEDT(de.ipcon.swing.WindowState lastWindowState)
Initializes and displays the client mainframe on the Event Dispatch Thread (EDT).
|
static void |
main(java.lang.String[] args)
Main entry point for the client application.
|
static void |
mainStart(java.lang.String[] args)
Initializes and starts the client application.
|
static void |
mainStart(java.lang.String[] args,
java.lang.String _pathClientLogTxt) |
FormElementI |
openForm(Formular form,
BO bo) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map parameters) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map parameters,
FormElementI origin)
Opens a form with standard desktop defaults and an explicit UI origin.
|
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map parameters,
java.lang.String title) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds,
boolean maximize) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds,
boolean maximize,
boolean ignoreOpenInstance) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds,
boolean maximize,
boolean ignoreOpenInstance,
boolean reuseOpenIfNew) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds,
boolean maximize,
boolean ignoreOpenInstance,
boolean reuseOpenIfNew,
boolean skipTxLoadedNewBOs)
Opens a form without an explicit Transaction context.
|
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map parameters) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map parameters,
java.lang.String title) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds,
boolean maximize) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds,
boolean maximize,
boolean ignoreOpenInstance) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds,
boolean maximize,
boolean ignoreOpenInstance,
boolean reuseOpenIfNew) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds,
boolean maximize,
boolean ignoreOpenInstance,
boolean reuseOpenIfNew,
boolean skipTxLoadedNewBOs) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map parameters,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds,
boolean maximize,
boolean ignoreOpenInstance,
boolean reuseOpenIfNew,
boolean skipTxLoadedNewBOs,
FormElementI origin)
Opens a form bound to the specified Transaction, dispatching synchronously to the EDT.
|
FormElementI |
openNew(Schablone s) |
FormElementI |
openNew(Schablone s,
java.util.Map parameters) |
FormElementI |
openNew(Schablone s,
java.util.Map parameters,
FormElementI origin)
Creates a new BO with the given
Schablone and parameters and opens it relative to the optional origin form |
FormElementI |
openView(BO bo) |
FormElementI |
openView(BO bo,
java.util.Map parameters) |
FormElementI |
openView(BO bo,
java.util.Map parameters,
java.lang.String title) |
FormElementI |
openView(BO bo,
java.util.Map parameters,
java.lang.String title,
boolean reloadFormList) |
FormElementI |
openView(BO bo,
java.util.Map parameters,
java.lang.String title,
boolean reloadFormList,
boolean useAutomatic) |
FormElementI |
openView(Lesezeichen l) |
FormElementI |
openView(Lesezeichen l,
java.util.Map parameters)
Open the given Lesezeichen.
|
void |
passwordChangeInLogonDialogInitiated()
Handles the event when a password change is initiated in the logon dialog.
|
static void |
politeMain(java.lang.String[] args)
Alternative entry point for the client application, called by the "LogWindow" GUI button.
|
void |
prefetchL10nPacksGUI()
Orchestrates the prefetching of localization packs with GUI feedback.
|
FormElementI |
preparePrinting(Report report,
BO bo) |
FormElementI |
preparePrinting(Report report,
BO[] bos) |
FormElementI |
preparePrinting(Report report,
BO[] bos,
java.lang.String title) |
FormElementI |
preparePrinting(Report report,
BO[] bos,
java.lang.String title,
FormElementI owner) |
FormElementI |
preparePrinting(Report report,
BO bo,
java.lang.String title) |
FormElementI |
preparePrinting(java.lang.String entityName,
java.lang.String reportName,
BO bo) |
FormElementI |
preparePrinting(java.lang.String entityName,
java.lang.String reportName,
BO[] bos) |
FormElementI |
preparePrinting(java.lang.String entityName,
java.lang.String reportName,
BO[] bos,
java.lang.String title) |
FormElementI |
preparePrinting(java.lang.String entityName,
java.lang.String reportName,
BO bo,
java.lang.String title) |
void |
processConnectionEvent(ConnectionEvent ce)
Called with a
ConnectionEvent that affects the current connection. |
void |
processDBManEvent(DBManEvent event)
Invoked when a subscribed DBManEvent occurs.
|
void |
processLocaleChanged(java.util.Locale oldLocale,
java.util.Locale newLocale)
For implementing L10nLocaleChangeListenerI.
|
void |
processPreloadFinished(java.util.Locale forLocale)
For implementing PreloadL10nCacheFinishedListenerI.
|
ClientLoginDialog |
provideLogonGUI(java.lang.String _server,
java.lang.String _user,
java.lang.String _passwd,
java.lang.String _pathClientLogTxt,
boolean _actionPWChange)
Constructs a @see de.ipcon.form.ClientLoginDialog so users may log in to the Swing-Solstice-GUI of the project.
|
void |
putLocalFile(java.io.File outfile,
byte[] data) |
void |
putLocalFile(java.io.File outfile,
java.io.InputStream is) |
java.util.List |
queryBO(groovy.lang.GString gs)
Executes a database query dynamically constructed via Groovy GString interpolation.
|
java.util.List |
queryBO(java.lang.String query)
Implementation Note: Performs parameterized querying against the backend.
|
java.util.List |
queryBO(java.lang.String query,
java.lang.Object[] params) |
boolean |
queryPluginFlag(java.lang.Class _clazz,
java.lang.String _methName) |
boolean |
queryPluginFlag(java.lang.Class _clazz,
java.lang.String _methName,
boolean _default) |
void |
receivedSystemMessage(java.lang.String msg,
java.lang.String sender)
Lifecycle hook triggered when a broadcast system message is received.
|
void |
receivedSystemMessageDefault(java.lang.String msg)
Convenience overload for
receivedSystemMessageDefault(String, String) without an explicit sender. |
void |
receivedSystemMessageDefault(java.lang.String msg,
java.lang.String sender)
Default UI fallback handler for displaying an incoming broadcast system message.
|
void |
refreshActions() |
void |
refreshActionsOnEDT() |
void |
refreshActionsOnEDT(boolean sync) |
void |
registerClientContainer(java.lang.String name,
ClientContainerI cc) |
javax.swing.JFrame |
registerMDIManagerInstance(java.lang.String name,
MDIManagerI mdiman) |
void |
removeAction(FormAction fa)
Removes an action globally from this ClientContextI.
|
void |
removeAction(FormAction fa,
MDIElementI mdie)
Removes an action from this ClientContextI, either globally or for a specific "MDIElementI".
|
void |
removeSaveBOListener(SaveBOListenerI l)
Removes the passed SaveBOListenerI from the list of listeners.
|
FormElementI |
reopenView(FormElementI fe) |
FormElementI |
reopenView(FormElementI fe,
Struktur useStruktur) |
FormElementI |
reopenView(FormElementI fe,
Struktur useStruktur,
boolean _reloadBO) |
void |
resetPassword(java.lang.String username) |
TransactionAnswer |
saveBO(Transaction tx)
Saves the provided transaction.
|
TransactionAnswer |
saveBO(Transaction tx,
boolean ignoreConflicts) |
void |
saveGlobals()
Saves global session variables and user preferences to the local machine configuration file.
|
void |
serverLocked()
Lifecycle hook triggered when the backend server enters maintenance lock mode.
|
void |
serverShutdown(java.util.Date dateShutdown)
Lifecycle hook invoked when the backend server has finalized shutdown.
|
void |
serverShutdownDefault(java.util.Date dateNow,
java.util.Date dateShutdown)
Default UI fallback executed upon finalized server shutdown.
|
void |
serverShutdownInitiated(int cSecsDelay,
java.lang.String msg)
Lifecycle hook triggered when a server shutdown process begins.
|
void |
serverShutdownInitiatedDefault(int cSecsDelay)
Convenience overload for
serverShutdownInitiatedDefault(int, String) without an explicit broadcast notice. |
void |
serverShutdownInitiatedDefault(int cSecsDelay,
java.lang.String msg)
Default UI fallback handler for an initiated server shutdown.
|
void |
serverShutdownStopped()
Lifecycle hook triggered when an active server shutdown sequence is canceled.
|
void |
serverShutdownStoppedDefault()
Default UI fallback handler when a server shutdown sequence is canceled.
|
void |
serverUnlocked()
Lifecycle hook triggered when the backend server leaves maintenance lock mode.
|
void |
setActions(java.util.HashMap $171) |
void |
setAllActions(java.util.LinkedHashMap $172) |
void |
setAllToolBars(java.util.HashMap $173) |
void |
setCachedServerDesc(java.lang.String $177) |
void |
setConfiguredMaxHeap(java.lang.String $181) |
void |
setConfiguredMinHeap(java.lang.String $180) |
void |
setDateLoggedOn(java.util.Date $179) |
void |
setDefaultDialogParent(java.awt.Component $169) |
void |
setDefaultFocusOwner(javax.swing.JComponent $176) |
void |
setEmptyMDIFocus() |
void |
setFolders(java.util.HashMap $170) |
void |
setGlobalVar(java.lang.String name,
java.lang.Object value)
Deprecated.
|
void |
setMenuBar(javax.swing.JMenuBar c) |
void |
setMenuManager(ClientMenuManager $175) |
void |
setPathClientLogTxt(java.lang.String $178) |
void |
setSchema(SchemaI $168) |
void |
setScript(BeanShellScript s) |
void |
setShowBOProperties(boolean _showBOProperties) |
void |
setShowHiddenProperties(boolean _showHiddenProperties) |
void |
setShowHistory(boolean _showHistory) |
void |
setStrukturCache(StrukturCache $174) |
void |
setTitle()
Sets the user-definable latter part of the title of the main client-window to the passed String.
|
void |
setTitle(java.lang.String userTitleString) |
java.math.BigDecimal |
showBigDecimalInputDialog(java.lang.String s,
java.lang.String title,
java.math.BigDecimal oldValue,
boolean nullAllowed)
Shows a modal dialog for
BigDecimal input. |
int |
showConfirmDialog(java.lang.String s) |
int |
showConfirmDialog(java.lang.String s,
java.lang.String title) |
int |
showConfirmDialog(java.lang.String s,
java.lang.String title,
boolean forceAffirmation,
java.lang.String affirmationText,
java.lang.String affirmationString)
Displays a confirmation dialog offering YES, NO, and CANCEL options, with optional
affirmation text required for confirmation.
|
java.util.Date |
showDateInputDialog(java.lang.String s,
java.lang.String title,
java.util.Date oldValue,
boolean nullAllowed,
java.lang.String format)
Shows a modal dialog for
Date input. |
java.lang.Object |
showError(java.lang.String s) |
java.lang.Object |
showError(java.lang.String s,
java.lang.Throwable throwableToShow) |
java.lang.Object |
showError(java.lang.String s,
java.lang.Throwable throwableToShow,
boolean suppressPrintCausedBy) |
java.lang.Object |
showError(java.lang.String s,
java.lang.Throwable throwableToShow,
boolean suppressPrintCausedBy,
java.lang.String title) |
java.lang.Object |
showError(java.lang.String s,
java.lang.Throwable ex,
boolean suppressPrintCausedBy,
java.lang.String title,
java.lang.Object[] buttons)
Shows an error message, controlling whether the "Caused by" trace is printed in the details.
|
java.lang.Object |
showError(java.lang.String s,
java.lang.Throwable throwableToShow,
java.lang.String title) |
java.lang.Object |
showError(java.lang.String s,
java.lang.Throwable throwableToShow,
java.lang.String title,
boolean deprecatedForceSynchronous) |
java.lang.Object |
showError(java.lang.String s,
java.lang.Throwable throwableToShow,
java.lang.String title,
boolean deprecatedForceSynchronous,
boolean takeScreenshot) |
java.lang.Object |
showError(java.lang.String s,
java.lang.Throwable throwableToShow,
java.lang.String title,
boolean deprecatedForceSynchronous,
boolean takeScreenshot,
boolean suppressPrintCausedBy) |
java.lang.Object |
showError(java.lang.String s,
java.lang.Throwable ex,
java.lang.String title,
boolean deprecatedForceSynchronous,
java.lang.Object[] buttons)
Shows an error message in a modal dialog with an optional exception stack trace.
|
java.lang.Object |
showException(java.lang.Throwable throwableToShow) |
java.lang.Object |
showException(java.lang.Throwable throwableToShow,
boolean deprecatedForceSynchronous) |
java.lang.Object |
showException(java.lang.Throwable ex,
boolean deprecatedForceSynchronous,
java.lang.Object[] buttons)
Shows an exception stack trace in a dialog without a custom error message.
|
java.io.File |
showFileChooser(java.lang.String title,
java.lang.String approveText,
java.lang.String key,
int selectionMode,
boolean quiet,
javax.swing.filechooser.FileFilter filter,
javax.swing.JComponent accessory,
java.io.File preselectedFile,
java.io.File fallbackLastUsedDir,
int dialogType)
Internal and Legacy routing method for single file / directory selections.
|
java.io.File[] |
showFilesChooser(java.lang.String title,
java.lang.String approveText,
java.lang.String key,
int selectionMode,
javax.swing.filechooser.FileFilter filter,
javax.swing.JComponent accessory,
java.io.File fallbackLastUsedDir)
Legacy multiple file routing method.
|
java.io.File |
showFolderChooser(java.lang.String title,
java.lang.String key,
boolean quiet,
java.io.File preselectedFile)
Opens a native dialog strictly tailored to select a FOLDER / DIRECTORY.
|
java.lang.Integer |
showIntegerInputDialog(java.lang.String s,
java.lang.String title,
java.lang.Integer oldValue,
boolean nullAllowed)
Shows a modal dialog for
Integer input. |
java.lang.Object |
showListChoiceDialog(java.lang.String title,
java.lang.Object[] options) |
java.lang.Object |
showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
int defaultIndex)
Shows a simple list choice dialog with a default choice index.
|
java.lang.Object |
showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
int defaultIndex,
java.lang.String cboFormat) |
java.lang.Object |
showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
int defaultIndex,
java.lang.String cboFormat,
boolean multiple)
Shows a dialog window that allows the user to select one or more from the provided options.
|
java.lang.Object |
showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
java.lang.Object defaultChoice)
Shows a simple list choice dialog with a default choice object.
|
java.lang.Object |
showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
java.lang.Object defaultChoice,
java.lang.String cboFormat) |
java.lang.Object |
showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
java.lang.Object defaultChoice,
java.lang.String cboFormat,
boolean multiple)
Shows a dialog window that allows the user to select one or more from the provided options.
|
java.lang.Long |
showLongInputDialog(java.lang.String s,
java.lang.String title,
java.lang.Long oldValue,
boolean nullAllowed)
Shows a modal dialog for
Long input. |
void |
showMessageDialog(java.lang.String s) |
void |
showMessageDialog(java.lang.String s,
java.lang.String type) |
void |
showMessageDialog(java.lang.String s,
java.lang.String type,
java.lang.String title)
Shows a modal message dialog that blocks execution until the user dismisses it.
|
void |
showMessageDialogNonModal(java.lang.String s) |
void |
showMessageDialogNonModal(java.lang.String s,
java.lang.String type) |
void |
showMessageDialogNonModal(java.lang.String s,
java.lang.String type,
java.lang.String title)
Shows a non-modal message dialog that does not block background execution.
|
java.lang.Object[] |
showMultiListChoiceDialog(java.lang.String title,
java.lang.Object[] options) |
java.lang.Object[] |
showMultiListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
java.lang.Object[] defaultChoices) |
java.lang.Object[] |
showMultiListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
java.lang.Object[] defaultChoices,
java.lang.String cboFormat)
Shows a dialog window that allows the user to select one or more from the provided options.
|
java.lang.Object |
showMultipleChoiceDialog(java.lang.String s,
java.lang.String title,
java.lang.Object[] options) |
java.lang.Object |
showMultipleChoiceDialog(java.lang.String s,
java.lang.String title,
java.lang.Object[] options,
int defaultIndex)
Shows a multiple choice dialog (checkbox style) with a default index.
|
java.io.File |
showOpenFileChooser(java.lang.String title,
java.lang.String key,
boolean quiet,
javax.swing.filechooser.FileFilter filter)
Opens a native OPEN dialog strictly tailored to select a SINGLE EXISTING FILE.
|
java.io.File[] |
showOpenFilesChooser(java.lang.String title,
java.lang.String key,
javax.swing.filechooser.FileFilter filter,
java.io.File preselectedFile)
Opens a native OPEN dialog configured to select MULTIPLE EXISTING FILES.
|
void |
showReportIssueForm(java.awt.image.BufferedImage screenshot,
java.lang.String stackTrace,
java.lang.String shownError) |
java.io.File |
showSaveFileChooser(java.lang.String title,
java.lang.String key,
javax.swing.filechooser.FileFilter filter,
boolean quiet,
java.io.File preselectedFile)
Opens a native SAVE dialog with an input field for defining a file name.
|
java.lang.String |
showStringInputDialog(java.lang.String s) |
java.lang.String |
showStringInputDialog(java.lang.String s,
java.lang.String title) |
java.lang.String |
showStringInputDialog(java.lang.String message,
java.lang.String title,
java.lang.String oldValue,
boolean multilineInput,
boolean passwordInput)
Shows a modal dialog for string input.
|
void |
showSystemMessageDialogNonModal(java.lang.String s) |
void |
showSystemMessageDialogNonModal(java.lang.String s,
java.lang.String type) |
void |
showSystemMessageDialogNonModal(java.lang.String s,
java.lang.String type,
java.lang.String title) |
void |
showSystemMessageDialogNonModal(java.lang.String s,
java.lang.String type,
java.lang.String title,
int maxLengthLines) |
void |
showSystemMessageDialogNonModal(java.lang.String s,
java.lang.String type,
java.lang.String title,
int maxLengthLines,
de.ipcon.swing.IconKeys iconKey) |
java.util.Date[] |
showTimespanInputDialog(java.lang.String s,
java.lang.String title,
java.util.Date oldValueStart,
java.util.Date oldValueEnd,
boolean startNullAllowed,
boolean endNullAllowed,
java.lang.String format)
Shows a modal dialog for inputting a start and end date timespan.
|
java.lang.String[] |
showUserLoginDialog(java.lang.String message,
java.lang.String title,
java.lang.String user)
Shows a dialog prompting for username and password, with an optionally pre-filled username.
|
boolean |
showYesNoDialog(java.lang.String s)
Shows a simple modal dialog asking a Yes/No question.
|
void |
startBOClassesInitializer() |
void |
startL10nPackPrefetcher()
Initiates the prefetching of localization packs.
|
void |
startWaitFeedback()
Lifecycle hook meant to be overridden by UI subclasses to activate
visual waiting indicators (like hourglass cursors or progress bars).
|
void |
submitAction(java.awt.event.ActionEvent a) |
void |
suggestGC() |
void |
trackLRUAccess(Formular form,
java.lang.Long boId,
java.lang.String title,
FormContextI ftx)
For tracking LRU forms in the persistent session (`Sitzung`).
|
void |
trackLRUAccess(Lesezeichen bookmark,
java.lang.String title)
For tracking LRU bookmarks in the persistent session (`Sitzung`).
|
void |
trackLRUAccess(Report report,
java.lang.String title)
For tracking LRU reports in the persistent session (`Sitzung`).
|
void |
trackReadAccess(Struktur structure)
Updates the read access statistics for the passed Struktur.
|
void |
transactionSaveSuccess(Transaction stubTx,
java.util.Map<java.lang.Long,java.lang.Long> tempIdToDbIdMap,
java.util.function.Predicate<Transaction> isSavedTransactionInstancePredicate)
Notifies all registered SaveBOListenerI-s about a successfully saved Transaction via the transactionSaveSuccess-callback.
|
void |
updateDawn()
Deprecated.
|
void |
updateServerHealth(DBManServerHealthEvent she)
Lifecycle hook triggered on server health updates.
|
void |
windowActivated(java.awt.event.WindowEvent e) |
void |
windowClosed(java.awt.event.WindowEvent e) |
void |
windowClosing(java.awt.event.WindowEvent e) |
void |
windowDeactivated(java.awt.event.WindowEvent e) |
void |
windowDeiconified(java.awt.event.WindowEvent e) |
void |
windowIconified(java.awt.event.WindowEvent e) |
void |
windowOpened(java.awt.event.WindowEvent e) |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitaddActions, getFtx, getTemplatesForSubEntitiesInAdminsOrdner, getTemplatesForSubEntitiesInAdminsOrdner, hasMDIManager, removeActions, showReportIssueForm, takeScreenshot, takeScreenshot, takeScreenshot, usesMultiWindowManager, usesSingleOrMultiWindowManager, usesSingleWindowManagersaveWithRetries, saveWithRetriesshowFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFolderChooser, showFolderChooser, showFolderChooser, showOpenFileChooser, showOpenFileChooser, showOpenFileChooser, showOpenFileChooser, showOpenFilesChooser, showOpenFilesChooser, showOpenFilesChooser, showSaveFileChooser, showSaveFileChooser, showSaveFileChooser, showSaveFileChooser, showSaveFileChoosershowBigDecimalInputDialog, showBigDecimalInputDialog, showBigDecimalInputDialog, showConfirmDialog, showConfirmDialog, showDateInputDialog, showDateInputDialog, showDateInputDialog, showDateInputDialog, showIntegerInputDialog, showIntegerInputDialog, showIntegerInputDialog, showLongInputDialog, showLongInputDialog, showLongInputDialog, showPasswordInputDialog, showPasswordInputDialog, showStringInputDialog, showStringInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showUserLoginDialoggetDawnMachineID, getOriginHashpublic static java.io.File log4jconf
public static java.net.URL jnlpCodeBase
public static boolean jnlpstart
public Client(java.lang.String _server)
Initializes the internal session state and starts the asynchronous ClientEventNotifier
daemon thread to handle backend events without blocking the UI.
public Client(java.lang.String _server,
java.lang.String username)
public Client(java.lang.String _server,
java.lang.String username,
java.lang.String pass)
public Client(java.lang.String _server,
java.lang.String username,
java.lang.String pass,
java.lang.String _pathClientLogTxt)
public Client(java.lang.String _server,
java.lang.String username,
java.lang.String pass,
java.lang.String _pathClientLogTxt,
java.lang.String minHeap)
public Client(java.lang.String _server,
java.lang.String username,
java.lang.String pass,
java.lang.String _pathClientLogTxt,
java.lang.String minHeap,
java.lang.String maxHeap)
public Client(java.lang.String _server,
java.lang.String username,
java.lang.String pass,
java.lang.String _pathClientLogTxt,
java.lang.String minHeap,
java.lang.String maxHeap,
java.lang.String _projectName)
public FormattedChoiceDialogI getDialogHelper()
getDialogHelper in interface ClientContextI@Deprecated public Benutzer getCurrentUser()
getCurrentUser in interface de.ipcon.db.core.BasicClientContextI@Deprecated public java.util.Map<java.lang.String,java.lang.Object> getGlobalVars()
getGlobalVars in interface de.ipcon.db.core.BasicClientContextI@Deprecated
public void setGlobalVar(java.lang.String name,
java.lang.Object value)
setGlobalVar in interface de.ipcon.db.core.BasicClientContextI@Deprecated public java.lang.Object getGlobalVar(java.lang.String name)
getGlobalVar in interface de.ipcon.db.core.BasicClientContextIpublic java.awt.Component getDialogParent()
Determines the optimal parent component for modal dialogs. Typically returns the active MDI (Multiple Document Interface) frame, or a default fallback during login.
getDialogParent in interface de.ipcon.db.core.BasicClientContextIpublic CodebausteinStorageI getCodebausteinStorage()
getCodebausteinStorage in interface ClientContextIpublic BackendConnectionManagerI getBackendConnectionManager()
ClientContextIgetBackendConnectionManager in interface ClientContextIBackendConnectionManagerI instance.public BOLoaderI getBOLoader()
getBOLoader in interface de.ipcon.db.core.BasicClientContextIpublic DBManEventProviderI getEventProvider()
getEventProvider in interface de.ipcon.db.core.BasicClientContextIpublic FulltextSearcherI getFulltextSearcher()
Checks if Fulltext Search (FTS) is available on the backend and returns the searcher instance if so.
getFulltextSearcher in interface ClientContextIpublic java.util.List<ClientPluginI> getPlugins()
getPlugins in interface ClientContextIpublic java.lang.String getServerName()
getServerName in interface ClientContextIpublic java.lang.String getInstanceName()
getInstanceName in interface ClientContextIpublic boolean isConnected()
isConnected in interface ClientContextIpublic boolean isConnected(boolean failfast)
isConnected in interface ClientContextIpublic boolean isMemoryTightClient()
isMemoryTightClient in interface ClientContextIpublic boolean isMemoryTightClient(boolean failfast)
isMemoryTightClient in interface ClientContextIpublic DBManInfo getDBManInfo()
ClientContextIgetDBManInfo in interface ClientContextIpublic Transaction getNewFormTransaction()
FormTransactionBuilderIgetNewFormTransaction in interface FormTransactionBuilderIpublic Transaction getNewFormTransaction(java.lang.String desc)
FormTransactionBuilderIgetNewFormTransaction in interface FormTransactionBuilderIdesc - transaction description; may be nullpublic Transaction getNewTransaction()
getNewTransaction in interface de.ipcon.db.core.TransactionBuilderIpublic Transaction getNewTransaction(java.lang.String desc)
getNewTransaction in interface de.ipcon.db.core.TransactionBuilderIpublic Transaction getNewTransaction(TemporaryIdSupplierI tempIdSupplier)
getNewTransaction in interface de.ipcon.db.core.TransactionBuilderIpublic Transaction getNewTransaction(java.lang.String desc, TemporaryIdSupplierI tempIdSupplier)
getNewTransaction in interface de.ipcon.db.core.TransactionBuilderIpublic Transaction getNewTransactionWithInstrumentedSchema()
getNewTransactionWithInstrumentedSchema in interface de.ipcon.db.core.TransactionBuilderIpublic Transaction getNewTransactionWithInstrumentedSchema(java.lang.String desc)
getNewTransactionWithInstrumentedSchema in interface de.ipcon.db.core.TransactionBuilderIpublic Transaction getNewTransactionWithInstrumentedSchema(TemporaryIdSupplierI tempIdSupplier)
getNewTransactionWithInstrumentedSchema in interface de.ipcon.db.core.TransactionBuilderIpublic Transaction getNewTransactionWithInstrumentedSchema(java.lang.String desc, TemporaryIdSupplierI tempIdSupplier)
getNewTransactionWithInstrumentedSchema in interface de.ipcon.db.core.TransactionBuilderIpublic Transaction getNewTransaction(BOLoaderI loader)
public Transaction getNewTransaction(BOLoaderI loader, SchemaI txSchema)
public Transaction getNewTransaction(BOLoaderI loader, SchemaI txSchema, java.lang.String desc)
public Transaction getNewTransaction(BOLoaderI loader, SchemaI txSchema, java.lang.String desc, TemporaryIdSupplierI tempIdSupplier)
loader - The BO loader to use.txSchema - The schema to use (optional).desc - A description for the transaction (optional).tempIdSupplier - A supplier for temporary IDs (optional).Transaction.java.lang.IllegalStateException - if not connected to a server.public boolean isShowHiddenProperties()
isShowHiddenProperties in interface ClientContextIpublic void setShowHiddenProperties(boolean _showHiddenProperties)
public boolean isShowBOProperties()
isShowBOProperties in interface ClientContextIpublic void setShowBOProperties(boolean _showBOProperties)
public boolean isShowHistory()
isShowHistory in interface ClientContextIpublic void setShowHistory(boolean _showHistory)
public java.io.File getLog4JConfigFile()
getLog4JConfigFile in interface ClientContextIpublic javax.swing.JRootPane determineRootPane(FormContextI ftx)
ClientContextIdetermineRootPane in interface ClientContextIftx - The FormContextI instance to start the search from.public javax.swing.JRootPane determineRootPaneViaFallback(FormContextI rootFtx)
rootFtx - The root FormContextI instance containing the direct JRootPane or the element.public java.lang.String getUniquePrefix()
getUniquePrefix in interface ClientContextIpublic void setTitle()
public void setTitle(java.lang.String userTitleString)
setTitle in interface ClientContextIpublic void processLocaleChanged(java.util.Locale oldLocale,
java.util.Locale newLocale)
processLocaleChanged in interface L10nLocaleChangeListenerIpublic void processPreloadFinished(java.util.Locale forLocale)
processPreloadFinished in interface PreloadL10nCacheFinishedListenerIpublic void processConnectionEvent(ConnectionEvent ce)
ConnectionEvent that affects the current connection.
Implementation of ConnectionEventListenerI.
Routes connection loss and establishment events into the asynchronous ClientEventNotifier.
processConnectionEvent in interface ConnectionEventListenerIpublic void processDBManEvent(DBManEvent event)
DBManBOChangeEvent for events triggered after modification on BOs.
Routes generic database manager events into the asynchronous ClientEventNotifier thread or immediately processes critical local user BO changes.
processDBManEvent in interface DBManEventListenerIpublic void updateServerHealth(DBManServerHealthEvent she)
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.updateServerHealth(DBManServerHealthEvent).
she - backend server health event payloadClientServerEventHandler.updateServerHealth(DBManServerHealthEvent)public void forcedClientDisconnectInitiated(int cSecsDelay,
java.lang.String msg)
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.forcedClientDisconnectInitiated(int, String).
cSecsDelay - countdown delay in centiseconds before disconnect takes effectmsg - optional notice or disconnection reason from the serverClientServerEventHandler.forcedClientDisconnectInitiated(int, String)public void forcedClientDisconnectInitiatedDefault(int cSecsDelay)
forcedClientDisconnectInitiatedDefault(int, String) without an explicit notice.
Preserved for backward compatibility. Delegates to forcedClientDisconnectInitiatedDefault(int, String)
passing null for the message.
cSecsDelay - countdown delay in centiseconds before disconnect takes effectforcedClientDisconnectInitiatedDefault(int, String)public void forcedClientDisconnectInitiatedDefault(int cSecsDelay,
java.lang.String msg)
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.forcedClientDisconnectInitiatedDefault(int, String).
cSecsDelay - countdown delay in centiseconds before disconnect takes effectmsg - optional notice or disconnection reason from the serverClientServerEventHandler.forcedClientDisconnectInitiatedDefault(int, String)public void forcedClientDisconnectStopped()
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.forcedClientDisconnectStopped().
public void forcedClientDisconnectStoppedDefault()
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.forcedClientDisconnectStoppedDefault().
public void serverShutdownInitiated(int cSecsDelay,
java.lang.String msg)
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.serverShutdownInitiated(int, String).
cSecsDelay - shutdown countdown delay in centisecondsmsg - optional broadcast notice from the server administratorClientServerEventHandler.serverShutdownInitiated(int, String)public void serverShutdownInitiatedDefault(int cSecsDelay)
serverShutdownInitiatedDefault(int, String) without an explicit broadcast notice.
Preserved for backward compatibility. Delegates to serverShutdownInitiatedDefault(int, String)
passing an empty message string.
cSecsDelay - shutdown countdown delay in centisecondsserverShutdownInitiatedDefault(int, String)public void serverShutdownInitiatedDefault(int cSecsDelay,
java.lang.String msg)
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.serverShutdownInitiatedDefault(int, String).
cSecsDelay - shutdown countdown delay in centisecondsmsg - optional broadcast notice from the server administratorClientServerEventHandler.serverShutdownInitiatedDefault(int, String)public void serverShutdownStopped()
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.serverShutdownStopped().
public void serverShutdownStoppedDefault()
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.serverShutdownStoppedDefault().
public void serverShutdown(java.util.Date dateShutdown)
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.serverShutdown(Date).
dateShutdown - timestamp when the server terminatedClientServerEventHandler.serverShutdown(Date)public void serverShutdownDefault(java.util.Date dateNow,
java.util.Date dateShutdown)
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.serverShutdownDefault(Date, Date).
dateNow - current client timestampdateShutdown - timestamp when the server terminatedClientServerEventHandler.serverShutdownDefault(Date, Date)public void receivedSystemMessage(java.lang.String msg,
java.lang.String sender)
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.receivedSystemMessage(String, String).
msg - broadcast message payloadsender - originating user or server authority identifierClientServerEventHandler.receivedSystemMessage(String, String)public void receivedSystemMessageDefault(java.lang.String msg)
receivedSystemMessageDefault(String, String) without an explicit sender.
Preserved for backward compatibility. Delegates to receivedSystemMessageDefault(String, String)
passing an empty sender string.
msg - broadcast message payloadreceivedSystemMessageDefault(String, String)public void receivedSystemMessageDefault(java.lang.String msg,
java.lang.String sender)
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.receivedSystemMessageDefault(String, String).
msg - broadcast message payloadsender - originating user or server authority identifierClientServerEventHandler.receivedSystemMessageDefault(String, String)public void serverLocked()
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.serverLocked().
ClientServerEventHandler.serverLocked()public void serverUnlocked()
Preserved for backward compatibility. Delegates to
ClientServerEventHandler.serverUnlocked().
public static void main(java.lang.String[] args)
This method is called when the client is launched using the following methods:
args - The command line arguments.public static void politeMain(java.lang.String[] args)
This method is invoked when the client is launched via the "LogWindow" GUI button, which is configured in the "Server.jnlp" (Java Web Start), "server.dst" (dawn) or Windows command line server start script "server.cmd" for some older projects. It initializes the RepaintManager with a custom implementation (IRepaintManager) and then delegates to the mainStart method to perform the actual client startup.
args - The command line arguments.public static void mainStart(java.lang.String[] args)
This method performs the core initialization and startup logic for the client application. It processes the command line arguments, sets up the necessary environment, and launches the logon window or the main client window if correct credentials were passed and logon was successful.
args - The command line arguments._pathClientLogTxt - The path to the client log file (optional).public static void mainStart(java.lang.String[] args,
java.lang.String _pathClientLogTxt)
public void afterConnectServer()
Subscribes to connection events, updates the waiting flag, and clears stale caches.
public boolean connectionAvailableNow()
SchemaIncompatibleException - if the connRunner reported that as errorpublic void killEventNotifier()
public BeanShellScript getScript()
getScript in interface de.ipcon.db.core.BasicClientContextIpublic void setScript(BeanShellScript s)
setScript in interface de.ipcon.db.core.BasicClientContextIpublic void initScript()
Sets up standard imports (GUI, BOs, Utils), injects default constants (like D_ZERO),
and binds the current client context to the script engine environment.
public void passwordChangeInLogonDialogInitiated()
When a password change is required, the user is active, so any inactivity timer needs to be stopped to prevent an accidental disconnect or timeout during the password update process. This method cancels the "inactivityDisconnectTimerTask", if it exists, to ensure the user is not disconnected prematurely.
passwordChangeInLogonDialogInitiated in interface ClientContextIpublic void trackReadAccess(Struktur structure)
ClientContextItrackReadAccess in interface ClientContextIpublic void trackLRUAccess(Lesezeichen bookmark, java.lang.String title)
ClientContextItrackLRUAccess in interface ClientContextIpublic void trackLRUAccess(Formular form, java.lang.Long boId, java.lang.String title, FormContextI ftx)
ClientContextItrackLRUAccess in interface ClientContextIpublic void trackLRUAccess(Report report, java.lang.String title)
ClientContextItrackLRUAccess in interface ClientContextI@Deprecated public Folder getFolder(EntityI ent)
public Folder getFolder(java.lang.String path)
ClientContextIgetFolder in interface ClientContextIpublic Folder[] getFolderChildren(Folder parent)
ClientContextIgetFolderChildren in interface ClientContextIpublic Struktur getAutomatikStrukturForPath(java.lang.String path)
AutomatikStrukturLoaderIgetAutomatikStrukturForPath in interface AutomatikStrukturLoaderIpath - a String containing the path to the automatically generated structure element that shall be loadedpublic Struktur getAutomatikStrukturForPath(java.lang.String path, boolean reload)
AutomatikStrukturLoaderIgetAutomatikStrukturForPath in interface AutomatikStrukturLoaderIpath - a String containing the path to the automatically generated structure element that shall be loadedreload - force a reloadpublic Struktur getAutomatikStrukturForPath(java.lang.String path, boolean reload, boolean directOnly)
AutomatikStrukturLoaderIgetAutomatikStrukturForPath in interface AutomatikStrukturLoaderIpath - a String containing the path to the automatically generated structure element that shall be loadedreload - force a reloaddirectOnly - only return structure that is for the entity directly, that is resolved from the path, no parent class structurepublic Struktur getAutomatikStrukturForPath(java.lang.String path, boolean reload, boolean directOnly, EntityI[] entitiesOnly)
AutomatikStrukturLoaderIgetAutomatikStrukturForPath in interface AutomatikStrukturLoaderIpath - a String containing the path to the automatically generated structure element that shall be loadedreload - force a reloaddirectOnly - only return structure that is for the entity directly, that is resolved from the path, no parent class structureentitiesOnly - only returns structure of the passed EntityI; no restriction if nullpublic ClientLoginDialog provideLogonGUI(java.lang.String _server, java.lang.String _user, java.lang.String _passwd, java.lang.String _pathClientLogTxt, boolean _actionPWChange)
public void startL10nPackPrefetcher()
This method schedules the prefetching process to run on the Event Dispatch Thread (EDT)
via SPU.onEDTv(java.lang.Object, java.lang.Runnable). It is a high-level entry point that kicks off the asynchronous
loading of localization resources.
startL10nPackPrefetcher in interface ClientContextIpublic void prefetchL10nPacksGUI()
This method, intended to be run on the EDT, updates the status message in the login
dialog to inform the user about the prefetching process. It then delegates the
actual data loading to preloadL10nPacks(Locale) by offloading the task
to a separate thread via SPU.offEDTAndWaitv(java.lang.Object, java.lang.Runnable) and waiting for its completion.
Finally, it updates the status message to "ready" and logs the time taken for the process.
public void startBOClassesInitializer()
public void clientLoginActivity(java.awt.AWTEvent e)
ClientLoginDialogActivityListenerIclientLoginActivity in interface ClientLoginDialogActivityListenerIpublic void authenticate(java.lang.String username,
java.lang.String pass)
throws AuthenticationException,
PasswordChangeRequiredException
authenticate in interface ClientContextIAuthenticationExceptionPasswordChangeRequiredExceptionpublic void authenticate(java.lang.String username,
java.lang.String pass,
boolean inhibitInitFeatureManager)
throws AuthenticationException,
PasswordChangeRequiredException
authenticate in interface ClientContextIAuthenticationExceptionPasswordChangeRequiredExceptionpublic void authenticate(java.lang.String username,
java.lang.String pass,
boolean inhibitInitFeatureManager,
java.lang.String originHash)
throws AuthenticationException,
PasswordChangeRequiredException
authenticate in interface ClientContextIAuthenticationExceptionPasswordChangeRequiredExceptionpublic void resetPassword(java.lang.String username)
resetPassword in interface ClientContextIpublic boolean isNotificationSystemActivated()
isNotificationSystemActivated in interface ClientContextIpublic void logon()
logon in interface ClientContextIpublic void initLogonSubscriptions()
Listens for server health events, operational state changes (lock/shutdown), and business object change events for the currently logged-in user.
public boolean isLoggingOn()
isLoggingOn in interface ClientContextIpublic de.ipcon.swing.WindowManagerType getCurrentRunningWindowManagerType()
WindowManagerType corresponding to the currently active desktop manager instance.WindowManagerType, or null if no manager is initialized or recognizedpublic de.ipcon.swing.WindowManagerType getWindowManagerType()
getWindowManagerType in interface ClientContextIWindowManagerType, or null if none is configured or matches.public FeatureManagerI getFeatureManager()
getFeatureManager in interface ClientContextIFeatureManagerI instance.public void action_reloadProfile()
public java.awt.Image getLogo()
getLogo in interface ClientContextIpublic java.util.Collection<java.lang.String> getProjectThemeLocations()
public void logonOnEDT(de.ipcon.swing.WindowState lastWindowState)
lastWindowState - last saved window layout and scale parameters (optional)public boolean queryPluginFlag(java.lang.Class _clazz,
java.lang.String _methName)
throws java.lang.IllegalAccessException,
java.lang.reflect.InvocationTargetException
java.lang.IllegalAccessExceptionjava.lang.reflect.InvocationTargetExceptionpublic boolean queryPluginFlag(java.lang.Class _clazz,
java.lang.String _methName,
boolean _default)
throws java.lang.IllegalAccessException,
java.lang.reflect.InvocationTargetException
java.lang.IllegalAccessExceptionjava.lang.reflect.InvocationTargetExceptionpublic void addVisualComponent(java.lang.String container,
javax.swing.JComponent c,
java.lang.String position)
addVisualComponent in interface ClientContextIpublic void addVisualComponent(javax.swing.JComponent c,
java.lang.String position)
addVisualComponent in interface ClientContainerIaddVisualComponent in interface ClientContextIpublic void registerClientContainer(java.lang.String name,
ClientContainerI cc)
registerClientContainer in interface ClientContextIpublic javax.swing.JFrame registerMDIManagerInstance(java.lang.String name,
MDIManagerI mdiman)
registerMDIManagerInstance in interface ClientContextIpublic void setMenuBar(javax.swing.JMenuBar c)
setMenuBar in interface ClientContextIpublic java.util.Map getGlobalActions(FormContextI ftx)
getGlobalActions in interface ClientContextIpublic void addAction(FormAction fa)
This method registers an action with the ClientContextI, making it available globally by adding it to the global action map.
The method also handles special cases for actions that are not local and are registered in a multi-window environment.
addAction in interface ClientContextIfa - The action to add.java.lang.IllegalArgumentException - If a non-local, non-prototype action is registered in a multi-window environment.public void addAction(FormAction fa, MDIElementI mdie)
ClientContextIThis method registers an action with the ClientContextI, making it available either globally or for a specific "MDIElementI". If an "MDIElementI" is provided, the action is associated with that element; otherwise, it is added to the global action map.
addAction in interface ClientContextIfa - The action to add.mdie - The "MDIElementI" to associate the action with (optional).public void removeAction(FormAction fa)
ClientContextIThis method unregisters an action globally from the ClientContextI by removing it from the global action map.
removeAction in interface ClientContextIfa - The action to remove.public void removeAction(FormAction fa, MDIElementI mdie)
ClientContextIThis method unregisters an action from the ClientContextI, either globally or for a specific "MDIElementI". If an "MDIElementI" is provided, the action is removed from that element; otherwise, it is removed from the global action map.
removeAction in interface ClientContextIfa - The action to remove.mdie - The "MDIElementI" to remove the action from (optional).public void refreshActions()
refreshActions in interface ClientContextIpublic void refreshActionsOnEDT()
public void refreshActionsOnEDT(boolean sync)
public void checkActionsEnabledStatus()
public javax.swing.JFrame getMainFrame()
getMainFrame in interface ClientContextIpublic javax.swing.JMenu getMenu(java.lang.String s)
getMenu in interface ClientContextIpublic void action_serverConsole()
public void action_groovyConsole()
public void action_toggleHiddenProperties(FormAction action)
public void action_toggleBOProperties(FormAction action)
public void action_toggleHistory(FormAction action)
public void action_zoomIn()
public void action_zoomReset()
public void action_zoomOut()
public void fireStatusChanged()
public void action_syncNG()
public void action_exportSystemObjects()
public void action_importSystemObjects()
public void action_openL10n()
public void action_schemaTool()
public void action_switchToMultiWindowDesktopManager()
public boolean action_switchToMultiWindowDesktopManager_available()
public void action_switchToSingleWindowDesktopManager()
public boolean action_switchToSingleWindowDesktopManager_available()
public void action_saveProfile()
Delegates window position serialization to ClientProfileSettingsHelper.saveWindowPosition(de.ipcon.swing.WindowState)
before committing persistent session storage.
public boolean action_changeGuiThemeToDefault_available()
public void action_changeGuiThemeToDefault()
Delegates XML profile cleanup and persistence to
ClientProfileSettingsHelper.resetGuiThemeToDefault().
public void action_changePW()
public void action_quit()
public void action_about()
public void action_keys()
public void action_importLicense()
public void action_changeLocale()
public void action_takeScreenshot()
This method captures a screenshot of the active window (if using a multi-window manager) or the main frame (if using a single-window manager). It then prompts the user to select a location and filename to save the screenshot as a PNG file.
If the screenshot is successfully saved, a confirmation message is displayed. If any errors occur during the process, an error message is shown.
ae - The "ActionEvent" associated with the screenshot request (optional).public void action_takeScreenshot(java.awt.event.ActionEvent ae)
public boolean isIssueReportFormEnabled()
isIssueReportFormEnabled in interface ClientContextIpublic void action_showReportIssueForm(BO sourceBO, Struktur sourceStruktur)
public void action_showReportIssueForm(BO sourceBO, Struktur sourceStruktur, java.awt.event.ActionEvent ae)
public void showReportIssueForm(java.awt.image.BufferedImage screenshot,
java.lang.String stackTrace,
java.lang.String shownError)
showReportIssueForm in interface ClientContextIpublic void action_installDawn()
@Deprecated public void updateDawn()
public boolean isClosed()
isClosed in interface ClientContextIpublic void close()
Closes the client session, unsubscribes from all server and connection events, and forcibly stops the event notifier thread.
close in interface ClientContextIpublic void close(boolean processLogoffScript)
processLogoffScript - if true and not serverDown, then gui.logoff scripts are processed before
shutting down the client and saving globals. Defaults to false.public void closeWithConfirmation()
closeWithConfirmation in interface ClientContextIpublic void setEmptyMDIFocus()
setEmptyMDIFocus in interface ClientContextIpublic void applyDefaults(electric.xml.Element e,
java.lang.Object[] l10nPath)
applyDefaults in interface de.ipcon.db.core.StrukturParameterDefaultApplierIpublic MDIElementI getMDIElementForBO(BO bo)
getMDIElementForBO in interface ClientContextIpublic FormElementI getFormElementForBO(BO bo)
getFormElementForBO in interface ClientContextIpublic FormElementI openNew(Schablone s)
openNew in interface ClientContextIpublic FormElementI openNew(Schablone s, java.util.Map parameters)
openNew in interface ClientContextIpublic FormElementI openNew(Schablone s, java.util.Map parameters, FormElementI origin)
ClientContextISchablone and parameters and opens it relative to the optional origin formopenNew in interface ClientContextIs - the template to create the new BO with, nonnull.parameters - a nullable map of parameters for the templateorigin - a nullable FormElementI to open the new view relative topublic FormElementI openForm(Formular form, BO bo, java.util.Map parameters, FormElementI origin)
ClientContextIopenForm in interface ClientContextIform - the form definition to displaybo - the business object to bind to the formparameters - optional parameter map passed to the form instanceorigin - the initiating UI component for focus tracking and window hierarchypublic FormElementI openForm(Formular form, BO bo)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, BO bo, java.util.Map parameters)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, BO bo, java.util.Map parameters, java.lang.String title)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType)
public FormElementI openForm(Formular form, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds)
public FormElementI openForm(Formular form, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds, boolean maximize)
public FormElementI openForm(Formular form, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds, boolean maximize, boolean ignoreOpenInstance)
public FormElementI openForm(Formular form, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds, boolean maximize, boolean ignoreOpenInstance, boolean reuseOpenIfNew)
public FormElementI openForm(Formular form, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds, boolean maximize, boolean ignoreOpenInstance, boolean reuseOpenIfNew, boolean skipTxLoadedNewBOs)
form - the form definition to displaybo - the business object to bind to the formparameters - optional parameter map passed to the form instancetitle - custom window title, or null to use the form's defaultftx - custom form context, or null for default resolutionmassChange - true if opened in batch/mass-edit mode; false otherwiseviewType - explicit desktop view mode (defaults to MDIManagerI.VIEWTYPE_FORMULAR)forcedBounds - explicit initial screen bounds, or null for default positioningmaximize - true to open the window maximized; false for standard boundsignoreOpenInstance - true to force a new window even if an instance for this BO is already openreuseOpenIfNew - true to allow reusing an open window even when the BO is newly createdskipTxLoadedNewBOs - true to prevent auto-including/frapping newly created BOs loaded by the form's transactionpublic FormElementI openForm(Formular form, Transaction tx, BO bo)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map parameters)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds, boolean maximize)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds, boolean maximize, boolean ignoreOpenInstance)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds, boolean maximize, boolean ignoreOpenInstance, boolean reuseOpenIfNew)
public FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds, boolean maximize, boolean ignoreOpenInstance, boolean reuseOpenIfNew, boolean skipTxLoadedNewBOs)
public FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map parameters, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds, boolean maximize, boolean ignoreOpenInstance, boolean reuseOpenIfNew, boolean skipTxLoadedNewBOs, FormElementI origin)
form - the form definition to displaytx - the transaction managing the lifecycle and persistence of the BObo - the business object to bind to the formparameters - optional parameter map passed to the form instancetitle - custom window title, or null to use the form's defaultftx - custom form context, or null for default resolutionmassChange - true if opened in batch/mass-edit mode; false otherwiseviewType - explicit desktop view mode (defaults to MDIManagerI.VIEWTYPE_FORMULAR)forcedBounds - explicit initial screen bounds, or null for default positioningmaximize - true to open the window maximized; false for standard boundsignoreOpenInstance - true to force a new window even if an instance for this BO is already openreuseOpenIfNew - true to allow reusing an open window even when the BO is newly createdskipTxLoadedNewBOs - true to prevent auto-including/frapping newly created BOs loaded by the form's transactionorigin - the initiating UI component, or nullpublic FormElementI openView(Lesezeichen l)
openView in interface ClientContextIpublic FormElementI openView(Lesezeichen l, java.util.Map parameters)
ClientContextIopenView in interface ClientContextIl - the bookmark to open, nonnull.parameters - a nullable or empty map, which can include additional parameters to initialize the bookmark with.public FormElementI openView(BO bo)
openView in interface ClientContextIpublic FormElementI openView(BO bo, java.util.Map parameters)
openView in interface ClientContextIpublic FormElementI openView(BO bo, java.util.Map parameters, java.lang.String title)
openView in interface ClientContextIpublic FormElementI openView(BO bo, java.util.Map parameters, java.lang.String title, boolean reloadFormList)
openView in interface ClientContextIpublic FormElementI openView(BO bo, java.util.Map parameters, java.lang.String title, boolean reloadFormList, boolean useAutomatic)
openView in interface ClientContextIpublic FormElementI reopenView(FormElementI fe)
reopenView in interface ClientContextIpublic FormElementI reopenView(FormElementI fe, Struktur useStruktur)
reopenView in interface ClientContextIpublic FormElementI reopenView(FormElementI fe, Struktur useStruktur, boolean _reloadBO)
reopenView in interface ClientContextIpublic FormElementI preparePrinting(java.lang.String entityName, java.lang.String reportName, BO bo)
preparePrinting in interface ClientContextIpublic FormElementI preparePrinting(java.lang.String entityName, java.lang.String reportName, BO bo, java.lang.String title)
preparePrinting in interface ClientContextIpublic FormElementI preparePrinting(java.lang.String entityName, java.lang.String reportName, BO[] bos)
preparePrinting in interface ClientContextIpublic FormElementI preparePrinting(java.lang.String entityName, java.lang.String reportName, BO[] bos, java.lang.String title)
preparePrinting in interface ClientContextIpublic FormElementI preparePrinting(Report report, BO bo)
preparePrinting in interface ClientContextIpublic FormElementI preparePrinting(Report report, BO bo, java.lang.String title)
preparePrinting in interface ClientContextIpublic FormElementI preparePrinting(Report report, BO[] bos)
preparePrinting in interface ClientContextIpublic FormElementI preparePrinting(Report report, BO[] bos, java.lang.String title)
preparePrinting in interface ClientContextIpublic FormElementI preparePrinting(Report report, BO[] bos, java.lang.String title, FormElementI owner)
preparePrinting in interface ClientContextIpublic java.lang.String getWindowTitle(BO bo) throws java.lang.IllegalArgumentException
getWindowTitle in interface ClientContextIjava.lang.IllegalArgumentExceptionpublic java.lang.String getWindowTitle(BO bo, java.lang.String explicitDescription) throws java.lang.IllegalArgumentException
java.lang.IllegalArgumentExceptionpublic java.lang.String getWindowTitle(BO bo, java.lang.String explicitDescription, boolean skipEntity) throws java.lang.IllegalArgumentException
getWindowTitle in interface ClientContextIjava.lang.IllegalArgumentExceptionpublic FormContextI getClientFtx()
This context serves as the execution environment for global desktop actions, such as
application-wide menu and toolbar actions marked as local="true" (e.g. dynamic LRU history items).
It is distinct from individual, form-specific contexts.
Returns the primary desktop FormContextI instance. This context is typically configured
as the execution context for application-level actions marked as "local" (such as dynamic
history menu actions).
getClientFtx in interface ClientContextIFormContextIpublic Struktur[] getStrukturenForSearchString(java.lang.String searchString, int searchType)
public Struktur[] getStrukturenForSearchString(java.lang.String searchString, int searchType, boolean reload)
public Struktur[] getStrukturenForSearchString(java.lang.String searchString, int searchType, boolean reload, boolean directOnly)
public Struktur[] getStrukturenForSearchString(java.lang.String searchString, int searchType, boolean reload, boolean directOnly, EntityI[] entitiesOnly)
ClientContextIgetStrukturenForSearchString in interface ClientContextIsearchString - the String to which the entities are comparedsearchType - defines the type of matching done. see DynamischerOrdnerreload - force a reloaddirectOnly - only return structure that is for the entity directly, that is resolved from the path, no parent class structureentitiesOnly - only returns structure of the passed EntityI; no restriction if nullpublic Struktur[] getStrukturenForEntity(java.lang.String entityName)
ClientContextIgetStrukturenForEntity in interface ClientContextIentityName - The entity name for which to collect the structurespublic Struktur[] getStrukturenForEntity(java.lang.String entityName, boolean reload)
ClientContextIgetStrukturenForEntity in interface ClientContextIentityName - The entity name for which to collect the structuresreload - force a reloadpublic Struktur[] getStrukturenForEntity(java.lang.String entityName, boolean reload, boolean directOnly)
ClientContextIgetStrukturenForEntity in interface ClientContextIentityName - The entity name for which to collect the structuresreload - force a reloaddirectOnly - only return structures that are for the entity directly, no parent class structurespublic Struktur[] getStrukturenForEntity(java.lang.String entityName, boolean reload, boolean directOnly, EntityI[] entitiesOnly)
ClientContextIgetStrukturenForEntity in interface ClientContextIentityName - The entity name for which to collect the structuresreload - force a reloaddirectOnly - only return structures that are for the entity directly, no parent class structuresentitiesOnly - only adds structures of the passed EntityI; no restriction if nullpublic Schablone[] getTemplates(EntityI e)
ClientContextISchablone instances associated with the specified entity from the cache, sorted by priority
in descending order (highest priority first). Equivalent to calling ClientContextI.getTemplates(EntityI, boolean) with
reload = false.getTemplates in interface ClientContextIe - the target entity for which to retrieve templatesSchablone instances, or an empty array if none are foundClientContextI.getTemplates(EntityI, boolean)public Schablone[] getTemplates(EntityI e, boolean reload)
ClientContextISchablone instances associated with the specified entity, sorted by priority
in descending order (highest priority first). Only templates assigned to at least one group of the
current user are returned.getTemplates in interface ClientContextIe - the target entity for which to retrieve templatesreload - if true, forces a fresh database query; if false, cached instances from
the StrukturCache may be usedSchablone instances, or an empty array if none are foundpublic Schablone[] getTemplatesForSubEntitiesInAdminsOrdner(EntityI e, boolean reload, boolean uniqueEntities, java.util.Set entitiesToExclude)
ClientContextIPolymorphicTemplateSelectionTree).getTemplatesForSubEntitiesInAdminsOrdner in interface ClientContextIe - the parent entity defining the polymorphic subtree scopereload - if true, forces a fresh database query bypass of the cacheuniqueEntities - if true, restricts the output to at most one template per sub-entity typeentitiesToExclude - optional set of EntityI instances to skip during traversal; may be nullSchablone instances assigned to the current user's groupspublic Formular[] getForms(EntityI e)
ClientContextIFormular instances associated with the specified entity from the cache, sorted by priority
in descending order (highest priority first). Equivalent to calling ClientContextI.getForms(EntityI, boolean) with
reload = false.getForms in interface ClientContextIe - the target entity for which to retrieve formsFormular instances, or an empty array if none are foundClientContextI.getForms(EntityI, boolean)public Formular[] getForms(EntityI e, boolean reload)
ClientContextIFormular instances associated with the specified entity, sorted by priority
in descending order (highest priority first). Only forms assigned to at least one group of the
current user are returned.getForms in interface ClientContextIe - the target entity for which to retrieve formsreload - if true, forces a fresh database query; if false, cached instances from
the StrukturCache may be usedFormular instances, or an empty array if none are foundpublic Lesezeichen[] getBookmarks(EntityI e)
ClientContextILesezeichen instances associated with the specified entity from the cache, sorted by priority
in descending order (highest priority first). Equivalent to calling ClientContextI.getBookmarks(EntityI, boolean) with
reload = false.getBookmarks in interface ClientContextIe - the target entity for which to retrieve bookmarksLesezeichen instances, or an empty array if none are foundClientContextI.getBookmarks(EntityI, boolean)public Lesezeichen[] getBookmarks(EntityI e, boolean reload)
ClientContextILesezeichen instances associated with the specified entity, sorted by priority
in descending order (highest priority first). Only bookmarks assigned to at least one group of the
current user are returned.getBookmarks in interface ClientContextIe - the target entity for which to retrieve bookmarksreload - if true, forces a fresh database query; if false, cached instances from
the StrukturCache may be usedLesezeichen instances, or an empty array if none are foundpublic Report[] getReports(EntityI e)
ClientContextIReport instances associated with the specified entity from the cache, sorted by priority
in descending order (highest priority first). Equivalent to calling ClientContextI.getReports(EntityI, boolean) with
reload = false.getReports in interface ClientContextIe - the target entity for which to retrieve reportsReport instances, or an empty array if none are foundClientContextI.getReports(EntityI, boolean)public Report[] getReports(EntityI e, boolean reload)
ClientContextIReport instances associated with the specified entity, sorted by priority
in descending order (highest priority first). Only reports assigned to at least one group of the
current user are returned.getReports in interface ClientContextIe - the target entity for which to retrieve reportsreload - if true, forces a fresh database query; if false, cached instances from
the StrukturCache may be usedReport instances, or an empty array if none are foundpublic Schablone getTemplateByTid(java.lang.String tid, java.lang.String entityName)
ClientContextISchablone uniquely identified by its tid and entity name. Only templates assigned to at least one
group of the current user are returned.getTemplateByTid in interface ClientContextItid - the tid of the templateentityName - the simple name of the target entitySchablone, or null if no template matches or if no matching template is assigned to at
least one group of the current user; if multiple templates match, the one with the highest priority is returnedpublic Formular getFormByTid(java.lang.String tid, java.lang.String entityName)
ClientContextIFormular uniquely identified by its tid and entity name. Only forms assigned to at least one
group of the current user are returned.getFormByTid in interface ClientContextItid - the tid of the formentityName - the simple name of the target entityFormular, or null if no form matches or if no matching form is assigned to at
least one group of the current user; if multiple forms match, the one with the highest priority is returnedpublic Lesezeichen getBookmarkByTid(java.lang.String tid, java.lang.String entityName)
ClientContextILesezeichen uniquely identified by its tid and entity name. Only bookmarks assigned to at least one
group of the current user are returned.getBookmarkByTid in interface ClientContextItid - the tid of the bookmarkentityName - the simple name of the target entityLesezeichen, or null if no bookmark matches or if no matching bookmark is assigned to at
least one group of the current user; if multiple bookmarks match, the one with the highest priority is returnedpublic Report getReportByTid(java.lang.String tid, java.lang.String entityName)
ClientContextIReport uniquely identified by its tid and entity name. Only reports assigned to at least one
group of the current user are returned.getReportByTid in interface ClientContextItid - the tid of the reportentityName - the simple name of the target entityReport, or null if no report matches or if no matching report is assigned to at
least one group of the current user; if multiple reports match, the one with the highest priority is returnedpublic MDIManagerI getMDIManager()
getMDIManager in interface ClientContextIpublic void submitAction(java.awt.event.ActionEvent a)
submitAction in interface ClientContextIpublic TransactionAnswer saveBO(Transaction tx)
saveBO methods, the default
value of the ignoreConflicts argument is 1/true here that is
ignoreConflicts is activated if this parameter is missing (for
backwards compatibility).
If saving was successful, then the transaction won't be active anymore. If saving wasn't successful, then
the transaction is still active, but might've fixed any conflicts and probably succeeds if saved again.
But there are no guarentees about data integrity in the latter case, e.g. if the same attribute was changed, which is the 'real' value?saveBO in interface TransactionProviderItx - the Transaction to savepublic TransactionAnswer saveBO(Transaction tx, boolean ignoreConflicts)
saveBO in interface TransactionProviderIpublic void transactionSaveSuccess(Transaction stubTx, java.util.Map<java.lang.Long,java.lang.Long> tempIdToDbIdMap, java.util.function.Predicate<Transaction> isSavedTransactionInstancePredicate)
transactionSaveSuccess in interface SaveBOListenerIstubTx - A shallow copy (stub) of the saved Transaction object. This object contains
all the business data of the transaction but is detached from any active
persistence context. It is intended for read-only use, such as updating
display logic or triggering post-save business processes.tempIdToDbIdMap - A map containing the original temporary IDs of new entities
within the transaction as keys, and their newly assigned persistent
database IDs as values. This is crucial for updating references to
these entities in local data structures. A key-value pair of
(tempId, dbId) indicates that the entity with tempId was saved
and now has dbId.isSavedTransactionInstancePredicate - A predicate to verify if a given
Transaction instance is the same object that was just saved. This is
particularly useful in scenarios where multiple instances of a transaction
might exist in memory. By using this predicate, callers can efficiently
identify the specific instance that needs to be updated or processed,
avoiding redundant operations. The predicate returns true if the provided
transaction is the same instance, and false otherwise.public void addSaveBOListener(SaveBOListenerI sbl)
addSaveBOListener in interface ClientContextIpublic void removeSaveBOListener(SaveBOListenerI l)
removeSaveBOListener in interface ClientContextIpublic void bringUsToFront()
bringUsToFront in interface ClientContextIpublic void windowOpened(java.awt.event.WindowEvent e)
windowOpened in interface java.awt.event.WindowListenerpublic void windowClosing(java.awt.event.WindowEvent e)
windowClosing in interface java.awt.event.WindowListenerpublic void windowClosed(java.awt.event.WindowEvent e)
windowClosed in interface java.awt.event.WindowListenerpublic void windowIconified(java.awt.event.WindowEvent e)
windowIconified in interface java.awt.event.WindowListenerpublic void windowDeiconified(java.awt.event.WindowEvent e)
windowDeiconified in interface java.awt.event.WindowListenerpublic void windowActivated(java.awt.event.WindowEvent e)
windowActivated in interface java.awt.event.WindowListenerpublic void windowDeactivated(java.awt.event.WindowEvent e)
windowDeactivated in interface java.awt.event.WindowListenerpublic void action_flushCaches()
public void flushCaches()
flushCaches in interface ClientContextIpublic void action_flatlafDefaults()
public void action_flatlafInspector(java.awt.event.ActionEvent event)
public void suggestGC()
suggestGC in interface ClientContextIpublic void startWaitFeedback()
ClientContextIstartWaitFeedback in interface ClientContextIpublic void endWaitFeedback()
ClientContextIendWaitFeedback in interface ClientContextIpublic java.lang.String executeCommand(java.lang.String cmd)
executeCommand in interface ClientContextIpublic void showSystemMessageDialogNonModal(java.lang.String s)
public void showSystemMessageDialogNonModal(java.lang.String s,
java.lang.String type)
public void showSystemMessageDialogNonModal(java.lang.String s,
java.lang.String type,
java.lang.String title)
public void showSystemMessageDialogNonModal(java.lang.String s,
java.lang.String type,
java.lang.String title,
int maxLengthLines)
public void showSystemMessageDialogNonModal(java.lang.String s,
java.lang.String type,
java.lang.String title,
int maxLengthLines,
de.ipcon.swing.IconKeys iconKey)
public java.io.File showSaveFileChooser(java.lang.String title,
java.lang.String key,
javax.swing.filechooser.FileFilter filter,
boolean quiet,
java.io.File preselectedFile)
BasicFileChooserINote: Native OS save dialogs inherently support single-file selection only.
showSaveFileChooser in interface BasicFileChooserItitle - The title of the dialog.key - The key under which this selection context is stored in the session (LRU dir tracking).filter - The file filter to apply natively.quiet - If true, suppresses the UI if the start directory is already set.preselectedFile - The file to be initially selected (pre-fills the save input field).File to save to, or null if canceled.public java.io.File showOpenFileChooser(java.lang.String title,
java.lang.String key,
boolean quiet,
javax.swing.filechooser.FileFilter filter)
BasicFileChooserIshowOpenFileChooser in interface BasicFileChooserItitle - The title of the dialog.key - The key under which this selection context is stored in the session (LRU dir tracking).quiet - If true, suppresses the UI if the start directory is already set.filter - The file filter to apply.File, or null if canceled.public java.io.File showFolderChooser(java.lang.String title,
java.lang.String key,
boolean quiet,
java.io.File preselectedFile)
BasicFileChooserINote: Native operating systems enforce directory selection via their "Open" dialog interface, even when the application intends to use the selected folder as a save/export destination.
showFolderChooser in interface BasicFileChooserItitle - The title of the dialog (e.g. "Select Export Folder").key - The key under which this selection context is stored in the session (LRU dir tracking).quiet - If true, suppresses the UI if the start directory is already set.preselectedFile - An optional directory to navigate into initially. If the directory does not exist, the OS typically falls back to the nearest existing parent.File, or null if canceled.public java.io.File[] showOpenFilesChooser(java.lang.String title,
java.lang.String key,
javax.swing.filechooser.FileFilter filter,
java.io.File preselectedFile)
BasicFileChooserIshowOpenFilesChooser in interface BasicFileChooserItitle - The title of the dialog.key - The key under which this selection context is stored in the session (LRU dir tracking).filter - The file filter to apply.preselectedFile - A file to pre-select, positioning the user contextually.File objects, or null if canceled.public java.io.File showFileChooser(java.lang.String title,
java.lang.String approveText,
java.lang.String key,
int selectionMode,
boolean quiet,
javax.swing.filechooser.FileFilter filter,
javax.swing.JComponent accessory,
java.io.File preselectedFile,
java.io.File fallbackLastUsedDir,
int dialogType)
BasicFileChooserIshowFileChooser in interface BasicFileChooserItitle - The dialog title.approveText - The text on the approval button.key - The key under which this selection context is stored in the session (LRU dir tracking).selectionMode - The Swing selection mode constant.quiet - If true, skips the dialog if LRU is known.filter - The file filter to apply.accessory - A custom Swing component (forces Swing fallback natively).preselectedFile - The initially selected file.fallbackLastUsedDir - The directory to start in if no LRU exists.dialogType - The Swing dialog type (Open, Save, Custom).File, or null if canceled.public java.io.File[] showFilesChooser(java.lang.String title,
java.lang.String approveText,
java.lang.String key,
int selectionMode,
javax.swing.filechooser.FileFilter filter,
javax.swing.JComponent accessory,
java.io.File fallbackLastUsedDir)
BasicFileChooserIshowFilesChooser in interface BasicFileChooserItitle - The dialog title.approveText - The text on the approval button.key - The key under which this selection context is stored in the session (LRU dir tracking).selectionMode - The Swing selection mode constant.filter - The file filter to apply.accessory - A custom Swing component (forces Swing fallback natively).fallbackLastUsedDir - The directory to start in if no LRU exists.Files, or null if canceled.public void saveGlobals()
Note: Currently saves to a per-machine file, not strictly per-user, due to legacy constraints. Exceptions are caught and logged without disrupting execution flow.
public void loadGlobals()
public java.util.List queryBO(groovy.lang.GString gs)
gs - The GString query template.public java.util.List queryBO(java.lang.String query)
Implementation Note: Performs parameterized querying against the backend.
queryBO in interface de.ipcon.db.core.BasicClientContextIpublic java.util.List queryBO(java.lang.String query,
java.lang.Object[] params)
queryBO in interface de.ipcon.db.core.BasicClientContextIpublic BO getBO(java.lang.Long id, java.lang.Class classTip)
Retrieves a specific Business Object from the backend by its ID and Class.
getBO in interface de.ipcon.db.core.BasicClientContextIpublic boolean isServerAuthoritativeSyncServer()
isServerAuthoritativeSyncServer in interface de.ipcon.db.core.BasicClientContextIpublic SessionI getSession()
getSession in interface de.ipcon.db.core.BasicClientContextIpublic byte[] getBLOB(java.lang.Long id)
Retrieves binary large object (BLOB) data corresponding to the given ID from the backend.
getBLOB in interface de.ipcon.db.core.BasicClientContextIpublic byte[] getLocalFile(java.io.File infile)
getLocalFile in interface de.ipcon.db.core.BasicClientContextIpublic void putLocalFile(java.io.File outfile,
byte[] data)
putLocalFile in interface de.ipcon.db.core.BasicClientContextIpublic void putLocalFile(java.io.File outfile,
java.io.InputStream is)
putLocalFile in interface de.ipcon.db.core.BasicClientContextIpublic java.lang.Object showError(java.lang.String s)
showError in interface BasicMessageDialogIBasicMessageDialogI.showError(String, Throwable, String, boolean, Object[])public java.lang.Object showError(java.lang.String s,
java.lang.Throwable throwableToShow)
showError in interface BasicMessageDialogIBasicMessageDialogI.showError(String, Throwable, String, boolean, Object[])public java.lang.Object showError(java.lang.String s,
java.lang.Throwable throwableToShow,
java.lang.String title)
showError in interface BasicMessageDialogIBasicMessageDialogI.showError(String, Throwable, String, boolean, Object[])public java.lang.Object showError(java.lang.String s,
java.lang.Throwable throwableToShow,
java.lang.String title,
boolean deprecatedForceSynchronous)
showError in interface BasicMessageDialogIBasicMessageDialogI.showError(String, Throwable, String, boolean, Object[])public java.lang.Object showError(java.lang.String s,
java.lang.Throwable throwableToShow,
java.lang.String title,
boolean deprecatedForceSynchronous,
boolean takeScreenshot)
public java.lang.Object showError(java.lang.String s,
java.lang.Throwable throwableToShow,
boolean suppressPrintCausedBy,
java.lang.String title)
showError in interface BasicMessageDialogIBasicMessageDialogI.showError(String, Throwable, boolean, String, Object[])public java.lang.Object showError(java.lang.String s,
java.lang.Throwable throwableToShow,
boolean suppressPrintCausedBy)
showError in interface BasicMessageDialogIBasicMessageDialogI.showError(String, Throwable, boolean, String, Object[])public java.lang.Object showError(java.lang.String s,
java.lang.Throwable throwableToShow,
java.lang.String title,
boolean deprecatedForceSynchronous,
boolean takeScreenshot,
boolean suppressPrintCausedBy)
public java.lang.Object showError(java.lang.String s,
java.lang.Throwable ex,
java.lang.String title,
boolean deprecatedForceSynchronous,
java.lang.Object[] buttons)
BasicMessageDialogIshowError in interface BasicMessageDialogIs - The error message to display.ex - The exception that caused the error (may be null).title - The title of the dialog window.deprecatedForceSynchronous - Ignored for modern execution. Retained only for backward compatibility.buttons - An array of custom buttons to display, or null for default buttons.public java.lang.Object showError(java.lang.String s,
java.lang.Throwable ex,
boolean suppressPrintCausedBy,
java.lang.String title,
java.lang.Object[] buttons)
BasicMessageDialogIshowError in interface BasicMessageDialogIs - The error message to display.ex - The exception that caused the error (may be null).suppressPrintCausedBy - If true, suppresses the printing of the "Caused by" chain.title - The title of the dialog window.buttons - An array of custom buttons to display.public java.lang.Object showException(java.lang.Throwable throwableToShow)
showException in interface BasicMessageDialogIBasicMessageDialogI.showException(Throwable, boolean, Object[])public java.lang.Object showException(java.lang.Throwable throwableToShow,
boolean deprecatedForceSynchronous)
showException in interface BasicMessageDialogIBasicMessageDialogI.showException(Throwable, boolean, Object[])public java.lang.Object showException(java.lang.Throwable ex,
boolean deprecatedForceSynchronous,
java.lang.Object[] buttons)
BasicMessageDialogIshowException in interface BasicMessageDialogIex - The exception to display.deprecatedForceSynchronous - Ignored for modern execution. Retained only for backward compatibility.buttons - An array of custom buttons to display.public boolean showYesNoDialog(java.lang.String s)
BasicMessageDialogIshowYesNoDialog in interface BasicMessageDialogIs - The question/message to display.true if the user selects Yes, false if No or canceled.public int showConfirmDialog(java.lang.String s,
java.lang.String title,
boolean forceAffirmation,
java.lang.String affirmationText,
java.lang.String affirmationString)
BasicMessageDialogIImportant Note on Return Value and Scripting Languages:
This method returns an int result code from JOptionPane.
If this result is used in a language that implicitly converts integers to booleans (like NetRexx or Groovy):
JOptionPane.YES_OPTION (which is 0) evaluates to false.JOptionPane.NO_OPTION (which is 1) and JOptionPane.CANCEL_OPTION (which is 2) evaluate to true.This inversion can lead to significant logical errors if not handled explicitly.
showConfirmDialog in interface BasicMessageDialogIs - The primary text or question to display.title - The title of the dialog.forceAffirmation - If true, the user must type the affirmationString to enable the confirm button.affirmationText - The instructional text displayed above the input field.affirmationString - The specific string the user must enter to affirm the action.int indicating the user action (e.g. JOptionPane.YES_OPTION).
Note: Closing the dialog (e.g. via the close window button) will be interpreted as a cancel action.public java.lang.String showStringInputDialog(java.lang.String message,
java.lang.String title,
java.lang.String oldValue,
boolean multilineInput,
boolean passwordInput)
BasicMessageDialogIshowStringInputDialog in interface BasicMessageDialogImessage - The prompt message.title - The title of the dialog.oldValue - The initial value shown in the input field.multilineInput - If true, allows multiple lines of text input.passwordInput - If true, hides the input text (e.g. for password entry).null if canceled.public java.lang.Integer showIntegerInputDialog(java.lang.String s,
java.lang.String title,
java.lang.Integer oldValue,
boolean nullAllowed)
BasicMessageDialogIInteger input.showIntegerInputDialog in interface BasicMessageDialogIs - The prompt message.title - The title of the dialog.oldValue - The initial value shown in the input field.nullAllowed - If true, allows the user to leave the field empty (returns null).Integer entered by the user, or null if canceled/empty.public java.lang.Long showLongInputDialog(java.lang.String s,
java.lang.String title,
java.lang.Long oldValue,
boolean nullAllowed)
BasicMessageDialogILong input.showLongInputDialog in interface BasicMessageDialogIs - The prompt message.title - The title of the dialog.oldValue - The initial value shown in the input field.nullAllowed - If true, allows the user to leave the field empty (returns null).Long entered by the user, or null if canceled/empty.public java.math.BigDecimal showBigDecimalInputDialog(java.lang.String s,
java.lang.String title,
java.math.BigDecimal oldValue,
boolean nullAllowed)
BasicMessageDialogIBigDecimal input.showBigDecimalInputDialog in interface BasicMessageDialogIs - The prompt message.title - The title of the dialog.oldValue - The initial value shown in the input field.nullAllowed - If true, allows the user to leave the field empty (returns null).BigDecimal entered by the user, or null if canceled/empty.public java.util.Date showDateInputDialog(java.lang.String s,
java.lang.String title,
java.util.Date oldValue,
boolean nullAllowed,
java.lang.String format)
BasicMessageDialogIDate input.showDateInputDialog in interface BasicMessageDialogIs - The prompt message.title - The title of the dialog.oldValue - The initial value shown in the input field.nullAllowed - If true, allows the user to leave the field empty (returns null).format - The date format pattern (e.g. "yyyy-MM-dd").Date entered by the user, or null if canceled/empty.public java.util.Date[] showTimespanInputDialog(java.lang.String s,
java.lang.String title,
java.util.Date oldValueStart,
java.util.Date oldValueEnd,
boolean startNullAllowed,
boolean endNullAllowed,
java.lang.String format)
BasicMessageDialogIshowTimespanInputDialog in interface BasicMessageDialogIs - The prompt message.title - The title of the dialog.oldValueStart - The initial value for the start date.oldValueEnd - The initial value for the end date.startNullAllowed - If true, allows the start date field to be empty.endNullAllowed - If true, allows the end date field to be empty.format - The date format pattern (e.g. "yyyy-MM-dd").Date objects: [startDate, endDate], or null if canceled.public void showMessageDialogNonModal(java.lang.String s,
java.lang.String type,
java.lang.String title)
BasicMessageDialogIshowMessageDialogNonModal in interface BasicMessageDialogIs - The message content.type - The type of message (e.g. TYPE_INFO, TYPE_ERROR).title - The title of the dialog.public void showMessageDialog(java.lang.String s,
java.lang.String type,
java.lang.String title)
BasicMessageDialogIshowMessageDialog in interface BasicMessageDialogIs - The message content.type - The type of message (e.g. TYPE_INFO, TYPE_ERROR).title - The title of the dialog.public java.lang.Object showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
java.lang.Object defaultChoice,
java.lang.String cboFormat,
boolean multiple)
FormattedChoiceDialogIshowListChoiceDialog in interface FormattedChoiceDialogItitle - The title of the dialog window.options - A non-empty array of options.defaultChoice - The object to select by default.cboFormat - Optional. An explicit formatting string used to render Business Objects (BOs) in the list.
If null, the default BO formatting logic will be used.multiple - If true, multiple options can be selected.null.public java.lang.Object[] showMultiListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
java.lang.Object[] defaultChoices,
java.lang.String cboFormat)
FormattedChoiceDialogIshowMultiListChoiceDialog in interface FormattedChoiceDialogItitle - The title of the dialog window.options - A non-empty array of options.defaultChoices - An array of objects to select by default.cboFormat - Optional. An explicit formatting string used to render Business Objects (BOs) in the list.
If null, the default BO formatting logic will be used.null, if there were either no available options or
the user cancelled the selection.public java.lang.Object showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
int defaultIndex,
java.lang.String cboFormat,
boolean multiple)
FormattedChoiceDialogIshowListChoiceDialog in interface FormattedChoiceDialogItitle - The title of the dialog window.options - A non-empty array of options.defaultIndex - The index of the object to be selected by default.cboFormat - Optional. An explicit formatting string used to render Business Objects (BOs) in the list.
If null, the default BO formatting logic will be used.multiple - If true, multiple options can be selected.null.public java.lang.Object showMultipleChoiceDialog(java.lang.String s,
java.lang.String title,
java.lang.Object[] options,
int defaultIndex)
BasicMessageDialogIshowMultipleChoiceDialog in interface BasicMessageDialogIs - The message or question to display.title - The title of the dialog.options - An array of options to choose from.defaultIndex - The index of the option to check by default.null if canceled.public java.lang.String[] showUserLoginDialog(java.lang.String message,
java.lang.String title,
java.lang.String user)
BasicMessageDialogIshowUserLoginDialog in interface BasicMessageDialogImessage - The message or prompt to display.title - The title of the dialog.user - The initial username to pre-fill.[username, password], or null if canceled.public void showMessageDialog(java.lang.String s)
showMessageDialog in interface BasicMessageDialogIBasicMessageDialogI.showMessageDialog(String, String, String)public void showMessageDialog(java.lang.String s,
java.lang.String type)
showMessageDialog in interface BasicMessageDialogIBasicMessageDialogI.showMessageDialog(String, String, String)public void showMessageDialogNonModal(java.lang.String s)
showMessageDialogNonModal in interface BasicMessageDialogIBasicMessageDialogI.showMessageDialogNonModal(String, String, String)public void showMessageDialogNonModal(java.lang.String s,
java.lang.String type)
showMessageDialogNonModal in interface BasicMessageDialogIBasicMessageDialogI.showMessageDialogNonModal(String, String, String)public int showConfirmDialog(java.lang.String s)
showConfirmDialog in interface BasicMessageDialogIBasicMessageDialogI.showConfirmDialog(String, String, boolean, String, String)public int showConfirmDialog(java.lang.String s,
java.lang.String title)
showConfirmDialog in interface BasicMessageDialogIBasicMessageDialogI.showConfirmDialog(String, String, boolean, String, String)public java.lang.String showStringInputDialog(java.lang.String s)
showStringInputDialog in interface BasicMessageDialogIBasicMessageDialogI.showStringInputDialog(String, String, String, boolean, boolean)public java.lang.String showStringInputDialog(java.lang.String s,
java.lang.String title)
showStringInputDialog in interface BasicMessageDialogIBasicMessageDialogI.showStringInputDialog(String, String, String, boolean, boolean)public java.lang.Object showListChoiceDialog(java.lang.String title,
java.lang.Object[] options)
showListChoiceDialog in interface FormattedChoiceDialogIshowListChoiceDialog in interface BasicMessageDialogIBasicMessageDialogI.showListChoiceDialog(String, Object[], Object)public java.lang.Object showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
java.lang.Object defaultChoice,
java.lang.String cboFormat)
showListChoiceDialog in interface FormattedChoiceDialogI(multiple=false)public java.lang.Object showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
java.lang.Object defaultChoice)
BasicMessageDialogIshowListChoiceDialog in interface FormattedChoiceDialogIshowListChoiceDialog in interface BasicMessageDialogItitle - The title of the dialog window.options - A non-empty array of selectable options.defaultChoice - The object instance to select by default.null if canceled.(multiple=false, cboFormat=null)public java.lang.Object[] showMultiListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
java.lang.Object[] defaultChoices)
showMultiListChoiceDialog in interface FormattedChoiceDialogI(cboFormat=null)public java.lang.Object[] showMultiListChoiceDialog(java.lang.String title,
java.lang.Object[] options)
showMultiListChoiceDialog in interface FormattedChoiceDialogI(defaultChoices=null, cboFormat=null)public java.lang.Object showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
int defaultIndex,
java.lang.String cboFormat)
showListChoiceDialog in interface FormattedChoiceDialogI(multiple=false)public java.lang.Object showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
int defaultIndex)
BasicMessageDialogIshowListChoiceDialog in interface FormattedChoiceDialogIshowListChoiceDialog in interface BasicMessageDialogItitle - The title of the dialog window.options - A non-empty array of options.defaultIndex - The integer index of the option to be selected by default.null if canceled.(multiple=false, cboFormat=null)public java.lang.Object showMultipleChoiceDialog(java.lang.String s,
java.lang.String title,
java.lang.Object[] options)
showMultipleChoiceDialog in interface BasicMessageDialogIBasicMessageDialogI.showMultipleChoiceDialog(String, String, Object[], int)public SchemaI getSchema()
getSchema in interface de.ipcon.db.core.BasicClientContextIpublic void setSchema(SchemaI $168)
public java.awt.Component getDefaultDialogParent()
public void setDefaultDialogParent(java.awt.Component $169)
public java.util.HashMap getFolders()
public void setFolders(java.util.HashMap $170)
public java.util.HashMap getActions()
public void setActions(java.util.HashMap $171)
public java.util.LinkedHashMap getAllActions()
getAllActions in interface ClientContextIpublic void setAllActions(java.util.LinkedHashMap $172)
public java.util.HashMap getAllToolBars()
getAllToolBars in interface ClientContextIpublic void setAllToolBars(java.util.HashMap $173)
public StrukturCache getStrukturCache()
public void setStrukturCache(StrukturCache $174)
public ClientMenuManager getMenuManager()
public void setMenuManager(ClientMenuManager $175)
public javax.swing.JComponent getDefaultFocusOwner()
public void setDefaultFocusOwner(javax.swing.JComponent $176)
setDefaultFocusOwner in interface ClientContextIpublic java.lang.String getCachedServerDesc()
getCachedServerDesc in interface de.ipcon.db.core.BasicClientContextIpublic void setCachedServerDesc(java.lang.String $177)
public java.lang.String getPathClientLogTxt()
getPathClientLogTxt in interface ClientContextIpublic void setPathClientLogTxt(java.lang.String $178)
public java.util.Date getDateLoggedOn()
getDateLoggedOn in interface ClientContextIpublic void setDateLoggedOn(java.util.Date $179)
public java.lang.String getConfiguredMinHeap()
public void setConfiguredMinHeap(java.lang.String $180)
public java.lang.String getConfiguredMaxHeap()
public void setConfiguredMaxHeap(java.lang.String $181)
Copyright © 2000-2026 OAshi S.à r.l. All Rights Reserved.