Класс NVList

public abstract class NVList
extends Object

Изменяемый список, содержащий NamedValue объекты.

Класс NVList используется следующим образом:

• для описания аргументов для объекта Request в интерфейсе динамического вызова и интерфейсе динамического скелета
• для описания значений контекста в объекте Context

Каждый объект NamedValue состоит из следующих элементов:

• имя, которое является объектом String
• значение, как объект Any
• флаг режима аргумента

Объект NVList может быть создан с помощью одного из следующих методов ORB:

1. org.omg.CORBA.ORB.create_list

   org.omg.CORBA.NVList nv = orb.create_list(3);

   Переменная nv представляет собой новый созданный объект NVList. Аргумент является подсказкой для управления памятью для орба и не подразумевает фактическую длину списка. Если, например, вы хотите использовать объект NVList в запросе, и вызываемый метод принимает три параметра, вы можете оптимизировать, передав 3 методу create_list. Обратите внимание, что новый объект NVList не обязательно будет иметь длину 3; он может иметь длину 2 или 4, например. Обратите также внимание, что вы можете добавить любое количество объектов NamedValue в этот список независимо от его первоначальной длины.
2. org.omg.CORBA.ORB.create_operation_list

   org.omg.CORBA.NVList nv = orb.create_operation_list(myOperationDef);

   Переменная nv представляет собой новый созданный объект NVList , содержащий описания аргументов метода, описанного в заданном объекте OperationDef.

Методы в классе NVList все обрабатывают объекты NamedValue в списке. Есть три метода для добавления объекта NamedValue, метод для получения количества объектов NamedValue в списке, метод для извлечения объекта NamedValue по заданному индексу и метод для удаления объекта NamedValue по заданному индексу.

Подробное описание конструкторов

NVList

public NVList()

Подробное описание методов

count

public abstract int count()

Возвращает количество объектов NamedValue , добавленных в этот объект NVList.

Возвращает:

значение, указывающее количество объектов NamedValue в этом объекте NVList.

add

public abstract NamedValue add(int flags)

Создает новый объект NamedValue , инициализированный заданным флагом, и добавляет его в конец этого объекта NVList. Флаг может быть любым из режимов передачи аргументов: ARG_IN.value, ARG_OUT.value, или ARG_INOUT.value.

Параметры:

flags - один из флагов режима передачи аргументов

Возвращает:

новый созданный объект NamedValue

add_item

public abstract NamedValue add_item(String item_name,
                                    int flags)

Создает новый объект NamedValue , инициализированный заданным именем и флагом, и добавляет его в конец этого объекта NVList. Флаг может быть любым из режимов передачи аргументов: ARG_IN.value, ARG_OUT.value, или ARG_INOUT.value.

Параметры:

item_name - имя для нового объекта NamedValue

flags - один из флагов режима передачи аргументов

Возвращает:

новый созданный объект NamedValue

add_value

public abstract NamedValue add_value(String item_name,
                                     Any val,
                                     int flags)

Создает новый объект NamedValue , инициализированный заданным именем, значением и флагом, и добавляет его в конец этого объекта NVList.

Параметры:

item_name - имя для нового объекта NamedValue

val - объект Any , содержащий значение для нового объекта NamedValue

flags - один из следующих режимов передачи аргументов: ARG_IN.value, ARG_OUT.value, или ARG_INOUT.value

Возвращает:

новый созданный объект NamedValue

item

public abstract NamedValue item(int index)
                         throws Bounds

Возвращает объект NamedValue по заданному индексу.

Параметры:

index - индекс искомого объекта NamedValue , который должен быть от нуля до длины списка минус один включительно. Первый элемент находится по индексу ноль.

Возвращает:

объект NamedValue по заданному индексу

Исключения:

Bounds - если индекс больше или равен количеству объектов NamedValue

remove

public abstract void remove(int index)
                     throws Bounds

Удаляет объект NamedValue по заданному индексу. Обратите внимание, что индексы всех объектов NamedValue , следующих за удаленным, сдвигаются вниз на одну позицию.

Параметры:

index - индекс объекта NamedValue , который нужно удалить, который должен быть от нуля до длины списка минус один включительно. Первый элемент находится по индексу ноль.

Исключения:

Bounds - если индекс больше или равен количеству объектов NamedValue в списке