TAO/tests/POA/On_Demand_Activation/README

   1
   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).