Scope
Class
Multiplicity
(0..*): You can use this tag zero or more
times on any Java™ source file that implements a CMP entity bean.
Purpose
This tag defines a value object that encompasses
some subset of the CMP entity bean's fields and container-managed relationships
(CMR fields). A Service Data Object (SDO) class will be generated for each
value-object. The “default” value-object contains members for all the CMP
fields defined in the bean. Value objects with a subset of CMP fields are
commonly referred to as “light” objects, and value objects that contain members
for CMR fields are commonly referred to as “deep” objects. When a CMR field
is added to a value-object, then there must also be a value-object defined
for the related CMP bean. For example, if the “address” CMR field of user
is added to the “User” value-object, then a value-object named “Address” (or
in this case default) must be defined on the “Address” CMP entity bean.
Parameters
Parameter |
Type |
Applicability |
Description |
Mandatory |
name |
text |
All |
The abstract name of the value object. The name must
be unique to the EJB module, and must be a valid Java identifier. The generated
class name will be the SDO name. By default all CMP fields and no CMR fields
are included in the generated SDO. |
True |
read-only |
boolean |
All |
If true, indicates that only "read" methods should be
created on the session façade. |
False |