@jws:control Tag

Specifies that the object annotated by this tag is a WebLogic Workshop control. Causes the object to be displayed as a control in Design View and causes WebLogic Server to connect the control to its underlying infrastructure.

# Syntax

    @jws:control

# Attributes

none

# Remarks

The following rules apply to this tag's use:

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

- Must appear on each control instance declaration in a JWS file A JWS file holds a WebLogic Workshop Java Web Service. JWS files contain syntactically correct Java code. However, they may also contain special annotation that allows the web services to take advantage of powerful features of the WebLogic Workshop runtime and the WebLogic Server. All JWS files contain a class derived from a special base class called Service that makes certain helper resources available to the class at runtime. The goal of all the helper code is to make it really easy to put a Java- and-J2EE-based service on the net with standard protocols..

If the @jws:control tag is not present on a control instance declaration, the control will not be connected to its underlying infrastructure and therefore the control will not operate. Attempts to invoke control methods will result in Null Pointer Exceptions (NPEs).

Note: All @jws tags are Javadoc tags. Javadoc tags are not recognized unless they are in a Javadoc comment, which must begin with /** (two asterisks).

Related Topics

Controls: Using Resources from a Web Service

Structure of a JWS File