|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface SetResourcePropertiesPermissions
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.
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.
Method Summary | |
---|---|
void |
deleteResourceProperty(QName qname,
Object securityToken)
Removes all properties with the given name. |
Object |
getSecurityToken()
Returns the security token that can be used by users of the WS-RP document to verify that they are internal callers with permission to circumvent published restrictions on property changes, etc. |
void |
insertResourceProperty(QName qname,
Object[] values,
Object securityToken)
Creates a new instance of the given property for each value specified in the array of values. |
void |
updateResourceProperty(QName qname,
Object[] values,
Object securityToken)
Updates all instances of the given property using the given values; all previous values will be removed in lieu of these new values. |
Method Detail |
---|
void deleteResourceProperty(QName qname, Object securityToken) throws BaseFault
qname
- The name of the property to delete.securityToken
- The token used to verify permission to call this method.
BaseFault
- Object getSecurityToken()
void insertResourceProperty(QName qname, Object[] values, Object securityToken) throws BaseFault
qname
- The name of the property instances to create.values
- The set of values that will be assigned to the new property
instances. Each value will be created once.securityToken
- The token used to verify permission to call this method.
BaseFault
- void updateResourceProperty(QName qname, Object[] values, Object securityToken) throws BaseFault
qname
- The name of the property to update.values
- The values to assign to the property.securityToken
- The token used to verify permission to call this method.
BaseFault
-
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |