WebLogic Builder

This document contains the following sections.

• Starting WebLogic Builder
• Migrating a J2EE Module to WebLogic Server
• Working with Web Applications
• Working with EJBs
• Working with the J2EE Container
• WebLogic Builder User Interface
• Porting and Deploying Applications with WebLogic Builder

How WebLogic Builder Works

WebLogic Builder is a visual environment for editing a J2EE application's deployment descriptor XML files. You can view descriptor files while you visually edit them in WebLogic Builder, and you won't need to make textual edits to the XML files.

What can I do using WebLogic Builder?

Begin by pointing WebLogic Builder at an application's compiled J2EE components (*.class files or modules that contain *.class files). If any of the deployment descriptor files needed for deployment on WebLogic Server are missing or defective, WebLogic Builder will offer to generate new or newly serviceable descriptor files.

Once deployment descriptor files exist, you can edit their elements and attributes using WebLogic Builder. You can, for example, add a tag library to a web application, or add a finder method to an EJB.

Test your application by using WebLogic Builder to deploy applications to a server.

Recommended Uses for WebLogic Builder

Use WebLogic Builder for the following tasks:

• Generate deployment descriptor files for a J2EE module
• Edit a module's deployment descriptor files
• View deployment descriptor files
• Compile and validate deployment descriptor files
• Deploy a module to a server

Limitations of WebLogic Builder

WebLogic Builder has some limitations.

• Cannot add new modules to an application's descriptor files
• Will notice changes to *.class files only if you close and reopen the module
• Support for generating descriptors for EJB 1.1 beans is not guaranteed; focus is on EJB 2.0
• Validates EJBs only
• Cannot automatically display the differences between a changed but unsaved descriptor file and original file
• Cannot perform batch descriptor update of XML element values
• Cannot remove components from a module's descriptor files
• If you make changes to descriptor files while they are opened in WebLogic Builder, Builder will not be aware of the changes
• No file management capabilities

 

---

Starting WebLogic Builder

Start Builder from the Start menu or from the command line.

From the Start menu, double-click WebLogic Builder under WebLogic 7.0.

In the command-line, use the following command:

for Windows:

startWLBuilder.cmd

for Unix:

startWLBuilder.sh

This command sets your environment and starts WebLogic Builder.

Open a module (a JAR or an EAR or a WAR or a J2EE module in exploded format) using the File menu's Open options.

 

 

 

When you open a module in WebLogic Builder, you see on the left a navigational tree view of the module's descriptor files, which you use to explore and select the components of the application.

 

 

On the right, you see tabbed panels with fields and other controls for editing the deployment descriptor elements of the module.

 

 

Use the navigational tree view on the left to select application components, and edit them in the corresponding tabs in the right-hand panel.

For more information about the interface, see WebLogic Builder User Interface.

 

---

Migrating a J2EE Module to WebLogic Server

Migrate a module with no WebLogic Server deployment descriptors to WebLogic Server by opening the module using the File menu Open Archive or Open Directory.

WebLogic Builder checks that the module has all the deployment descriptor files required for successful deployment on WebLogic Server. If needed deployment descriptor files are missing, WebLogic Builder will offer to generate them for you. If you accept, WebLogic Builder will introspect the class files in your module and create appropriate deployment descriptor files.

To generate the descriptors, WebLogic Builder matches beans with their interfaces using method signatures and naming conventions. WebLogic Builder expects that bean class file names will end in either "Bean" or "EJB." If possible, Builder will match up both methods and bean names. If bean names do not match, Builder looks for beans and interfaces that contain the same methods. If there are duplicate methods, or if it is not possible to use both method signatures and bean names, Builder displays a warning in the error pane that it has made a guess based on available information. You can click on this error message to be taken to the class panel of the suspect bean to check and edit the class selection.

WebLogic Builder will not overwrite your existing deployment descriptor files.

For more information about using WebLogic Builder to port applications to WebLogic Server, see Porting and Deploying Applications with WebLogic Builder.

 

---

Working with Web Applications

See the following sections for information on Web Applications:

• Adding a Servlet with Servlet Mapping and Security Constraints
• Adding an ejb-ref/ejb-local-ref and Reference-Description
• Adding a Resource-Reference
• Adding a Listener Class
• Adding a Filter with Filter Mapping
• Defining a Match Map Class
• Setting Welcome and Error Pages
• Adding a Tag Library
• Adding a Virtual Directory

Adding a Servlet with Servlet Mapping and Security Constraints

This section describes how to add servlets to your Web Application's deployment descriptor files, and configure them with security roles, constraints, and assignments.

Adding a Servlet with URL Mapping

Use the following procedure to add a new servlet to the deployment descriptor file:

1. Under your Web Application's name in the navigational tree, select Servlets.
2. In the Servlets panel, select the servlet and click Add.
3. In the General tab, enter the Servlet Name and servlet class or JSP file.
4. Optionally, add URL mappings to the servlet in the URL mappings list by entering the URL pattern and clicking Add.
5. Click OK.

   The servlet's name appears in the Servlet node in the navigational tree.

Adding Security Roles, Constraints, and Assignments

Add security constraints and assignments to security roles using the following procedures.

1. Under the Web Application node in the navigational tree, select Security Roles.
2. In the editing panel, click Add, enter security role names and descriptions, and click OK.
3. Under the Web Application node in the navigational tree, select Security Role Assignments.
4. In the editing panel, select a Role and click Add.
5. In the edit dialog, add the names of members of the Role.
6. Expand the Security Constraints node, and select a role node.
7. In the Resources/Pages tab, set the following:
   • Web Resource Name
   • URL patterns for
   • HTTP methods
   • allowed and disallowed roles
   • Transport Guarantee
   • Display Name
8. In the Roles tab, set the Roles for which the Resources/Pages settings are allowed.

Adding an ejb-ref/ejb-local-ref and Reference-Description

1. In the navigational tree, under the name of your Web Application, open the Servlets directory and select J2EE References.
2. In the J2EE References editing panel, select the EJB Refs tab and click Add.
3. Use the edit dialog to specify for the EJB the following, and then click OK:
   • EJB Reference Name
   • Link Name (optional)
   • EJB Type (Session or Entity)
   • Remote Interface
   • Home Interface
   • Run As (optional)
   • Description (optional)

   WebLogic Builder writes the EJB reference to web.xml. and lists it in the EJB Refs tab of the J2EE References editing panel.

Adding a Resource-Reference

Add a resource-reference to web.xml and then to weblogic.xml using the following procedure.

1. In the navigational tree, under the name of your Web Application, open the Servlets directory and select J2EE References.
2. In the J2EE editing panel, select the Resource Refs tab and click Add.
3. In the edit dialog, select the following:
   • Reference Type
   • Resource Sharing
   • Resource Authentication

   Add a description and the Reference name, and click OK.

4. In the navigational tree, expand the WebLogic Settings node under Web Applications, select J2EE Links and click Add.
5. Select the Resource Reference that you added in step 3, enter its JNDI name for WebLogic, and click OK.

Adding a Listener Class

Add an event listener class to a Web Application using the following procedures:

1. In the navigational tree, under the name of your Web Application, select Miscellaneous.
2. In the Miscellaneous panel, select Listeners and click Add.
3. Enter the classname of the event and click OK.

Adding a Filter with Filter Mapping

1. Under the name of your Web Application in the navigational tree, select Filters.
2. In the Filters edit panel, click Add.
3. In the edit dialog, enter the display settings for the filter:
   • Display Name
   • Small Icon (must reside within the Web Application)
   • Description (optional)
   • Large Icon (also must reside within the Web Application)
4. Still in the dialog, select the Init Parameters tab and click Add.
5. Enter the filter's parameter name and value, and click OK.

Defining a Match Map Class

1. Under the name of your Web Application in the navigational tree, select Miscellaneous—>Container Settings.
2. Specify an URL match-map class name for this Web Application by entering its name in the URL match-map class name field.

Setting Welcome and Error Pages

Set the welcome and error pages for your Web Application using the following procedures:

