summaryrefslogtreecommitdiff
path: root/TAO/tao/IOR_LookupTable.h
blob: b15c162781c043b9aef968cdf7654917b2264981 (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
/* -*- C++ -*- */
// $Id$

// ============================================================================
//
// = LIBRARY
//    TAO/orbsvcs/orbsvcs
//
// = FILENAME
//   IOR_LookupTable.h
//
// = DESCRIPTION
//   Represents a table for the IOR lookups, given the object keys. A
//   Hash_Map_Manager is being used currently for the table. This
//   could be changed/added-on-to by other data structures like a file
//   etc. This class is going to be used as a backing store by the
//   resolve initial references. IOR_Multicast will be responsible for
//   initialising this class.
//
// = AUTHOR
//   Vishal Kachroo.
//
// ============================================================================

#ifndef TAO_IOR_LOOKUPTABLE_H
#define TAO_IOR_LOOKUPTABLE_H

#include "ace/Synch_T.h"
#include "ace/Hash_Map_Manager.h"
#include "tao/corbafwd.h"

#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */

class TAO_Export TAO_IOR_LookupTable
{
  // @@ Vishal, the DESCRIPTION above belongs to the class, not to the 
  // file, please move it here...
  //
public:
  // = Initialization and termination methods.
  TAO_IOR_LookupTable (void);
  // Constructor.

  ~TAO_IOR_LookupTable (void);
  // Destructor.

  int init (void);
  // This creates and initialises the table.
  // Currently, the hash map manager.

  int add_ior (ACE_CString &object_name,
               ACE_CString &ior);
  // Associate <object_name> with <ior>.  If <object_name> is already in the
  // map then the <ACE_Hash_Map_Entry> is not changed.  Returns 0 if a
  // new IOR is bound successfully, returns 1 if an attempt is made
  // to bind an existing object_name, and returns -1 if failures occur.

  int find_ior (ACE_CString &object_name,
                ACE_CString &ior);
  // Locate <object_name> and pass out parameter via <ior>.  If the IOR is
  // found, return 0. Return -1 if not found.

private:
  // @@ Vishal the following two fields are not used in the class, do
  // you have any plans for them or should we zap them?
  ACE_CString object_name_;
  // object string to do the lookup with.

  ACE_CString ior_;
  // IOR returned as a result of the lookup.

  ACE_Hash_Map_Manager<ACE_CString,
    ACE_CString,
    ACE_Null_Mutex> hash_map_;
  // Maintains the table of object_names -> IORs.
};

#endif /* TAO_IOR_LOOKUPTABLE_H */