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 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() |
void |
action_changeGuiThemeToDefault() |
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() |
void |
action_schemaTool() |
void |
action_serverConsole() |
void |
action_showReportIssueForm()
Displays the issue reporting form.
|
void |
action_showReportIssueForm(BO sourceBO) |
void |
action_showReportIssueForm(BO sourceBO,
Struktur sourceStruktur) |
void |
action_showReportIssueForm(BO sourceBO,
Struktur sourceStruktur,
java.awt.event.ActionEvent ae) |
void |
action_showReportIssueForm(BO sourceBO,
Struktur sourceStruktur,
java.awt.event.ActionEvent ae,
java.awt.image.BufferedImage screenshot) |
void |
action_showReportIssueForm(BO sourceBO,
Struktur sourceStruktur,
java.awt.event.ActionEvent ae,
java.awt.image.BufferedImage screenshot,
java.lang.String stackTrace) |
void |
action_showReportIssueForm(BO sourceBO,
Struktur sourceStruktur,
java.awt.event.ActionEvent ae,
java.awt.image.BufferedImage screenshot,
java.lang.String stackTrace,
java.lang.String shownError) |
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)
Modifies the XML of the given element according to the default settings.
|
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 |
buildFolderStructure()
Creates the root folder and then creates the folder structure for each entity
|
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.
|
void |
createOrFindFolder(EntityI ent)
Builds the temporary folder structure for the path of a given entity
|
FormElementI |
createPrintingDialog(Report report,
BO[] bos,
java.lang.String title,
FormElementI owner) |
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 |
downloadAndInstallDawn(java.lang.String from,
java.io.File dest) |
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 |
forcedClientDisconnectInitiated(int _cSecsDelay)
Lifecycle hook triggered when the server requests a forced client disconnect.
|
void |
forcedClientDisconnectInitiated(int _cSecsDelay,
java.lang.String _msg) |
void |
forcedClientDisconnectInitiatedDefault(int _cSecsDelay)
So it can be easily called from the script hook too.
|
void |
forcedClientDisconnectInitiatedDefault(int _cSecsDelay,
java.lang.String _msg) |
void |
forcedClientDisconnectStopped()
Lifecycle hook triggered when a forced client disconnect is aborted.
|
void |
forcedClientDisconnectStoppedDefault()
So it can be easily called from the script hook too.
|
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 ent)
Returns all
Lesezeichen instances associated with the specified entity from the cache, sorted by priority
in descending order (highest priority first). |
Lesezeichen[] |
getBookmarks(EntityI ent,
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() |
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)
returns the temporary folder for the path of the given entity
|
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 ent)
Returns all
Formular instances associated with the specified entity from the cache, sorted by priority
in descending order (highest priority first). |
Formular[] |
getForms(EntityI ent,
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.
|
Gruppe[] |
getGruppenSortiert()
Returns the
Gruppe entities the current Benutzer is a member of,
sorted according to their Prioritaet property in ascending order. |
java.lang.String |
getInstanceName() |
byte[] |
getLocalFile(java.io.File infile)
Reads a local file entirely into memory and returns its content as a byte array.
|
java.io.File |
getLog4JConfigFile() |
java.awt.Image |
getLogo() |
MDIElementI |
getMDIElementForBO(BO bo) |
MDIManagerI |
getMDIManager() |
javax.swing.JMenu |
getMenu(java.lang.String s) |
ClientMenuManager |
getMenuManager() |
int |
getMsgPopupAutocloseAfter() |
int |
getMsgPopupPosition() |
Transaction |
getNewFormTransaction()
Convenience method for creating a typical UI 'form transaction',
pre-populated with the current user and flagged to detect interactivity.
|
Transaction |
getNewFormTransaction(java.lang.String desc) |
Transaction |
getNewTransaction() |
Transaction |
getNewTransaction(BOLoaderI loader)
Central internal factory method to create and fully initialize a new database transaction.
|
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) |
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 ent)
Returns all
Report instances associated with the specified entity from the cache, sorted by priority
in descending order (highest priority first). |
Report[] |
getReports(EntityI ent,
boolean reload)
Returns all
Report instances associated with the specified entity, sorted by priority
in descending order (highest priority first). |
SchemaI |
getSchema() |
BeanShellScript |
getScript() |
AbstractScript |
getScriptServerLocked() |
AbstractScript |
getScriptServerUnlocked() |
AbstractScript |
getScriptShutdown() |
AbstractScript |
getScriptShutdownInitiated() |
AbstractScript |
getScriptShutdownStopped() |
AbstractScript |
getScriptSystemMessage() |
java.lang.String |
getServerName() |
SessionI |
getSession() |
StrukturCache |
getStrukturCache() |
Struktur[] |
getStrukturenForEntity(java.lang.String entity)
Returns all structures for a given entity-name
|
Struktur[] |
getStrukturenForEntity(java.lang.String entity,
boolean reload)
Returns all structures for a given entity-name
|
Struktur[] |
getStrukturenForEntity(java.lang.String entity,
boolean reload,
boolean directOnly)
Returns all structures for a given entity-name
|
Struktur[] |
getStrukturenForEntity(java.lang.String entity,
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 ent)
Returns all
Schablone instances associated with the specified entity from the cache, sorted by priority
in descending order (highest priority first). |
Schablone[] |
getTemplates(EntityI ent,
boolean reload)
Returns all
Schablone instances associated with the specified entity, sorted by priority
in descending order (highest priority first). |
Schablone[] |
getTemplatesForSubEntitiesInAdminsOrdner(EntityI ent,
boolean reload,
boolean uniqueEntities,
java.util.Set entitiesToExclude)
Internal specialized lookup for templates across polymorphic sub-entities located in administrator folders.
|
FormContextI |
getTemporaryFtx()
Creates and returns a temporary
FormContextI bound to this client's BO loader. |
java.lang.String |
getUniquePrefix()
Returns the unique prefix for the window-title, only being applied
for OS-managed windows when using the ClientNativeWindowManager.
|
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 |
isMemoryTightClient() |
boolean |
isMemoryTightClient(boolean failfast) |
boolean |
isMsgPopupWithButton() |
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)
Opens a form without an explicit Transaction context.
|
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map params) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map params,
FormElementI origin)
Opens a form with standard desktop defaults and an explicit UI origin.
|
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map params,
java.lang.String title) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map params,
java.lang.String title,
FormContextI ftx) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map params,
java.lang.String title,
FormContextI ftx,
boolean massChange) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map params,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map params,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds) |
FormElementI |
openForm(Formular form,
BO bo,
java.util.Map params,
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 params,
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 params,
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 params,
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)
Opens a form bound to the specified Transaction, dispatching synchronously to the EDT.
|
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map params) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map params,
java.lang.String title) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map params,
java.lang.String title,
FormContextI ftx) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map params,
java.lang.String title,
FormContextI ftx,
boolean massChange) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map params,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType) |
FormElementI |
openForm(Formular form,
Transaction tx,
BO bo,
java.util.Map params,
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 params,
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 params,
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 params,
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 params,
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 params,
java.lang.String title,
FormContextI ftx,
boolean massChange,
int viewType,
java.awt.Rectangle forcedBounds,
boolean maximize,
boolean ignoreOpenInstance,
boolean reuseOpenIfNew,
boolean skipTxLoadedNewBOs,
FormElementI origin) |
FormElementI |
openNew(Schablone s)
Open the given Schablone.
|
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)
Open the given Lesezeichen.
|
FormElementI |
openView(Lesezeichen l,
java.util.Map parameters) |
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 |
processLoginScript(java.lang.String timeToExecute)
Processes and executes login scripts bound to the current user and their associated groups.
|
void |
processLoginScript(java.lang.String timeToExecute,
boolean noTimeExecute) |
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)
Writes raw byte data out to a local file.
|
void |
putLocalFile(java.io.File outfile,
java.io.InputStream is)
Streams data from an InputStream out to a local file.
|
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)
Lifecycle hook triggered when a broadcast system message is received.
|
void |
receivedSystemMessage(java.lang.String _msg,
java.lang.String _sender) |
void |
receivedSystemMessageDefault(java.lang.String _msg)
So it can be easily called from the script hook too.
|
void |
receivedSystemMessageDefault(java.lang.String _msg,
java.lang.String _sender) |
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 server enters a locked state.
|
void |
serverShutdown(java.util.Date _dateShutdown)
Lifecycle hook triggered upon actual server shutdown.
|
void |
serverShutdownDefault(java.util.Date _dateNow,
java.util.Date _dateShutdown)
So it can be easily called from the script hook too.
|
void |
serverShutdownInitiated(int _cSecsDelay)
Lifecycle hook triggered when a server shutdown process begins.
|
void |
serverShutdownInitiated(int _cSecsDelay,
java.lang.String _msg) |
void |
serverShutdownInitiatedDefault(int _cSecsDelay)
So it can be easily called from the script hook too.
|
void |
serverShutdownInitiatedDefault(int _cSecsDelay,
java.lang.String _msg) |
void |
serverShutdownStopped()
Lifecycle hook triggered when a server shutdown process is aborted.
|
void |
serverShutdownStoppedDefault()
So it can be easily called from the script hook too.
|
void |
serverUnlocked()
Lifecycle hook triggered when the server leaves a locked state.
|
void |
setActions(java.util.HashMap $292) |
void |
setAllActions(java.util.LinkedHashMap $293) |
void |
setAllToolBars(java.util.HashMap $294) |
void |
setCachedServerDesc(java.lang.String $298) |
void |
setConfiguredMaxHeap(java.lang.String $310) |
void |
setConfiguredMinHeap(java.lang.String $309) |
void |
setDateLoggedOn(java.util.Date $308) |
void |
setDefaultDialogParent(java.awt.Component $290) |
void |
setDefaultFocusOwner(javax.swing.JComponent $297) |
void |
setEmptyMDIFocus() |
void |
setFolders(java.util.HashMap $291) |
void |
setGlobalVar(java.lang.String name,
java.lang.Object value)
Deprecated.
|
void |
setMenuBar(javax.swing.JMenuBar c) |
void |
setMenuManager(ClientMenuManager $296) |
void |
setMsgPopupAutocloseAfter(int $306) |
void |
setMsgPopupPosition(int pos) |
void |
setMsgPopupWithButton(boolean $307) |
void |
setPathClientLogTxt(java.lang.String $305) |
void |
setSchema(SchemaI $289) |
void |
setScript(BeanShellScript s) |
void |
setScriptServerLocked(AbstractScript $299) |
void |
setScriptServerUnlocked(AbstractScript $300) |
void |
setScriptShutdown(AbstractScript $302) |
void |
setScriptShutdownInitiated(AbstractScript $301) |
void |
setScriptShutdownStopped(AbstractScript $303) |
void |
setScriptSystemMessage(AbstractScript $304) |
void |
setShowBOProperties(boolean _showBOProperties) |
void |
setShowHiddenProperties(boolean _showHiddenProperties) |
void |
setShowHistory(boolean _showHistory) |
void |
setStrukturCache(StrukturCache $295) |
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 ex,
boolean suppressPrintCausedBy) |
java.lang.Object |
showError(java.lang.String s,
java.lang.Throwable ex,
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 sessionKey,
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 sessionKey,
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 sessionKey,
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 |
showMessageDialog(java.lang.String s,
java.lang.String type,
java.lang.String title,
int maxLengthLines,
boolean alwaysOnTop,
boolean sync)
Internal extended router for showing standardized message dialogs.
|
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 sessionKey,
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 sessionKey,
javax.swing.filechooser.FileFilter filter,
java.io.File preselectedFile)
Opens a native OPEN dialog configured to select MULTIPLE EXISTING FILES.
|
java.io.File |
showSaveFileChooser(java.lang.String title,
java.lang.String sessionKey,
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) |
void |
showSystemMessageDialogNonModal(java.lang.String s,
java.lang.String type,
java.lang.String title,
int maxLengthLines,
de.ipcon.swing.IconKeys iconKey,
int position) |
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() |
java.awt.image.BufferedImage |
takeScreenshot()
Takes a screenshot, either of the whole desktop or the passed Component.
|
java.awt.image.BufferedImage |
takeScreenshot(boolean wholeScreens) |
java.awt.image.BufferedImage |
takeScreenshot(boolean wholeScreens,
java.awt.Component c) |
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() |
void |
updateLinuxDawn() |
void |
updateServerHealth(DBManServerHealthEvent she)
Lifecycle hook triggered on server health updates.
|
void |
updateWindowsDawn() |
void |
waitAndHandleCompilationErrors(InstrumentingSchemaI is,
Benannt strref) |
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, removeActionssaveWithRetries, saveWithRetriesshowBigDecimalInputDialog, showBigDecimalInputDialog, showBigDecimalInputDialog, showConfirmDialog, showConfirmDialog, showDateInputDialog, showDateInputDialog, showDateInputDialog, showDateInputDialog, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFileChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFilesChooser, showFolderChooser, showFolderChooser, showFolderChooser, showIntegerInputDialog, showIntegerInputDialog, showIntegerInputDialog, showLongInputDialog, showLongInputDialog, showLongInputDialog, showOpenFileChooser, showOpenFileChooser, showOpenFileChooser, showOpenFileChooser, showOpenFilesChooser, showOpenFilesChooser, showOpenFilesChooser, showPasswordInputDialog, showPasswordInputDialog, showSaveFileChooser, showSaveFileChooser, showSaveFileChooser, showSaveFileChooser, showSaveFileChooser, showStringInputDialog, showStringInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showTimespanInputDialog, showUserLoginDialoggetDawnMachineID, getOriginHashpublic static java.io.File log4jconf
public static java.net.URL jnlpCodeBase
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)
@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()
BackendConnectionManagerI 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()
getDBManInfo in interface ClientContextIpublic Transaction getNewFormTransaction()
Convenience method for creating a typical UI 'form transaction', pre-populated with the current user and flagged to detect interactivity.
getNewFormTransaction in interface FormTransactionBuilderIpublic Transaction getNewFormTransaction(java.lang.String desc)
getNewFormTransaction in interface FormTransactionBuilderIpublic Transaction getNewTransaction(java.lang.String desc)
getNewTransaction in interface TransactionBuilderIpublic Transaction getNewTransaction(java.lang.String desc, TemporaryIdSupplierI tempIdSupplier)
getNewTransaction in interface TransactionBuilderIpublic Transaction getNewTransaction()
getNewTransaction in interface TransactionBuilderIpublic Transaction getNewTransaction(TemporaryIdSupplierI tempIdSupplier)
getNewTransaction in interface TransactionBuilderIpublic Transaction getNewTransactionWithInstrumentedSchema(java.lang.String desc)
getNewTransactionWithInstrumentedSchema in interface TransactionBuilderIpublic Transaction getNewTransactionWithInstrumentedSchema(java.lang.String desc, TemporaryIdSupplierI tempIdSupplier)
getNewTransactionWithInstrumentedSchema in interface TransactionBuilderIpublic Transaction getNewTransactionWithInstrumentedSchema()
getNewTransactionWithInstrumentedSchema in interface TransactionBuilderIpublic Transaction getNewTransactionWithInstrumentedSchema(TemporaryIdSupplierI tempIdSupplier)
getNewTransactionWithInstrumentedSchema in interface TransactionBuilderIpublic Transaction getNewTransaction(BOLoaderI loader)
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 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)
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)
determineRootPane 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 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 ClientContextIpublic Folder getFolder(EntityI ent)
public Folder getFolder(java.lang.String path)
getFolder in interface ClientContextIpublic void createOrFindFolder(EntityI ent)
public void buildFolderStructure()
public Folder[] getFolderChildren(Folder parent)
getFolderChildren 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 processLoginScript(java.lang.String timeToExecute)
Iterates through the VoreinstellungenElemente scripts. Executing the scripts
is done on a best-effort basis and will depend on the active server connection state.
timeToExecute - The identifier string indicating the execution phase (e.g. 'gui.login').noTimeExecute - If true, scripts without a specific timing definition will be executed unconditionally.public void processLoginScript(java.lang.String timeToExecute,
boolean noTimeExecute)
public FormContextI getTemporaryFtx()
FormContextI bound to this client's BO loader.public void initLogonSubscriptions()
Listens for server health events, operational state changes (lock/shutdown), and business object change events for the currently logged-in user.
public de.ipcon.swing.WindowManagerType getCurrentRunningWindowManagerType()
WindowManagerType corresponding to the currently active desktop manager instance.WindowManagerType, or null if no manager is initialized or recognizedpublic FeatureManagerI getFeatureManager()
FeatureManagerI instance.public Gruppe[] getGruppenSortiert()
Gruppe entities the current Benutzer is a member of,
sorted according to their Prioritaet property in ascending order.Gruppe objects.public int getMsgPopupPosition()
public void setMsgPopupPosition(int pos)
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.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()
public boolean action_changeGuiThemeToDefault_available()
public void action_changeGuiThemeToDefault()
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 java.awt.image.BufferedImage takeScreenshot()
throws java.awt.AWTException,
java.lang.InterruptedException
This method captures a screenshot of either the entire desktop or a specific component. When "wholeDesktop" is true, it captures all screens stitched together horizontally; otherwise, it captures the specified component. If no component is provided, it defaults to capturing the main frame.
Note that capturing the whole desktop may result in a black image under Linux when using Wayland, as Java's Robot class does not fully support Wayland.
wholeScreens - Whether to capture the whole screen(s) or just the specified component or main frame of the application.c - The component to capture. If null, the main frame of the application is captured.java.awt.AWTException - If an error occurs during the screenshot process.java.lang.InterruptedException - If the thread is interrupted during the screenshot process.public java.awt.image.BufferedImage takeScreenshot(boolean wholeScreens)
throws java.awt.AWTException,
java.lang.InterruptedException
java.awt.AWTExceptionjava.lang.InterruptedExceptionpublic java.awt.image.BufferedImage takeScreenshot(boolean wholeScreens,
java.awt.Component c)
throws java.awt.AWTException,
java.lang.InterruptedException
java.awt.AWTExceptionjava.lang.InterruptedExceptionpublic boolean isIssueReportFormEnabled()
public void action_showReportIssueForm()
This method opens the form for reporting an issue, allowing the user to provide details about the problem they encountered. The form can be pre-filled with information about the source of the issue, such as the associated business object (BO) or structure, as well as a screenshot of the application at the time of the issue.
If called from an exception dialog, the form can also include the stack trace and error message of the exception.
sourceBO - The BO associated with the issue (optional).sourceStruktur - The source structure (Struktur) associated with the issue (optional).ae - The ActionEvent that triggered the issue reporting (optional).screenshot - A pre-captured screenshot of the application or current window (optional).stackTrace - The stack trace of the exception, if applicable (optional).shownError - The error message displayed to the user, if applicable (optional).public void action_showReportIssueForm(BO sourceBO)
public void action_showReportIssueForm(BO sourceBO, Struktur sourceStruktur)
public void action_showReportIssueForm(BO sourceBO, Struktur sourceStruktur, java.awt.event.ActionEvent ae)
public void action_showReportIssueForm(BO sourceBO, Struktur sourceStruktur, java.awt.event.ActionEvent ae, java.awt.image.BufferedImage screenshot)
public void action_showReportIssueForm(BO sourceBO, Struktur sourceStruktur, java.awt.event.ActionEvent ae, java.awt.image.BufferedImage screenshot, java.lang.String stackTrace)
public void action_showReportIssueForm(BO sourceBO, Struktur sourceStruktur, java.awt.event.ActionEvent ae, java.awt.image.BufferedImage screenshot, java.lang.String stackTrace, java.lang.String shownError)
public void action_installDawn()
public void updateDawn()
public void updateLinuxDawn()
public void updateWindowsDawn()
public void downloadAndInstallDawn(java.lang.String from,
java.io.File dest)
public java.lang.Object showError(java.lang.String s,
java.lang.Throwable ex,
boolean suppressPrintCausedBy,
java.lang.String title)
showError in interface BasicDialogIBasicDialogI.showError(String, Throwable, boolean, String, Object[])public java.lang.Object showError(java.lang.String s,
java.lang.Throwable ex,
boolean suppressPrintCausedBy)
showError in interface BasicDialogIBasicDialogI.showError(String, Throwable, boolean, String, Object[])public java.lang.Object showError(java.lang.String s)
showError in interface BasicDialogIBasicDialogI.showError(String, Throwable, String, boolean, Object[])public java.lang.Object showError(java.lang.String s,
java.lang.Throwable throwableToShow)
showError in interface BasicDialogIBasicDialogI.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 BasicDialogIBasicDialogI.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 BasicDialogIBasicDialogI.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,
java.lang.String title,
boolean deprecatedForceSynchronous,
boolean _takeScreenshot,
boolean suppressPrintCausedBy)
public java.lang.Object showException(java.lang.Throwable throwableToShow)
showException in interface BasicDialogIBasicDialogI.showException(Throwable, boolean, Object[])public java.lang.Object showException(java.lang.Throwable throwableToShow,
boolean deprecatedForceSynchronous)
showException in interface BasicDialogIBasicDialogI.showException(Throwable, boolean, Object[])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()
public void setEmptyMDIFocus()
setEmptyMDIFocus in interface ClientContextIpublic void applyDefaults(electric.xml.Element e,
java.lang.Object[] l10nPath)
This method applies default settings to the specified XML element, based on the "defaults" property. These default settings are typically used to modify the source code or parameters for bookmarks and forms, according to the user's preferences defined in the "Voreinstellungen.Defaults" section of their profile.
The method iterates through the default settings and applies them to the corresponding elements within the XML structure. If a default setting is marked as "force", it will be applied even if the element already has a value for that attribute.
applyDefaults in interface StrukturParameterDefaultApplierIe - The XML element to modify.l10nPath - The localization path used for resolving localized strings in the default settings.java.lang.IllegalArgumentException - If the XML structure or attributes are invalid.public FormElementI openView(Lesezeichen l)
openView 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(Lesezeichen l, java.util.Map parameters)
openView 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 MDIElementI getMDIElementForBO(BO bo)
getMDIElementForBO in interface ClientContextIpublic FormElementI getFormElementForBO(BO bo)
getFormElementForBO in interface ClientContextIpublic FormElementI openForm(Formular form, BO bo, java.util.Map params, FormElementI origin)
openForm in interface ClientContextIform - the form definition to displaybo - the business object to bind to the formparams - 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 ClientContextIform - the form definition to displaybo - the business object to bind to the formparams - 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, BO bo, java.util.Map params)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, BO bo, java.util.Map params, java.lang.String title)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, BO bo, java.util.Map params, java.lang.String title, FormContextI ftx)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, BO bo, java.util.Map params, java.lang.String title, FormContextI ftx, boolean massChange)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, BO bo, java.util.Map params, java.lang.String title, FormContextI ftx, boolean massChange, int viewType)
public FormElementI openForm(Formular form, BO bo, java.util.Map params, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds)
public FormElementI openForm(Formular form, BO bo, java.util.Map params, 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 params, 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 params, 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 params, 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)
openForm in interface ClientContextIform - the form definition to displaytx - the transaction managing the lifecycle and persistence of the BObo - the business object to bind to the formparams - 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 openForm(Formular form, Transaction tx, BO bo, java.util.Map params)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map params, java.lang.String title)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map params, java.lang.String title, FormContextI ftx)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map params, java.lang.String title, FormContextI ftx, boolean massChange)
openForm in interface ClientContextIpublic FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map params, java.lang.String title, FormContextI ftx, boolean massChange, int viewType)
public FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map params, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds)
public FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map params, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds, boolean maximize)
public FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map params, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds, boolean maximize, boolean ignoreOpenInstance)
public FormElementI openForm(Formular form, Transaction tx, BO bo, java.util.Map params, 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 params, 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 params, java.lang.String title, FormContextI ftx, boolean massChange, int viewType, java.awt.Rectangle forcedBounds, boolean maximize, boolean ignoreOpenInstance, boolean reuseOpenIfNew, boolean skipTxLoadedNewBOs, FormElementI origin)
public void waitAndHandleCompilationErrors(InstrumentingSchemaI is, Benannt strref)
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 FormElementI createPrintingDialog(Report report, BO[] bos, java.lang.String title, FormElementI owner)
public 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 entity)
ClientContextIgetStrukturenForEntity in interface ClientContextIentity - The entity name for which to collect the structurespublic Struktur[] getStrukturenForEntity(java.lang.String entity, boolean reload)
ClientContextIgetStrukturenForEntity in interface ClientContextIentity - The entity name for which to collect the structuresreload - force a reloadpublic Struktur[] getStrukturenForEntity(java.lang.String entity, boolean reload, boolean directOnly)
ClientContextIgetStrukturenForEntity in interface ClientContextIentity - 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 entity, boolean reload, boolean directOnly, EntityI[] entitiesOnly)
ClientContextIgetStrukturenForEntity in interface ClientContextIentity - 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 ent)
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 ClientContextIent - the target entity for which to retrieve templatesSchablone instances, or an empty array if none are foundClientContextI.getTemplates(EntityI, boolean)public Schablone[] getTemplates(EntityI ent, 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 ClientContextIent - 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 ent, boolean reload, boolean uniqueEntities, java.util.Set entitiesToExclude)
ClientContextIPolymorphicTemplateSelectionTree).getTemplatesForSubEntitiesInAdminsOrdner in interface ClientContextIent - 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 ent)
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 ClientContextIent - the target entity for which to retrieve formsFormular instances, or an empty array if none are foundClientContextI.getForms(EntityI, boolean)public Formular[] getForms(EntityI ent, 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 ClientContextIent - 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 ent)
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 ClientContextIent - the target entity for which to retrieve bookmarksLesezeichen instances, or an empty array if none are foundClientContextI.getBookmarks(EntityI, boolean)public Lesezeichen[] getBookmarks(EntityI ent, 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 ClientContextIent - 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 ent)
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 ClientContextIent - the target entity for which to retrieve reportsReport instances, or an empty array if none are foundClientContextI.getReports(EntityI, boolean)public Report[] getReports(EntityI ent, 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 ClientContextIent - 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 ClientContextI_tid - the tid of the template_entityName - 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 ClientContextI_tid - the tid of the form_entityName - 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 ClientContextI_tid - the tid of the bookmark_entityName - 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 ClientContextI_tid - the tid of the report_entityName - 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 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 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)
public void forcedClientDisconnectInitiated(int _cSecsDelay)
public void forcedClientDisconnectInitiated(int _cSecsDelay,
java.lang.String _msg)
public void forcedClientDisconnectInitiatedDefault(int _cSecsDelay)
public void forcedClientDisconnectInitiatedDefault(int _cSecsDelay,
java.lang.String _msg)
public void forcedClientDisconnectStopped()
public void forcedClientDisconnectStoppedDefault()
public void serverShutdownInitiated(int _cSecsDelay)
public void serverShutdownInitiated(int _cSecsDelay,
java.lang.String _msg)
public void serverShutdownInitiatedDefault(int _cSecsDelay)
public void serverShutdownInitiatedDefault(int _cSecsDelay,
java.lang.String _msg)
public void serverShutdownStopped()
public void serverShutdownStoppedDefault()
public void serverShutdown(java.util.Date _dateShutdown)
public void serverShutdownDefault(java.util.Date _dateNow,
java.util.Date _dateShutdown)
public void receivedSystemMessage(java.lang.String _msg)
public void receivedSystemMessage(java.lang.String _msg,
java.lang.String _sender)
public void receivedSystemMessageDefault(java.lang.String _msg)
public void receivedSystemMessageDefault(java.lang.String _msg,
java.lang.String _sender)
public void serverLocked()
public void serverUnlocked()
public 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 void showSystemMessageDialogNonModal(java.lang.String s,
java.lang.String type,
java.lang.String title,
int maxLengthLines,
de.ipcon.swing.IconKeys iconKey,
int position)
public java.io.File showSaveFileChooser(java.lang.String title,
java.lang.String sessionKey,
javax.swing.filechooser.FileFilter filter,
boolean quiet,
java.io.File preselectedFile)
Note: Native OS save dialogs inherently support single-file selection only.
Implementation Note: Routes to the internal method, explicitly requesting a native SAVE dialog.
showSaveFileChooser in interface BasicDialogItitle - The title of the dialog.sessionKey - A global variable name for this selection context (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 sessionKey,
boolean quiet,
javax.swing.filechooser.FileFilter filter)
Implementation Note: Routes to the internal method, explicitly requesting a native OPEN dialog.
showOpenFileChooser in interface BasicDialogItitle - The title of the dialog.sessionKey - A global variable name for this selection context (LRU dir).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 sessionKey,
boolean quiet,
java.io.File preselectedFile)
Note: 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.
Implementation Note: Routes to the internal method, explicitly requesting a native OPEN dialog strictly restricted to directories.
showFolderChooser in interface BasicDialogItitle - The title of the dialog (e.g. "Select Export Folder").sessionKey - A global variable name for this selection context (LRU dir).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 sessionKey,
javax.swing.filechooser.FileFilter filter,
java.io.File preselectedFile)
Implementation Note: Bypasses the single-file router and calls chooseFile directly for native multi-selection.
showOpenFilesChooser in interface BasicDialogItitle - The title of the dialog.sessionKey - A global variable name for this selection context (LRU dir).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 sessionKey,
int selectionMode,
boolean quiet,
javax.swing.filechooser.FileFilter filter,
javax.swing.JComponent accessory,
java.io.File preselectedFile,
java.io.File fallbackLastUsedDir,
int dialogType)
showFileChooser in interface BasicDialogItitle - The dialog title.approveText - The text on the approval button.sessionKey - The LRU tracking variable name.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 sessionKey,
int selectionMode,
javax.swing.filechooser.FileFilter filter,
javax.swing.JComponent accessory,
java.io.File fallbackLastUsedDir)
showFilesChooser in interface BasicDialogItitle - The dialog title.approveText - The text on the approval button.sessionKey - The LRU tracking variable name.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.lang.Object showError(java.lang.String s,
java.lang.Throwable ex,
java.lang.String title,
boolean deprecatedForceSynchronous,
java.lang.Object[] buttons)
showError in interface BasicDialogIs - 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)
showError in interface BasicDialogIs - 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 ex,
boolean deprecatedForceSynchronous,
java.lang.Object[] buttons)
showException in interface BasicDialogIex - 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)
showYesNoDialog in interface BasicDialogIs - 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)
Important 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 BasicDialogIs - 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)
Implementation Note: Acts as a wrapper for DialogTools.showInputMessageDialog(...)
showStringInputDialog in interface BasicDialogImessage - 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)
Integer input.showIntegerInputDialog in interface BasicDialogIs - 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)
Long input.showLongInputDialog in interface BasicDialogIs - 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)
BigDecimal input.showBigDecimalInputDialog in interface BasicDialogIs - 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)
Date input.showDateInputDialog in interface BasicDialogIs - 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)
showTimespanInputDialog in interface BasicDialogIs - 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)
showMessageDialogNonModal in interface BasicDialogIs - 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)
showMessageDialog in interface BasicDialogIs - 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,
int maxLengthLines,
boolean alwaysOnTop,
boolean sync)
s - The message to display.type - The dialog type string constant.title - The title of the dialog.maxLengthLines - The maximum line length before word wrapping occurs.alwaysOnTop - Whether the dialog forces itself on top of the window stack.sync - Whether the dialog blocks execution synchronously.public java.lang.Object showListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
java.lang.Object defaultChoice,
java.lang.String cboFormat,
boolean multiple)
showListChoiceDialog 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 void showMessageDialog(java.lang.String s)
showMessageDialog in interface BasicDialogIBasicDialogI.showMessageDialog(String, String, String)public void showMessageDialog(java.lang.String s,
java.lang.String type)
showMessageDialog in interface BasicDialogIBasicDialogI.showMessageDialog(String, String, String)public void showMessageDialogNonModal(java.lang.String s)
showMessageDialogNonModal in interface BasicDialogIBasicDialogI.showMessageDialogNonModal(String, String, String)public void showMessageDialogNonModal(java.lang.String s,
java.lang.String type)
showMessageDialogNonModal in interface BasicDialogIBasicDialogI.showMessageDialogNonModal(String, String, String)public int showConfirmDialog(java.lang.String s)
showConfirmDialog in interface BasicDialogIBasicDialogI.showConfirmDialog(String, String, boolean, String, String)public int showConfirmDialog(java.lang.String s,
java.lang.String title)
showConfirmDialog in interface BasicDialogIBasicDialogI.showConfirmDialog(String, String, boolean, String, String)public java.lang.String showStringInputDialog(java.lang.String s)
showStringInputDialog in interface BasicDialogIBasicDialogI.showStringInputDialog(String, String, String, boolean, boolean)public java.lang.String showStringInputDialog(java.lang.String s,
java.lang.String title)
showStringInputDialog in interface BasicDialogIBasicDialogI.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 BasicDialogIBasicDialogI.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)
BasicDialogIshowListChoiceDialog in interface FormattedChoiceDialogIshowListChoiceDialog in interface BasicDialogItitle - 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)
BasicDialogIshowListChoiceDialog in interface FormattedChoiceDialogIshowListChoiceDialog in interface BasicDialogItitle - 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 BasicDialogIBasicDialogI.showMultipleChoiceDialog(String, String, Object[], int)public java.lang.Object[] showMultiListChoiceDialog(java.lang.String title,
java.lang.Object[] options,
java.lang.Object[] defaultChoices,
java.lang.String cboFormat)
showMultiListChoiceDialog 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)
showListChoiceDialog 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)
Implementation Note: Shows a dialog offering multiple options of answering (NOT selecting, if this is wanted use showListChoiceDialog() with param 'multiple' set to true)
showMultipleChoiceDialog in interface BasicDialogIs - 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)
showUserLoginDialog in interface BasicDialogImessage - 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 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)
Reads a local file entirely into memory and returns its content as a byte array. Extremely useful for scripting contexts.
getLocalFile in interface de.ipcon.db.core.BasicClientContextIjava.lang.IllegalArgumentException - if an I/O error occurs or the file is not read completely.public void putLocalFile(java.io.File outfile,
byte[] data)
Writes raw byte data out to a local file.
putLocalFile in interface de.ipcon.db.core.BasicClientContextIpublic void putLocalFile(java.io.File outfile,
java.io.InputStream is)
Streams data from an InputStream out to a local file.
putLocalFile in interface de.ipcon.db.core.BasicClientContextIjava.lang.IllegalArgumentException - if an I/O error occurs during write.public SchemaI getSchema()
getSchema in interface de.ipcon.db.core.BasicClientContextIpublic void setSchema(SchemaI $289)
public java.awt.Component getDefaultDialogParent()
public void setDefaultDialogParent(java.awt.Component $290)
public java.util.HashMap getFolders()
public void setFolders(java.util.HashMap $291)
public java.util.HashMap getActions()
public void setActions(java.util.HashMap $292)
public java.util.LinkedHashMap getAllActions()
getAllActions in interface ClientContextIpublic void setAllActions(java.util.LinkedHashMap $293)
public java.util.HashMap getAllToolBars()
getAllToolBars in interface ClientContextIpublic void setAllToolBars(java.util.HashMap $294)
public StrukturCache getStrukturCache()
public void setStrukturCache(StrukturCache $295)
public ClientMenuManager getMenuManager()
public void setMenuManager(ClientMenuManager $296)
public javax.swing.JComponent getDefaultFocusOwner()
public void setDefaultFocusOwner(javax.swing.JComponent $297)
setDefaultFocusOwner in interface ClientContextIpublic java.lang.String getCachedServerDesc()
public void setCachedServerDesc(java.lang.String $298)
public AbstractScript getScriptServerLocked()
public void setScriptServerLocked(AbstractScript $299)
public AbstractScript getScriptServerUnlocked()
public void setScriptServerUnlocked(AbstractScript $300)
public AbstractScript getScriptShutdownInitiated()
public void setScriptShutdownInitiated(AbstractScript $301)
public AbstractScript getScriptShutdown()
public void setScriptShutdown(AbstractScript $302)
public AbstractScript getScriptShutdownStopped()
public void setScriptShutdownStopped(AbstractScript $303)
public AbstractScript getScriptSystemMessage()
public void setScriptSystemMessage(AbstractScript $304)
public java.lang.String getPathClientLogTxt()
getPathClientLogTxt in interface ClientContextIpublic void setPathClientLogTxt(java.lang.String $305)
public int getMsgPopupAutocloseAfter()
public void setMsgPopupAutocloseAfter(int $306)
public boolean isMsgPopupWithButton()
public void setMsgPopupWithButton(boolean $307)
public java.util.Date getDateLoggedOn()
getDateLoggedOn in interface ClientContextIpublic void setDateLoggedOn(java.util.Date $308)
public java.lang.String getConfiguredMinHeap()
public void setConfiguredMinHeap(java.lang.String $309)
public java.lang.String getConfiguredMaxHeap()
public void setConfiguredMaxHeap(java.lang.String $310)
Copyright © 2000-2026 OAshi S.à r.l. All Rights Reserved.