Класс CompositeDataInvocationHandler

public class CompositeDataInvocationHandler
extends Object
implements InvocationHandler

Обработчик InvocationHandler, который перенаправляет методы-геттеры в CompositeData. Если у вас есть интерфейс, содержащий только методы-геттеры (например, String getName() или boolean isActive()), то вы можете использовать этот класс в сочетании с классом Proxy, чтобы создать реализацию интерфейса, где каждый геттер возвращает значение соответствующего элемента в CompositeData.

Например, предположим, что у вас есть интерфейс такого вида:

public interface NamedNumber {
    public int getNumber();
    public String getName();
}

и объект CompositeData, созданный так:

CompositeData cd =
    new CompositeDataSupport(
        someCompositeType,
        new String[] {"number", "name"},
        new Object[] {5, "five"}
    );

, то вы можете создать объект, реализующий NamedNumber, поддерживаемый объектом cd, следующим образом:

InvocationHandler handler =
    new CompositeDataInvocationHandler(cd);
NamedNumber nn = (NamedNumber)
    Proxy.newProxyInstance(NamedNumber.class.getClassLoader(),
                           new Class[] {NamedNumber.class},
                           handler);

. Вызов nn.getNumber() тогда вернёт **5**.

Если первая буква свойства, определённого геттером, заглавная, то этот обработчик сначала ищет элемент в CompositeData, начинающийся с заглавной буквы, а затем, если он не найден, ищет элемент, начинающийся с соответствующей строчной буквы или кода символа. Для геттера, названного getNumber(), обработчик сначала будет искать элемент, названный Number, а затем number. Если геттер называется getnumber(), то элемент должен называться number.

Если метод, переданный в invoke, является методом boolean equals(Object), унаследованным от Object, то он вернёт true только тогда, когда аргумент является Proxy, чьё InvocationHandler также является CompositeDataInvocationHandler и чья поддержка CompositeData равна (не обязательно идентична) объекту этого обработчика. Если метод, переданный в invoke, является методом int hashCode(), унаследованным от Object, то он вернёт значение, согласованное с этим определением equals: если два объекта равны согласно equals, то они будут иметь то же самое hashCode.

Конструкторы

CompositeDataInvocationHandler

public CompositeDataInvocationHandler(CompositeData compositeData)

Создаёт обработчик, поддерживаемый заданным CompositeData.

Параметры:

compositeData - CompositeData, который будет предоставлять информацию геттерам.

Исключения:

IllegalArgumentException - если compositeData равно null.

Методы

getCompositeData

public CompositeData getCompositeData()

Возвращает CompositeData, переданное в конструктор.

Возвращает:

CompositeData, на котором базируется этот обработчик. Это никогда не null.