blob: 348ab0d758cfba433799f523e81c3fd15fe0172d (
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
129
|
// $Id$
/**
* @@ Compile this file with:
*
* tao_idl -Gv -I ../.. -I ../../orbsvcs/orbsvcs \
* -Wb,export_macro=CIAO_Export \
* -Wb,export_include=CIAO_export.h \
* -Wb,pre_include="ace/pre.h" \
* -Wb,post_include="ace/post.h" \
* CCM_Component.idl
*/
#if !defined (CCM_OBJECT_IDL)
#define CCM_OBJECT_IDL
#include "CCM_Event.idl"
#include "CCM_Navigation.idl"
#include "tao/IFR_Client/IFR_Base.pidl"
module Components
{
typeprefix Components "omg.org";
typedef unsigned long FailureReason;
typedef FailureReason InvalidConfigurationReason;
const InvalidConfigurationReason UnknownConfigValueName = 0;
const InvalidConfigurationReason InvalidConfigValueType = 1;
const InvalidConfigurationReason ConfigValueRequired = 2;
const InvalidConfigurationReason ConfigValueNotExpected = 3;
exception CreateFailure {
FailureReason reason;
};
exception FinderFailure
{
FailureReason reason;
};
exception RemoveFailure
{
FailureReason reason;
};
exception DuplicateKeyValue {};
exception InvalidKey {};
exception UnknownKeyValue {};
interface CCMObject;
interface CCMHome
{
CORBA::IRObject get_component_def ();
CORBA::IRObject get_home_def ();
void remove_component ( in CCMObject comp)
raises (RemoveFailure);
};
exception InvalidConfiguration
{
InvalidConfigurationReason reason;
FeatureName name;
};
abstract valuetype PrimaryKeyBase {};
valuetype ComponentPortDescription
{
public FacetDescriptions facets;
public ReceptacleDescriptions receptacles;
public ConsumerDescriptions consumers;
public EmitterDescriptions emitters;
public PublisherDescriptions publishers;
};
interface StandardConfigurator;
exception NoKeyAvailable {};
interface CCMObject : Navigation, Receptacles, Events
{
CORBA::IRObject get_component_def ( );
CCMHome get_ccm_home( );
PrimaryKeyBase get_primary_key( )
raises (NoKeyAvailable);
void remove()
raises (RemoveFailure);
ComponentPortDescription get_all_ports ();
/// Factory method to return a StandardConfigurator interface. CIAO specific
StandardConfigurator get_standard_configurator ( );
/// CIAO specific operations to have some control on when and how
/// to activate components.
/**
* This is all from our work on ARMS where we needed to know whether
* every component has been configured, say for example to use
* logging in the assembly which could in turn be provided by a
* component. To get around all this we are adding some methods on
* this till we think of some standard way to do this. The problem
* is that the deployer should be able to call this as opposed to
* the home calling it as soon as the component is created.
*
* All these operations are called in the order mentioned, ie. the
* deployer calls ciao_preactivate () on all components, then
* ciao_activate and then ciao_postactivate (). The speciality is
* that these operations would be invoked on every target object
* before the next call is made. It is similar to the way
* portable interceptors work, trying to get everything onto the
* flow stack, but differ in the intention.
*/
void ciao_preactivate ()
raises (InvalidConfiguration);
void ciao_activate ()
raises (InvalidConfiguration);
void ciao_postactivate ()
raises (InvalidConfiguration);
void ciao_passivate ()
raises (InvalidConfiguration);
void configuration_complete ()
raises (InvalidConfiguration);
};
};
#endif /* CCM_OBJECT_IDL */
|
