@jws:connection Tag

Specifies the data source used by a Database control.

# Syntax

    @jws:connection
        data-source-jndi-name="JNDINameofDataSource"

# Attributes

data-source-jndi-name

Required. The JNDI name of a defined data source. Default: null.

# Remarks

The following rules apply to this tag's use:

- Only one @jws:connection tag may appear within a single Javadoc comment block.

- The @jws:connection tag must appear in the Javadoc comment on the main interface defined in a Database control's CTRL file.

JNDI is the Java Naming and Directory Interface. data-source-jndi-name must be a valid name of a data source as it appears in the local JNDI registry.

To learn how to create, configure and register a new data source, please consult the WebLogic Server documentation on JDBC Data Sources.

Two data sources are pre-configured when WebLogic Workshop is installed. Both operate on the default PointBase database system by default. The pre-configured data source names are:

- cgSampleDataSource: the default data source name that is the initial value for @jws:connection when a new Database control is created. This data source is intended for experimentation. It is used by all Database controls in the samples project.

- cgDataSource: a data source used by WebLogic Workshop for internal bookkeeping. You should not perform any database activities against this data source. When WebLogic Server web services are deployed to a production environment, cgDataSource should be redirected to a more robust database system.

Related Topics

Database Control: Using a Database from Your Web Service

How Do I: Connect a Database Control to a Database Such as SQL Server or Oracle?

How Do I: Configure WebLogic Workshop to Use a Different Database for Internal State?

How Do I: WebLogic Workshop-Enable an Existing WebLogic Server Domain?

@jws:sql Tag