1. Select your Web Application's name in the navigational tree.
2. In the edit panel for the Web Application, select Welcome Files.
3. Set the order for existing welcome files using the Move up, Move down buttons, or add new files by entering the filenames and clicking Add.
4. Select the Error Pages tab and click Add.
5. Enter the filename or browse to the file. Set HTTP Error Code or Exception Type, and click OK.

Adding a Tag Library

Add tag libraries using the following procedure:

1. Under your Web Application name in the navigational tree, select Tag Libraries.
2. In the Tag Libraries editing panel, click Add.
3. Enter the URI for the tag library.
4. Enter the location of the TLD or JAR file, or browse to it and select it.
5. Click OK.

   
    

   
    

   
    

Adding a Virtual Directory

Add a virtual directory to your Web Application using the following procedures:

1. In the navigational tree, under Web Application, WebLogic Settings, select VirtualDirectoryMappings and click Add.
2. Set a local directory path by entering it, and add its URL patterns by entering them in the bottom text field and clicking Add. Then click OK.

 

---

Working with EJBs

WebLogic Builder generates descriptors and interfaces for a bean class only if the bean class follows the naming convention of ending in either "Bean" or "EJB."

See the following sections for information about EJBs.

• Creating a Relationship Between 2.0 CMP Beans
• Adding a CMP Field to an Entity Bean
• Adding a Finder Method to an EJB
• Specifying Optimistic Concurrency
• Adding an ejb-reference Between Two Beans

Creating a Relationship Between 2.0 CMP Beans

Create a relationship between two 2.0 CMP beans using the following procedure.

1. In the navigational tree under the EJB node, right-click the Relations node and select Add a relation... Note that if your module does not have CMP beans, WebLogic Builder will not display the Relations node.
2. In the Relations dialog, enter or select a name for the relation.

   
    

   
    

   
    

3. Set the Between option to One or Many for the first bean, and select the bean.
4. Set the And option for the second bean to the desired match with the first bean's Between option, and select the second bean and click Next.
5. In the second Relations dialog, select a Role name, a CMR (Container Managed Relationship) field for the second bean, and a primary key Field for the first bean and a column for the second bean.

   
    

   
    

   
    

6. Click Next.
7. In the third Relations dialog, select the role name and optionally set bidirectional relations (CMR field and field type).

   
    

   
    

   
    

8. Click Finish.

   WebLogic Builder writes the relation to ejb-jar.xml, and an entry for the relation appears in the Relations node.

Adding a CMP Field to an Entity Bean

Add a Container Managed Persistence field to an entity bean using the following procedure.

1. In the navigational tree under EJB, expand an entity bean node and select the CMP Fields node.
2. In the CMP Fields dialog, select the field's name, which will correspond to a getter on your Bean class. For example, if you have getFirstName() on your Bean class, the name of the CMP field will be firstName.
3. Use the browse button to browse to a table name. If you are not connected to a server, the browse button will activate the Connect to a Server dialog.
4. To select the column name, click the browse button and browse the table. Select a column and click OK.
5. Set the column type.
6. Click OK.

   The new CMP field will appear in the navigational tree under the CMP node of the bean.

Adding a Finder Method to an EJB

To add a finder method to a bean, use the following procedure.

1. In the navigational tree, under the name of your entity bean, expand the bean and select Finders.
2. In the bean's Finder editing panel, click Add.

   
    

   
    

   
    

3. Select the method name, enter its properties, and click OK.

Specifying Optimistic Concurrency

You may want to set optimistic concurrency for your CMP entity beans when parallel transactions seem unlikely to conflict or when speed of response times is more important than certainty that transactions have not conflicted. WebLogic Builder's default setting is pessimistic concurrency. To set optimistic concurrency, do the following.

1. With an entity bean selected in the left navigational panel, select Tuning -> Cache. In the Concurrency strategy selection field, select Optimistic.

   A dialog offers to let you select the Verify column and the Optimistic column to map the entity bean to a table.

   
    

2. Select Version or Timestamp in the Verify column to enable the Optimistic column field.
3. You can use the Browse button to connect to a server, browse a database, and select a column, or you can type the column name directly.

Adding an ejb-reference Between Two Beans

1. In the navigation tree, expand an EJB and select Resources.
2. In the EJB's Resources editing panel, select the EJB Refs or the EJB Local Refs tab and click Add.

 

---

Working with the J2EE Container

• Ordering a Module
• Setting Up EJB Caching
• Choosing a Security Realm

Ordering a Module

To set the deployment order of a module, use the following procedure.

1. In the navigational tree, select the module.
2. In the module's editing panel, select Deployment Order.
3. In the field that lists the module's components, select components and use the Move up and Move down buttons to reset their deployment order.

Setting Up EJB Caching

Set up EJB caching using the following procedure.

1. In the navigational tree, under the EJB node, expand a bean and select Tuning.
2. In the Tuning panel, set the following caching conditions.
   • Enter a the name of a concurrency strategy.
   • Check or leave unchecked the option to cache between transactions.
   • For a cache, set maximum number of beans in cache, idle time-out, and read time-out.
   • For cache reference, select the entity cache name and set the estimated bean size.

Choosing a Security Realm

Set a security realm for a module using the following procedure.

1. In the navigational tree, select the WebLogic Application Settings node.
2. In the WebLogic Application Settings editing panel, select the Security Realm tab.
3. In the Security Realm tab, enter the realm name.

 

---

WebLogic Builder User Interface

This section describes menu tasks and provides a key for locating deployment descriptor elements in the Builder interface.

Menu Tasks

Deployment Descriptor Elements in WebLogic Builder

Menu Tasks

• Opening an Application
• Connecting to a Server
• Deploying
• Selecting a Compiler
• Closing an Application
• Saving an Application
• Validating an Application
• Generating Descriptors
• Removing a Component Descriptor
• Adding a New Descriptor Element
• Removing a Deployment Descriptor Element
• Viewing Deployment Descriptor XML Files

Opening an Application

To open an archived or an exploded module, from the File menu, select Open. Browse to the archived module or to the directory that contains the exploded module, select it, and click Open.

Troubleshooting

If you try to load a module that is not well formed, for example an EAR that has a nested JAR which is not referenced in the accompanying MANIFEST.MF file, WebLogic Builder may have trouble opening your module.

Connecting to a Server

Connect to a server to deploy your module for testing, or to connect your module to a data source.

From the tools menu, select Connect to Server..

Enter the connect information in the dialog, and click Connect.

 

 

Deploying

From the Tools menu, select Deploy Module. If you are not connected to a server, WebLogic Builder offers the Connect dialog.

Selecting a Compiler

1. From the Tools menu, select Options.
2. In the Options dialog, select EJBC Compiler.
3. Click Browse, and browse to the compiler. Select it and click Open.

Closing an Application

From the File menu, select Close.

Saving an Application

From the File menu, select Save.

All changes that you have made to deployment descriptor files in WebLogic Builder will be saved to your module.

Validating an Application

Validating does not save new changes to a module.

Select Validate from the Tools menu to validate your module.

Generating Descriptors

On opening a new module, WebLogic Builder asks you for permission to generate deployment descriptors for your opened module. When you accept, J2EE Application Builder creates the new descriptors and writes them to the appropriate location in the module.

Removing a Component Descriptor

Remove a component from the module by removing its associated descriptor element from the module, outside of WebLogic Builder.

Adding a New Descriptor Element

Add a new descriptor element to the module outside of WebLogic Builder.

Removing a Deployment Descriptor Element

Remove files from module outside of WebLogic Builder.

Viewing Deployment Descriptor XML Files

View the XML files for the actively selected component using the following procedure. Note that these XML views are read-only.

1. From the View menu, select XML Source.

   A tabbed XML viewer appears.

2. Use the tabs to select the XML file you wish to view.

   
    

   
    

   
    

Deployment Descriptor Elements in WebLogic Builder

The sections listed below show the locations of deployment descriptor elements in WebLogic Builder.

• weblogic.xml Elements in WebLogic Builder
• web.xml Elements in WebLogic Builder
• weblogic-application.xml Elements in WebLogic Builder
• ejb-jar.xml Elements in WebLogic Builder
• weblogic-ejb-jar.xml Elements in WebLogic Builder
• Tag Lib Elements in WebLogic Builder
• weblogic-cmp20-rdbms-jar.xml Elements in WebLogic Builder

