org.omg.CORBA
클래스 Request

java.lang.Object 
  org.omg.CORBA.Request

public abstract class Request
extends Object 

메소드를 호출하기 위해서(때문에) 필요한 정보를 포함한 객체입니다. 이 클래스는, 동적 작성과 요구의 호출을 가능하게 하는 ORB Dynamic Invocation Interface (DII)를 닮아 있습니다. 서버가 클라이언트 Stub를 사용하는 클라이언트 호출과 DII 를 사용하는 요구동안의 차이를 나타낼 수 없습니다.

다음에,Request 객체의 원가요소를 나타냅니다.

• 불려 가는 오퍼레이션의 이름
• 조작의 인수를 포함한 NVList
  리스트내의 각 항목은 NamedValue 객체로, 다음의 3 개의 부분이 있습니다.
  1. 인수의 이름
  2. 인수의 값 (Any 객체)
  3. 인수가 입력, 출력, 또는 그 양쪽 모두인가 어떤가를 나타내는 인수 모드 플래그

조작이 원의 IDL 인터페이스 정의에 어떻게 정의되고 있을까에 의해,Request 객체도 추가 정보를 포함하는 일이 있습니다. 예를 들어, 적절한 경우는, 반환값 또는 예외, 문맥, 취할 수 있는 예외, 및 해결할 필요가 있는 문맥 캐릭터 라인의 리스트를 보관 유지하기 위해(때문에),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 객체를 가져옵니다. 이것은, 호출이 복귀한 뒤, 불려 간 메소드가 throw 되었다고 하는 예외를 포함합니다.

반환값:

이 요구에 대한 Environment 객체

exceptions

public abstract ExceptionList  exceptions()

이 요구에 대한 ExceptionList 객체를 가져옵니다. 이 리스트는, 불려 가는 메소드에 의해 throw 되는 일이 있는 예외를 기술하는 TypeCode 객체를 포함합니다.

반환값:

불려 가는 메소드에 의해 throw 되는 일이 있다 예외를 기술하는 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 Service 스펙」을 참조