Класс 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() если map не содержит ключ. Если исходный язык требует такой семантики, её можно легко реализовать с помощью операций над несколькими пространствами имён.

Даже если сам язык не различает некоторые пространства имён, может быть полезно сопоставлять различные синтаксисы с различными порядками пространств имён. Например, исходное выражение 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");