~ubuntu-branches/ubuntu/breezy/ace/breezy

« back to all changes in this revision

Viewing changes to TAO/examples/POA/On_Demand_Activation/README

  • Committer: Bazaar Package Importer
  • Author(s): Adam Conrad, Benjamin Montgomery, Adam Conrad
  • Date: 2005-09-18 22:51:38 UTC
  • mfrom: (1.2.1 upstream) (2.1.1 sarge) (0.1.2 woody)
  • Revision ID: james.westby@ubuntu.com-20050918225138-seav22q6fyylb536
Tags: 5.4.7-3ubuntu1
[ Benjamin Montgomery ]
* Added a patch for amd64 and powerpc that disables the compiler
  option -fvisibility-inlines-hidden

[ Adam Conrad ]
* Added DPATCH_OPTION_CPP=1 to debian/patches/00options to make
  Benjamin's above changes work correctly with dpatch.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
// README,v 1.5 2002/08/22 18:08:04 irfan Exp
2
 
 
3
 
On_Demand_Activation Tests:
4
 
==========================
5
 
 
6
 
Description:
7
 
===========
8
 
 
9
 
ServantManagers:
10
 
===============
11
 
 
12
 
Servant managers are associated with POAs. A servant manager supplies
13
 
a POA with the ability to objects on demand when the POA receives a
14
 
request targeted at an inactive object. A servant manager is
15
 
registered with a POA as a callback object, to be invoked by the POA
16
 
when necessary.  An application server that activates all its needed
17
 
objects at the beginning of execution does not need to use a servant
18
 
manager; it is used only for the case in which an object must be
19
 
activated during request processing.
20
 
 
21
 
When the POA has the RETAIN policy it uses servant managers that are
22
 
ServantActivators. When the POA has the NON_RETAIN policy it uses
23
 
servant managers that are ServantLocators.
24
 
 
25
 
server:
26
 
======
27
 
 
28
 
        The test program server creates 2 POAs firstPOA and secondPOA.
29
 
firstPOA is created with a RETAIN,USER_ID,USE_SERVANT_MANAGER policy
30
 
and test_i_Activator is registered as its servant Manager.
31
 
secondPOA is created with a NON_RETAIN,USER_ID,USE_SERVANT_MANAGER
32
 
policy and ServantLocator is registered as it servant Manager.
33
 
 
34
 
It then creates an object reference from the string "first test" in
35
 
firstPOA and prints its IOR.Similarly it creates an object reference
36
 
from the string "second test" in secondPOA and prints its IOR. Finally
37
 
it changes the state of the POA_Manager to 'active' and runs the ORB.
38
 
 
39
 
USAGE:
40
 
======
41
 
 
42
 
You can use the run_test.pl perl script or follow these directions:
43
 
 
44
 
%server [-ORBobjrefstyle URL] [-f IOR file]
45
 
 
46
 
client:
47
 
======
48
 
        The client program is in the path
49
 
 
50
 
        TAO/tests/POA/Generic_Servant/client
51
 
        i.e ../Generic_Servant/client
52
 
 
53
 
% client [-k IOR] [-f IOR file]
54
 
 
55
 
where IOR is got from the server output to the screen or to the IOR file.
56
 
 
57
 
To Test:
58
 
=======
59
 
 
60
 
1. Run the server
61
 
 
62
 
Servant Activator:
63
 
===================
64
 
 
65
 
2. Get the IOR for "first test"  from the server output .
66
 
 
67
 
3. Run client -k IOR    
68
 
 
69
 
4. You should get an output
70
 
 
71
 
        27
72
 
 
73
 
along with some diagnostic messages.
74
 
 
75
 
Servant Locator:
76
 
=================
77
 
 
78
 
2. Get the IOR for "second test" from the server output
79
 
 
80
 
3. Run client -k IOR
81
 
 
82
 
4. The first time a client is run you should get an output
83
 
 
84
 
        2 (or 1)
85
 
 
86
 
along with some diagnostic messages.
87
 
 
88
 
5. Subsequent runs of the client program results in the output
89
 
   incremented by 2 (or 1).
90
 
 
91
 
6. Thus, the second run of client should give you an output 4 (or 2).
92
 
 
93
 
 
94
 
 
95
 
 
96
 
 
97
 
 
98