Класс NamespaceOperation

public final class NamespaceOperation
extends Object
implements Operation

Описание операции, которая работает с по крайней мере одним Namespace объекта. Например, описание получения свойства будет

Operation propertyGetter = new NamespaceOperation(
     StandardOperation.GET,
     StandardNamespace.PROPERTY);

Они часто комбинируются с NamedOperation, например, чтобы выразить получение свойства с именем "color", вы бы построили:

Operation colorPropertyGetter = new NamedOperation(
     new NamespaceOperation(
         StandardOperation.GET,
         StandardNamespace.PROPERTY),
     "color");

Хотя NamespaceOperation можно построить напрямую, часто удобнее использовать фабричные методы Operation.withNamespace(Namespace) и Operation.withNamespaces(Namespace...), например:

Operation getElementOrPropertyEmpty =
     StandardOperation.GET
         .withNamespace(StandardNamespace.PROPERTY)
         .named("color");

Операции над несколькими именованными пространствами имён

Если указано несколько пространств имён, пространства имён рассматриваются как альтернативы друг другу в порядке приоритета. Семантика такой операции — "первое применимое". То есть, составная операция GET:PROPERTY|ELEMENT:color должна интерпретироваться как получение свойства с именем "color" у объекта, но если такое свойство отсутствует, то получение элемента коллекции с именем "color".

Операции с несколькими именованными пространствами имён полезны при реализации языков, которые не различают одно или несколько пространств имён, или когда требуется выразить операции над объектами, которые могут рассматриваться как обычные объекты и как коллекции, например, объекты Java Map. Операция GET:PROPERTY|ELEMENT:empty над объектом Java map всегда будет соответствовать свойству Map.isEmpty(), но GET:ELEMENT|PROPERTY:empty фактически будет соответствовать элементу карты с ключом "empty", если карта содержит этот ключ, и только воспользуется получением свойства isEmpty() как запасным вариантом, если ключ в карте отсутствует. Если исходный язык требует такой семантики, её легко можно достичь с помощью операций над несколькими именованными пространствами имён.

Даже если сам язык не различает некоторые из пространств имён, полезно сопоставлять различные синтаксические конструкции с различными порядками пространств имён. Например, исходное выражение obj.color может быть сопоставлено с GET:PROPERTY|ELEMENT|METHOD:color, но другое исходное выражение, которое выглядит как доступ к элементу коллекции obj[key] может быть выражено как GET:ELEMENT|PROPERTY|METHOD для того, чтобы отдать предпочтение семантике элементов. Наконец, если полученное значение впоследствии вызывается, имеет смысл поместить METHOD в начало списка пространств имён: часть получения значения исходного выражения obj.color() может быть GET:METHOD|PROPERTY|ELEMENT:color, а часть для obj[key]() может быть GET:METHOD|ELEMENT|PROPERTY.

Основной операцией операции над именованным пространством имён не может быть сама операция над именованным пространством имён или именованная операция, а скорее одна из простых операций, таких как элементы StandardOperation. Однако сама операция над именованным пространством имён может служить основной операцией именованной операции; типичный способ построения, например, GET:ELEMENT|PROPERTY:empty из вышеприведённого примера, заключается в следующем:

Operation getElementOrPropertyEmpty = StandardOperation.GET
     .withNamespaces(
         StandardNamespace.ELEMENT,
         StandardNamespace.PROPERTY)
     .named("empty");