WebLogic Builder Online Help
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.
- Under your Web Application's name in the navigational tree, select Servlets.
- In the Servlets panel, select the servlet and click Add.
- In the General tab, enter the Servlet Name and servlet class or JSP file.
- Optionally, add URL mappings to the servlet in the URL mappings list by entering the URL pattern and clicking Add.
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.
- Under the Web Application node in the navigational tree, select Security Roles.
- In the editing panel, click Add, enter security role names and descriptions, and click OK.
- Under the Web Application node in the navigational tree, select Security Roles.
- In the editing panel, select a Role and click Edit.
- In the Edit dialog, add the names of members of the Role.
- Expand the Security Constraints node, and select a Constraint.
- In the Resources/Pages tab, set the following:
- Web Resource Name
- URL patterns for Web Resources
See virtual-directory-mapping in weblogic.xml Deployment Descriptor Elements, and filter-mapping in web.xml Deployment Descriptor Elements.
- HTTP methods
- allowed and disallowed roles
- In the Roles tab, set the Roles for which the Resources/Pages settings are allowed.
- 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.
- In the navigational tree, under the Web Tier, select J2EE References.
- 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.
- 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.
- In the navigational tree, under the name of your Web Application, select J2EE References.
- In the J2EE References editing panel, select the Resource Refs tab and click Add.
- 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.
- In the navigational tree, expand the WebLogic Settings node under Web Applications, select J2EE Links and click Add.
- 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.
- In the navigational tree, under the name of your Web Application, select Listeners.
- In the Listener editing panel, click Add.
- 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.
- Under the name of your Web Application in the navigational tree, select Filters.
- In the Filters edit panel, click Add.
- 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.
- Under the name of your Web Application in the navigational tree, select the Miscellaneous node and then the Container Settings tab.
- 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
.
- 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.
- Specify whether to check authentication on forward. If checked, the request dispatcher will check authorization on forwarded requests.
- 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.
- Select your Web Application's name in the navigational tree.
- In the edit panel for the Web Application, select Welcome Files.
- 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.
- Select the Error Pages tab and click Add.
- 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.
- Under your Web Application name in the navigational tree, select Tag Libraries.
- In the Tag Libraries editing panel, click Add.
- Enter the URI for the tag library.
- Enter the location of the TLD or JAR file, or browse to it and select it.
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.
- In the navigational tree, under Web Application, Miscellaneous, select VirtualDirectoryMappings and click Add.
- 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.
- 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.
- In the Relations dialog, enter a name for the relation.
- Set the Between option to One or Many for the first bean, and select the bean.
- 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.
- 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.
- In the third Relations dialog, select the role name and optionally set bidirectional relations (CMR field and field type).
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
- , In the navigational tree under EJB, expand an entity bean node, select the CMP Fields node and cllick Add.
- 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.
- 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.
- To select the column name, click the browse button and browse the table. Select a column and 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
- In the navigational tree, under the name of your entity bean, expand the bean and select Finders.
- In the bean's Finder editing panel, click Add.
- 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.
- With an entity bean selected in the left navigational panel, select Tuning -> Cache. In the Concurrency strategy selection field, select Optimistic.
- Click Configure concurrency and select the Verify column and the Optimistic column to map the entity bean to a table.
- Select Version or Timestamp in the Verify column to enable the Optimistic column field.
- 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.
- In the navigation tree, expand an EJB and select Resources.
- 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.
- In the navigational tree, select the root node of the application.
- In the editing panel, select Deployment Order.
- 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.
- In the navigational tree, under the EJB node, expand a bean and select Tuning.
- 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.
- In the navigational tree, select the WebLogic Application Settings node.
- In the WebLogic Application Settings editing panel, select the Security Realm tab.
- 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
- From the Tools menu, select Options.
- In the Options dialog, select EJBC Compiler.
- 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.
- From the View menu, select XML Source.
A tabbed XML viewer appears.
- 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-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 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—>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 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
|