|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectedu.bonn.xulu.gui.XuluGUIUtil
public class XuluGUIUtil
Diese Klasse stellt Funktionen fuer die Xulu-GUI zur Verfuegung.
Field Summary |
---|
Fields inherited from interface edu.bonn.xulu.appl.XuluConstants |
---|
EXTENTION_BUNDLE, ICONS_DIR, LOCALES_BASE, RESOURCE_DIR, SWING_RES, VERSION, VERSION_DATE, XULU_ICON, XULU_INFOICON, XULU_STARTICON, XULU_VIS_RES, XULUERR_RES, XULUGUI_RES |
Constructor Summary | |
---|---|
XuluGUIUtil()
|
Method Summary | |
---|---|
static Class<XuluModel> |
askModelClass(XuluModellingPlatform appl,
boolean askIfClear)
Fragt eine der in der Xulu-Registry geladenen Modell-Klassen ab. |
static ModelControlFrame |
askModelFrame(XuluModellingPlatform appl,
boolean askIfClear)
Fragt eines der in Xulu geladenen Modelle ab. |
static Object |
convertImportSourceAsNeeded(ImportFactory fac,
Object givenSource)
Konvertiert ein durch die Plattform zur Verfuegung gestelltes Objekt in ein Objekt, das von der Factory angefordert wird. |
static void |
createNewDynamicModel(Component parent,
XuluModellingPlatform appl)
Ermittelt alle geladenen Modelle aus dem Xulu-Datenpool und gibt sie dem Anwender zur Auswahl. |
static void |
createNewModel(Component parent,
Class modelClass,
String modelName,
XuluModellingPlatform appl)
Erzeugt ein neues Model aus einem übergebenen Modellklassennamen und einer Modelbezeichnung |
static void |
createNewModel(Component parent,
XuluModellingPlatform appl)
Ermittelt alle registrierten Modelle aus der Xulu-Registry und gibt sie dem Anwender zur Auswahl. |
static Object[][] |
determineObjectsFromDataPool(Object type,
DataPool dataPool)
Ermittelt (rekursiv) alle Xulu-Objekte und Eigenschaften aus dem Xulu-Datenpool, die zu einer Klasse (oder Ressource) passen. |
static void |
determineObjectsFromDataPool(Object type,
DataPool dataPool,
Vector objects,
Vector<String> names)
Ermittelt (rekursiv) alle Xulu-Objekte und Eigenschaften aus dem Xulu-Datenpool, die zu einer Klasse (oder Ressource) passen. |
static void |
determineObjectsFromList(Object type,
Enumeration objList,
Vector objects,
Vector<String> names,
String namePrefix)
Ermittelt (rekursiv) alle Xulu-Objekte und Eigenschaften aus einer Liste, die zu einer Klasse (oder Ressource) passen. |
static void |
exportObjects(Component parent,
Object object,
ExportFactory fac,
XuluModellingPlatform appl)
Exportiert ein Objekt ueber eine ExportFactory . |
static void |
exportObjectsToFiles(Component parent,
Object object,
ExportFactory fac,
XuluModellingPlatform appl)
Exportiert ein Objekt ueber eine ExportFactory . |
static Object[] |
importObjects(Component parent,
ImportFactory fac,
XuluModellingPlatform appl)
Importiert Objekte ueber eine ImportFactory . |
static Object[] |
importObjectsFromFiles(Component parent,
ImportFactory fac,
XuluModellingPlatform appl)
Importiert Objekte ueber eine ImportFactory . |
static void |
importObjectsFromFileToDataPool(Component parent,
ImportFactory fac,
XuluModellingPlatform appl)
Importiert ein oder mehrere Objekte ueber eine ImportFactory
und fuegt sie in den Xulu-Datenpool ein. |
static void |
importObjectsToDataPool(Component parent,
ImportFactory fac,
XuluModellingPlatform appl)
Importiert ein oder mehrere Objekte ueber eine ImportFactory
und fuegt sie in den Xulu-Datenpool ein. |
static void |
insertObjectsToDataPool(Component parent,
Object[] object,
DataPool pool)
Fuegt eine Anzahl an Objekten in den Xulu-Datenpool ein. |
static boolean |
insertObjectToDataPool(Component parent,
Object object,
DataPool pool,
boolean partOfMultipleInsert,
boolean autoSkipDupl)
Fuegt ein Objekt in den Xulu-Datenpool ein. |
static void |
performScriptInThread(XuluModellingPlatform appl,
ScriptInterpreter.ScriptExecutionDefinition scriptDef)
Fuehrt ein Skript innerhalb der Xulu-Modelling-Platform aus. |
static void |
performScriptInThread(XuluModellingPlatform appl,
ScriptInterpreter interpreter)
Fuehrt ein Skript innerhalb der Xulu-Modelling-Platform aus. |
static void |
reloadModelClass(XuluModellingPlatform appl)
Ermittelt alle Modell-Klassen aus der Xulu-Registry und stellt sie dem Anwender zur Auswahl. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public XuluGUIUtil()
Method Detail |
---|
public static ModelControlFrame askModelFrame(XuluModellingPlatform appl, boolean askIfClear)
appl
- Xulu-InstanzaskIfClear
- Flag, ob der Dialog auch angezeigt werden soll,
wenn nur ein einziges Modell geladen ist (die Auswahl
also eindeutig ist)
UnsupportedOperationException,
- falls aktuell kein Modell
in Xulu geladen istpublic static Class<XuluModel> askModelClass(XuluModellingPlatform appl, boolean askIfClear)
appl
- Xulu-InstanzaskIfClear
- Flag, ob der Dialog auch angezeigt werden soll,
wenn nur eine einzige Modell-Klasse geladen ist (die Auswahl
also eindeutig ist)
UnsupportedOperationException,
- falls aktuell keine Modell-Klassen
in Xulu registriert sindpublic static Object[] importObjects(Component parent, ImportFactory fac, XuluModellingPlatform appl) throws Exception
ImportFactory
. Je nachdem welche
Eingabequelle die Factory benoetigt, wird diese ueber einen passenden
Anwender Dialog ermittelt. Zur Zeit werden folgende Verfahren unterstuetzt:Art | benoetigte Quelle | Ablauf |
---|---|---|
Import aus Datei(en) | File |
Es wird ein Dateiauswahl-Dialog angezeigt, ueber den der Anwender
eine Datei (bzw. mehrere, falls von der Factory gefordert)
fuer den Datenimport bestimmt. Ggf. werden die ausgewaehlten
Files noch in FileInputStream -Instanzen umgewandelt.
(siehe importObjectsFromFiles(Component,ImportFactory,XuluModellingPlatform) ) |
parent
- aufrufende Komponente (kann null
sein)fac
- fuer den Import zu verwendende Factoryappl
- Instanz der Xulu-Anwendung
UnsupportedOperationException
- falls fuer die von der Factory benoetigte Quelle (noch) kein
Ablauf implementiert ist
Exception
- falls ein unerwarteter Fehler beim Import auftrittpublic static Object[] importObjectsFromFiles(Component parent, ImportFactory fac, XuluModellingPlatform appl) throws Exception
ImportFactory
. Hierzu werden vom
Anwender ueber einen Auswahl-Dialog Dateien als
Import-Quelle ausgewahlt. Je nach von der Factory benoetigter
Eingabequelle, werden diese in FileInputStream
s umgewandelt.
parent
- aufrufende Komponente (kann null
sein)fac
- fuer den Import zu verwendende Factoryappl
- Instanz der Xulu-Anwendung
UnsupportedOperationException
- falls fuer die von der Factory
benoetigte Quelle kein File
, File[]
,
InputStream
oder InputStream[]
ist.
Exception
- falls ein unerwarteter Fehler beim Import auftrittpublic static Object convertImportSourceAsNeeded(ImportFactory fac, Object givenSource) throws Exception
fac
- Import-FactorygivenSource
- gegebenes Objekt
Exception
- falls eine Konvertierung nicht moeglich istpublic static void insertObjectsToDataPool(Component parent, Object[] object, DataPool pool)
parent
- aufrufende Komponente (kann null
sein)object
- einzufuegende Objektepool
- Datenpool in den die Objekte eingefuegt werden solleninsertObjectToDataPool(Component,Object,DataPool,boolean,boolean)
public static boolean insertObjectToDataPool(Component parent, Object object, DataPool pool, boolean partOfMultipleInsert, boolean autoSkipDupl)
parent
- aufrufende Komponente (kann null
sein)object
- einzufuegendes Objektpool
- Datenpool in den das Objekt eingefuegt werden sollenpartOfMultipleInsert
- gibt an, dass die Einfuege-Operation Teil von
mehreren Einfuegungen ist; in einem etwaigen
Dialog kann der Anwender dann angeben, dass seine
Auswahl auch fuer die Folge-Operationen verwendet
werden sollautoSkipDupl
- gibt an, ob Duplikat-Fehler automatisch uebergangen werden
sollen (ohne dass eine Fehlermeldung erscheint)
false
, falls die Einfuegung nicht vorgenommen werden konnte
OperationCanceledException,
- falls der Anwender in einem
Konflikt-Dialog die "Abbrechen"-Auswahl getroffen hat (Folge-Einfuegungen
sollten in diesem Fall nicht mehr durchgefuehrt werden!)
AlreadyHandledException,
- falls der Anwender in einem
Konflikt-Dialog die "Uebergehen"-Auswahl getroffen hat und
diese Auswahl fuer alle Folge-Einfuegungen gemerkt werden sollpublic static void importObjectsToDataPool(Component parent, ImportFactory fac, XuluModellingPlatform appl) throws Exception
ImportFactory
und fuegt sie in den Xulu-Datenpool ein. Wie die Import-Quelle vom Anwender
abgefragt wird, haengt von der Quellenanforderung der Factory ab.
Entsprechend wird ein passender Ablauf gewahlt (siehe
importObjects(Component,ImportFactory,XuluModellingPlatform)
).
parent
- aufrufende Komponente (kann null
sein)fac
- fuer den Import zu verwendende Factoryappl
- Instanz der Xulu-Anwendung
java.lang.XuluDataException
- falls die Factory keine Objekte
erzeugt, die im Datenpool verwaltet werden koennen
Exception
importObjectsFromFiles(Component,ImportFactory,XuluModellingPlatform)
,
insertObjectsToDataPool(Component,Object[],DataPool)
public static void importObjectsFromFileToDataPool(Component parent, ImportFactory fac, XuluModellingPlatform appl) throws Exception
ImportFactory
und fuegt sie in den Xulu-Datenpool ein. Quelle fuer den Import
bilden Dateien, die ueber einen Anwender-Dialog abgefragt werden.
Fehler beim Import werden nicht durch eine Exception verarbeitet, sondern werden
ueber eine Meldung dem Anwender mitgeteilt. Das betroffene Objekt wird
in diesem Fall ignoriert und nicht in den Datenpool eingefuegt.
parent
- aufrufende Komponente (kann null
sein)fac
- fuer den Import zu verwendende Factoryappl
- Instanz der Xulu-Anwendung
java.lang.XuluDataException
- falls die Factory keine Objekte
erzeugt, die im Datenpool verwaltet werden koennen
Exception
importObjectsFromFiles(Component,ImportFactory,XuluModellingPlatform)
,
insertObjectsToDataPool(Component,Object[],DataPool)
public static void exportObjects(Component parent, Object object, ExportFactory fac, XuluModellingPlatform appl) throws Exception
ExportFactory
. Je nachdem welches
Ausgabe-Ziel die Factory benoetigt, wird dieses ueber einen passenden
Anwender Dialog ermittelt. Zur Zeit werden folgende Verfahren unterstuetzt:Art | benoetigtes Ziel | Ablauf |
---|---|---|
Export in Datei(en) | File |
Es wird ein Dateiauswahl-Dialog angezeigt, ueber den der Anwender
eine Datei (bzw. mehrere, falls von der Factory gefordert)
fuer den Datenexport bestimmt. Ggf. werden die ausgewaehlten
Files noch in FileOutputStream -Instanzen umgewandelt.
(siehe exportObjectsToFiles(Component,Object,ExportFactory,XuluModellingPlatform) ) |
parent
- aufrufende Komponente (kann null
sein)object
- zu exportierendes Objektfac
- fuer den Export zu verwendende Factoryappl
- Instanz der Xulu-Anwendung
UnsupportedOperationException
- falls fuer die von der Factory benoetigte Quelle (noch) kein
Ablauf implementiert ist
IllegalArgumentException
- falls die Factory das angegebene Objekt nicht exportieren kann
Exception
- falls ein unerwarteter Fehler beim Export auftrittpublic static void exportObjectsToFiles(Component parent, Object object, ExportFactory fac, XuluModellingPlatform appl) throws Exception
ExportFactory
. Hierzu werden vom
Anwender ueber einen Auswahl-Dialog Dateien als
Export-Ziel ausgewahlt. Je nach von der Factory benoetigtem
Ausgabe-Ziel, werden diese in FileOutputStream
s umgewandelt.
parent
- aufrufende Komponente (kann null
sein)fac
- fuer den Export zu verwendende Factoryappl
- Instanz der Xulu-Anwendung
UnsupportedOperationException
- falls fuer das von der Factory
benoetigte Ziel kein File
, File[]
,
OutputStream
oder OutputStream[]
ist.
Exception
- falls ein unerwarteter Fehler beim Export auftrittpublic static void createNewModel(Component parent, XuluModellingPlatform appl)
ModelControlFrame_Basic
dem ModelControlManager hinzugefuegt.
parent
- aufrufende Komponente (kann null
sein)appl
- Instanz der Xulu-Anwendungpublic static void createNewModel(Component parent, Class modelClass, String modelName, XuluModellingPlatform appl)
modelClass
- ModellklassemodelName
- Modellbezeichnungpublic static void createNewDynamicModel(Component parent, XuluModellingPlatform appl)
ModelControlFrame_Basic
dem ModelControlManager
hinzugefuegt.
parent
- aufrufende Komponente (kann null
sein)appl
- Instanz der Xulu-Anwendungpublic static void reloadModelClass(XuluModellingPlatform appl)
appl
- Xulu-Instanzpublic static void performScriptInThread(XuluModellingPlatform appl, ScriptInterpreter interpreter)
appl
- Applikation innerhalb der das Skript ausgefuehrt wirdinterpreter
- Interpreter, der das Skript ausfuehrtSwingWorker
,
StatusDialog
public static void performScriptInThread(XuluModellingPlatform appl, ScriptInterpreter.ScriptExecutionDefinition scriptDef)
appl
- Applikation innerhalb der das Skript ausgefuehrt wirdscriptDef
- Script-DefinitionSwingWorker
,
StatusDialog
public static Object[][] determineObjectsFromDataPool(Object type, DataPool dataPool)
type
- Objekt-Type (spezifiert durch ein Class
-Objekt oder
ein ModelResource
-Objekt)dataPool
- Datenpool, in dem gesucht wird
obj[][]
, wobei obj[0]
die ermittelten
Objekte enthaelt und obj[1]
deren Objektnamen.
IllegalArgumentException
- falls type
keine Class
-
oder ModelResource
-Instanz istpublic static void determineObjectsFromDataPool(Object type, DataPool dataPool, Vector objects, Vector<String> names)
type
- Objekt-Type (spezifiert durch ein Class
-Objekt oder
ein ModelResource
-Objekt)dataPool
- Liste von Objekten, in denen gesucht wirdobjects
- wird mit den gefundenen (passenden) Objekten gefuelltnames
- wird mit den Bezeichnungen zu den objects
-Elementen
befuellt
IllegalArgumentException
- falls type
keine Class
-
oder ModelResource
-Instanz istpublic static void determineObjectsFromList(Object type, Enumeration objList, Vector objects, Vector<String> names, String namePrefix)
type
- Objekt-Type (spezifiert durch ein Class
-Objekt oder
ein ModelResource
-Objekt)objList
- Liste von Objekten, in denen gesucht wirdobjects
- wird mit den gefundenen (passenden) Objekten gefuelltnames
- wird mit den Bezeichnungen zu den objects
-Elementen
befuelltnamePrefix
- Praefix, die den Bezeichnungen vorangestellt wird, bevor
sie in names
eingefuegt werden (wird fuer Rekursion
benoetigt, sollte beim Aufruf "" oder null
sein)
IllegalArgumentException
- falls type
keine Class
-
oder ModelResource
-Instanz ist
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |