A configure element creates and updates an entity. The value of the type attribute specifies the operation to perform, as follows:
Value of type attribute |
Action |
|---|---|
create |
Create a new entity with the specified name and with the specified properties. The operation fails if the entity already exists. |
update |
Update the specified properties for an existing entity. The operation fails if the entity does not exist. |
delete |
Deletes the specified property settings from an existing entity. The operation fails if the entity does not exist. |
If you are embedding an XML file in a J2EE archive to configure entities defined in the archive, use the update operation. Entities defined in the file will exist when the XML configuration file is applied.
The entity attribute specifies the entity to operate on, using the format described in “Entity identifiers”. The configure element can contain 0 or more property elements to configure the entity’s properties.
Here is an example configure element:
<configure type="create" entity="Package:DocTest">
<property name="${desc}" value="New package" />
</configure>
