Axis2/C - Sample

Sample Code

Copy the sample source file, hello_svc.c, from the installation folder to a folder of your choice:
```
copy C:\bin\axis2c-bin-1.1.0-win32\docs\docs\hello\service\hello_svc.c
```
Copy the sample, services.xml file to the same folder:
```
copy C:\bin\axis2c-bin-1.1.0-win32\docs\docs\hello\service\hello\services.html services.xml
```
Note: services.html need to be renamed to services.xml.

Setup

Open a Visual Studio .NET 2003 Command Prompt and set the standard environment variables:

set AXIS2C_HOME=C:\bin\axis2c-bin-1.1.0-win32
set PATH=%PATH%;%AXIS2C_HOME%\lib

Compile

Compile and link the code (creates hello.dll):

cl.exe /D "WIN32" /D "_WINDOWS" /D "_MBCS" /D "AXIS2_DECLARE_EXPORT" /D "AXIS2_SVR_MULTI_THREADED" /w /nologo /I  %AXIS2C_HOME%\include /c hello_svc.c
link.exe /nologo /LIBPATH:%AXIS2C_HOME%\lib axutil.lib axiom.lib axis2_parser.lib axis2_engine.lib /DLL /OUT:hello.dll *.obj

Deploy

In the services folder of the axis2c installation, create a folder to contain the service e.g. services/hello:
```
C:\bin\axis2c-bin-1.1.0-win32\services\hello\
```

Copy hello.dll and services.xml to this folder:

copy hello.dll C:\bin\axis2c-bin-1.1.0-win32\services\hello\
copy services.xml C:\bin\axis2c-bin-1.1.0-win32\services\hello\

Re-start the Simple Axis2 HTTP Server and list the services to see if your new hello service has been deployed:

http://localhost:9090/axis2/services

Client

To build a test client, use similar command lines, just remove /DLL from the link command and name the output file exe rather than dll.

REST

hello

The service (above) can be called as a REST service (I think), using this: curl, curl, command:

curl http://localhost:9090/axis2/services/hello/greet -d "<name>Sam</name>"

echo

Build the echo sample in exactly the same way as we build the hello sample (above). To invoke the REST service, use curl, curl.

curl http://localhost:9090/axis2/services/echo/echoString?name=Patrick

Doing an HTTP POST rather than a get, returns a nice error message:

curl http://localhost:9090/axis2/services/echo/echoString -d "name=Patrick"