Класс ParameterBlock

public class ParameterBlock
extends Object
implements Cloneable, Serializable

Класс ParameterBlock содержит всю информацию о источниках и параметрах (объектах), необходимых классу RenderableImageOp или другим классам, обрабатывающим изображения.

Хотя в вектор источников можно поместить произвольные объекты, пользователи этого класса могут накладывать семантические ограничения, например, требуя, чтобы все источники были RenderedImages или RenderableImage. Сам класс ParameterBlock является просто контейнером и не выполняет проверки типов источников или параметров.

Все параметры в ParameterBlock являются объектами; доступны удобные методы add и set, которые принимают аргументы базовых типов и создают соответствующий подкласс Number (например, Integer или Float). Соответствующие методы get выполняют приведение типов и возвращают значения базового типа; если сохранённые значения не имеют правильного типа, будет выброшено исключение. Нет способа отличить результаты "short s; add(s)" и "add(new Short(s))".

Обратите внимание, что методы get и set работают с ссылками. Поэтому необходимо быть осторожным, чтобы не использовать ссылки между ParameterBlock при необходимости. Например, для создания нового ParameterBlock, равного старому, за исключением добавленного источника, можно попытаться написать:

ParameterBlock addSource(ParameterBlock pb, RenderableImage im) {
     ParameterBlock pb1 = new ParameterBlock(pb.getSources());
     pb1.addSource(im);
     return pb1;
 }

Этот код приведёт к побочному эффекту изменения исходного ParameterBlock, так как операция getSources вернула ссылку на его вектор источников. pb и pb1 делят свой вектор источников, и изменения в одном из них видны для обоих.

Правильный способ написания функции addSource — это клонирование вектора источников:

ParameterBlock addSource (ParameterBlock pb, RenderableImage im) {
     ParameterBlock pb1 = new ParameterBlock(pb.getSources().clone());
     pb1.addSource(im);
     return pb1;
 }

Метод clone класса ParameterBlock определён так, чтобы производить клонирование как вектора источников, так и вектора параметров. Для этого также доступен стандартный поверхностный клон - shallowClone.

Методы addSource, setSource, add и set возвращают 'this' после добавления аргумента. Это позволяет использовать синтаксис, подобный:

ParameterBlock pb = new ParameterBlock();
 op = new RenderableImageOp("operation", pb.add(arg1).add(arg2));