WebLogic Builder

This document contains the following sections.

 

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.

Open WebLogic Builder and use the file menu to open an application's compiled J2EE components (*.class files or modules that contain *.class files). If any of the application's deployment descriptor files needed for deployment on WebLogic Server are missing or defective, WebLogic Builder will offer to generate new or repaired descriptor files.

Once deployment descriptor files exist, use WebLogic Builder to edit their elements and attributes. 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

  • 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
  • Generated XML representations of relations among entity beans are only accurate for one-to-one relations. For entity beans that already have descriptors, Builder does not refresh relations that have a "many" side.

 

Starting WebLogic Builder

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

From the Start menu, choose BEA WebLogic Platform-->Development Tools-->WebLogic Builder.

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 does not overwrite 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

The following sections provide information about Web Applications.

 

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

Use the following procedures to define security roles and add security constraints and assignments to them.

  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 Roles.
  4. In the editing panel, select a Role and click Edit.
  5. In the Edit dialog, add the names of members of the Role.
  6. Expand the Security Constraints node, and select a Constraint.
  7. In the Resources/Pages tab, set the following:

  8. In the Roles tab, set the Roles for which the Resources/Pages settings are allowed.
  9. In the SSL/Misc tab, set:

    • Transport Guarantee

      See security-constraint in web.xml Deployment Descriptor Elements.

    • Display Name

 

Adding an ejb-ref/ejb-local-ref

Use an ejb-ref in the web application to define a reference to an EJB resource. See ejb-ref in web.xml Deployment Descriptor Elements.

Use an ejb-local-ref to declare a reference to the home interface of a local EJB. See ejb-local-ref in web.xml Deployment Descriptor Elements.

  1. In the navigational tree, under the Web Tier, select J2EE References.
  2. In the J2EE References editing panel, select the EJB Refs tab for an ejb-ref, or the EJB Local Refs tab for an ejb-local-ref, and click Add.
  3. In the Edit dialog, specify the following properties of the reference and then click OK:

    • Reference Name
    • Link Name (optional)
    • EJB Type (Session or Entity)
    • Remote Interface
    • Home Interface
    • Description (optional)

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

 

Adding a Resource Reference

Declare a reference to an external resource for your web application using the following procedure. The resource-ref element written using this procedure is located in web.xml. See resource-ref.

  1. In the navigational tree, under the name of your Web Application, select J2EE References.
  2. In the J2EE References editing panel, select the Resource Refs tab and click Add.
  3. In the Add dialog, select or enter the following parameters for the resource reference:

    • Reference name
    • Reference type
    • JNDI name
    • Resource Sharing
    • Resource Authentication
    • Description

    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 Server, and click OK.

 

Adding a Listener Class

Add an event listener class to a Web Application using the following procedure. See Application Events and Event Listener Classes.

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

 

Adding a Filter with Filter Mapping

Declare a filter and filter mapping for your Web application using the following procedure. The filter element and filter-mapping element written using this procedure are located in web.xml. See filter and 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:

    • In the General tab, enter the filter name and class and click OK.
    • In the Init Params tab, add the name, value and, optionally, a description of the parameters, and click OK.
    • In the Display tab, enter the Display Name, Small Icon (must reside within the Web Application), Large Icon (also must reside within the Web .Application), and Description (optional), and click OK

 

Defining a Match Map Class

Define a match map to specify a class for URL pattern matching for your web application using the following procedure. The url-match-map element written using this procedure is located in weblogic.xml. See url-match-map.

  1. Under the name of your Web Application in the navigational tree, select the Miscellaneous node and then the Container Settings tab.
  2. The Redirect content (determines the value for user-readable data used in a redirect) and Redirect content type (the servlet container uses this value to set the type on the response for internal redirects) fields do not persist values entered in them. Set these values in the text of weblogic.xml.
  3. Check to specify whether redirects will use absolute URLs. If unchecked, the servlet container will not convert the relative url to the absolute URL in the location header in a redirect.
  4. Specify whether to check authentication on forward. If checked, the request dispatcher will check authorization on forwarded requests.
  5. Enter the name of a URL match-map class name for this Web Application.

 

Setting Welcome and Error Pages

Specify a welcome page and error using the following procedure. The welcome-file-list element and error-page element written using this procedure are located in web.xml. See welcome-file-list and error-page.

  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 an Existing Tag Library

Add tag libraries to your web application using the following procedure. The taglib element written using this procedure is located in web.xml. For information about tag libraries, see Overview of Programming JSP Tag Extensions. Also see taglib

  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. See virtual-directory-mapping in weblogic.xml Deployment Descriptor Elements.

  1. In the navigational tree, under Web Application, Miscellaneous, 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

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 2.0 beans, WebLogic Builder will not display the Relations node.
  2. In the Relations dialog, enter 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, set 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

  1. , In the navigational tree under EJB, expand an entity bean node, select the CMP Fields node and cllick Add.
  2. In the CMP Fields dialog, set the field's name. 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

  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. See Choosing a Concurrency Strategy.

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.
  2. Click Configure concurrency and select the Verify column and the Optimistic column to map the entity bean to a table.
  3. Select Version or Timestamp in the Verify column to enable the Optimistic column field.
  4. 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 or an ejb-local-reference Between Two Beans

See http://java.sun.com/dtd/ejb-jar_2_0.dtd and weblogic-ejb-jar.xml Deployment Descriptor Reference.

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

    In the Add dialog, enter or select the following parameters:

    • EJB name
    • EJB reference (or local reference) name
    • Type of bean
    • Home class
    • Remote class
    • JNDI name

 

Working with the J2EE Container

 

Ordering a Module

To set the deployment order of a module, use the following procedure. See Deployment Order in Deploying WebLogic Server Applications.

  1. In the navigational tree, select the root node of the application.
  2. In the 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. See Tuning WebLogic Server EJBs and http://www.bea.com/servers/wls810/dtd/weblogic-ejb-jar.dtd.

  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

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.

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-refdescription, 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 Deployment Descriptor Reference.

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 - >AdvancedFor 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 - >CacheNot 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 - >Cachenot 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 Programming WebLogic Server Enterprise JavaBeans.

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

Skip navigation bar  Back to Top Previous Next