A
resource is created by providing a location as an argument to a type-specific
creation method.
Any properties that might be needed to create the resource, such as the
stream for the activity, must be set in the proxy before calling the create
method. You cannot create a resource with empty or invalid values for required
properties. The failure occurs (as a WvcmException) when
you call the doCreateResource() or doCreateGeneratedResource() method.
The Activity proxy (
a2, in the following example) is constructed
before the server-side object. For example:
CcStream stream = . . .;
CcActivity a2 = provider.ccActivity(provider.stpLocation("cc.activity:a_new_activity@\projects"));
// set the headline
a2.setHeadline("The new task");
// Set the stream
a2.setStream(stream);
// create the activity
a2.doCreateCcActivity();
A new resource (including a file-area private ControllableResource such
as CcFile or CcDirectory) is constructed as follows:
- Determine the address for the new resource.
- Construct a Location object for that address by using one of the StpProvider.stpLocation() methods.
Create a location for the resource by adding a child segment to the selected
folder location.
- Obtain a proxy for that location from the provider. Construct a proxy
whose object class matches the type of the new resource by using the appropriate
Provider proxy factory method.
- Populate the proxy with any property values required or appropriate for
the new resource. Establish the initial values for the resource properties
that can be set by using the set methods on the new proxy.
- Invoke the create-resource operation (doCreateResource method)
on the proxy, which returns a proxy for the newly created resource that contains
any property values requested in the create-resource operation.