org.omg.CORBA
클래스 Request

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

public abstract class Request

extends Object

메소드를 호출하기 위해서(때문에) 필요한 정보를 저장하는 오브젝트입니다. 이 클래스는 요구의 동적인 작성이라고 불러 방편을 실현하는 ORB Dynamic Invocation Interface (DII)의 기초입니다. 서버는 클라이언트 그루터기를 사용하는 클라이언트 호출과 DII 를 사용하는 요구의 차이를 구별할 수 없습니다.

다음에,Request 오브젝트의 원가요소를 나타냅니다.

• 불려 가는 오퍼레이션의 이름
• 오퍼레이션의 인수를 저장하는 NVList
  리스트의 각 항목은 다음의 3 개의 부분을 가지는 NamedValue 오브젝트입니다.
  1. 인수명
  2. 인수의 값 (Any 오브젝트)
  3. 인수의 대상이 입력, 출력, 또는 양쪽 모두의 어떤 것인지를 나타내는 인수 모드 플래그

Request 오브젝트는 오퍼레이션이 원의 IDL 의 인터페이스 정의로 어떻게 정의되고 있을까에 응해 추가 정보도 저장합니다. 예를 들어, 필요에 따라서, 반환값이나 예외를 보관 유지하는 NamedValue 오브젝트, 문맥, 가능성이 있는 예외의 리스트, 및 해결이 필요한 문맥 캐릭터 라인의 리스트를 저장합니다.

새로운 Request 오브젝트는 Object 클래스의 create_request 메소드의 1 개를 사용하는 것으로써 작성됩니다. 즉,create_request 메소드는 불려 가는 오브젝트로 실행됩니다.

관련 항목:

NamedValue

생성자의 개요

Request ()

메소드의 개요

abstract Any	add_in_arg () 입력 인수를 작성해, 이 인수를 이 Request 오브젝트에 추가합니다.
abstract Any	add_inout_arg () 입출력 인수를 이 Request 오브젝트에 추가합니다.
abstract Any	add_named_in_arg (String name) 지정된 이름을 가지는 입력 인수를 작성해, 그 인수를 이 Request 오브젝트에 추가합니다.
abstract Any	add_named_inout_arg (String name) 지정된 이름을 가지는 입출력 인수를 이 Request 오브젝트에 추가합니다.
abstract Any	add_named_out_arg (String name) 지정된 이름을 가지는 출력 인수를 이 Request 오브젝트에 추가합니다.
abstract Any	add_out_arg () 출력 인수를 이 Request 오브젝트에 추가합니다.
abstract NVList	arguments () 불려 가는 메소드의 인수를 저장하는 NVList 오브젝트를 취득합니다.
abstract ContextList	contexts () 이 요구의 ContextList 오브젝트를 취득합니다.
abstract Context	ctx () 이 요구의 Context 오브젝트를 취득합니다.
abstract void	ctx (Context c) 이 요구의 Context 오브젝트가 지정된 것으로 설정합니다.
abstract Environment	env () 이 요구의 Environment 오브젝트를 취득합니다.
abstract ExceptionList	exceptions () 이 요구의 ExceptionList 오브젝트를 취득합니다.
abstract void	get_response () send_deferred 메소드로 벌써 방아쇠 된 호출에 대한 응답에, 유저가 액세스 할 수 있게 합니다.
abstract void	invoke () Request 오브젝트의 정보를 사용하는 것으로써, 동기 호출을 실시합니다.
abstract String	operation () 불려 가는 메소드의 이름을 취득합니다.
abstract boolean	poll_response () send_deferred 메소드로 벌써 방아쇠 된 호출에 대한 응답에, 유저가 액세스 할 수 있게 합니다.
abstract NamedValue	result () 메소드의 반환값이 저장되고 있는 NamedValue 오브젝트를 취득합니다.
abstract Any	return_value () 메소드의 결과의 값을 저장하는 Any 오브젝트를 돌려줍니다.
abstract void	send_deferred () 비동기의 요구의 호출을 실시합니다.
abstract void	send_oneway () 한방향의 요구의 호출을 실시합니다.
abstract void	set_return_type (TypeCode tc) 메소드의 반환값의 타입 코드를 설정합니다.
abstract Object	target () 타겟의 오브젝트 참조를 취득합니다.

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

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

생성자의 상세

Request

public Request()

메소드의 상세

target

public abstract Object  target()

타겟의 오브젝트 참조를 취득합니다.

반환값:

메소드가 불려 가는 오브젝트의 구현을 가리키는 오브젝트 참조

operation

public abstract String  operation()

불려 가는 메소드의 이름을 취득합니다.

반환값:

불려 가는 메소드의 이름

arguments

public abstract NVList  arguments()

불려 가는 메소드의 인수를 저장하는 NVList 오브젝트를 취득합니다. 리스트의 요소는 NamedValue 오브젝트이며, 각각이 메소드의 인수를 기술합니다.

반환값:

메소드의 인수가 저장되고 있는 NVList 오브젝트

result

public abstract NamedValue  result()

메소드의 반환값이 저장되고 있는 NamedValue 오브젝트를 취득합니다.

반환값:

메소드의 결과가 저장되고 있는 NamedValue 오브젝트

env

public abstract Environment  env()

이 요구의 Environment 오브젝트를 취득합니다. 이것은 불려 가는 메소드가 (호출이 돌려주어진 뒤에) 슬로우 한 예외를 저장합니다.

