org.omg.PortableInterceptor
인터페이스 ServerRequestInterceptorOperations

모든 슈퍼 인터페이스:

InterceptorOperations

알려진 서브 인터페이스 목록 :

ServerRequestInterceptor

public interface ServerRequestInterceptorOperations
extends InterceptorOperations 

서버측의 요구 인타세프타입니다.

요구 인타세프타는 특정의 지점에서 ORB를 개입시켜 요구/응답 순서의 흐름을 차단해, 서비스가 요구 정보를 조회하거나 클라이언트와 서버와의 사이에 거래되는 서비스 컨텍스트를 조작하거나 할 수 있도록 설계되고 있습니다. 요구 인타세프타의 주된 사용 목적은 ORB 서비스가 클라이언트와 서버와의 사이에 컨텍스트 정보를 전송 할 수 있도록 하는 것입니다. 요구 인타세프타에는 클라이언트측과 서버측의 2 종류가 있습니다.

서버측의 인타세프타를 작성하려면, ServerRequestInterceptor 인터페이스를 구현합니다.

관련 항목:

ServerRequestInfo

메서드 개요

void	receive_request_service_contexts (ServerRequestInfo ri) 인타세프타로 서비스 컨텍스트 정보를 처리할 수 있도록 합니다.
void	receive_request (ServerRequestInfo ri) 오퍼레이션 파라미터등의 모든 정보를 사용할 수 있게 된 후에 인타세프타가 요구 정보를 조회할 수 있도록 합니다.
void	send_exception (ServerRequestInfo ri) 예외가 클라이언트에 Throw 되기 전에 인타세프타가 예외 정보를 조회하거나 응답 서비스 컨텍스트를 변경하거나 할 수 있도록 합니다.
void	send_other (ServerRequestInfo ri) 요구에 의해 보통 의 응답 또는 예외 이외의 것이 돌려주고졌을 때에 인타세프타가 이용 가능한 정보를 조회할 수 있도록 합니다.
void	send_reply (ServerRequestInfo ri) 타겟 오퍼레이션이 불려가 고 나서 응답이 클라이언트에 돌려주고질 때까지, 인타세프타가 응답 정보를 조회하거나 응답 서비스 컨텍스트를 변경하거나 할 수 있도록 합니다.

인터페이스 org.omg.PortableInterceptor. InterceptorOperations 로부터 상속된 메서드

destroy, name

메서드의 상세

receive_request_service_contexts

void receive_request_service_contexts(ServerRequestInfo  ri)
                                      throws ForwardRequest 

인타세프타로 서비스 컨텍스트 정보를 처리할 수 있도록 합니다.

이 차단점으로써, 인타세프타는 착신 요구로부터 그 서비스 컨텍스트 정보를 취득해, 그것을 PortableInterceptor.Current 슬롯에 전송 할 필요가 있습니다.

이 차단점은 서번트 매니저가 불려가기 전에 호출합니다. 오퍼레이션 파라미터는 이 시점에서는 아직 사용할 수 없습니다. 이 차단점은 타겟의 호출과 같은 thread내에서 동작하는 경우도 하지 않는 경우도 있습니다.

이 차단점에서는 시스템 예외가 발생되는 경우가 있습니다. 이 예외가 Throw 되었을 경우, 다른 인타세프타의 receive_request_service_contexts 오퍼레이션은 불려가 지 않습니다. 플로우 스택상의 그러한 인타세프타가 표시되어 그 send_exception 차단점이 호출합니다.

이 차단점에서는 ForwardRequest 예외가 발생되는 경우도 있습니다. 이 예외가 Throw 되었을 경우, 다른 인타세프타의 receive_request_service_contexts 오퍼레이션은 불려가 지 않습니다. 플로우 스택상의 그러한 인타세프타가 표시되어 그 send_other 차단점이 호출합니다.

이 차단점으로부터 시스템 예외를 Throw 하는 경우, 준거하고 있는 인타세프타는 completion_status 시멘틱스에 엄밀하게 따릅니다. completion_status는 COMPLETED_NO가 됩니다.

파라미터:

ri - 차단되는 현재의 요구에 관한 정보

예외:

ForwardRequest - Throw 되었을 경우는 예외로 가리키는 새로운 객체를 사용해 요구의 재시행을 하는 것을 ORB에 통지한다

receive_request

void receive_request(ServerRequestInfo  ri)
                     throws ForwardRequest 

오퍼레이션 파라미터등의 모든 정보를 사용할 수 있게 된 후에 인타세프타가 요구 정보를 조회할 수 있도록 합니다. 이 차단점은 타겟의 호출과 같은 thread내에서 동작합니다.

DSI 모델에서는 사용자 코드에 의해 arguments가 불려 간 시점에서 처음으로 파라미터를 사용할 수 있게 되기 때문에 receive_request는 arguments 내로부터 호출합니다. DSI 모델에서는 arguments가 불려가 지 않는 것도 있습니다. 또, set_exception가 불려가 고 나서, arguments가 호출되는 일도 있습니다. ORB 에서는 arguments 또는 set_exception 어느 쪽인지를 개입시켜 receive_request이 1번 만 호출되는 것을 보증하고 있습니다. set_exception을 개입시켜 불려 갔을 경우, 인수를 요구하면, 표준 마이너 코드 1 이 설정된 NO_RESOURCES가 발생 됩니다.

이 차단점에서는 시스템 예외가 발생되는 경우가 있습니다. 이 예외가 Throw 되었을 경우, 다른 인타세프타의 receive_request 오퍼레이션은 불려가 지 않습니다. 플로우 스택상의 그러한 인타세프타가 표시되어 그 send_exception 차단점이 호출합니다.

