File: omniServer.h

package info (click to toggle)
omniorb-dfsg 4.3.3%2Bds1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 13,172 kB
  • sloc: cpp: 115,843; python: 24,962; ansic: 13,414; sh: 2,665; makefile: 40
file content (124 lines) | stat: -rw-r--r-- 4,215 bytes parent folder | download | duplicates (5)
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
// -*- Mode: C++; -*-
//                            Package   : omniORB2
// omniServer.h               Created on: 05/01/2001
//                            Author    : Sai Lai Lo (sll)
//
//    Copyright (C) 2006 Apasphere Ltd
//    Copyright (C) 2001 AT&T Laboratories Cambridge
//
//    This file is part of the omniORB library
//
//    The omniORB library is free software; you can redistribute it and/or
//    modify it under the terms of the GNU Lesser General Public
//    License as published by the Free Software Foundation; either
//    version 2.1 of the License, or (at your option) any later version.
//
//    This library is distributed in the hope that it will be useful,
//    but WITHOUT ANY WARRANTY; without even the implied warranty of
//    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
//    Lesser General Public License for more details.
//
//    You should have received a copy of the GNU Lesser General Public
//    License along with this library. If not, see http://www.gnu.org/licenses/
//
//
// Description:
//	*** PROPRIETARY INTERFACE ***
//	

#ifndef __OMNISERVER_H__
#define __OMNISERVER_H__

OMNI_NAMESPACE_BEGIN(omni)

////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////
class orbServer {
public:
  orbServer() {}

protected:
  // Only deleted by remove().
  virtual ~orbServer() {}

public:

  typedef _CORBA_Unbounded_Sequence_String PublishSpecs;
  typedef _CORBA_Unbounded_Sequence_String EndpointList;

  virtual _CORBA_Boolean instantiate(const char*    endpoint_uri,
				     _CORBA_Boolean no_publish,
				     EndpointList&  listening_endpoints) = 0;
  // Accept to serve requests coming in from this endpoint. If
  // start() has already been called, incoming requests from this
  // endpoint will be served immediately.
  //
  // If <no_publish> is TRUE(1), the endpoint should not be published
  // in the IORs of the local objects.
  //
  // The URIs for all endpoints that can be used to contact the
  // instantiated server are added to <listening_endpoints>.
  //
  // If the instantiation is successful, returns TRUE(1) otherwise
  // returns FALSE(0).
  //
  // This function does not raise any exceptions.
  // 
  // Thread Safety preconditions:
  //    None. Concurrent calls to methods of this object are synchronised 
  //    internally.

  virtual _CORBA_Boolean publish(const PublishSpecs& publish_specs,
				 _CORBA_Boolean      all_specs,
				 _CORBA_Boolean      all_eps,
				 EndpointList&       published_endpoints) = 0;
  // For each endpoint instantiated in the server, publish its details
  // in IORs according to the <publish_specs> and flags, and add the
  // endpoint URIs to <published_endpoints>.
  //
  // Any URIs that are already in <published_endpoints> are not added
  // again.
  //
  // Returns TRUE(1) if the <publish_specs> were understood; FALSE(0)
  // if not.
  //
  // Thread Safety preconditions:
  //    None. Concurrent calls to methods of this object are synchronised 
  //    internally.

  virtual void start() = 0;
  // When this function returns, the server will service requests.
  //
  // This function does not raise any exceptions.
  //
  // Thread Safety preconditions:
  //    None. Concurrent calls to methods of this object are synchronised 
  //    internally.

  virtual void stop() = 0;
  // When this function returns, the server will no longer serve the requests.
  // Existing strands will be shutdown. 
  // However, the endpoints will stay.
  // This server will serve incoming requests again when start() is called.
  //
  // This function does not raise any exceptions.
  //
  // Thread Safety preconditions:
  //    None. Concurrent calls to methods of this object are synchronised 
  //    internally.

  virtual void remove() = 0;
  // When this function returns, all endpoints will be removed and
  // this server object will be deleted.
  //
  // This function does not raise any exceptions.
  //
  // Thread Safety preconditions:
  //    None. Concurrent calls to methods of this object are synchronised 
  //    internally.

};

OMNI_NAMESPACE_END(omni)

#endif // __OMNISERVER_H__