blob: 3f799f2b542deabc647aa2dfe2cd234a05ef10f9 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
//=============================================================================
/**
* @file Service_Callbacks.h
*
* $Id$
*
* This is a generic interface that would be used to override many
* of the default functionalities that the ORB provides by the
* services if they have been loaded in to the ORB_Core
*
*
* @author Bala Natarajan <bala@cs.wustl.edu>
*/
//=============================================================================
#ifndef TAO_SERVICE_CALLBACK_H
#define TAO_SERVICE_CALLBACK_H
#include "ace/pre.h"
#include "tao/IOPC.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
class TAO_Profile;
class TAO_MProfile;
class TAO_GIOP_Invocation;
class TAO_ServerRequest;
class TAO_Message_State_Factory;
/**
* @class TAO_Service_Callbacks
*
* @brief An Abstract Base class for the hooks in the ORB.
*
* This class (would) define all the hooks that may be needed by
* the ORB to override some of its default behaviour. The methods
* can be potentially used to call service level specific
* processing that may be required.
*/
class TAO_Export TAO_Service_Callbacks
{
public:
/// Dtor
virtual ~TAO_Service_Callbacks (void);
/// Select the profile from MProfile as the needs of the services
/// may be. Return the profile in <pfile>
virtual CORBA::Boolean select_profile (TAO_MProfile *mprofile,
TAO_Profile *&pfile);
/// Select the profile from MProfile as the needs of the services
/// may be. Return the profile in <pfile>
virtual CORBA::Boolean reselect_profile (TAO_Stub *stub,
TAO_Profile *&pfile);
/// Reset the profile flags that the services could have
virtual void reset_profile_flags (void);
/// Check whether <obj> is nil or not.
virtual CORBA::Boolean object_is_nil (CORBA::Object_ptr obj);
/// Allow the services to add service specific service context
/// information.
virtual void service_context_list (TAO_Stub *&stub,
IOP::ServiceContextList &service_list,
CORBA::Boolean restart
ACE_ENV_ARG_DECL);
/// Allow the service layer to decide whether the COMM_FAILURE
/// exception should be thrown or a reinvocation is needed
virtual int raise_comm_failure (TAO_GIOP_Invocation *invoke,
TAO_Profile *profile
ACE_ENV_ARG_DECL);
/// Allow the service layer to decide whether the TRANSIENT
/// exception should be thrown or a reinvocation is needed
virtual int raise_transient_failure (TAO_GIOP_Invocation *invoke,
TAO_Profile *profile
ACE_ENV_ARG_DECL);
/**
* Send the message state to the FT service for logging. This hook
* sends the message state after the server receives the
* message. The message at this point has been verified that it is a
* GIOP message.
*/
virtual void service_log_msg_rcv (TAO_Message_State_Factory &state);
/**
* Send the message state to the FT service for logging. This hook
* sends the message state after the POA receives upcall but just
* before the call has been dispatched to the servant
*/
virtual void service_log_msg_pre_upcall (TAO_ServerRequest &req);
/**
* Send the message state to the FT service for logging. This hook
* sends the message state just before the reply is ready to be
* dispatched.
*/
virtual void service_log_msg_post_upcall (TAO_ServerRequest &req);
};
#if defined (__ACE_INLINE__)
# include "tao/Service_Callbacks.i"
#endif /* __ACE_INLINE__ */
#include "ace/post.h"
#endif /*TAO_SERVICE_CALLBACK_H*/
|
