apache > ws.apache

## Apache Muse - WS-DistributedManagement - Relationships Capability

Spec name and port type: WS-DistributedManagement v1.1, Relationships (WSDL)

Capability URI: http://docs.oasis-open.org/wsdm/muws/capabilities/Relationships

Description: This capability allows users to create relationships between the resource and another resource (that also has this capability). The two resources that are involved in a relationship are called participants. Each relationship between participants is represented as a WS-resource.

Java interface: org.apache.muse.ws.dm.muws.Relationships

> JAR file: muse-wsdm-muws-api.jar

Default Java implementation: org.apache.muse.ws.dm.muws.impl.SimpleRelationships

> JAR file: muse-wsdm-muws-impl.jar

Action on initialize(): The default implementation checks to make sure that a resource with the WSDM RelationshipResource capability has been deployed in the same application so that it can create relationship resources. If no such resource type is deployed, initialization will fail.

Action on initializeCompleted(): None.

Action on prepareShutdown(): None.

Action on shutdown(): None.

Non-Core Dependencies:

- http://docs.oasis-open.org/wsdm/muws/capabilities/RelationshipResource

Behavior and Limitations: Muse's implementation of WSDM Relationships provides a way for server-side code to create, manipulate, and destroy resources, but does not expose these interfaces to remote clients. In fact, no remote interface for relationship manipulation is provided by WSDM 1.1. This should not be a problem since the creation of relationships is usually a side effect of some other event (initialization or state change) and allowing clients a generic control over the relationship collection would prove hard to secure. If you absolutely want to provide a remote SetRelationship operation (or equivalent), you should make your own operation and then forward to the methods in the Relationships interface so that you have the opportunity to filter the requests.