You are viewing a plain text version of this content. The canonical link for it is here.
Posted to muse-commits@ws.apache.org by da...@apache.org on 2006/08/28 23:55:30 UTC
svn commit: r437856 [2/2] - in /webservices/muse/trunk/modules:
muse-wsrf-api/src/org/apache/muse/ws/resource/
muse-wsrf-api/src/org/apache/muse/ws/resource/basefaults/
muse-wsrf-api/src/org/apache/muse/ws/resource/ext/
muse-wsrf-api/src/org/apache/mus...
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetRequest.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetRequest.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetRequest.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetRequest.java Mon Aug 28 14:55:27 2006
@@ -20,6 +20,17 @@
import org.apache.muse.util.xml.XmlSerializable;
+/**
+ *
+ * SetRequest is a simple collection of {@linkplain SetRequestComponent SetRequestComponents}.
+ * It represents the parameters of a wsrf-rp:SetResourceProperties request.
+ * Instances of this type do not perform any set commands themselves, they
+ * simply contain the definitions of the commands (SetReqeustComponents).
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ */
+
public interface SetRequest extends XmlSerializable
{
void addRequestComponent(SetRequestComponent operation);
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetRequestComponent.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetRequestComponent.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetRequestComponent.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetRequestComponent.java Mon Aug 28 14:55:27 2006
@@ -24,17 +24,45 @@
import org.apache.muse.ws.resource.basefaults.BaseFault;
import org.apache.muse.ws.resource.properties.ResourcePropertyCollection;
+/**
+ *
+ * SetRequestComponent is the atomic unit of construction for WSRP
+ * SetResourceProperties requests. Instances of this type can be
+ * executed against a {@linkplain ResourcePropertyCollection WSRP document}.
+ * There is a finite set of concrete SetRequestComponent types, and they are
+ * defined by the WSRP v1.2 spec.
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ *
+ */
+
public interface SetRequestComponent extends XmlSerializable
{
- Element[] EMPTY_VALUES = new Element[0];
-
+ /**
+ *
+ * Performs the set command on the given WSRP document. There may be
+ * one or more changes made to the document as the result of this command.
+ *
+ */
void execute(ResourcePropertyCollection props)
throws BaseFault;
-
+
int getNumberOfValues();
-
+
+ /**
+ *
+ * @return The name of the property being operated on.
+ *
+ */
QName getPropertyName();
-
+
+ /**
+ *
+ * @return The security token assigned by the command's creator, which
+ * may affect its ability to execute successfully.
+ *
+ */
Object getSecurityToken();
Element getValue(int index);
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetResourceProperties.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetResourceProperties.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetResourceProperties.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetResourceProperties.java Mon Aug 28 14:55:27 2006
@@ -23,32 +23,8 @@
import org.apache.muse.ws.resource.properties.set.faults.UnableToModifyResourcePropertyFault;
/**
- *
- * SetResourcePropertiesRequests breaks apart the WS-RP SetResourceProperties
- * operation into a set of convenience methods. Each of the set operations
- * { Insert, Update, Delete } now has its own method(s), allowing internal
- * callers to perform modifications with much less plumbing code.
- * <br><br>
- * This interface also defines a security mechanism that can be used to limit
- * the use of these methods to internal callers, and/or to differentiate
- * between internal and external callers so that internal requests can have
- * more freedom in their modifications. A resource may need to modify properties
- * in a way that is not allowed from an external client; an example would be
- * a read-only property such as "free disk space" which changes frequently
- * but is not directly write-able by clients. It also allows users to define
- * specialized methods for accessing certain properties and disallow access
- * through the generic WS-RP methods.
- * <br><br>
- * The security token is meant to be a simple unique value that cannot be
- * easily generated by an external caller; for many implementations, the use
- * of a simple Object reference will suffice, since the JVM will never produce
- * two references with the same address. If code is written that uses the
- * security token version of these methods, the calls will not succeed unless
- * the token matches the document's internal token.
- *
- * @author Dan Jemiolo (danj)
*
- * @see org.apache.muse.ws.resource.properties.set.impl.AbstractSetRequestComponent
+ * @author Dan Jemiolo (danj)
*
*/
@@ -62,7 +38,6 @@
* transaction support as part of basic WS-RP, so if one operation fails,
* the operations that were completed before it will remain intact.
*
- *
* @param request
* The SetResourceProperties request that contains the individual
* operations { Insert, Update, Delete } to perform on the document.
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetResourcePropertiesComponents.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetResourcePropertiesComponents.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetResourcePropertiesComponents.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetResourcePropertiesComponents.java Mon Aug 28 14:55:27 2006
@@ -20,14 +20,21 @@
import org.apache.muse.ws.resource.basefaults.BaseFault;
+/**
+ *
+ * SetResourcePropertiesComponents breaks apart the WS-RP SetResourceProperties
+ * operation into a set of convenience methods. Each of the set operations
+ * { Insert, Update, Delete } now has its own method(s), allowing internal
+ * callers to perform modifications with much less plumbing code.
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ */
public interface SetResourcePropertiesComponents
{
/**
*
- * Removes <b>all</b> properties with the given name. Calling this method
- * is the same as calling delete(QName, Object) with a valid security token.
- *
- * @throws BaseFault
+ * Removes <b>all</b> properties with the given name.
*
*/
void deleteResourceProperty(QName qname)
@@ -35,9 +42,7 @@
/**
*
- * Creates a new instance of the given property using the given value.
- * Calling this method is the same as calling
- * insert(QName, Object[], Object) with a valid security token.
+ * Creates new instances of the given property using the given values.
*
*/
void insertResourceProperty(QName qname, Object[] values)
@@ -45,10 +50,7 @@
/**
*
- * Updates <b>all</b> instances of the given property using the given
- * values; all previous values will be removed in lieu of these new
- * values. Calling this method is the same as calling
- * update(QName, Object, Object) with a valid security token.
+ * Replaces all of a property's current values with the given values.
*
*/
void updateResourceProperty(QName qname, Object[] values)
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetResourcePropertiesPermissions.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetResourcePropertiesPermissions.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetResourcePropertiesPermissions.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/SetResourcePropertiesPermissions.java Mon Aug 28 14:55:27 2006
@@ -20,6 +20,28 @@
import org.apache.muse.ws.resource.basefaults.BaseFault;
+/**
+ *
+ * SetResourcePropertyPermissions defines a security mechanism that can be used
+ * to limit the use of these methods to internal callers, and/or to differentiate
+ * between internal and external callers so that internal requests can have
+ * more freedom in their modifications. A resource may need to modify properties
+ * in a way that is not allowed from an external client; an example would be
+ * a read-only property such as "free disk space" which changes frequently
+ * but is not directly write-able by clients. It also allows users to define
+ * specialized methods for accessing certain properties and disallow access
+ * through the generic WS-RP methods.
+ * <br><br>
+ * The security token is meant to be a simple unique value that cannot be
+ * easily generated by an external caller; for many implementations, the use
+ * of a simple Object reference will suffice, since the JVM will never produce
+ * two references with the same address. If code is written that uses the
+ * security token version of these methods, the calls will not succeed unless
+ * the token matches the document's internal token.
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ */
public interface SetResourcePropertiesPermissions
{
/**
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/InvalidModificationFault.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/InvalidModificationFault.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/InvalidModificationFault.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/InvalidModificationFault.java Mon Aug 28 14:55:27 2006
@@ -21,6 +21,12 @@
import org.apache.muse.ws.resource.basefaults.BaseFault;
import org.apache.muse.ws.resource.properties.WsrpConstants;
+/**
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ */
+
public class InvalidModificationFault extends BaseFault
{
private static final long serialVersionUID = -322440717755308354L;
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/SetResourcePropertyRequestFailedFault.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/SetResourcePropertyRequestFailedFault.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/SetResourcePropertyRequestFailedFault.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/SetResourcePropertyRequestFailedFault.java Mon Aug 28 14:55:27 2006
@@ -21,6 +21,12 @@
import org.apache.muse.ws.resource.basefaults.BaseFault;
import org.apache.muse.ws.resource.properties.WsrpConstants;
+/**
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ */
+
public class SetResourcePropertyRequestFailedFault extends BaseFault
{
private static final long serialVersionUID = 2505691715009677115L;
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/UnableToModifyResourcePropertyFault.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/UnableToModifyResourcePropertyFault.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/UnableToModifyResourcePropertyFault.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/UnableToModifyResourcePropertyFault.java Mon Aug 28 14:55:27 2006
@@ -21,6 +21,12 @@
import org.apache.muse.ws.resource.basefaults.BaseFault;
import org.apache.muse.ws.resource.properties.WsrpConstants;
+/**
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ */
+
public class UnableToModifyResourcePropertyFault extends BaseFault
{
private static final long serialVersionUID = 7530628873576034625L;
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/UnableToPutResourcePropertyDocumentFault.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/UnableToPutResourcePropertyDocumentFault.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/UnableToPutResourcePropertyDocumentFault.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/properties/set/faults/UnableToPutResourcePropertyDocumentFault.java Mon Aug 28 14:55:27 2006
@@ -7,8 +7,6 @@
/**
*
- * UnableToPutResourcePropertyDocumentFault is ...
- *
* @author Mohammad Fakhar
*
*/
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/Entry.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/Entry.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/Entry.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/Entry.java Mon Aug 28 14:55:27 2006
@@ -28,20 +28,16 @@
/**
*
- * Entry is an interface for WS-ServiceGroup Entry resources. Such resources
+ * Entry represents the WS-RF ServiceGroupEntry resource type. Such resources
* represent a relationship between a resource and the service group of which
* it is a member; the modification or destruction of these resources
* represents a change in the resource's membership in a service group.
* Changes in the service group members do not necessarily affect membership.
* <br><br>
- * Muse represents all WS-SG entries at WS-RF (implied) resources. They
- * are accessible through a unique endpoint and can be destroyed via WS-RL.
- * Users who want to create service groups but don't want to expose them to
- * external components should use the <b>private</b> tag in their resource
- * definition in muse.xml.
- * <br><br>
- * If you want to add the WSDM ServiceGroup capability to a participant
- * resource, use the {@linkplain ServiceGroup ServiceGroup} interface.
+ * Muse represents all WS-SG entries at WS-RF implied resources. They
+ * are accessible through a unique endpoint and can be destroyed via WS-RL
+ * if the WS-RL capabilities are used. Adding this capability to a resource
+ * type gives it all of the required features of a WS-RF ServiceGroupEntry.
*
* @author Dan Jemiolo (danj)
*
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/MembershipContentRule.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/MembershipContentRule.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/MembershipContentRule.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/MembershipContentRule.java Mon Aug 28 14:55:27 2006
@@ -21,6 +21,18 @@
import org.apache.muse.util.xml.XmlSerializable;
import org.apache.muse.ws.addressing.EndpointReference;
+/**
+ *
+ * MembershipContentRule represents the wsrf-sg:MembershipContentRule
+ * resource property defined by the WS-RF ServiceGroup resource type.
+ * Aside from the fields that are included in the content rule definition,
+ * the interface also contains a method for evaluating the rules against
+ * a WS-resource.
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ */
+
public interface MembershipContentRule extends XmlSerializable
{
QName[] getContentElements();
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroup.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroup.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroup.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroup.java Mon Aug 28 14:55:27 2006
@@ -33,10 +33,10 @@
/**
*
* ServiceGroup is an internal representation of the WSDM ServiceGroup
- * capability. It provides access to the one property (Entry) along
- * with methods for creating, destroying, and querying entries. The
- * Add operation is exposed here; the other methods are for internal
- * entry management and should not be made public.
+ * capability. It provides access to the service group properties along
+ * with methods for creating, destroying, and querying entries. Resources
+ * that use this capability will have the ability to act as directories for
+ * other resources while still performing other functions.
*
* @author Dan Jemiolo (danj)
*
@@ -51,8 +51,8 @@
/**
*
- * Creates a new Entry resource and adds it to the touchpoint's
- * ResourceManager and the ServiceGroup's WS-RP container.
+ * Creates a new Entry resource and adds it to Muse's ResourceManager and
+ * the ServiceGroup's WS-RP container.
*
* @param memberEPR
* The EPR of the resource that the Entry will represent.
@@ -61,15 +61,7 @@
* The initial termination time for the Entry. This may be null
* if the Entry is not scheduled for destruction.
*
- * @return The newly-created (and stored) Entry.
- *
- * @throws BaseFault
- * <ul>
- * <li>If there was an error during the initialization of the
- * Entry resource instance.</li>
- * <li>If there was an error inserting into the ServiceGroup's
- * WS-RP container.</li>
- * </ul>
+ * @return The newly-created (and stored) Entry resource.
*
*/
WsResource addEntry(EndpointReference memberEPR,
@@ -80,18 +72,45 @@
UnsupportedMemberInterfaceFault,
BaseFault;
+ /**
+ *
+ * Adds the EPR/resource mapping to the implementation's collection
+ * of service group entries.
+ *
+ * @param memberEPR
+ * The EPR of the service group entry.
+ *
+ * @param entry
+ * The resource that represents the service group entry.
+ *
+ * @return The same resource provided as a second parameter.
+ *
+ */
WsResource addEntry(EndpointReference memberEPR, WsResource entry)
throws AddRefusedFault,
ContentCreationFailedFault,
UnsupportedMemberInterfaceFault,
BaseFault;
+ /**
+ *
+ * @return All of the content elements in the group's membership content rules.
+ *
+ */
QName[] getContentElements()
throws BaseFault;
WsResource[] getEntry()
throws BaseFault;
+ /**
+ *
+ * @param memberEPR
+ *
+ * @return The entry resource associated with the given EPR, or null if
+ * no such resource exists.
+ *
+ */
WsResource getEntry(EndpointReference memberEPR)
throws BaseFault;
@@ -111,19 +130,7 @@
*/
boolean isMatch(EndpointReference epr)
throws BaseFault;
-
- /**
- *
- * Deletes the Entry from the ServiceGroup's WS-RP container.
- *
- * @param entry
- *
- * @throws BaseFault
- * <ul>
- * <li>If the entry has already been removed.</li>
- * </ul>
- *
- */
+
void removeEntry(WsResource entry)
throws BaseFault;
}
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroupPersistence.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroupPersistence.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroupPersistence.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroupPersistence.java Mon Aug 28 14:55:27 2006
@@ -20,6 +20,17 @@
import org.apache.muse.core.ResourceManagerListener;
import org.apache.muse.ws.resource.WsResource;
+/**
+ *
+ * ServiceGroupPersistence is an extension of the basic
+ * {@linkplain Persistence Persistence API} to provide a link to the
+ * {@linkplain ServiceGroup ServiceGroup API} and resource lifecycle events.
+ * Implementations of the ServiceGroup capability should use instances of
+ * this interface for persistence of service group state.
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ */
public interface ServiceGroupPersistence extends Persistence, ResourceManagerListener
{
WsResource getServiceGroup();
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroupRegistration.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroupRegistration.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroupRegistration.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/ServiceGroupRegistration.java Mon Aug 28 14:55:27 2006
@@ -27,9 +27,37 @@
import org.apache.muse.ws.resource.sg.faults.ContentCreationFailedFault;
import org.apache.muse.ws.resource.sg.faults.UnsupportedMemberInterfaceFault;
+/**
+ *
+ *
+ * ServiceGroupRegistration contains the optional wsrf-sg:Add operation, which
+ * can be added to resource types that already include the WS-RF
+ * {@linkplain ServiceGroup ServiceGroup capability}. The wsrf-sg:Add operation
+ * exposes to remote clients the ServiceGroup.addEntry() method so that external
+ * components can manage the contents of the service group.
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ */
public interface ServiceGroupRegistration extends WsResourceCapability
{
+ /**
+ *
+ * @param memberEPR
+ * The EPR of the resource that is being added to the group.
+ *
+ * @param content
+ * The current values of the resource properties that are listed
+ * in the group's membership content rules. This may be null.
+ *
+ * @param terminationTime
+ * The time at which the service group entry should be deleted.
+ * This may be null.
+ *
+ * @return The EPR of the resource that represents the new service group entry.
+ *
+ */
EndpointReference add(EndpointReference memberEPR, Element content, Date terminationTime)
throws AddRefusedFault,
ContentCreationFailedFault,
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/WssgConstants.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/WssgConstants.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/WssgConstants.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/WssgConstants.java Mon Aug 28 14:55:27 2006
@@ -21,7 +21,7 @@
/**
*
* WssgConstants is a collection of properties that is useful when programming
- * against the WS-ServiceGroups spec. This class uses WS-SG v1.2, draft 02.
+ * against the WS-ServiceGroups spec. This class uses WS-SG v1.2.
*
* @author Dan Jemiolo (danj)
*
@@ -30,10 +30,10 @@
public class WssgConstants
{
public static final String NAMESPACE_URI = "http://docs.oasis-open.org/wsrf/sg-2";
-
- public static final String WSDL_NAMESPACE_URI = "http://docs.oasis-open.org/wsrf/sgw-2";
public static final String PREFIX = "wsrf-sg";
+
+ public static final String WSDL_NAMESPACE_URI = "http://docs.oasis-open.org/wsrf/sgw-2";
public static final String WSDL_PREFIX = "wsrf-sgw";
@@ -43,66 +43,58 @@
public static final String ENTRY_URI = WSDL_NAMESPACE_URI + "/ServiceGroupEntry";
+ public static final QName ADD_QNAME =
+ new QName(NAMESPACE_URI, "Add", PREFIX);
+
+ public static final QName ADD_REFUSED_QNAME =
+ new QName(NAMESPACE_URI, "AddRefusedFault", PREFIX);
+
+ public static final QName ADD_RESPONSE_QNAME =
+ new QName(NAMESPACE_URI, "AddResponse", PREFIX);
+
/**
*
* The WS-A Action URI of the Add operation.
*
*/
- public static final String ADD_URI = SERVICE_GROUP_REG_URI + "/AddRequest";
-
- public static final QName ADD_QNAME =
- new QName(NAMESPACE_URI, "Add", PREFIX);
-
- public static final QName ADD_RESPONSE_QNAME =
- new QName(NAMESPACE_URI, "AddResponse", PREFIX);
+ public static final String ADD_URI = NAMESPACE_URI + "/Add";
public static final QName CONTENT_CREATION_FAILED_QNAME =
new QName(NAMESPACE_URI, "ContentCreationFailedFault", PREFIX);
- public static final QName UNSUPPORTED_MEMBER_INTERFACE_QNAME =
- new QName(NAMESPACE_URI, "UnsupportedMemberInterfaceFault", PREFIX);
-
- public static final QName ADD_REFUSED_QNAME =
- new QName(NAMESPACE_URI, "AddRefusedFault", PREFIX);
+ public static final String CONTENT_ELEMENTS = "ContentElements";
/**
*
- * The name of the wssg:SimpleMembershipContentRule property.
+ * The name of the wssg:Content property.
*
*/
- public static final QName CONTENT_RULE_QNAME =
- new QName(NAMESPACE_URI, "MembershipContentRule", PREFIX);
-
- public static final String MEMBERSHIP_INTERFACE = "MembershipInterface";
-
- public static final String CONTENT_ELEMENTS = "ContentElements";
-
- public static final QName INIT_TERMINATION_QNAME =
- new QName(NAMESPACE_URI, "InitialTerminationTime", PREFIX);
+ public static final QName CONTENT_QNAME =
+ new QName(NAMESPACE_URI, "Content", PREFIX);
/**
*
- * The name of the wssg:MemberEPR property.
+ * The name of the wssg:MembershipContentRule property.
*
*/
- public static final QName MEMBER_EPR_QNAME =
- new QName(NAMESPACE_URI, "MemberEPR", PREFIX);
+ public static final QName CONTENT_RULE_QNAME =
+ new QName(NAMESPACE_URI, "MembershipContentRule", PREFIX);
/**
*
- * The name of the wssg:ServiceGroupEPR property.
+ * The name of the wssg:CurrentTime return value.
*
*/
- public static final QName SG_EPR_QNAME =
- new QName(NAMESPACE_URI, "ServiceGroupEPR", PREFIX);
+ public static final QName CURRENT_TIME_QNAME =
+ new QName(NAMESPACE_URI, "CurrentTime", PREFIX);
/**
*
- * The name of the wssg:Content property.
+ * The name of the WS-SG entry addition event.
*
*/
- public static final QName CONTENT_QNAME =
- new QName(NAMESPACE_URI, "Content", PREFIX);
+ public static final QName ENTRY_ADDITION_QNAME =
+ new QName(NAMESPACE_URI, "EntryAdditionNotification", PREFIX);
/**
*
@@ -114,64 +106,72 @@
/**
*
- * The name of the wssg:CurrentTime return value.
+ * The name of the WS-SG entry destruction event.
*
*/
- public static final QName CURRENT_TIME_QNAME =
- new QName(NAMESPACE_URI, "CurrentTime", PREFIX);
+ public static final QName ENTRY_REMOVAL_QNAME =
+ new QName(NAMESPACE_URI, "EntryRemovalNotification", PREFIX);
+
+ public static final QName INIT_TERMINATION_QNAME =
+ new QName(NAMESPACE_URI, "InitialTerminationTime", PREFIX);
/**
*
- * The name of the wssg:TerminationTime return value.
+ * The name of the wssg:MemberEPR property.
*
*/
- public static final QName TERMINATION_TIME_QNAME =
- new QName(NAMESPACE_URI, "TerminationTime", PREFIX);
+ public static final QName MEMBER_EPR_QNAME =
+ new QName(NAMESPACE_URI, "MemberEPR", PREFIX);
/**
*
- * The name of the wssg:ServiceGroupEntryReference return value.
+ * The name of the wssg:MemberServiceEPR property.
*
*/
- public static final QName SG_ENTRY_REFERENCE_QNAME =
- new QName(NAMESPACE_URI, "ServiceGroupEntryReference", PREFIX);
+ public static final QName MEMBER_SERVICE_EPR_QNAME =
+ new QName(NAMESPACE_URI, "MemberServiceEPR", PREFIX);
+
+ public static final String MEMBERSHIP_INTERFACE = "MembershipInterface";
/**
*
- * The name of the wssg:ServiceGroupEntryEPR property.
+ * The name of the WS-N Topic for WS-SG lifecycle events.
*
*/
- public static final QName SG_ENTRY_EPR_QNAME =
- new QName(NAMESPACE_URI, "ServiceGroupEntryEPR", PREFIX);
+ public static final String MODIFICATION_TOPIC_NAME = "ServiceGroupModification";
/**
*
- * The name of the wssg:MemberServiceEPR property.
+ * The name of the wssg:ServiceGroupEntryEPR property.
*
*/
- public static final QName MEMBER_SERVICE_EPR_QNAME =
- new QName(NAMESPACE_URI, "MemberServiceEPR", PREFIX);
+ public static final QName SG_ENTRY_EPR_QNAME =
+ new QName(NAMESPACE_URI, "ServiceGroupEntryEPR", PREFIX);
/**
*
- * The name of the WS-SG entry addition event.
+ * The name of the wssg:ServiceGroupEntryReference return value.
*
*/
- public static final QName ENTRY_ADDITION_QNAME =
- new QName(NAMESPACE_URI, "EntryAdditionNotification", PREFIX);
+ public static final QName SG_ENTRY_REFERENCE_QNAME =
+ new QName(NAMESPACE_URI, "ServiceGroupEntryReference", PREFIX);
/**
*
- * The name of the WS-SG entry destruction event.
+ * The name of the wssg:ServiceGroupEPR property.
*
*/
- public static final QName ENTRY_REMOVAL_QNAME =
- new QName(NAMESPACE_URI, "EntryRemovalNotification", PREFIX);
+ public static final QName SG_EPR_QNAME =
+ new QName(NAMESPACE_URI, "ServiceGroupEPR", PREFIX);
/**
*
- * The name of the WS-N Topic for WS-SG lifecycle events.
+ * The name of the wssg:TerminationTime return value.
*
*/
- public static final String MODIFICATION_TOPIC_NAME = "ServiceGroupModification";
+ public static final QName TERMINATION_TIME_QNAME =
+ new QName(NAMESPACE_URI, "TerminationTime", PREFIX);
+
+ public static final QName UNSUPPORTED_MEMBER_INTERFACE_QNAME =
+ new QName(NAMESPACE_URI, "UnsupportedMemberInterfaceFault", PREFIX);
}
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/faults/AddRefusedFault.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/faults/AddRefusedFault.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/faults/AddRefusedFault.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/faults/AddRefusedFault.java Mon Aug 28 14:55:27 2006
@@ -21,6 +21,12 @@
import org.apache.muse.ws.resource.basefaults.BaseFault;
import org.apache.muse.ws.resource.sg.WssgConstants;
+/**
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ */
+
public class AddRefusedFault extends BaseFault
{
private static final long serialVersionUID = -5069068147595306686L;
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/faults/ContentCreationFailedFault.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/faults/ContentCreationFailedFault.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/faults/ContentCreationFailedFault.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/faults/ContentCreationFailedFault.java Mon Aug 28 14:55:27 2006
@@ -21,6 +21,12 @@
import org.apache.muse.ws.resource.basefaults.BaseFault;
import org.apache.muse.ws.resource.sg.WssgConstants;
+/**
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ */
+
public class ContentCreationFailedFault extends BaseFault
{
private static final long serialVersionUID = 5271763331503613580L;
Modified: webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/faults/UnsupportedMemberInterfaceFault.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/faults/UnsupportedMemberInterfaceFault.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/faults/UnsupportedMemberInterfaceFault.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-api/src/org/apache/muse/ws/resource/sg/faults/UnsupportedMemberInterfaceFault.java Mon Aug 28 14:55:27 2006
@@ -21,6 +21,12 @@
import org.apache.muse.ws.resource.basefaults.BaseFault;
import org.apache.muse.ws.resource.sg.WssgConstants;
+/**
+ *
+ * @author Dan Jemiolo (danj)
+ *
+ */
+
public class UnsupportedMemberInterfaceFault extends BaseFault
{
private static final long serialVersionUID = -6827344709676009932L;
Modified: webservices/muse/trunk/modules/muse-wsrf-impl/src/org/apache/muse/ws/resource/properties/set/impl/AbstractSetRequestComponent.java
URL: http://svn.apache.org/viewvc/webservices/muse/trunk/modules/muse-wsrf-impl/src/org/apache/muse/ws/resource/properties/set/impl/AbstractSetRequestComponent.java?rev=437856&r1=437855&r2=437856&view=diff
==============================================================================
--- webservices/muse/trunk/modules/muse-wsrf-impl/src/org/apache/muse/ws/resource/properties/set/impl/AbstractSetRequestComponent.java (original)
+++ webservices/muse/trunk/modules/muse-wsrf-impl/src/org/apache/muse/ws/resource/properties/set/impl/AbstractSetRequestComponent.java Mon Aug 28 14:55:27 2006
@@ -43,6 +43,8 @@
//
private static Messages _MESSAGES =
MessagesFactory.get(AbstractSetRequestComponent.class);
+
+ private static final Element[] _EMPTY_VALUES = new Element[0];
//
// The name of the property to modify
@@ -107,7 +109,7 @@
if (values.length == 0)
{
- _valuesXML = EMPTY_VALUES;
+ _valuesXML = _EMPTY_VALUES;
return;
}
---------------------------------------------------------------------
To unsubscribe, e-mail: muse-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: muse-commits-help@ws.apache.org