intra-mart Accel Platform / Web Service Specifications

Version 2 2014-04-01

«  Introduction   ::   Contents   ::   Authentication/Authorization  »

Overview

What is Web Service ?

[Web Service] refers to the technologies that use internet and the services utilizing them. [Web Service] addressed in this document refers to Web Service that use SOAP and WSDL.

Web Service Provider and Web Service Client

In this document, [Web Service Provider] is the one that provides Web Service, and [Web Service Client] is the one that utilizes Web Service.
../../_images/outline.png

SOAP

SOAP is a protocol to exchange messages in XML format.
Web Service exchanges SOAP XML messages (SOAP Envelope) according to the protocol.
SOAP Envelope is made up of the 2 parts below :
  • SOAP Header

    Additional information is saved. It is optional.

  • SOAP Body

    Main information (data) is saved.

SOAP is a protocol for the software to exchange data each other. SOAP Envelope does not have descriptions about communication protocol, and therefore can be used in various scenes in common.
Please refer to books or Web sites for details about SOAP. Please refer to [Web Services Activity] of W3C for the specifications of SOAP.

SOAP Fault

In SOAP, if any error occurs in Web Service Provider, the error information would be saved in SOAP Body and can be returned to Web Service Client. This error information is called [SOAP Fault].
SOAP Fault is made up of error code, error message, and error detail.

WSDL

WSDL(Web Services Description Language) is the XML-based language specification to describe Web Service.
Following information necessary for the use of Web Service is stated :
  • Access point of Web Service
  • Communication protocol of Web Service
  • Input information to use Web Service
  • Execution result format of Web Service
Web Service Client uses Web Service based on the interface of Web Service stated in WSDL.
WSDL is made up of the following elements :
  • wsdl:definitions
  • wsdl:types
  • wsdl:message
  • wsdl:operation
  • wsdl:postType
  • wsdl:binding
  • wsdl:port
  • wsdl:service
Please refer to books or Web sites for the detail information about WSDL. Please refer to [Web Services Activity] of W3C for the specifications of WSDL.

XML Schema

wsdl:types element of WSDL defines the format of XML messages exchanged in Web Service. It uses [XML Schema] as the schema language that defines XML message structure.
Please refer to books or Web sites for the detail information about XML schema. Please refer to [XML Schema] of W3C for the specifications of XML schema.

Web Service Operation

Web Service Operation means operations defined in Web Service. Web Service Operation is defined by wsdl:operation element of WSDL.

Apache Axis2

In intra-mart Accel Platform, [Apache Axis2] is adopted as Web Service engine.

«  Introduction   ::   Contents   ::   Authentication/Authorization  »