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