Request (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

org.omg.CORBA
클래스 Request

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

public abstract class Request
extends Object
extends Object

메서드를 호출하기 위해서 필요한 정보를 포함한 객체입니다. 이 클래스는 동적 작성과 요구의 호출을 가능하게 하는 ORB Dynamic Invocation Interface (DII)를 닮아 있습니다. 서버가 클라이언트 스텁을 사용하는 클라이언트 호출과 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 객체를 취득합니다. 이 리스트는 호출되는 메서드에 의해 발생되는 일이 있는 예외를 기술하는 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 Service 사양」을 참조

개요