How To Call Rest Service From Java Wdsl Web

RESTful Web Services Support

This document presents an introduction on REST and REST with HTTP POST and GET.

Content

Introduction
Doing Rest Web Services with HTTP POST
- Sample REST - HTTP Postal service Client
Admission a REST Web Service via HTTP GET

Introduction

WSDL ii.0 HTTP Binding defines a way to implement REST (Representational State Transfer) with Spider web services. Axis2 implements the most defined HTTP binding specification. REST Spider web services are a reduced subset of the usual Web service stack.

The Axis2 REST implementation assumes the post-obit properties:

REST Web services are Synchronous and Request Response in nature.
When REST Web services are accessed via GET, the service and the operations are identified based on the URL. The parameters are assumed as parameters of the Web service. In this case, the GET based REST Spider web services support only unproblematic types as arguments and information technology should adhere to the IRI style.
Mail service based Spider web services exercise not need a SOAP Envelope or a SOAP Body. REST Web Services do non have Headers and the payload is sent directly.

Axis2 can be configured equally a Residue Container and tin exist used to send and receive RESTful Web service requests and responses. REST Web services can be accessed using HTTP GET and Postal service.

Remainder Spider web Services with HTTP Post

If Remainder is enabled, the Axis2 server volition act as both a Residuum endpoint and a Soap endpoint. When a bulletin is received, if the content type is text/xml and if the SOAPAction Header is missing, and then the bulletin is treated as a RESTful Bulletin, if non it is treated equally a usual Soap Message.

On sending a message, whether the message is RESTful or not, tin can be decided from the client API.
Gear up a property in the client API.

... Options options = new Options(); options.setProperty(Constants.Configuration.ENABLE_REST, Constants.VALUE_TRUE); ...

Sample REST - HTTP Postal service Customer

There is an example named, userguide.clients.RESTClient.java found in AXIS2_HOME/samples/userguide/src/userguide/clients which demonstrates the usage of the in a higher place. It uses the "repeat" performance of the userguide.example1.MyService of the AXIS2_HOME/samples/userguide/src/userguide/example1.

The class source will be as follows:

public grade RESTClient {      private static String toEpr = "http://localhost:8080/axis2/services/MyService";          public static void main(Cord[] args) throws AxisFault {          Options options = new Options();         options.setTo(new EndpointReference(toEpr));         options.setTransportInProtocol(Constants.TRANSPORT_HTTP);                  options.setProperty(Constants.Configuration.ENABLE_REST, Constants.VALUE_TRUE);          ServiceClient sender = new ServiceClient();         sender.engageModule(Constants.MODULE_ADDRESSING);         sender.setOptions(options);         OMElement result = sender.sendReceive(getPayload());          endeavor {             XMLStreamWriter writer = XMLOutputFactory.newInstance()                     .createXMLStreamWriter(System.out);             outcome.serialize(writer);             writer.flush();         } catch (XMLStreamException east) {             due east.printStackTrace();         } catch (FactoryConfigurationError e) {             e.printStackTrace();         }     }      private static OMElement getPayload() {         OMFactory fac = OMAbstractFactory.getOMFactory();         OMNamespace omNs = fac.createOMNamespace(                 "http://example1.org/example1", "example1");         OMElement method = fac.createOMElement("echo", omNs);         OMElement value = fac.createOMElement("Text", omNs);         value.addChild(fac.createOMText(value, "Axis2 Echo Cord "));         method.addChild(value);          return method;     } }

Admission a REST Web Service via HTTP Become

Axis2 allows users to access Web services that have unproblematic type parameters via HTTP Get. For example, the post-obit URL requests the Version Service via HTTP Go. All the same, the Web service arriving via GET assumes Residue. Other parameters are converted into XML and put into the SOAP body.

http://127.0.0.1:8080/axis2/services/Version/getVersion

The event can be shown in the browser equally follows:

For example, the post-obit asking,

http://127.0.0.1:8080/axis2/services/Version/getVersion

will be converted into the following SOAP message for processing by Axis2.

                    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">       <soapenv:Body>              <axis2:getVersion xmlns:axis2="http://ws.apache.org/goGetWithREST" />       </soapenv:Trunk>    </soapenv:Envelope>