| Attribut | Typ | Beschreibung | Pflicht | RTExp | ||||||||||||
| converter | Java Klassenname oder Converter Id |
Gibt den Datentyp Konverter an mit welchem die Daten des
Kontrollelementes konvertiert werden sollen. Wird dieses
Attribut nicht angegeben, so verwendet das Framework einen
Default Konverter passend zum Datentyp des Kontrollelementes.
(ConverterRegistry.lookup()).
Der Konverter kann auf die folgenden Arten angegeben werden:
Anmerkung: Die angegebene Java Klasse muss das Converter Interface implementieren! |
 |
|||||||||||||
| filter | Boolean |
Mit dem filter-Attribut kann die automatische
HTML-Konvertierung des Elementes aktiviert bzw. deaktiviert werden.
|
 |
|||||||||||||
| height | String |
Setzt die Höhe des Kontrollelmentes. Die Höhe kann absolut oder
prozentual angegeben werden.
Es hängt von dem jeweiligen Kontrollelement Painter ab, ob dieses Attribut ausgewertet wird. Siehe HTML-Dokumentation |
|
|||||||||||||
| help | String |
Weist dem Kontrollelement einen Hilfe Bezeichner zu. Es wird
ein Hilfe Symbol neben dem Kontrollelement angezeigt,
welches bei einem Klick einen onHelp Event erzeugt.
Der Bezeichner wird dabei als Parameter übergeben und kann somit
zur Anzeige von kontextabhängigen Hilfetexten benutzt werden.
Das eigentliche Hilfesystem ist nicht Teil des Common-Controls Frameworkes, der onHelp Event kann jedoch zur Verankerung verwendet werden. Für die Erzeugung des Hyperlinks zum Aufruf der Hilfe sind einige vordefinierte Framework Ressourcen zuständig. Diese kann der Anwendungsentwickler global oder auf Kontrollelement Ebene verändern:
Anmerkung: Der Hilfe Bezeichner wird von dem Common-Controls Framework an das Hilfesystem weitergegeben. Die Syntax und Semantik hängt daher von dem verwendeten Hilfesystem ab. |
|
|||||||||||||
| hidden | boolean | Dieses Flag gibt an ob zusätzlich ein Hidden Tag erzeugt werden soll. Damit kann auf den Feldinhalt bei einem Form Submit zugegriffen werden. |
|
|||||||||||||
| id | String |
Weist dem Kontrollelement einen eindeutigen Bezeichner zu.
Im Tag Body wird daraufhin eine Java Variable angelegt, auf
die in Java Scriptlets zugegriffen werden kann.
Diese Variable verweist auf die Kontrollelement Instanz
(abgeleitet von Control).
Dieses Attribut wird meist in Verbindung mit dem type Attribut verwendet Anmerkung: Da zur JSP Compile Zeit eine Java Variable mit diesem Bezeichner angelegt wird, muss hier ein String Literal (und keine Expression!) angegeben werden! Der Bezeichner muss den Regeln für gültiger Java Bezeichner folgen. |
|
|||||||||||||
| name | String |
Gibt den Namen der Java-Bean - eine Instanz der Klasse
Control.
Die Java-Bean muss im angegebenen Scope abgelegt sein.
Wenn das Tag von einem Struts <html:form> Tag umschlossen ist, dann muss kein Bean Name angegeben werden. In diesem Fall wird die Java-Bean über ein Property der Struts Formular Bean gezogen. Anmerkung: Es muss ein gültiger Java Bezeichner angegeben werden. |
|
|||||||||||||
| permission | ACL |
Mit diesem Attribut kann der Zugriff auf das Element
beschränkt werden.
Berechtigungen werden über das Principal Objekt in der Benutzer Session geprüft. Das Principal Objekt wird mit der Methode SecurityUtil.registerPrincipal() in der Session registriert. Es wird vom Anwendungsentwickler durch Implementierung des Principal Interfaces zur Verfügung gestellt. Somit lassen sich sehr einfach beliebige Berechtigungssysteme mit dem Framework verbinden. Berechtigungen werden immer in Form einer Access Control List (ACL) angegeben. Dabei handelt es sich um einen Ausdruck dessen Elemente Einzelberechtigungen sind. Das Framweork unterstützt die folgenden Berechtigungstypen, welche jedoch vom Anwendungsentwickler beliebig erweitert werden können:
Zur Formulierung der Ausdrücke kann die folgende Syntax verwendet werden:
PERMISSION_PREFIX
: '#' | '$'
AND_OP
: 'and' | '&' | '*'
XOR_OP
: 'xor' | '^'
OR_OP
: 'or' | '|' | '+'
UNARY_OP
: '~' | '!'
permission
: PERMISSION_PREFIX IDENTIFIER
primary_expr
: permission
| '(' expr_list ')'
unary_expr
: primary_expr
| UNARY_OP primary_expr
logical_and_expr
: unary_expr
| logical_and_expr AND_OP unary_expr
logical_xor_expr
: logical_and_expr
| logical_or_expr XOR_OP logical_and_expr
logical_or_expr
: logical_xor_expr
| logical_or_expr OR_OP logical_xor_expr
expr_list
: logical_or_expr
| expr_list ';' logical_or_expr
| expr_list ',' logical_or_expr
Access Control Listen werden mit der statischen Methode AccessControlList.parse() eingelesen. Der Parser verwendet wiederum die statische Methode PermissionFactory.parse() um die einzelnen Permissions zu lesen. Der Anwendungsentwickler kann über die PermissionFactory eigene von Permission abgeleitete Klassen registrieren und so den Sprachumfang der ACL erweitern. |
|
|||||||||||||
| property | String |
Gibt den Namen des Properties an, über welchen auf
die Java-Bean zugegriffen werden soll. Dies ist in
der Regel nur dann notwendig, wenn die Java-Bean
mit einer Struts Formular Bean assoziiert ist.
Anmerkung: Es muss ein gültiger Java Bezeichner angegeben werden. |
|
|||||||||||||
| tooltip | String |
Tooltip Text welcher in einem Popup Fenster
angezeigt wird, wenn der Benutzer die Maus über das
Kontrollelement bewegt.
Die Zeichenkette wird vor der Ausgabe HTML-codiert |
|
|||||||||||||
| value | String | Der Wert des Kontrollelementes kann mit diesem Attribut auch direkt als Litteral angegeben werden. |
|
|||||||||||||
| width | String |
Setzt die Breite des Kontrollelmentes. Die Breite kann
absolut oder prozentual angegeben werden.
Siehe HTML-Dokumentation |
|