DesignTime@Runtime content abstraction for modification purposes.
Used to modify the underlying components in a running system.
It restricts the changes to those designed to be modified.
An ADF application is represented by objects at all the MVC layers.
This family of interfaces allows the client code to interact on a
simple abstraction and have the implementation do the right things
with all the cooperating layers and artifacts in the application.
It's expected that this interface can be implemented by various
view layer technologies, most especially, ADF Swing and ADF Faces.
Create a new default usage that can be added to this content.
A default usage is what would most commonly be referred to as a region.
That is, some other content referred to in this content. At runtime
the content is dynamically added to this content. Making changes to the
reference in this content through parameters on the usage is allowed,
but changing the included content directly from this content is not.
Changing the other content directly would affect all usages.
The usage definition must be available in the application.
This creates a usage object for the given definition type.
If no matching definition can be found an exception is thrown.
defName - contains the fully qualified def name of the usage to add
the customizable object (or null if it doesn't exist)
//RF: TODO: check out the exception in adf-faces-dt
Create a new usage that can be added to this content using the
creator registered with the registerUsageCreator in ContentFactory.
Both the elementName and namespaceURL are used to lookup the factory class.
elementName - the view document element name
namespaceURL - the view document namespace URL
the content usage that was factoried based on the element and namespace
Insert a usage into the content inside of the parent component.
Adds the given usage inside the parent component.
When successfully added to the content, the model will also reflect a
new binding created for the usage.
parent - The component within the content to insert into,
which was retrieved by a call to findComponent
newChild - the usage to add to the view
Note: Any content specific requirements will be met
Ex: All changes are registered with the faces change API.