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
|
.TH CosNaming 3 "orber 3.6.9" "Ericsson AB" "ERLANG MODULE DEFINITION"
.SH MODULE
CosNaming \- The CosNaming service is a collection of interfaces that together define the naming service\&.
.SH DESCRIPTION
.LP
The naming service provides the principal mechanism for clients to find objects in an ORB based world\&. The naming service provides an initial naming context that functions as the root context for all names\&. Given this context clients can navigate in the name space\&.
.LP
Types that are declared on the CosNaming level are:
.nf
typedef string Istring;
struct NameComponent {
Istring id;
Istring kind;
};
typedef sequence <NameComponent> Name;
enum BindingType {nobject, ncontext};
struct Binding {
Name binding_name;
BindingType binding_type;
};
typedef sequence <Binding> BindingList;
.fi
.LP
To get access to the record definitions for the structs use: \fI-include_lib("orber/COSS/CosNaming\&.hrl")\&.\fR\&.
.LP
Names are not an ORB object but the can be structured in components as seen by the definition above\&. There are no requirements on names so the service can support many different conventions and standards\&.
.LP
There are two different interfaces supported in the service:
.RS 2
.TP 2
*
NamingContext
.TP 2
*
BindingIterator
.RE
.LP
IDL specification for CosNaming:
.nf
// Naming Service v1\&.0 described in CORBAservices:
// Common Object Services Specification, chapter 3
// OMG IDL for CosNaming Module, p 3-6
#pragma prefix "omg\&.org"
module CosNaming
{
typedef string Istring;
struct NameComponent {
Istring id;
Istring kind;
};
typedef sequence <NameComponent> Name;
enum BindingType {nobject, ncontext};
struct Binding {
Name binding_name;
BindingType binding_type;
};
typedef sequence <Binding> BindingList;
interface BindingIterator;
interface NamingContext;
interface NamingContext {
enum NotFoundReason { missing_node, not_context, not_object};
exception NotFound {
NotFoundReason why;
Name rest_of_name;
};
exception CannotProceed {
NamingContext cxt;
Name rest_of_name;
};
exception InvalidName{};
exception AlreadyBound {};
exception NotEmpty{};
void bind(in Name n, in Object obj)
raises(NotFound, CannotProceed, InvalidName, AlreadyBound);
void rebind(in Name n, in Object obj)
raises(NotFound, CannotProceed, InvalidName);
void bind_context(in Name n, in NamingContext nc)
raises(NotFound, CannotProceed,InvalidName, AlreadyBound);
void rebind_context(in Name n, in NamingContext nc)
raises(NotFound, CannotProceed, InvalidName);
Object resolve (in Name n)
raises(NotFound, CannotProceed, InvalidName);
void unbind(in Name n)
raises(NotFound, CannotProceed, InvalidName);
NamingContext new_context();
NamingContext bind_new_context(in Name n)
raises(NotFound, AlreadyBound, CannotProceed, InvalidName);
void destroy( )
raises(NotEmpty);
void list (in unsigned long how_many,
out BindingList bl,
out BindingIterator bi);
};
interface BindingIterator {
boolean next_one(out Binding b);
boolean next_n(in unsigned long how_many,
out BindingList bl);
void destroy();
};
};
.fi
|
