Für die Umsetzung von Autorisierung werden in der Datenbank 3 Tabellen für die Verwaltung von Benutzer, Rollen und Rechte benötigt, die durch eine n:m Relation miteinander verknüpft sind. Per Assistent können Sie sich die entsprechenden Entities dafür generieren lassen. Zusätzlich werden die Entities durch ein Mapping miteinander verknüpft. Dadurch kann RapidClipse mit belibigen Bezeichnungen von Entities und Attributen umgehen. Falls das Standard-Mapping für Ihre Datenstruktur ungeeignet ist, können Sie dafür benutzerdefinierte Abfragen definieren.

• Benötigte Datenstruktur allgemein

  • Benutzer - Speicherung von Benutzername, Passwort und ggf. zusätzliche nutzerspezifische Informationen. In RapidClipse APIs verwendete Bezeichnungen: User, Subject.

  • Rollen - Speicherung der Rollen die ein Benutzer besitzen kann. In RapidClipse APIs verwendete Bezeichnungen: Roles, Usergroups, Userroles.

  • Rechte - Speicherung der Rechte die eine Rolle besitzen kann. In RapidClipse APIs verwendete Bezeichnungen: Permissions, Resources.

• Von RapidClipse generierte Datenstruktur 

  Entities				DAOs
  Name	Attribute	Datentyp	Erklärung
  User	username	String		UserDAO
  	password	byte[]
  	roles	Set
  Role	name	String		RoleDAO
  	resources	Set
  	childRoles	Set
  	parentRoles	Set
  	users	Set
  Resource	name	String		ResourceDAO
  	roles	Set

• Umgang mit vorhandener Datenbank - Sind in Ihrer Datenbank bereits Tabellen für die Verwaltung von Benutzern, Rollen und Rechten vorhanden, stellen Sie sicher, dass für jede Tabelle ein entsprechendes Entity mit dazugehörigem DAO in Ihrem Project Management unter Entities bzw. Data Access vorhanden ist. Falls nicht, können Sie die fehlenden Entities und DAOs mit der Import-Funktion Create JPA entities from table generieren lassen. Abweichende Tabellen- und Datenfeldnamen stellen auf Grund des später durchgeführten Mappings kein Problem dar. 

Hinweis:

• Synchronisierung - Die Entities User und Usergroups müssen zur Laufzeit synchronisiert werden.

Resource Tabelle definieren / generieren 

1. Entity für Berechtigungen bereits vorhanden - Wählen Sie Ihr bereits vorhandenes Entity aus.
   Noch kein Resource Entity vorhanden - Klicken Sie auf New Entity... um ein neues Entity Resource inklusive DAO ResourceDAO anzulegen. 
2. Wählen Sie bei Mapping > Resource name das Attribut zur Speicherung der Benutzerrechte aus.
3. Klicken Sie auf Next >.
   

Optionen:

• Resource name - Auswahl des Attributs für die Bezeichnung der Benutzerrechte.

Ergebnis:

• Project Management > Entities - Es wird die Entity-Klasse Resource.java generiert oder durch Auswahl ein bereits existierendes Entity verwendet.

  Entity	Attribute	Datentyp
  Resource	name	String

• Project Management > Data Access - Es wird die DAO-Klasse ResourceDAO.java generiert. Bei Auswahl eines bereits existierenden Entities wird kein neues DAO generiert. 

Roles Tabelle definieren / generieren 

1. Tabelle für die Rollen (Roles) bereits vorhanden - Wählen Sie Ihr bereits vorhandenes Role Entity aus.
   Noch kein Role Entity vorhanden - Klicken Sie auf New Entity... um ein neues Entity Role inklusive DAO RoleDAO anzulegen. 
2. Wählen Sie bei Mapping > Role name das Attribut zur Speicherung der Rollen aus. 
3. Wählen Sie bei Mapping > Resources das Attribut zur Speicherung der Rechte aus. 
4. Wählen Sie bei Mapping > Child roles das Attribut zur Speicherung von Unterrollen aus.
5. Klicken Sie auf Next >.
   

Optionen:

• Role name - Auswahl des Attributs für die Bezeichnung der Rollen.

• Resources - Auswahl des Attributs für die Rechte.

• Child roles - Auswahl des Attributs für die Child-Rollen.

Ergebnis:

• Project Management > Entities 

  • Role - Es wird die Entity-Klasse Role.java generiert oder durch Auswahl ein bereits existierendes Entity verwendet.

    Entity	Attribute	Datentyp
    Role	name	String
    	resources	Set
    	childRoles	Set
    	parentRoles	Set

  • Resource - Die Entity-Klasse Resource.java wird um das Attribut roles erweitert.

    Entity	Attribute	Datentyp
    Resource	name	String
    	roles	Set

• Project Management > Data Access - Es wird die DAO-Klasse RoleDAO.java generiert. Bei Auswahl eines bereits existierenden Entities wird kein neues DAO generiert. 

Verknüpfung von User und Roles

1. Tabelle für die Benutzer (User) bereits vorhanden - Wählen Sie Ihr bereits vorhandenes User Entity aus.
   Noch kein User Entity vorhanden - Klicken Sie auf New Entity... um ein neues Entity User anzulegen. 
2. Wählen Sie bei Mapping > Subject name das Attribut für den Benutzernamen aus.
3. Klicken Sie bei Mapping > Roles auf Create Attribute, um im Entity User ein Attribut anzulegen, das die Entities User und Roles miteinander verknüpft.
4. Klicken Sie auf Finish.
   

Optionen:

• Subject name - A

• Roles -

Datenbanktabellen für generierte Entities anlegen - Für die neu generierten Entities müssen entsprechende Tabellen in der Datenbank angelegt werden. Dafür bietet Ihne RapidClipse eine Export-Funktion.