- All Known Implementing Classes:
NamedOperation,NamespaceOperation,StandardOperation
public interface Operation
An object that describes a dynamic operation. Dynalink defines a set of
standard operations with the
StandardOperation class, as well as a
way to express the target namespace(s) of an operation
on an object using NamespaceOperation and finally a way to attach
a fixed target name to an operation using NamedOperation.
When presenting examples in this documentation, we will refer to standard
operations using their name (e.g. GET), to namespace operations
by separating their base operation with a colon from their namespace
(e.g. GET:PROPERTY), or in case of multiple namespaces we will
further separate those with the vertical line character (e.g.
GET:PROPERTY|ELEMENT), and finally we will refer to named operations
by separating the base operation and the name with the colon character (e.g.
GET:PROPERTY|ELEMENT:color).-
Method Summary
Modifier and Type Method Description default NamedOperationnamed(Object name)Returns aNamedOperationusing this operation as its base.default NamespaceOperationwithNamespace(Namespace namespace)Returns aNamespaceOperationusing this operation as its base.default NamespaceOperationwithNamespaces(Namespace... namespaces)Returns aNamespaceOperationusing this operation as its base.
-
Method Details
-
withNamespace
Returns aNamespaceOperationusing this operation as its base.- Parameters:
namespace- the namespace that is the target of the namespace operation.- Returns:
- a
NamespaceOperationwith this operation as its base and the specified namespace as its target. - Throws:
IllegalArgumentException- if this operation is already a namespace operation or a named operation.NullPointerException- ifnamespaceis null.
-
withNamespaces
Returns aNamespaceOperationusing this operation as its base.- Parameters:
namespaces- the namespaces that are the target of the namespace operation.- Returns:
- a
NamespaceOperationwith this operation as its base and the specified namespaces as its targets. - Throws:
IllegalArgumentException- if this operation is already a namespace operation or a named operation.NullPointerException- ifnamespaceor any of its elements is null.
-
named
Returns aNamedOperationusing this operation as its base.- Parameters:
name- the name that is the target of the named operation.- Returns:
- a
NamedOperationwith this operation as its base and the specified name. - Throws:
IllegalArgumentException- if this operation is already a named operation.NullPointerException- ifnameis null.
-