General Features and Data Source Tab

1.1. For each application you build, Rev creates a project file that includes all of your Rev-related settings. The file menu and main toolbar allow you to open, close, save or create new Rev project files. You can also manage general application settings (defaults for GUI, data source defaults, and default folders for generated projects and the project Java package root) and licenseing information here.

1.2. To begin your application building project with Rev, first add or edit a data source (establish a connection to a database and schema) by clicking the Data Source icon. This lets you change the database connection at any time. The Query Object Tool icon lets you create an object on a query (see 1.6 below).

1.3. This will popup the Data Source Detail dialog box and allows you to database name, location, type, and login credentials.

Once the data source is loaded, Rev lets you:

• Navigate the database
• Choose elements to include in your application
• Generate custom queries, objects and data relationships
• Choose output and deployment options
• Generate the application

1.4. The left side of the Data Source tab lets you navigate schema, tables, stored procedures, and views of the data source. You can expand schemas to see tables and click tables to see fields.

When you click an element name, a check appears in the box next to it. All items checked will be included in the application to be created. You can right-click to select all.

1.5. The right side of Rev displays the details of the elements clicked on the left, including fields, corresponding data types and structure.

1.6. Clicking the Query Object Tool icon lets you create an object on a query, which is primarily used for complex data extraction from your data source.

Model Tab

2.1. Rev's Model tab lets you create (and remove) objects (see 2.4 below) and data relationships. Use the relationships tool to manually create data relationships which do not already exist through keys in the database.

2.2. The left side displays all available objects. This includes each table you included in the project and any additional objects you create in Rev.

2.3. This main window displays the details of the objects and relationships included in the project, and allows you to change names, fields, declare reference objects, and choose the primary key generation method.

2.4 Creating an object pops up a window which allows you to name your object and select table(s).

Generation Tab

3.1. The Generation tab lets you click your way through a branch of the "tasklist" to set the GUI output type, persistence layer type and application server deployment options for your application.

3.2. The main window provides settings for the:

• Local directory here to place the generated output files
• Application name (to be used by the application server)
• Package root (naming convention for objects as they will appear in an IDE)
• Number of rows to be displayed by default in your application's list view web page
• Driver JAR file (for licensing)
• OC4J settings (whether to deploy immediately and application server settings and password)

3.3. When ready, click the build icon (Vgo logo) to generate your application code. The ant icon generates the Ant script. The main window will then display the progress of the files being created and any error messages

Successful Build

Generated Files and Folder Tree

Each of the generated files is placed in a logical folder structure. Generated code is formatted for easy modification and integration.

Sample DAO Code

Sample Struts Code

Generated Web Application

In this example, the application generated was a Struts interface with a DAO persistence layer deployed on an OC4j application server.