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
//! ORB core: connection management, request dispatch and the POA.
//!
//! Network I/O runs on an internal multi-threaded tokio runtime, and
//! servants are invoked on a separate pool of long-lived ORB threads.
//! The public API is synchronous.
//!
//! The client side:
//!
//! - [`Orb`] owns the runtime and a pool of GIOP connections, one per
//! server endpoint. [`Orb::string_to_object`] accepts stringified IORs,
//! `corbaloc:` and `corbaname:` URLs, and
//! [`Orb::resolve_initial_references`] the
//! `-ORBInitRef` / `-ORBDefaultInitRef` options.
//! - [`ObjectRef::request`] builds a request whose arguments are written to
//! an [`OutStream`]; [`Request::invoke`] returns a [`Reply`] to read with
//! an [`InStream`], or an [`Exception`]. Requests use GIOP 1.0 to 1.2 as
//! the target's profile allows, follow `LOCATION_FORWARD`, answer
//! `NEEDS_ADDRESSING_MODE`, try alternate addresses, and are sent again
//! after a `CloseConnection` from the server.
//! - [`name`] has the CosNaming name type and its string form, used for
//! `corbaname:` and by the naming service client in `rustorb-naming`.
//! - [`TypeCode`] describes IDL types, and [`Any`] holds a [`Value`] of
//! any type; [`OutStream::write_any`] and [`InStream::read_any`] marshal
//! them, and [`OutStream::write_value`] / [`InStream::read_value`]
//! marshal any value as its TypeCode says.
//! - [`CodeSets`] negotiates the transmission code sets from the IOR and
//! converts `string` data; rustorb's native code sets are UTF-8 and
//! UTF-16.
//!
//! The server side, started by [`Orb::root_poa`]:
//!
//! - The ORB listens on [`OrbOptions::endpoints`] and answers GIOP 1.0 to
//! 1.2 requests in the version they came in.
//! - [`Poa`] is the RootPOA and the POAs created under it, with their
//! [`Policy`] values, active object maps and [`PoaManager`]s. Object keys
//! of PERSISTENT POAs have omniORB's format, so references survive a
//! switch between the two.
//! - A [`Servant`] reads its arguments from an [`InStream`] and writes the
//! result or a user exception to a [`ServerReply`]. Servants run on a
//! pool of long-lived upcall threads, never on the I/O threads, and
//! requests of one connection run in parallel. SINGLE_THREAD_MODEL POAs
//! run their requests one at a time, and MAIN_THREAD_MODEL ones on the
//! thread in [`Orb::run`] or [`Orb::perform_work`].
//! - Objects not in the active object map can be served by a default
//! servant, a [`ServantActivator`] or a [`ServantLocator`], and child
//! POAs created on demand by an [`AdapterActivator`]. [`PoaCurrent`]
//! tells a servant which object a request is for.
//! - Calls to objects of the same ORB do not use the network: the request
//! is marshalled and dispatched on the calling thread.
//! - [`Orb::run`] waits for [`Orb::shutdown`], which finishes the running
//! requests and closes every connection with `CloseConnection`.
//!
//! What the ORB does (connections, requests, exceptions, forwards, GIOP
//! messages) is reported as [`tracing`](https://docs.rs/tracing) events;
//! without a subscriber, `-ORBtraceLevel` writes them to standard error.
//! See [`trace`].
pub use CodeSets;
pub use ;
pub use ;
pub use ;
pub use ;
pub use ;
pub use ;
pub use ;
pub use rustorb_cdr as cdr;
pub use ;
pub use rustorb_giop as giop;
pub use CompletionStatus;
pub use ;
pub use ;
pub use ;
pub use ;
pub use ;