| Index Previous <<>> Next |
| |
| 7.1 Overview |
| 7.2 EIS tier |
| 7.3 Business tier |
| 7.4 Web tier |
| 7.5 Web services tier |
| 7.6 Relationships (Business tier) |
| 7.6.1 Adding a relationship |
| 7.6.2 Editing a relationship |
| 7.6.3 Deleting a relationship |
| 7.7 Web.xml (web tier) |
| 7.7.1 Adding a child node |
| 7.7.2 Inserting a node |
| 7.7.3 Editing a node |
| 7.7.4 Deleting a node |
| 7.1 Overview | To top of page |
JCodeBox allows you to build multitiered applications. Each tier acts as a container for the components you define in your application.
Depending on the type of application you are building the following tiers are available:
- EIS tier
- Business tier
- Web tier
- Web services tier
To add components to a tier either:
- Right mouse click on the tier in the define application dialog
- Select the component to add from the popup menu
- A dialog specific to the component type you have selected will be displayed
Or
- Select the Action=>Tier menu option from the main menu in the define application dialog
- Select the tier you would like to add the component to
- Select the component to add from the available list
- A dialog specific to the component type you have selected will be displayed
Most tiers have properties where you can add additional items that operate across the whole tier.
To invoke the properties dialog for a tier:
- Right mouse click on the tier in the define application dialog
- Select properties
Or
- Select the Action=>Tier menu option from the main menu in the define application dialog
- Select the tier you would like to invoke the properties dialog for
- Select properties
|
| 7.2 EIS tier | To top of page |
In the EIS tier you define logical entities that map to data stored in your database. In database mode you define database
entities in this tier, in manual mode (i.e. application is not based on an underlying database schema) you define manual
entities in this tier
- Supported components
- Database entities
- Manual entities
- Properties
- Patterns tab
The patterns tab allows you to add/edit/delete patterns for the EIS tier (see chapter 12 patterns for further details on using patterns.
|
| 7.3 Business tier | To top of page |
In the business tier you define business objects that implement the core business logic of the application. These business objects
map to logical entities defined in the EIS tier. Typically the objects are implemented as EJBs.
- Supported components
- Bean Managed Persistence (BMP) entity EJB
- Container Managed Persistence (CMP) entity EJB
- Stateless session EJB
- Stateful session EJB
- Message driven EJB
- Properties
- Patterns tab
The patterns tab allows you to add/edit/delete patterns for the business tier (see chapter 12 patterns for further details on using patterns).
- Relationships tab
The relationships tab allows you to add/edit/delete relationships for components in the business tier. Note that relationships
are only applicable to entity EJBs. Relationships are described in more detail later in this chapter.
- Code tab
The code tab allows you to add/edit/delete classes and interfaces for the business tier. (see chapter 13 Additional code/objects for further details on adding code).
|
| 7.4 Web tier | To top of page |
In the web tier you define components that process user requests and generate the appropriate responses.
- Supported components
- View sets
- View helpers (+ JSP)
- JSP
- Servlets
- Text components (i.e. HTML pages)
- Resource components (i.e. graphics)
- Properties
- Patterns tab
The patterns tab allows you to add/edit/delete patterns for the web tier (see chapter 12 for further details on using patterns).
Currently, patterns available to the web tier are automatically applied.
- Code tab
The code tab allows you to add/edit/delete classes and interfaces for the web tier. (see chapter 13 Additional code/objects for further details on adding code).
- Options tab
The options tab displays the web style to be applied to the web tier and allows you to add/remove entries to the menu page (for the generated application) if supported by the web style.
- web.xml tab
The web.xml tab allows you to graphically edit the web.xml deployment descriptor for the application.
|
| 7.5 Web services tier | To top of page |
In the web services tier you define web service components that expose the functionality provided by your application to
web services clients.
- Supported components
- Properties
Currently there are no properties available for the web services tier.
|
| 7.6 Relationships (Business tier) | To top of page |
|
| 7.6.1 Adding a relationship | To top of page |
- Select the relationships tab on the Business tier properties dialog
- Press the Add button. The select relationship type wizard is displayed
- Select the bean persistence type and press next
- Select the relationship type and press next
The Define relationship dialog is displayed.
- Enter the relationship name in the relationship name text field
1:1 and 1:M relationships
- Select the component on the one side of the relationship in the component dropdown list on the left of the dialog.
The primary key fields will be displayed in the table below
- Select the component on the other one side of the relationship (or the many side in the case of 1:M) in the component
dropdown list on the right of the dialog. For each primary key field (on the left hand side of the table), select the field it
should be mapped to (on the right hand side of the table). Note, each field (cell) in the right hand column of the table will
present a dropdown list of available fields when it is clicked on.
M:M relationships
- Select the first component on the many side of the relationship in the component dropdown list on the left of the dialog.
The primary key fields will be displayed in the table below
- Select the second component on the many side of the relationship in the component dropdown list on the right of the dialog.
The primary key fields will be displayed in the table below
- Select the mapping component for the relationship in the component dropdown list in the middle of the dialog. For each primary
key field (on the left and right hand sides of the table), select the field it should be mapped to in the mapping component (in
the middle two columns of the table). Note, each field (cell) in the middle two columns of the table will present a dropdown list
of available fields when they are clicked on.
- Select whether the relationship should be bi-directional
- Select whether the relationship should be aggressively loaded
- Select the CMR field type to use for the relationship (Only applicable to CMP 2)
- Press OK to save your relationship
- Your relationship is displayed in the relationships list on the Business tier properties dialog.
|
| 7.6.2 Editing a relationship | To top of page |
|
| 7.6.3 Deleting a relationship | To top of page |
- Select the relationships tab on the Business tier properties dialog
- Select the relationship you would like to delete.
- Press the Delete button
- The relationship will be deleted and removed from the relationships list on the Business tier properties dialog.
|
| 7.7 Web.xml (web tier) | To top of page |
The web.xml tab in the web tier properties dialog allows you to graphically edit the web.xml deployment descriptor for your application.
|
| 7.7.1 Adding a child node | To top of page |
- Right mouse click on a node and select Add child
- The Add web.xml entry dialog is displayed
- Enter the entry name (you can use the lookup button to select the name from a list)
- Optionally enter the entry value (you can use the lookup button to select an existing component in your application)
- Press OK to save your entry
- Your entry is displayed in the web.xml tab.
|
| 7.7.2 Inserting a node | To top of page |
- Right mouse click on a node and select Insert before/after
- The Insert web.xml entry dialog is displayed
- Enter the entry name (you can use the lookup button to select the name from a list)
- Optionally enter the entry value (you can use the lookup button to select an existing component in your application)
- Press OK to save your entry
- Your entry is displayed in the web.xml tab.
|
| 7.7.3 Editing a node | To top of page |
- Right mouse click on a node and select Edit
- The Edit web.xml entry dialog is displayed
- Update the entry name (you can use the lookup button to select the name from a list)
- Optionally update the entry value (you can use the lookup button to select an existing component in your application)
- Press OK to save your updated entry
- Your entry is displayed in the web.xml tab.
|
| 7.7.4 Deleting a node | To top of page |
- Right mouse click on a node and select Delete
- Press Yes in the Confirm delete dialog to delete your entry
- Your entry is removed from the web.xml tab.
|
Index Previous <<>> Next |