org.omg.CORBA
클래스 NVList

java.lang.Object 
  |
  +--org.omg.CORBA.NVList

public abstract class NVList

extends Object

NamedValue 오브젝트가 저장된 변경 가능 리스트입니다.

NVList 클래스는 다음의 목적으로 사용됩니다.

• Dynamic Invocation Interface 와 Dynamic Skeleton Interface 로 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 오브젝트를 나타낸다. 인수는 ORB 에 대한 메모리 메니지먼트 힌트이며, 리스트의 실제의 길이를 나타내는 것은 아니다. 예를 들어, 요구에 NVList 오브젝트를 사용해, 불려 가는 메소드가 3 개의 파라미터를 취하는 경우,create_list 메소드에 3 을 지정해 최적화할 수 있다. 새로운 NVList 는 반드시 길이 3 은 아니고, 예를 들어, 길이가 2 또는 4 의 경우가 있다. 원의 길이에 관계없이, 이 리스트에 임의의 수의 NamedValue 오브젝트를 추가하는 일도 가능

2. org.omg.CORBA.ORB.create_operation_list

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

   변수 nv 는 지정된 OperationDef 오브젝트로 기술되는 메소드의 인수 기술을 저장하고 있는 새롭게 생성된 NVList 오브젝트를 나타낸다

NVList 클래스의 메소드는 모두, 리스트내의 NamedValue 오브젝트를 처리합니다. NamedValue 오브젝트의 추가용 메소드에는 리스트내의 NamedValue 오브젝트의 수를 취득하는 메소드, 지정한 인덱스의 NamedValue 오브젝트를 취득하는 메소드, 및 지정한 인덱스의 NamedValue 오브젝트를 삭제하는 메소드, 의 3 개가 있습니다.

도입된 버젼:

JDK1. 2

관련 항목:

Request , ServerRequest , NamedValue , Context

생성자의 개요

NVList ()

메소드의 개요

abstract NamedValue	add_item (String item_name, int flags) 지정된 이름과 플래그로 초기화된 새로운 NamedValue 오브젝트를 작성해, 그것을 이 NVList 오브젝트의 말미에 추가합니다.
abstract NamedValue	add_value (String item_name, Any val, int flags) 지정된 이름, 값, 및 플래그로 초기화된 NamedValue 오브젝트를 신규 작성해, 그것을 이 NVList 오브젝트의 말미에 추가합니다.
abstract NamedValue	add (int flags) 지정된 플래그로 초기화된 NamedValue 오브젝트를 신규 작성해, 그것을 이 NVList 오브젝트의 말미에 추가합니다.
abstract int	count () 이 NVList 오브젝트에 추가된 NamedValue 오브젝트의 수를 돌려줍니다.
abstract NamedValue	item (int index) 지정된 인덱스에서의 NamedValue 를 취득합니다.
abstract void	remove (int index) 지정된 인덱스의 NamedValue 오브젝트를 삭제합니다.

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자의 상세

NVList

public NVList()

메소드의 상세

count

public abstract int count()

이 NVList 오브젝트에 추가된 NamedValue 오브젝트의 수를 돌려줍니다.

반환값:

이 NVList 내의 NamedValue 오브젝트의 수를 나타내는 int

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 - 새로운 NamedValue 오브젝트의 값을 포함한 Any 오브젝트

flags - 인수 인도 모드 ARG_IN.value,ARG_OUT.value,ARG_INOUT.value 의 언젠가

반환값:

새롭게 작성된 NamedValue 오브젝트

item

public abstract NamedValue  item(int index)
                         throws Bounds 

지정된 인덱스에서의 NamedValue 를 취득합니다.

파라미터:

index - 대상의 NamedValue 오브젝트의 인덱스. 인덱스는 0 으로부터 (리스트의 길이 - 1)까지의 값이 아니면 안된다. 최초의 항목의 인덱스는 0 이 된다

반환값:

지정된 인덱스에서의 NamedValue

예외:

Bounds - 인덱스가 NamedValue 오브젝트수이상의 경우

remove

public abstract void remove(int index)
                     throws Bounds 

지정된 인덱스의 NamedValue 오브젝트를 삭제합니다. 삭제된 NamedValue 오브젝트 이후의 모든 인덱스가 1 만 감소합니다.

파라미터:

index - 삭제하는 NamedValue 오브젝트의 인덱스. 인덱스는 0 으로부터 (리스트의 길이 - 1)까지의 값이 아니면 안된다. 최초의 항목의 인덱스는 0 이 된다

예외:

Bounds - 인덱스가 리스트내의 NamedValue 오브젝트수이상의 경우