axis-axis2-c-core

                      Apache Axis2/C

What is it?

Apache Axis2/C is a web services framework written in C, for building and
consuming JSON/REST and SOAP services. It is embeddable: the same engine runs
as an Apache httpd module, inside a standalone server, or linked directly into
an application binary.

It is written in C with no runtime beyond libc and its transport dependencies,
which makes it usable where a managed runtime is not an option: as a module in
an existing Apache httpd deployment, in embedded and resource-constrained
environments, and on Android, where the build produces a native library and
services are linked statically into the host process.

Features

* JSON/REST services over HTTP/1.1 and HTTP/2, with a JSON reader and
  writer and a JSON-RPC message receiver.

* Runs as an Apache httpd module, as a standalone HTTP server, or embedded
  in an application.

* Android and other static-linking targets. Service functions are declared
  as weak symbols, so the framework compiles and links with no service
  implementation present and an application supplies strong implementations
  at link time. This is what allows services to be linked into a single
  native binary on platforms that do not load shared modules at runtime.
  configure detects an Android target and builds accordingly.

* Model Context Protocol (MCP) support, so deployed services can be called
  as tools by an AI agent. Demonstrated in the financial-benchmark-service
  sample, with two transports: a JSON-RPC 2.0 stdio server for MCP clients
  that launch a subprocess, and an HTTP catalog endpoint that builds the
  tool list by walking the deployed services at request time. Tool
  descriptions, JSON Schema and the read-only, idempotent and destructive
  hints come from parameters in services.xml, so an existing service is
  exposed as an MCP tool by adding metadata rather than writing code.

* SOAP 1.1 and SOAP 1.2, built on the AXIOM XML object model, with complete
  WS-Addressing 1.0 support and MTOM/XOP for binary attachments.

* One-way (In-Only) and request-response (In-Out) messaging, synchronous or
  asynchronous.

* A code generator that produces C stubs and skeletons from WSDL.

For an overview of the architecture Axis2/C implements, see
http://axis.apache.org/axis2/java/core/docs/Axis2ArchitectureGuide.html

As a project of the Apache Software Foundation, the developers aim to
collaboratively develop and maintain a robust, commercial-grade,
standards-based web services stack implementation with freely available
source code.

The Latest Version

Details of the latest version can be found on the Apache Axis2/C
project page under http://axis.apache.org/axis2/c/core/.

Documentation

The documentation available as of the date of this release is
included in HTML format in the docs/ directory. The most
up-to-date documentation can be found at
http://axis.apache.org/axis2/c/core/docs/index.html.

Installation

Please see the file named INSTALL. You can also have a look at
docs/installationguide.html.

Licensing

Please see the file named LICENSE.

Contacts

 o If you want freely available support for using Apache Axis2/C please 
   join the Apache Axis2/C user community by subscribing to users mailing 
   list, [email protected]' as described at 
   http://axis.apache.org/axis2/c/core/mail-lists.html

 o If you have a bug report for Apache Axis2/C please go log a Jira issue 
   at http://issues.apache.org/jira/browse/AXIS2C

 o If you want to participate in actively developing Apache Axis2/C please
   subscribe to the `[email protected]' mailing list as described at
   http://axis.apache.org/axis2/c/core/mail-lists.html

Acknowledgements

Apache Axis2/C relies heavily on the use of autoconf and libtool to provide
a build environment.