이 차단점에서는 ForwardRequest 예외가 발생되는 경우도 있습니다. 이 예외가 Throw 되었을 경우, 다른 인타세프타의 receive_request 오퍼레이션은 불려가 지 않습니다. 플로우 스택상의 그러한 인타세프타가 표시되어 그 send_other 차단점이 호출합니다.

이 차단점으로부터 시스템 예외를 Throw 하는 경우, 준거하고 있는 인타세프타는 completion_status 시멘틱스에 엄밀하게 따릅니다. completion_status는 COMPLETED_NO가 됩니다.

파라미터:

ri - 차단되는 현재의 요구에 관한 정보

예외:

ForwardRequest - Throw 되었을 경우는 예외로 가리키는 새로운 객체를 사용해 요구의 재시행을 하는 것을 ORB에 통지한다

send_reply

void send_reply(ServerRequestInfo  ri)

타겟 오퍼레이션이 불려가 고 나서 응답이 클라이언트에 돌려주고질 때까지, 인타세프타가 응답 정보를 조회하거나 응답 서비스 컨텍스트를 변경하거나 할 수 있도록 합니다. 이 차단점은 타겟의 호출과 같은 thread내에서 동작합니다.

이 차단점에서는 시스템 예외가 발생되는 경우가 있습니다. 이 예외가 Throw 되었을 경우, 다른 인타세프타의 send_reply 오퍼레이션은 불려가 지 않습니다. 플로우 스택내의 나머지의 인타세프타가 표시되어 그 send_exception 차단점이 호출합니다.

이 차단점으로부터 시스템 예외를 Throw 하는 경우, 준거하고 있는 인타세프타는 completion_status 시멘틱스에 엄밀하게 따릅니다. completion_status는 COMPLETED_YES가 됩니다.

파라미터:

ri - 차단되는 현재의 요구에 관한 정보

send_exception

void send_exception(ServerRequestInfo  ri)
                    throws ForwardRequest 

예외가 클라이언트에 Throw 되기 전에 인타세프타가 예외 정보를 조회하거나 응답 서비스 컨텍스트를 변경하거나 할 수 있도록 합니다. 예외가 발생하면, 이 차단점이 호출합니다. 이 차단점은 타겟의 호출과 같은 thread내에서 동작합니다.

이 차단점에서는 시스템 예외가 발생되는 경우가 있습니다. 이 예외가 Throw 되면, 플로우 스택으로부터 표시된 후속의 인타세프타가 그 send_exception 호출로 수신하는 예외가 변경됩니다. 클라이언트에 발생되는 예외는 인타세프타에 의해 마지막에 발생되는 예외가 됩니다. 다만, 예외를 변경하는 인타세프타가 없는 경우는 원의 예외가 됩니다.

이 차단점에서는 ForwardRequest 예외가 발생되는 경우도 있습니다. 이 예외가 Throw 되었을 경우, 다른 인타세프타의 send_exception 오퍼레이션은 불려가 지 않습니다. 플로우 스택내의 나머지의 인타세프타가 표시되어 그 send_other 차단점이 호출합니다.

이 예외의 completion_status가 COMPLETED_NO인 경우, 이 차단점에 의해 ForwardRequest 예외가 발생되는 것은 적절하지는 않습니다. 이 요구의 「최대로 1회 」라고 하는 시멘틱스가 없어집니다.

이 차단점으로부터 시스템 예외를 Throw 하는 경우, 준거하고 있는 인타세프타는 completion_status 시멘틱스에 엄밀하게 따릅니다. 원의 예외가 시스템 예외인 경우, 새로운 예외의 completion_status는 원의 예외의 그것과 같게 됩니다. 원의 예외가 사용자 예외인 경우, 새로운 예외의 completion_status는 COMPLETED_YES가 됩니다.

파라미터:

ri - 차단되는 현재의 요구에 관한 정보

예외:

ForwardRequest - Throw 되었을 경우는 예외로 가리키는 새로운 객체를 사용해 요구의 재시행을 하는 것을 ORB에 통지한다

send_other

void send_other(ServerRequestInfo  ri)
                throws ForwardRequest 

요구에 의해 보통 의 응답 또는 예외 이외의 것이 돌려주고졌을 때에 인타세프타가 이용 가능한 정보를 조회할 수 있도록 합니다. 예를 들어 요구에 의해 재시행이 생길 가능성이 있습니다 (LOCATION_FORWARD 상태가 설정된 GIOP 응답이 수신되었을 경우 등). 이 차단점은 타겟의 호출과 같은 thread내에서 동작합니다.

이 차단점에서는 시스템 예외가 발생되는 경우가 있습니다. 이 예외가 Throw 되었을 경우, 다른 인타세프타의 send_other 오퍼레이션은 불려가 지 않습니다. 플로우 스택내의 나머지의 인타세프타가 표시되어 그 send_exception 차단점이 호출합니다.

이 차단점에서는 ForwardRequest 예외가 발생되는 경우도 있습니다. 이 예외가 Throw 되었을 경우는 후속의 인타세프타의 send_other 오퍼레이션이 불려가 ForwardRequest 예외에 의해 새로운 정보가 제공됩니다.

이 차단점으로부터 시스템 예외를 Throw 하는 경우, 준거하고 있는 인타세프타는 completion_status 시멘틱스에 엄밀하게 따릅니다. completion_status는 COMPLETED_NO가 됩니다.

파라미터:

ri - 차단되는 현재의 요구에 관한 정보

예외:

ForwardRequest - Throw 되었을 경우는 예외로 가리키는 새로운 객체를 사용해 요구의 재시행을 하는 것을 ORB에 통지한다