TAO/examples/ior_corbaloc/README

   1
   2
   3 This is test to exercise the corbaloc: and corbaname: style URL.
   4 The simple way to test is to run the run_test.pl.
   5
   6 The corbaloc: and corbaname: URL syntax is documented in Chapter
   7 13.6.7 "Object URLs", of the CORBA 2.4.2 specification:
   8 ftp://ftp.omg.org/pub/docs/formal/01-02-01.pdf
   9
  10 To test manually:
  11
  12 1. Run the NamingService at a specified endpoint.
  13
  14         $NamingService -m 1 -ORBEndPoint iiop://doc.ece.uci.edu:12345 &
  15
  16 2. Run the server.
  17
  18         ./server STATUS -ORBInitRef NameService=corbaloc:iiop:doc.ece.uci.edu:12345 &
  19
  20         This will create a corbaloc::Status CORBA object and register
  21         the object reference in the Naming Service with the name
  22         STATUS.
  23
  24
  25 3. The client takes in a corbaloc style URL for the CORBA
  26    Naming Service on the command-line.  The client will
  27    first try to resolve the Naming Service using this corbaloc URL.
  28    The client will then try to resolve a corbaloc::Status object
  29    (see corbaloc.idl) named "STATUS".
  30    The client will then try to invoke the print_status() method
  31    on this object.
  32
  33    Run the client as one of these:
  34
  35  a)     ./client corbaloc::doc.ece.uci.edu:12345/NameService
  36
  37         CORBALOC style URL is used and the protocol used to
  38         contact the naming context is <iiop> implicitly.
  39
  40  b)     ./client corbaloc:iiop:doc.ece.uci.edu:12345/NameService
  41
  42         CORBALOC style URL is used and the protocol used to
  43         contact the naming context is <iiop>.
  44
  45  c)     ./client corbaloc:rir:/NameService
  46
  47         CORBALOC style URL is used and the protocol used to
  48         contact the naming context is <rir>.
  49
  50  d)     ./client corbaloc:rir:/
  51
  52         CORBALOC style URL is used with resolve initial references (rir)
  53         format.  Since no object key is specified, it defaults
  54         to "NameService"
  55
  56
  57 4.  The corbaname_client will try to look up an object in the
  58     CORBA Naming Service based on the corbaname URL passed in on the
  59     command line.   The corbaname_client will resolve the object,
  60     and then narrow it down to a corbaloc::Status object.  The
  61     corbaname_client will then try to invoke the print_status() method
  62     on the object.
  63
  64     Run the corbaname_client as one of these:
  65
  66  a)    ./corbaname_client corbaname:iiop:doc.ece.uci.edu:12345#STATUS
  67
  68        - Specify the protocol, host, and port where the Naming Service is.
  69        - Resolve an object reference of name "STATUS".
  70
  71  b)    ./corbaname_client corbaname::doc.ece.uci.edu:12345#STATUS
  72
  73        - Do not specify the protocol (defaults to iiop).
  74        - Specify where the host and port of the Naming Service is.
  75        - Resolve an object reference of name "STATUS".
  76
  77  c)    ./corbaname_client corbaname:rir:#STATUS
  78
  79        - Determine where the Naming Service is by using
  80          orb->resolve_initial_references("NameService")
  81        - Resolve an object reference of name "STATUS"