com.softwareag.mdm.service
Interface ValueContextForUpdate

All Superinterfaces:

ValueContext

public interface ValueContextForUpdate

extends ValueContext

This container-interface provides the possibility to set values on a persistent or transient content whose structure and types conform to an underlying schema.

See Also:

ProcedureContext.getContext(AdaptationName), ProcedureContext.getContextForNewOccurrence(AdaptationTable)

Method Summary

void	setValue(Object aValue, Path aPath) Sets the value to the node specified.
void	setValueFromXsString(String aString, Path aPath) The string must comply with the standard representation of the associated type, as specified by XML Schema.

Methods inherited from interface com.softwareag.mdm.instance.ValueContext

displayOccurrence, formatOccurrence, getHome, getNode, getNode, getValue, getValue

Method Detail

setValue

public void setValue(Object aValue,
                     Path aPath)
              throws UnavailableContentError,
                     PathAccessException,
                     IllegalArgumentException

Sets the value to the node specified. The value's Java type must be consistent with the schema node type.

On a terminal adaptation node, the peculiar value AdaptationValue.INHERIT_VALUE may be set for specifying that a node inherits its value from the parent adaptation instance (this is indeed the default value for a newly created adaptation instance).

The container will validate it against the schema type and constraints when the transaction is committed.

Warning: data updates

Any update on data must conform to Rule for updates.

Throws:

UnavailableContentError - If content has become unavailable because of a schema error.

PathAccessException - If the node specified does not exist.

IllegalArgumentException - If the node specified cannot be written.

See Also:

AdaptationValue.INHERIT_VALUE

setValueFromXsString

public void setValueFromXsString(String aString,
                                 Path aPath)
                          throws InvalidChangeError,
                                 UnavailableContentError,
                                 PathAccessException

The string must comply with the standard representation of the associated type, as specified by XML Schema.

Warning: data updates

Any update on data must conform to Rule for updates.

Throws:

InvalidChangeError

UnavailableContentError

PathAccessException

See Also:

SchemaNode.parseXsString(String)