diff options
Diffstat (limited to 'sca-cpp/branches/cpp-M1/sca/samples/Calculator/Client/readme.txt')
-rw-r--r-- | sca-cpp/branches/cpp-M1/sca/samples/Calculator/Client/readme.txt | 64 |
1 files changed, 64 insertions, 0 deletions
diff --git a/sca-cpp/branches/cpp-M1/sca/samples/Calculator/Client/readme.txt b/sca-cpp/branches/cpp-M1/sca/samples/Calculator/Client/readme.txt new file mode 100644 index 0000000000..62672483af --- /dev/null +++ b/sca-cpp/branches/cpp-M1/sca/samples/Calculator/Client/readme.txt @@ -0,0 +1,64 @@ +Tuscany SCA for C++ Samples - Calculator Sample +=============================================== + +This is a very simple sample to show how an SCA module with a single component +can be built and called from an executable. + +There are three sub projects in this workspace: + - CalculatorModule + This contains the source code and SCA artifacts for the SCA module. This + is the module that will be deployed into the SCA runtime. + - CalculatorSubsystem + This contains the sca.subsystem file which describes a subsystem to the + SCA runtime. + - Client + An example client which will call the service exposed by the single component + in the CalculatorModule. + + +Build instructions +------------------ + +Notes: + +The projects are set up to locate SCA and SDO libraries using the environment variables +TUSCANY_SCACPP and TUSCANY_SDOCPP. These must be set before building. + +scagan is a code generation tool written in java. This will need to be built before you +can run it. To build scagen, you must go to the tools/scagen directory, and type "ant". +(You must have apache ant installed, and have a valid java virtual machine installed - +upwards of version 1.4.2). Once scagen has successfully built, it can be run from the +sca/bin directory. + +1) Build the SCA module. + - Set CalculatorModule project as the active project. + Right click->Set as active project + + - Run the SCA generation tool to create the proxy and wrapper classes. + Either Tools->SCA Gen if you have added SCA Gen as an external tool + Or run from the command line: + scagen -dir <projectDirectory> -output <projectDirectory> + where the projectDirectory is the directory with the sca.module file. + + - Rebuild All + Build->Rebuild All + +2) Package and deploy the SCA module + - There is a script file in the sca/samples/Calculator directory which will + copy across all the files needed for deployment to the Tuscany runtime. + On a command line run pack_deploy.cmd + As a default, the sample will be copied to sca/samples/runtime directory + Both the SCA module and the subsystem will be copied. + +3) Build the client + - Set the Client project as the active project. + Right click->Set as active project + + - Rebuild All + Build->Rebuild All + +4) Run the client + - Use the command file in the sca/samples/Calculator/Client directory to run the + client. This command file will set the SCA environment variables before running + the client. For example, + runclient add 4 9 |