TAO/tests/ForwardUponObjectNotExist/README

   1 /**
   2
   3 @page ForwardUponObjectNotExist Test README File
   4
   5
   6
   7         This is test for feature of request forwarding when client receives
   8         OBJECT_NOT_EXIST exception. The feature is enabled and disabled by
   9         -ORBForwardInvocationOnObjectNotExist [0|1] option.
  10
  11         The servant implementation is made to raise OBJECT_NOT_EXIST exception.
  12         This is to simulate the server exception reply regardless the actual
  13         meaning of the OBJECT_NOT_EXIST exception. The test also takes advantage
  14         of the IORTable facilities in TAO to create a simple corbaloc IOR, TAO
  15         always responds with a LOCATION_FORWARD message when a request is
  16         made for an object in the IORTable. This would make the stub have the
  17         forward address upon receiving OBJECT_NOT_EXIST exception so it can
  18         perform the forwarding. If client runs with the feature disabled
  19         (-ORBForwardInvocationOnObjectNotExist 0) then the client should catch
  20         the OBJECT_NOT_EXIST exception, otherwise, the request will be looping
  21         between server and client and the invocation never ends. The invocation
  22         finally ends because of the server shutdown.
  23
  24         To execute the test simply run:
  25
  26 $ ./run_test.pl
  27
  28         the script returns 0 on success and non-zero on failures.
  29
  30 */