ReadMe - FrontBase PlugIn for WebObjects 5
1. Introduction
The FrontBase PlugIn for WebObjects 5 is required for WebObjects 5 applications to work properly with the FrontBase RDBMS through a JDBC connection.
2. The innards of a FrontBase PlugIn installation
The FrontBase PlugIn consists of three items which must be
installed on the target computer system.
The following items are copied onto the system:
FrontBasePlugIn.EOMplugin |
|
NEXT_ROOT\Developer\EOMBundles |
FrontBasePlugIn.framework |
|
NEXT_ROOT\Local\Library\Frameworks |
frontbasejdbc.jar |
|
WEBOBJECTS_JAVA_EXTENSIONS |
frontbasejdbc.jar |
|
FB_HOME_DIR\Java |
ReadMe.html |
|
FB_HOME_DIR\Java |
|
These items will enable you to connect to FrontBase from WebObjects 5 using the FrontBase plugin.
3. Documentation
To use the FrontBase plugin with WebObjects 5
EOModeler:
In the login panel it is only necessary to specify a URL in the URL field. Alternatively the user and password fields can be extracted and entered into the respective fields in the login panel. The URL syntax is as follows:
jdbc:FrontBase:// <host info> [<arg list>] |
|
<host info> |
::= |
<regular> | <cluster list> |
<arg list> |
::= |
<user> | <user password> | <database password> | <session> | <system> | <isolation level> | <locking discipline> | <access mode> |
|
<regular> |
::= |
host_name <database info> |
<cluster list> |
::= |
<cluster member> {/<cluster member>} |
|
<database info> |
::= |
/database_name | :port |
|
<cluster member> |
::= |
database_name@host_name |
|
<user> |
::= |
/user=user_name |
<user password> |
::= |
/upasswd=user_password |
<database password> |
::= |
/dbpasswd=database_password |
<session> |
::= |
/session=session_id |
<system> |
::= |
/system=system_user |
<isolation level> |
::= |
/isolation=<isolation value> |
<locking discipline> |
::= |
/locking=<locking value> |
<access mode> |
::= |
/readOnly=<access value> |
|
<isolation value> |
::= |
read_uncommitted | read_committed | repeatable_read | serializable | versioned |
<locking value> |
::= |
pessimistic | deferred | optimistic |
<access value> |
::= |
true | false |
|
Example:jdbc:FrontBase://localhost/MyDatabase/user=admin/upasswd=secret
Please note that the user name is compulsory for the connection to work. If you have not created any users then you could simply use _SYSTEM (user=_SYSTEM) to get started.
WebObjects 5 runtime:
In order to make a WebObjects 5 project use the FrontBase plugin the framework FrontBasePlugIn.framework must be added to the project.
This framework is located in NEXT_ROOT\Local\Library\Frameworks
The documentation for the FrontBase database server can be downloaded from our website's download area.
Please take the time to peruse this documentation, so you at least have a good feeling for what is in there.