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-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

 

back to top