<ctrl:cancel>

Dieses Attribut muss nicht angegeben werden, wenn das Tag von einem Struts <html:form> Tag umschlossen ist. in diesem Fall wird der Name der Action über die Struts Formular Bean ermittelt.

Anmerkung: Die Action muss in einer der struts-config.xml Dateien deklariert sein.

Id (nummerisch) zur Referenzierung einer alternativen Hintergrundgrafik für einen Textbutton.

Die Hintergrundgrafiken müssen zuvor in einer ResourceMap registriert worden sein.
Der Resourcenschlüssel wird dabei nach der folgenden Konvention mit der angegebenen Id zusammengesetzt:

• true = Die HTML Konvertierung ist aktiv. So wird beispielsweise das "<" Zeichen als "&lt;" codiert. HTML Code wird damit nicht ausgeführt.
• false = Die HTML Konvertierung ist abgeschaltet. HTML Code wird demzufolge direkt in die Seite eingesetzt und somit ausgeführt.

Als Formularelement

Es wird ein Submit des umschliessenden Formulars ausgeführt. Alle Informationen über das Kontrollelement Ereignis werden in Hidden Feldern zum Server transportiert.

Als eigenständiges Kontrollelement

Kontrollelement Ereignisse werden direkt in Form von Hyperlinks ausgelösst. Sämtliche eingegeben Daten in der HTML Seite gehen damit verloren!

Anmerkung: Der Wert true (= Formularelement) darf nur dann verwendet werden, wenn sich das Kontrollement in einem Formular befindet.

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.

Die folgenden Werte sind möglich:

• "true" Die Lokalisierung ist aktiv und es wird die von Struts vergebene Ländereinstellung des angemeldenten Benutzers verwendet (wie in der HTTP Session unter dem Schlüssel org.apache.struts.action.LOCALE abgelegt).
• "false" Die Lokalisierung ist nicht aktiviert. Alle Zeichenkettenliterale werden wie angegeben in die HTML Seite geschrieben.
• ISO Code Die Lokalisierung ist aktiv und es wird die angegebene Sprache verwendet.

Bei aktivierter Lokalisierung werden die angegebenen Schlüssel von dem registrierten FrameworkAdapter (eine Interface Klasse) mit Hilfe der überschreibbaren localizeKey() Methode übersetzt. Der mitgelieferte StrutsFrameworkAdapter verwendet die in der struts-config.xml registrierten Message Resource Bundles für die Übersetzung des Ressourcen Schlüssels.

Zeichenketten die mit einem "#"-Zeichen beginnen werden grundsätzlich nicht lokalisiert (Das "#"-Zeichen wird jedoch abgeschnitten).

Alle Zeichenketten die von einem DataModel zurückgeliefert werden, sind ebenfalls von dem Lokalisierungsmechanismus ausgeschlossen, da dies in den Aufgabenbereich der Applikation fällt.

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.

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

Anmerkung: JavaScript Code

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:

Literal

true|false -> StaticPermission

Rolle

#rollenname -> RoleBasedPermission

Funktion

$funktionsname -> FunctionBasedPermission

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.

Anmerkung: Es muss ein gültiger Java Bezeichner angegeben werden.

• server = Alle Kontrollelement Aktionen führen zu einem Server Roundtrip und werden auf dem Server bearbeitet.
• client = Kontrollelement Aktionen werden direkt im Browser des Benutzers durchgeführt. Es hängt von der verwendeten Painter Factory und dem konkreten Kontrollelement Painter ab, wie weit die Unterstützung für Clientside Scripting geht.
• auto = Das Framework wählt basierend auf der JavaScript Aktivierung des Anwender Browsers den Modus "client" bei aktiviertem JavaScript und "server" bei deaktiviertem JavaScript (siehe BrowserInfo).

• any = Nach der Bean wird in jedem Scope gesucht.
• page = Die Bean liegt im PageContext der JSP Seite.
• request = Die Bean liegt im HTTP Servlet Request
• session = Die Bean liegt in der HTTP Session
• application = Die Bean liegt applikationsweit im Servlet Kontext

Diese Funktion ist nur bei bestimmten Painterfactories verfügbar

Namenskonvention: Das Framework bietet einen Mechanismus zum automatischen Image Austausch bei bestimmten Mausereignissen an. Damit der Mechanismus genutzt werden kann gelten die folgenden Regeln:

• Der Name der Schaltfläche (angegeben im name-Attribut) muss mit dem Präfix btn beginnen.
• Der Dateiname des verwendeten gif Bildes muss das folgende format haben: xxxxxxxN.gif. Dabei Steht <N> für den Schaltflächenzustand.

• 1 = aktiv (normal)
• 2 = inaktiv (disabled)
• 3 = hover (Maus über der Schaltfläche)
• 4 = pressed

Anmerkung: Siehe HTML Dokumentation für das Attribut style.

Anmerkung: Siehe HTML Dokumentation für das Attribut class.

Anmerkung: Siehe HTML Dokumentation für das Attribut id.

Die Zeichenkette wird vor der Ausgabe HTML-codiert

Siehe HTML-Dokumentation