Класс 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 фактически будет соответствовать элементу map с ключом "empty", если map содержит этот ключ, и только затем обратится к свойству-оператору получения значения свойства 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");