Java Doc for DatabaseRmsFactory.java in  » Workflow-Engines » wfmopen-2.1.1 » de » danet » an » workflow » rmsimpls » dbrms » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Usage of this class as service factory requires several configuration parameters for accessing the database. The factory uses the following ordered lookup procedure to determine these parameters:

• Look for parameters in JNDI. Lookup parameters in java:comp/env/de.danet.an.workflow.rmsimpls.dbrms.parameter. The configuration for a parameter using this mechanism thus looks like:

   <env-entry>
   <description>Configure database parameter parameter</description>
   <env-entry-name>de.danet.an.workflow.rmsimpls.dbrms.parameter</env-entry-name>
   <env-entry-type>java.lang.String</env-entry-type>
   <env-entry-value>Value of parameter</env-entry-value>
   </env-entry>

  Note that the environment entries must be inserted in the ejb-jar.xml or web.xml for every EJB resp. servlet that calls the de.danet.an.workflow.spis.rms.ResourceManagementServiceFactory.newInstancenewInstance method of ResourceManagementServiceFactory.
• Find the application resource file de.danet.an.workflow.rmsimpls.dbrms-factory.properties and look for entries "parameter = Value of parameter".

The following parameters are used:

dataSource

The lookup name of the data source in JNDI (e.g. java:/DefaultDS).

allUsersQuery

The query that returns the known users as a two column result with the user's entry's primary key in the first column and the user's display name in the second.

allRolesQuery

The query that returns the known roles as a two column result with the role's entry's primary key in the first column and the role's display name in the second.

allGroupsQuery

The query that returns the known groups as a two column result with the group's entry's primary key in the first column and group's display name in the second.

userNameQuery

The query that returns user data as a single column result with the user's display name in the only column. The user's entry's primary key is set as query parameter.

roleNameQuery

The query that returns role data as a single column result with the role's display name in the only column. The role's entry's primary key is set as query parameter.

groupNameQuery

The query that returns group data as a single column result with the group's display name in the only column. The group's entry's primary key is set as query parameter.

userLookupQuery

The query that returns a user's data as a two column result with the user's entry's primary key in the first column and the user's display name in the second. The user's account name (usually the login name) is set as query parameter.

roleLookupQuery

The query that returns a role's data as a two column result with the role's entry's primary key in the first column and the role's display name in the second. The role's "account" name (clear text name) is set as query parameter.

groupLookupQuery

The query that returns a group's data as a two column result with the group's entry's primary key in the first column and the group's name display in the second. The groups's "account" name (clear text name) is set as query parameter.

rolesQuery

The query that returns a user's roles as a two column result with the role's entry's primary key in the first column and the role's display name in the second. The user's entry's primary key is set as query parameter.

groupsQuery

The query that returns a user's groups as a two column result with the group's entry's primary key in the first column and the group's display name in the second. The user's entry's primary key is set as query parameter.

author:
   Michael Lipp
version:
   $Revision: 1.7 $