A persistence instance defines how Rhino connects to an external database endpoint.

A persistence instance requires the following configuration properties:

  • A unique name that identifies the persistence instance in the SLEE.

  • The fully-qualified name of the Java class from the database driver that implements the javax.sql.DataSource interface or the javax.sql.ConnectionPoolDataSource interface. For more information on the distinction between these interfaces and their implications for application-level JDBC connection pooling in Rhino, please see Managing database connections.

  • Configuration properties for the datasource. Each datasource has a number of JavaBean properties (as defined by the JDBC specification). For each configured property, its name, expected Java type, and value must be specified.
    Variables may be used in the construct of JavaBean property values. Variables are indicated using the ${...} syntax, where the value between the braces is the variable name. Rhino attempts to resolve the variable name by looking in the following places in this order:

    • The content of the $RHINO_HOME/config/config_variables file

    • Java system properties

    • User environment variables

Note At a minimum, configuration properties that inform the JDBC driver where to connect to the database server must be specified.
Previous page Next page
Rhino Version 3.2