반환값:

이 요구의 Environment 오브젝트

exceptions

public abstract ExceptionList  exceptions()

이 요구의 ExceptionList 오브젝트를 취득합니다. 이 리스트는 불려 가는 메소드에 의해 슬로우 되는 예외를 기술하는 TypeCode 오브젝트를 저장합니다.

반환값:

불려 가는 메소드에 의해 슬로우 되는 예외를 기술하는 ExceptionList 오브젝트

contexts

public abstract ContextList  contexts()

이 요구의 ContextList 오브젝트를 취득합니다. 이 리스트는 해결되어 호출과 함께 보내질 필요가 있는 문맥 String 를 저장합니다.

반환값:

치가 해결되어 호출과 함께 보내질 필요가 있는 콘테 키스 캐릭터 라인의 리스트

ctx

public abstract Context  ctx()

이 요구의 Context 오브젝트를 취득합니다. 이것은 클라이언트, 환경, 또는 이 요구의 상황에 대한 정보를 제공하는 프로퍼티의 리스트입니다.

반환값:

치가 호출과 함께 보내질 필요가 있는 문맥 캐릭터 라인을 해결하기 위해서 사용되는 Context 오브젝트

ctx

public abstract void ctx(Context  c)

이 요구의 Context 오브젝트가 지정된 것으로 설정합니다.

파라미터:

c - 문맥 캐릭터 라인을 해결하기 위해서 사용되는 새로운 Context 오브젝트

add_in_arg

public abstract Any  add_in_arg()

입력 인수를 작성해, 이 인수를 이 Request 오브젝트에 추가합니다.

반환값:

추가되는 입력 인수의 값 및 타입 코드를 저장하는 Any 오브젝트

add_named_in_arg

public abstract Any  add_named_in_arg(String  name)

지정된 이름을 가지는 입력 인수를 작성해, 그 인수를 이 Request 오브젝트에 추가합니다.

파라미터:

name - 추가되는 인수의 이름

반환값:

추가되는 입력 인수의 값 및 타입 코드를 저장하는 Any 오브젝트

add_inout_arg

public abstract Any  add_inout_arg()

입출력 인수를 이 Request 오브젝트에 추가합니다.

반환값:

추가되는 입출력 인수의 값 및 타입 코드를 저장하는 Any 오브젝트

add_named_inout_arg

public abstract Any  add_named_inout_arg(String  name)

지정된 이름을 가지는 입출력 인수를 이 Request 오브젝트에 추가합니다.

파라미터:

name - 추가되는 인수의 이름

반환값:

추가되는 입출력 인수의 값 및 타입 코드를 저장하는 Any 오브젝트

add_out_arg

public abstract Any  add_out_arg()

출력 인수를 이 Request 오브젝트에 추가합니다.

반환값:

추가되는 출력 인수의 값 및 타입 코드를 저장하는 Any 오브젝트

add_named_out_arg

public abstract Any  add_named_out_arg(String  name)

지정된 이름을 가지는 출력 인수를 이 Request 오브젝트에 추가합니다.

파라미터:

name - 추가되는 인수의 이름

반환값:

추가되는 출력 인수의 값 및 타입 코드를 저장하는 Any 오브젝트

set_return_type

public abstract void set_return_type(TypeCode  tc)

메소드의 반환값의 타입 코드를 설정합니다.

파라미터:

tc - 반환값의 형태 정보가 저장되고 있는 TypeCode 오브젝트

return_value

public abstract Any  return_value()

메소드의 결과의 값을 저장하는 Any 오브젝트를 돌려줍니다.

반환값:

반환값의 값 및 타입 코드를 저장하는 Any 오브젝트

invoke

public abstract void invoke()

Request 오브젝트의 정보를 사용하는 것으로써, 동기 호출을 실시합니다. 예외 정보는 Request 오브젝트의 환경 오브젝트에 배치됩니다.

send_oneway

public abstract void send_oneway()

한방향의 요구의 호출을 실시합니다. 즉, 그 호출은 응답을 대기하지 않습니다. 이것은 오퍼레이션이 IDL 선언으로 한방향으로서 선언되어 있지 않아도 사용할 수 있습니다. 응답 또는 예외 정보는 돌려주어지지 않습니다.

send_deferred

public abstract void send_deferred()

비동기의 요구의 호출을 실시합니다. 즉 그 호출은 유저에게 돌아오기 전에 응답을 대기하는 것은 하지 않습니다. 유저는 나중에 poll_response 메소드 및 get_response 메소드를 사용해, 호출의 결과 또는 예외 정보를 취득할 수 있습니다.

poll_response

public abstract boolean poll_response()

send_deferred 메소드로 벌써 방아쇠 된 호출에 대한 응답에, 유저가 액세스 할 수 있게 합니다.

반환값:

메소드의 응답이 수신되고 있는 경우는 true, 그렇지 않은 경우는 false

get_response

public abstract void get_response()
                           throws WrongTransaction 

send_deferred 메소드로 벌써 방아쇠 된 호출에 대한 응답에, 유저가 액세스 할 수 있게 합니다.

예외:

WrongTransaction - 당초 요구가 보내져 온 것과는 다른 트랜잭션(transaction)의 스코프로부터 get_response 메소드가 불려 갔을 경우. OMG 트랜잭션(transaction) 서비스의 사양을 참조