Класс 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.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");