Merge pull request #1551 from DOCGroup/plm_jira_333
[ACE_TAO.git] / TAO / orbsvcs / examples / ORT / README
blobc842a17005920894057ab1cd0ba60eca5756fea5
3 This example shows the use of ORT Template by a simple application.
5 Scenario:
6 ========
8 1. There's a server which has a dummy method that adds the two 'in' variables
9    and return the sum to the client.
11 2. There is a Gateway which receives the requests on behalf of the
12    server and redirects to the server. So the client never knows about
13    the actual server but only the gateway.
15 3. And, as always we will have a client that invokes the server
16    method.
18 Files and Small Description
19 =====================
22 Gateway.idl                     IDL for the Gateway
24 Gateway_IORInterceptor          IORInterceptor for the Gateway.
26 Gateway_i                       Implementation of the Gateway which changes the
27                                 DSI to DII.
29 Object_Factory_i                Implementation for the
30                                 Gateway IDL method. This method
31                                 creates a reference which points to the gateway
32                                 instead of the server.
34 gateway_server                  As the name means, gateway server
35                                 implementation.
37 sum_server.idl                  idl for the sum_server.
39 server                          The main server which is being
40                                 gatewayed by the gateway
42 sum_server_i                    Implementation of sum_server.idl methods.
44 client                          Simple client which invokes the sum_server
45                                 method add_variables.
47 How to run the example
48 ======================
50 1. First run the IFR_Service.
52 % $IFR_Service
54         It generates an ior in if_repo.ior by default.
56 2. Then, run the tao_ifr passing sum_server.idl as its argument,
58 % $tao_ifr sum_server.idl
60 3. Run the gateway server
62 % ./gateway_server -o gateway_ior -ORBInitRef IFR_Service=file://if_repo.ior
64 4. Run the actual server.
66 % ./server -o server_ior -ORBInitRef Gateway_Object_Factory=file://gateway_ior
68 5. Run the client
70 % ./client -k file://server_ior