Die Common-Controls Tag Bibliothek

disabled

Boolean

Über dieses Attribut kann das Kontrollelement deaktiviert werden. Es nimmt dann keine Benutzereingaben entgegen und erzeugt keine Kontrollelement Ereignisse.

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

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:

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.

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.

scope

HttpScope

Dieses Attribut gibt den Scope an, in welchem die Java-Bean mit den eigentlichen Anzeigedaten zu finden ist.

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

style

String

Über dieses Attribut kann direkt ein HTML-style Attribut angegeben werden.

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

styleClass

String

Über dieses Attribut kann direkt ein HTML-class Attribut angegeben werden.

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

styleId

String

Über dieses Attribut kann direkt ein HTML-id Attribut angegeben werden.

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

tabindex

Integer

Legt den Tabulator Index für dieses Element fest.

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

width

String

Setzt die Breite des Kontrollelmentes. Die Breite kann absolut oder prozentual angegeben werden.

Siehe HTML-Dokumentation

`<ctrl:recurrencepattern>`

[ Syntax ]

Standard Syntax

[ Attribute ]

[ Beispiel ]

Attribut	Typ	Beschreibung	Pflicht	RTExp
disabled	Boolean	Über dieses Attribut kann das Kontrollelement deaktiviert werden. Es nimmt dann keine Benutzereingaben entgegen und erzeugt keine Kontrollelement Ereignisse.
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
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: 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.
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.
scope	HttpScope	Dieses Attribut gibt den Scope an, in welchem die Java-Bean mit den eigentlichen Anzeigedaten zu finden ist. 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
style	String	Über dieses Attribut kann direkt ein HTML-style Attribut angegeben werden. Anmerkung: Siehe HTML Dokumentation für das Attribut style.
styleClass	String	Über dieses Attribut kann direkt ein HTML-class Attribut angegeben werden. Anmerkung: Siehe HTML Dokumentation für das Attribut class.
styleId	String	Über dieses Attribut kann direkt ein HTML-id Attribut angegeben werden. Anmerkung: Siehe HTML Dokumentation für das Attribut id.
tabindex	Integer	Legt den Tabulator Index für dieses Element fest.
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
width	String	Setzt die Breite des Kontrollelmentes. Die Breite kann absolut oder prozentual angegeben werden. Siehe HTML-Dokumentation