blob: 935dda887641379a1dd49aa1c6ef5f7e6a774126 (
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
118
119
120
121
122
123
124
125
126
127
128
|
// -*- C++ -*-
//=============================================================================
/**
* @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 "ace/CORBA_macros.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "tao/TAO_Export.h"
#include "tao/Basic_Types.h"
#include "tao/Invocation_Utils.h"
#include "tao/Object.h"
#include "tao/Service_Context.h"
TAO_BEGIN_VERSIONED_NAMESPACE_DECL
class TAO_Profile;
class TAO_MProfile;
class TAO_Stub;
namespace CORBA
{
class Object;
typedef Object *Object_ptr;
class Environment;
}
namespace IOP
{
class ServiceContextList;
}
/**
* @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:
enum Profile_Equivalence
{
EQUIVALENT,
NOT_EQUIVALENT,
DONT_KNOW
};
/// 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);
/// Check for equivalency of the two profiles
virtual Profile_Equivalence is_profile_equivalent (const TAO_Profile *,
const TAO_Profile *);
/// Calculate the hash value..
virtual CORBA::ULong hash_ft (TAO_Profile *p,
CORBA::ULong m);
// Verify if condition is given for LOCATION_FORWARD_PERM reply
virtual CORBA::Boolean is_permanent_forward_condition (const CORBA::Object_ptr obj,
const TAO_Service_Context &service_context) const;
/// Allow the service layer to decide whether the COMM_FAILURE
/// exception should be thrown or a reinvocation is needed
virtual TAO::Invocation_Status raise_comm_failure (
IOP::ServiceContextList &clist,
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 TAO::Invocation_Status raise_transient_failure (
IOP::ServiceContextList &clist,
TAO_Profile *profile
ACE_ENV_ARG_DECL);
};
TAO_END_VERSIONED_NAMESPACE_DECL
#include /**/ "ace/post.h"
#endif /*TAO_SERVICE_CALLBACK_H*/
|
