org.omg.CORBA.ServerRequest
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
java.lang.Object
public abstract class ServerRequest
Dynamic Skeleton Interface (DSI)의 명시적인 상태를 수중에 넣는 객체입니다. DSI
기반인 이 클래스는 DII에 있어서의 Request 객체를 닮아 있습니다.
ORB에 의해 요구가 구체화되어, Dynamic Implementation Routine (DIR)에 보내집니다. 동적 서번트 (DIR)는 DynamicImplementation 클래스를 구현하는 것으로써 작성되어 1개의 invoke 메서드를 가집니다. 이 메서드는 ServerRequest 객체를 받습니다.
추상 클래스 ServerRequest에
의해 메서드명, 인수 및 요구 컨텍스트에 액세스 하는 메서드 및 요구의 결과를 반환값 또는 예외로서 설정하는 메서드가 정의됩니다.
요구의 인수에 액세스 할 때, 인수에 관한 결정된 정보가 존재하지 않기 때문에
예기 되는 인수의 형태 정보를 DIR가 제공할 필요가 있습니다. 이 정보는 NamedValue 객체의 리스트인 NVList에 의해 제공됩니다. 각 NamedValue 객체에는 Any 객체가 포함되어Any 객체가 인수의 형태를 나타내는 TypeCode 객체를 보관 유지합니다.
같이 예기 되는 결과 또는 예외용으로 응답의 형태 정보를 지정할 필요가 있기 때문에
result 및 except 메서드가 파라미터로서 Any 객체를 취합니다.
DynamicImplementation,
NVList,
NamedValue | 생성자 개요 | |
|---|---|
ServerRequest ()
|
|
| 메서드 개요 | |
|---|---|
void |
arguments (NVList args)
메서드의 파라미터형을 지정해 in 및 inout 인수치를 취득합니다. |
abstract Context |
ctx ()
조작이 속성 액세스가 아니고 조작의 IDL 정의에 컨텍스트 식이 가리키는 경우는 조작의 IDL 로 지정된 컨텍스트 정보를 리턴합니다. |
void |
except (Any any)
추천하지 않습니다. set_exception()를 사용해 주세요. |
String |
op_name ()
추천하지 않습니다. operation()를 사용해 주세요. |
String |
operation ()
org.omg.CORBA.NO_IMPLEMENT 예외를 Throw 합니다. |
void |
params (NVList params)
추천하지 않습니다. arguments 메서드를 사용해 주세요. |
void |
result (Any any)
추천하지 않습니다. set_result 메서드를 사용한다 |
void |
set_exception (Any any)
org.omg.CORBA.NO_IMPLEMENT 예외를 Throw 합니다. |
void |
set_result (Any any)
org.omg.CORBA.NO_IMPLEMENT 예외를 Throw 합니다. |
| 클래스 java.lang. Object 로부터 상속된 메서드 |
|---|
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
| 생성자 상세 |
|---|
public ServerRequest()
| 메서드의 상세 |
|---|
@Deprecated public String op_name()
_get_<attribute_name>와
_set_<attribute_name>가 됩니다.
public String operation()
org.omg.CORBA.NO_IMPLEMENT 예외를 Throw 합니다.
호출되는 조작명을 취득합니다. OMG IDL
규칙에서는 이러한 이름은 이 객체의 「최상정도의 파생」인터페이스로 지원
되는 모든 조작 안에서 일의가 아니면 안됩니다. 속성의 취득과 설정의 조작명은 각각 _get_<attribute_name>와
_set_<attribute_name>가 됩니다.
CORBA package comments for unimplemented features @Deprecated public void params(NVList params)
arguments 메서드를 사용해 주세요.
이 메서드는 추천 되지 않습니다. 대신에 arguments 메서드를 사용해 주세요.
set_exception 메서드가 불려가
지 않는 경우, DIR는 메서드의 시그니쳐에 파라미터가 없어도 1번
만 이 메서드를 호출할 필요가 있습니다. arguments 또는 set_exception 메서드가 불려 갔을 경우, 같은 ServerRequest 객체로 arguments를 호출하면 BAD_INV_ORDER 시스템 예외가 됩니다. DIR는
조작의 파라미터형을 설명하는 TypeCode와
Flag 로 초기화된 NVList를, IDL 사양으로 가리키는 순서 (왼쪽에서 오른쪽)로 arguments 메서드에 건네줄 필요가 있습니다. 잠재적으로 다른 NVList 가 지정된 in 및 inout 인수치를 사용해 arguments로
부터 리턴됩니다
. set_exception 메서드를 호출하지 않는 경우, DIR는
복귀전에
리턴된
NVList에 모든 out 인수의 반환값을 지정할 필요가 있습니다. 또, 모든 inout 인수의 반환값을 변경하는 경우도 있습니다.
params - 메서드의 인수 (NVList 객체의 형식)public void arguments(NVList args)
set_exception 메서드가 불려가
지 않는 경우, DIR는 메서드의 시그니쳐에 파라미터가 포함되지 않아도 1번
만 이 메서드를 호출할 필요가 있습니다. arguments 또는 set_exception 메서드가 불려 갔을 경우, 같은 ServerRequest 객체에 대해서 arguments를 호출하면 BAD_INV_ORDER 시스템 예외가 발생 됩니다. DIR는
조작의 파라미터형을 설명하는 TypeCode와
Flag 로 초기화된 NVList를, IDL 사양으로 지정된 순서 (왼쪽에서 오른쪽)로 arguments 메서드에 건네줄 필요가 있습니다. 잠재적으로 다른 NVList 가 지정된 in 및 inout 인수치를 사용해 arguments로
부터 리턴됩니다
. set_exception 메서드가 불려가
지 않는 경우, DIR는
복귀전에
리턴된
NVList에 모든 out 인수의 반환값을 지정할 필요가 있습니다. 또, 모든 inout 인수의 반환값을 변경하는 경우도 있습니다.
args - 메서드의 인수 (NVList
형식)CORBA package comments for unimplemented features @Deprecated public void result(Any any)
set_result 메서드를 사용한다
이 메서드는 추천 되지 않습니다. 대신에 set_result 메서드를 사용해 주세요.
set_exception 메서드가 불려가
지 않고, 불려 간 메서드의 결과형이 void 이외의 경우, DIR
복귀전에 set_result 메서드를 1번
만 호출할 필요가 있습니다. 조작의 결과형이 void인 경우, 필요에 따라서, tk_void 형의 Any 객체를 사용해 set_result 메서드를 1번
호출할 수 있습니다
. arguments 메서드가 불려가기 전, 혹은 set_result 또는 set_exception 메서드가 불려 간 뒤에 set_result 메서드를 호출하면, BAD_INV_ORDER 예외가 발생 됩니다. IDL 조작에 컨텍스트
식이 포함되는지, 인수에게 건네진 NVList에 클라이언트로부터 건네받은 모든 파라미터가 기술되지 않는 경우, 그 이전에 ctx 메서드를 호출하지 말고 set_result 메서드를 호출하면, MARSHAL 시스템 예외가 발생되는 경우가 있습니다.
any - 설정하는 반환값을 포함한 Any 객체public void set_result(Any any)
org.omg.CORBA.NO_IMPLEMENT 예외를 Throw 합니다.
호출의 임의의 반환값을 지정합니다. set_exception 메서드가 불려가
지 않고, 불려 간 메서드의 결과형이 void 이외의 경우, DIR
복귀전에 set_result 메서드를 1번
만 호출할 필요가 있습니다. 조작의 결과형이 void인 경우, 필요에 따라서, tk_void 형의 Any 객체를 사용해, set_result 메서드를 1번
호출할 수 있습니다
. arguments 메서드가 불려가기 전, 혹은 set_result 또는 set_exception 메서드가 불려 간 뒤에 set_result 메서드를 호출하면, BAD_INV_ORDER 예외가 발생 됩니다. IDL 조작에 컨텍스트
식이 포함되는지, 인수에게 건네진 NVList에 클라이언트로부터 건네받은 모든 파라미터가 기술되지 않는 경우, 그 이전에 ctx 메서드를 호출하지 말고 set_result 메서드를 호출하면, MARSHAL 시스템 예외가 발생되는 경우가 있습니다.
any - 설정하는 반환값을 포함한 Any 객체CORBA package comments for unimplemented features @Deprecated public void except(Any any)
any - 예외를 포함한 Any 객체public void set_exception(Any any)
org.omg.CORBA.NO_IMPLEMENT 예외를 Throw 합니다.
지정된 예외를 클라이언트에 리턴합니다. 이 메서드는 DIR 로부터 불려가
언제라도 호출할 수 있습니다
. 이 메서드에게 건네진 Any 객체에는 시스템 예외 또는 호출되는 조작의 IDL 정의로 지정된 사용자
예외의 어느쪽이든을 포함할 필요가 있습니다. 예외가 지정되어 있지 않은 Any를 건네주면, BAD_PARAM 시스템 예외가 발생 됩니다. 리스트되어 있지 않은 사용자
예외를 건네주면, DIR가 BAD_PARAM 시스템 예외를 받는지, 클라이언트가 UNKNOWN_EXCEPTION 시스템 예외를 받습니다.
any - 예외를 포함한 Any 객체BAD_PARAM - 지정된 Any 객체에 예외가 포함되지 않는 또는 예외가 리스트되어 있지 않은 사용자
예외인 경우
UNKNOWN_EXCEPTION - 지정된 예외가 리스트되어 있지 않은 사용자
예외로 DIR가 BAD_PARAM 예외를 받지 않았던 경우CORBA package comments for unimplemented features public abstract Context ctx()
Context 참조를 리턴합니다. arguments 메서드의 호출전, 혹은 ctx, set_result, 또는 set_exception 메서드의 호출 후에 ctx 메서드를 호출하면, BAD_INV_ORDER 시스템 예외가 발생 됩니다.
BAD_INV_ORDER - (1) arguments 메서드의 전에 ctx 메서드가 호출되는지, (2) set_result 또는 set_exception
호출 후에 ctx가 호출되는 경우
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.