The file tree in the left panel contains nodes that group various deployment descriptor elements together in an intuitive manner. Click these nodes to navigate among the editing panels on the right, where you can make changes to the deployment descriptor elements.

 

 

weblogic.xml Elements in WebLogic Builder

The table below maps elements found in weblogic.xml to locations in WebLogic Builder's interface. See weblogic.xml Deployment Descriptor Elements.

XML Element	WebLogic Builder Node —> Tab
description	Web Application Node—>Display
weblogic-version
security-role-assignment: role-name, principal-name	Web Application Node—>Security Roles
reference-descriptor: resource-description, res-ref-name, jndi-name, ejb-reference-description, ejb-ref-name, resource-env-description, res-env-ref-name	Web Application Node—>J2EE References
session-descriptor: session-param, param-name: (CacheSize, ConsoleMainAttribute, CookieComment, CookieDomain, CookieMaxAgeSecs, CookieName, CookiePath, CookiesEnabled, IDLength, InvalidationIntervalSecs, JDBCConnectionTimeoutSecs, PersistentStoreCookieName, PersistentStoreDir, PersistentStorePool, PersistentStoreType, SwapIntervalSecs, TimeoutSecs, TrackingEnabled, URLRewritingEnabled)	Web Application Node—>Session Settings
jsp-descriptor: jsp-param, param-name (compileCommand, compileFlags, compilerClass, compilerSupportsEncoding, defaultFilename, encoding, keepgenerated, noTryBlocks, packagePrefix, pageCheckSeconds, precompile, verbose, workingDir, debug)	Web Application Node—>JSP Settings
container-descriptor	Web Application, Miscellaneous Node—>Container Settings
charset-params	Web Application, Miscellaneous Node—>IANA-Java Charset Mappings, and —>Path-Charset Mappings
virtual-directory-mapping: (local-path, url-pattern	Web Application, Miscellaneous Node—>Virtual Directories
url-match-map	Web Application, Miscellaneous Node—>Container Settings
security-permission	Web Application, Security Constraints

web.xml Elements in WebLogic Builder

The table below maps elements found in web.xml to locations in WebLogic Builder's interface. See web.xml Deployment Descriptor Elements.

XML Elements and Attributes	WebLogic Builder Node —> Tab
icon	Web Application Node—>Display
display-name	Web Application Node—>Display
description	Web Application Node—>Display
distributable	not supported
context-param	Web Application Node—>Context Params
filter: icon, filter-name, display-name, description, filter-class, init-param	Web Application, Filter Node—>Filter
filter-mapping	Web Application, Servlet/Filter Mappings Node—>Filter Mappings
listener	Web Application, Listeners—>Listener Class
servlet: icon, servlet-name, display-name, description, (servlet-class|jsp-file), init-param, load-on-startup, security-role-ref	Web Application, Servlets—>Servlets
servlet-mapping: servlet-name, url-pattern	Web Application, Servlet/Filter Mappings Node—>Servlet Mappings
session-config: session-timeout	Web Application, Session Settings—>General
mime-mapping: extension, mime-type	Web Application—>Mime Types
welcome-file-list	Web Application—>Welcome Files
error-page: (error-code|exception-type), location	Web Application—>Error Pages
taglib: taglib-uri, taglib-location	Web Application, Tag Libraries—>Tag Libraries
resource-env-ref: description, resource-env-ref-name, resource-env-ref-type	Web Application, J2EE References—>Resource Env Refs
resource-ref: description, res-ref-name, res-type, res-auth, res-sharing-scope	Web Application, J2EE References—>Resource Refs
security-constraint: display-name, web-resource-collection, auth-constraint, user-data-constraint	Web Application, Security Constraints—>Resource Pages, Roles, SSL/Misc
login-config: auth-method, realm-name, form-login-config	Web Application—>Login
security-role: description, role-name	Web Application, Security Roles—>Role name, Description, Principal Names
security-role-ref: description, role-name, role-link	Web Application, Servlets, Servlet—>Security Role Refs
env-entry: description, env-entry-name, env-entry-value, env-entry-type	Web Application, J2EE References—>Env Entries
ejb-ref description, ejb-ref-name, ejb-ref-type, home, remote, ejb-link, run-as	Web Application, J2EE References—>EJB Refs

weblogic-application.xml Elements in WebLogic Builder

The table below maps elements found in weblogic-application.xml to locations in WebLogic Builder's interface. See weblogic-application.xml Deployment Descriptor Elements.

XML Elements and Attributes	WebLogic Builder Node —> Tab
weblogic-application	WebLogic Application Settings
ejb: entity-cache (entity-cache-name, (max-beans-in-cache | max-cache-size), caching-strategy, start-mdbs-with-application	WebLogic Application Settings, EJB Settings—>EJB Settings
xml: parser-factory (saxparser-factory, document-builder-factory, transformer-factory), entity-mapping (entity-mapping-name, public-id, system-id, entity-uri, when-to-cache, cache-timeout-interval)	WebLogic Application Settings—>XML Parser Factory, XML Entity Mappings
security: realm-name	WebLogic Application Settings—>Security Realm
jdbc-connection-pool: data-source-name, connection-factory (factory-name, connection-properties), pool-params (size-params, xa-params, login-delay-seconds, leak-profiling-enabled, connection-check-params), driver-params (statement, prepared-statement, row-prefetch-enabled, row-prefetch-size, stream-chunk-size), xa-params (debug-level, keep-conn-until-tx-complete-enabled, end-only-once-enabled, recover-only-once-enabled, tx-context-on-close-needed, new-conn-for-commit-enabled, prepared-statement-cache-size, keep-logical-conn-open-on-release, local-transaction-supported, resource-health-monitoring-enabled) acl-name	WebLogic Application Settings, JDBC Data Sources—>General, Connection, Pool, XA Settings, Driver

ejb-jar.xml Elements in WebLogic Builder

The table below maps elements found in ejb-jar.xml to locations in WebLogic Builder's interface. See WebLogic Server EJB Deployment Files.

XML Elements and Attributes	WebLogic Builder Node —> Tab
abstract-schema-name	EJB—>Advanced
acknowledge-mode	Message Driven Bean—>Advanced
security-role	EJB—>Security
method-permission,	EJB, Methods—>Permissions
container-transaction	EJB, Methods —>Transactions
cascade-delete	not supported
cmp-field: description, field-name	EJB, CMP Fields—>CMP Fields
cmp-version	EJB —>Persistence
cmr-field: description, cmr-field-name, cmr-field-type	EJB, Relations—>Relation Wizard (right-click Relations)
destination-type	Message Driven Bean—> General
ejb-class	EJB—>Classes
ejb-client-jar	not supported
ejb-link	EJB—>Resources
ejb-local-ref: description, ejb-ref-name, ejb-ref-type, local-home, local, ejb-link	EJB, Resources—>EJB Local Refs
ejb-name	EJB—>General
ejb-ql	EJB Application, Finders—>Finders
ejb-ref: description, home, remote, ejb-link	EJB, Resources—>EJB Refs
ejb-relation: description, ejb-relation-name, ejb-relationship-role	Relations—>Relations Wizard (right-click on Relations)
ejb-relationship-role: description, ejb-relationship-role-name, multiplicity, relationship-role-source, cmr-field	Relations—>Relations Wizard (right-click on Relations)
ejb-relationship-role-name	Relations—>Relations Wizard (right-click on Relations)
ejb-class: home, remote, local-home, local	EJB—>Classes
primkey-field	Entity Bean—>Persistence
resource-env-ref: env-entry (description, env-entry-name, env-entry-type, env-entry-value)	EJB—>Resources
field-name	Entity Bean, CMP Fields—>CMP Fields
message-driven: ejb-name, ejb-class, message-driven-destination	Message Driven Bean—>General, Classes
message-selector: acknowledge-mode, transaction-type	Message Driven Bean—>Advanced
subscription-durability	Message Driven Bean—>General
persistence-type	Entity Bean—>Persistence
prim-key-class	Entity Bean—>Persistence
primkey-field	Entity Bean—>Persistence
query: description, query-method, result-type-mapping, ejb-ql	EJB, Finders—>Finders
reentrant	EJB—>Advanced
relationships: description, ejb-relation	EJB Application, Relations—>Relations Wizard (right-click on Relations)
resource-env-ref: description, resource-env-ref-name, resource-env-ref-type	EJB, Resources—>Environment
resource-ref: description, res-ref-name, res-type, res-auth, res-sharing-scope	EJB, Resources—>Resource References
role-name	Enterprise Application—>Security
session-type	Session Bean—>General
session: ejb-name, home, remote, local-home, local, ejb-class, session-type, transaction-type,	Session Bean—>General, Classes
session: env-entry, ejb-ref, ejb-local-ref, security-role-ref, security-identity, resource-ref, resource-env-ref	Session Bean, Resources—>Environment, Resource References, EJB Refs, EJB Local Refs
subscription-durability	Message-Driven Bean—>General
transaction-type	EJB, Methods—>Transactions
trans-attribute	EJB, Methods—>Transactions

weblogic-ejb-jar.xml Elements in WebLogic Builder

The table below maps elements found in weblogic-ejb-jar.xml to locations in WebLogic Builder's interface. See weblogic-ejb-jar.xml Document Type Definitions.

XML Elements and Attributes	WebLogic Builder Node —> Tab
cache-between-transactions	EJB, Tuning—>Cache
concurrency-strategy	EJB, Tuning—>Cache
connection-factory-jndi-name	Message-Driven Bean—>Foreign JMS Provider
jms-polling-interval-seconds	Message-Driven Bean—>Advanced
jms-client-id	Message-Driven Bean—>Advanced
delay-updates-until-end-of-tx	EJB—>Persistence
destination-jndi-name	Message-Driven Bean—>General
ejb-reference-description: ejb-ref-name, jndi-name	EJB, Resources—>EJB Refs
ejb-local-reference-description: ejb-ref-name, jndi-name	EJB, Resources—>EJB Local Refs
enable-call-by-reference	For Session Bean: EJB—>Advanced For Entity Bean: EJB—>Persistence
enable-dynamic-queries	not supported
entity-cache: max-beans-in-cache, idle-timeout-seconds, read-timeout-seconds, concurrency-strategy, cache-between-transactions	EJB, Tuning—>Cache Not supported for Entity EJB.
entity-cache-ref: entity-cache-name, concurrency-strategy, cache-between-transactions, estimated-bean-size	EJB, Tuning—>Pool
entity-cache-name	not supported
estimated-bean-size	not supported
entity-clustering: home-is-clusterable, home-load-algorithm, home-call-router-class-name	EJB, Tuning—>Cluster
enable-dynamic-queries	not suported
finders-load-bean	EJB—>Advanced
home-call-router-class-name	Session and Entity Beans, Tuning—>Cluster
home-is-clusterable	Session and Entity Beans, Tuning—>Cluster
home-load-algorithm	Session and Entity Beans, Tuning—>Cluster
idempotent-methods	EJB, Tuning—>Cluster
idle-timeout-seconds	EJB, Tuning—>Cache not supported for Stateful Session Bean
cache-type	not supported
initial-beans-in-free-pool	EJB, Tuning—>Cluster
initial-context-factory	Message Driven Bean—>Foreign JMS Provider
is-modified-method-name	not supported
isolation-level	Entity Bean, Methods—>Transactions
jndi-name	Entity Bean—>General
clients-on-same-server	not supported
local-jndi-name	EJB—>General
max-beans-in-cache	EJB, Tuning—>Cache
max-beans-in-free-pool	EJB, Tuning—>Pool
message-driven-descriptor	not supported
persistence-use	not supported
pool: max-beans-in-free-pool, initial-beans-in-free-pool	EJB, Tuning—>Pool
read-timeout-seconds	EJB, Tuning—>Cache
replication-type	EJB, Tuning—>Cluster
security-role-assignment: role-name, principal-name	EJB Application
stateful-session-clustering: home-is-clusterable, home-load-algorithm, home-call-router-class-name, replication-type	EJB, Tuning—>Cluster
stateful-session-cache: max-beans-in-cache, idle-timeout-seconds	EJB, Tuning—>Cache
stateless-bean-call-router-class-name	not supported
stateless-bean-is-clusterable	not supported
stateless-bean-load-algorithm	not supported
stateless-bean-methods-are-idempotent	not supported
stateless-clustering: home-is-clusterable, home-load-algorithm, home-call-router-class-name, stateless-bean-is-clusterable, stateless-bean-load-algorithm, stateless-bean-call-router-class-name, stateless-bean-methods-are-idempotent	not supported
stateless-session-descriptor: pool, stateless-clustering	not supported
transaction-isolation: isolation-level	not supported
trans-timeout-seconds	Entity Bean—>Persistence
type-identifier	not supported
provider-url	Message Driven Bean—>Foreign JMS Provider
invalidation-target: ejb-name	Entity Bean—>Advanced

Tag Lib Elements in WebLogic Builder

The table below maps tag library elements to locations in WebLogic Builder's interface. See Creating a Tag Library Descriptor.

XML Elements and Attributes	WebLogic Builder Node —> Tab
taglib: tlib-version, jsp-version, short-name, uri, display-name, small-icon, large-icon, description, validator, listener	Web Application, Tag Libraries—>Location, URI

weblogic-cmp20-rdbms-jar.xml Elements in WebLogic Builder

The table below maps elements found in weblogic-cmp20-rdbms-jar.xml to locations in the WebLogic Builder interface. See WebLogic Server Container-Managed Persistence Services.

XML Elements and Attributes	WebLogic Builder Node —> Tab
create-default-dbms-table	EJB—>Application
delay-database-insert-until	Entity Bean—>Advanced
automatic-key-generation	Entity Bean—>Automatic Key Generation
field-group	not supported
table-map: table-name, field-map	EJB Application, Relations—>Relation wizard (right-click Relations)
verify-columns, optimistic-column	not supported
check-exists-on-method	Entity Bean—>Advanced
ejb-name	EJB—>General
data-source-name	EJB—>Persistence
table-name	EJB Application, Relations—>Relation wizard (right-click Relations)
field-map: cmp-field, dbms-column, dbms-column-type	not supported
cmp-field	EJB Application, Relations—>Relation wizard (right-click Relations)
dbms-column	EJB Application, Relations—>Relation wizard (right-click Relations)
optimistic-column	not supported
dbms-column-type	EJB Application, CMP Fields, CMP—>CMP
column-map: foreign-key-column, key-column	EJB Application, Relations—>Relation wizard (right-click Relations)
weblogic-rdbms-relation: relation-name, table-name, weblogic-relationship-role, relationship-role-name	EJB Application, Relations—>Relation wizard (right-click Relations)
relationship-role-map: foreign-key-table, primary-key-table, column-map	EJB Application, Relations—>Relation wizard (right-click Relations)
group-name	EJB Application, Finders, Finder—>Query Settings
cmr-field	EJB Application, Relations—>Relation wizard (right-click Relations)
relationship-caching: caching-name, caching-element	not supported
caching-name	not supported
caching-element: cmr-field, group-name, caching-element	not supported
weblogic-query: query-method, weblogic-ql, group-name, max-elements, include-updates	EJB Application, Finders, Finder
sql-select-distinct	not supported
weblogic-ql	EJB Application, Finders, Finder
method-name	EJB Application, Finders, Finder
query-method	EJB Application, Finders, Finder
max-elements	EJB Application, Finders, Finder
include-updates	EJB Application, Finders, Finder
sql-select-distinct	EJB Application, Finders, Finder
automatic-key-generation: generator-type, generator-name, key-cache-size	EJB—>Automatic Key Generation
generator-type	EJB—>Automatic Key Generation
generator-name	EJB—>Automatic Key Generation
key-cache-size	EJB—>Automatic Key Generation
delay-database-insert-until	EJB—>Advanced
validate-db-schema-with	not supported
database-type	not supported