summaryrefslogtreecommitdiff
path: root/TAO/tao/Acceptor_Registry.h
blob: aed5fef2161cfff75ac05edc4a8cb0c6a5966403 (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
// This may look like C, but it's really -*- C++ -*-
// $Id$

// ============================================================================
//
// = LIBRARY
//     TAO
//
// = FILENAME
//     Acceptor_Registry.h
//
// = DESCRIPTION
//     Interface for the TAO pluggable protocol framework.
//
// = AUTHOR
//     Fred Kuhns <fredk@cs.wustl.edu>
//
// ============================================================================

#ifndef TAO_ACCEPTOR_REGISTRY_H
#define TAO_ACCEPTOR_REGISTRY_H

#include "tao/Pluggable.h"
#include "tao/corbafwd.h"
#include "tao/Typecode.h"
#include "ace/Containers_T.h"

// Forward declarations.
class ACE_Addr;
class ACE_Reactor;
class TAO_ORB_Core;

class TAO_Stub;
class TAO_Profile;
class TAO_MProfile;
class TAO_Resource_Factory;

typedef ACE_Unbounded_Set<TAO_Acceptor*>
        TAO_AcceptorSet;
typedef ACE_Unbounded_Set_Iterator<TAO_Acceptor*>
        TAO_AcceptorSetItor;

class TAO_Export TAO_Acceptor_Registry
{
  // = TITLE
  //   Acceptor Registry and Generic Acceptor interface definitions.
  //   All loaded ESIOP or GIOP acceptor bridges must register with
  //   this object.
  //
  // = DESCRIPTION
  //   This class maintains a list os acceptor factories
  //   for all loaded ORB protocols.
public:
  TAO_Acceptor_Registry (void);
  //  Default constructor.

  ~TAO_Acceptor_Registry (void);
  //  Default destructor.

  // virtual TAO_Acceptor* acceptor (const char* endpoint) = 0;
  // Create a new acceptor from an endpoint specification, if
  // the specification is not recognized then we return 0.
  // Each protocol will be characterized by a prefix, so
  // endpoints will be specified as:
  // "iiop:macarena:0" - IIOP on macarena, port <any>
  // "uiop:/foo/bar"   - GIOP over unix domain, file /foo/bar
  // "iiop:localhost:0" - IIOP, sap_any [any better idea?]
  // "aal5giop:......"   - GIOP over AAL5, how to specify the
  //                       end point?
  //
  // this format is extensible, for example:
  // "rtiiop:macarena:0,15" - real-time IIOP, host, port, prio.
  //

  int open (TAO_ORB_Core *orb_core);
  // Initialize all registered acceptors.  Return -1 on error.
  // @@ Fred&Ossama: What is the relationship between the ORB_Core and
  //    the Acceptor_Registry? Is there just one per orb core? Should
  //    tbe acceptor registry know which ORB_Core it belongs to?

  size_t endpoint_count (void);
  // returns the total number of endpoints, i.e. the number of profiles
  // that will be created.

  int make_mprofile (const TAO_ObjectKey &object_key,
                     TAO_MProfile &mprofile);
  // add profiles to the mprofile object for all open endpoints.

  int is_collocated (const TAO_MProfile& mprofile);
  // Check if there is at least one profile in <mprofile> that
  // corresponds to a collocated object.

  TAO_AcceptorSetItor begin (void);
  TAO_AcceptorSetItor end (void);
  // Iteration

private:

  TAO_AcceptorSet acceptors_;
  // list of acceptors currently open.
};

#if defined(__ACE_INLINE__)
#include "tao/Acceptor_Registry.i"
#endif /* __ACE_INLINE__ */

#endif /* TAO_ACCEPTOR_REGISTRY_H */