Difference between revisions of "Web Services"

From GreenVulcano Wiki
Jump to: navigation, search
(Create new {{GVWS}} with {{VULCON}})
 
(39 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
==Definition==
 
==Definition==
Web Service is a software system that allows the interoperability among machines on the same network.  
+
[http://en.wikipedia.org/wiki/Web_service Web Service] is a method of communication between different machines.  
Through a Web Service it is possible to pubblish business services using a contract, called WSDL.  
+
Using a Web Service it is possible to publish business services using a contract, called WSDL.  
  
 
{{GVESB}} provides a very simple method that helps developers to manage {{GVWS}} operations as:
 
{{GVESB}} provides a very simple method that helps developers to manage {{GVWS}} operations as:
Line 9: Line 9:
 
*publishing
 
*publishing
 
*undeploy
 
*undeploy
Any service flow can be pubblished in {{GVESB}} as a {{GVWS}}.{{L_VULCON}} helps the user to pubblish an ESB service as a web service, leaving the user the only task to define the data structures in order to interact with the external world.
+
Any service flow can be published in {{GVESB}} as a Web Service. {{L_VULCON}} helps the user to create or invoke a Web Service, leaving the user the only task to define the data structures in order to interact with the external world.
  
 
{{GVESB}} provides a complete management of {{GVWS}} through Axis2 platform. It supports:
 
{{GVESB}} provides a complete management of {{GVWS}} through Axis2 platform. It supports:
*{{GVWS}} stateful and asynchronous
+
*Stateful and asynchronous {{GVWS}}
*Processing SOAP Messages with XML parsing more efficient pull-based instead of DOM (Document Object Model)
+
*Processing SOAP Messages with XML parsing, using the more efficient AXIOM pull-parser instead of DOM (Document Object Model)
 
*Increased Scalability
 
*Increased Scalability
 
*Hot deploy and undeploy
 
*Hot deploy and undeploy
  
 
==Create new {{GVWS}} with {{VULCON}}==
 
==Create new {{GVWS}} with {{VULCON}}==
[[File:ws1.png|thumb|WebService Wizard window]]
+
{{VULCON}} provides two wizards for creating new {{GVWS}}. The first one starts from a {{GVESB}} service and creates the WSDL and the AAR to deploy ([[bottom-up development method]]), while the second one starts from a WSDL and creates {{GVESB}} services for each chosen operation ([[top-down development method]]).
VulCon provides two wizards to create new Web Services. The first one starting from an {{GVESB}} service and creating the WSDL and the AAR to deploy (bottom-up development method), the second one, starting from a WSDL, creating {{GVESB}} services for each operation chosen (top-down development method).
+
If you need to invoke a Web Service operation, instead, you can choose [[Wizard Call Web Service]] or, if you want to simply redirect a Web Service call to a different endpoint, you can choose [[Wizard Proxy Web Service]]. The wizard can be activated opening the context menu on the Core view tree's Service element.
'''bottom-up development method'''
+
<div class="version_ge3.3">
Right click on GVServices-->Services label and select "Wizard New WebService...".
+
You can publish any {{GVESB}} core service using a generic Web Service interface. By means of this feature, you can invoke directly the following core service operations, depending on the how the {{GVESB}} core service has been designed:
New WebService Wizard window will be open.
+
*requestReply
Fill the window fields as following:
+
*request
*In the "WebService name" field set the WebService name that you want to publish
+
*getReply
*In the "target namespace" field if you want you can change the default operation target namespace proposed
+
*getRequest
*In the "Operation" field choose the operation to bind from list proposed.
+
*sendReply
 +
*execute
 +
You can get the generic WSDL at location:<pre>http://<host>:<port>/gvaxis2/services/GreenVulcanoWebservice?wsdl</pre>
 +
In order to invoke the service, you have to set all required parameters. This can be done also using the [[Wizard Enable GreenVulcano Web Service]].
 +
</div>
  
On the second page you can change:
+
=={{GVCONSOLE}} Web service section==
*Soap Action and the mapped operation name to the WebService-This optional property is set on an outgoing SOAP/JMS request message to indicate the soapAction value associated with the Web services request. This property is similar to the SOAPAction HTTP header used when transporting Web service requests over an HTTP transport. The value of the soapAction property is a URI identifying the intent of the SOAP request. If the soapAction property is specified, it is used by the server component to determine the target of the request. The SOAP specification places no restrictions on the format or specificity of the URI or that it is resolvable. Typically, this property is set to the soapAction value from the WSDL document.
 
On the third page you can choose your preferred transport protocol
 
*Soap Transport
 
*Soap12 Transport
 
*Rest Transport
 
*JMS Transport
 
  
If you choose Rest Transport, you must additionally select the verb for the operation.
+
The Web Service section in {{GVCONSOLE}} contains five main pages:
If you choose JMS Transport, You must additionally:
+
#[[General parameter]]: shows the general configuration of business web services and the UDDI Registry's configuration,  
*select The jms connection factory
+
#[[WSDL Section]]: allows to generate or delete WSDL files, and to deploy the Web Service
*JMS destination name
+
#[[UDDI Section]]: allows to publish Web Service in UDDI registry, if the UDDI registry has been configured.
*JMS destination type
+
#BPEL Deployed Processes
*Reply destination: Destination where a reply will be posted
+
#BPEL Currently Available Instances
*contentType:This property is similar to the Content-Type header found in an HTTP message and is used to describe the content type of the message
+
 
*ByteMessage
+
If you are familiar with [http://axis.apache.org/axis2/java/core/docs/webadminguide.html#Intro  Axis2 console] it's possible to look up the following link:<pre>http://ipaddredss:portnumber/gvaxis2</pre>
*TextMessage
 
On the fourth and last page you must choose:
 
*The WebService input type
 
*The [[DATA PROVIDER]] name
 
And optionally
 
*The input XSD name
 
*The output XSD name
 
And check the preferred Radio Button for:
 
*HTTP or HTTPS
 
*Target namespace that WebService use, is or not is in the XSD
 
*Use or not use the original wsdl
 
 
{{VOTE}}
 
{{VOTE}}

Latest revision as of 08:25, 29 April 2013

Definition

Web Service is a method of communication between different machines. Using a Web Service it is possible to publish business services using a contract, called WSDL.

GreenVulcano® ESB provides a very simple method that helps developers to manage Web Services operations as:

  • create
  • invoke
  • deploy
  • publishing
  • undeploy

Any service flow can be published in GreenVulcano® ESB as a Web Service. VulCon® helps the user to create or invoke a Web Service, leaving the user the only task to define the data structures in order to interact with the external world.

GreenVulcano® ESB provides a complete management of Web Services through Axis2 platform. It supports:

  • Stateful and asynchronous Web Services
  • Processing SOAP Messages with XML parsing, using the more efficient AXIOM pull-parser instead of DOM (Document Object Model)
  • Increased Scalability
  • Hot deploy and undeploy

Create new Web Services with VulCon

VulCon provides two wizards for creating new Web Services. The first one starts from a GreenVulcano® ESB service and creates the WSDL and the AAR to deploy (bottom-up development method), while the second one starts from a WSDL and creates GreenVulcano® ESB services for each chosen operation (top-down development method). If you need to invoke a Web Service operation, instead, you can choose Wizard Call Web Service or, if you want to simply redirect a Web Service call to a different endpoint, you can choose Wizard Proxy Web Service. The wizard can be activated opening the context menu on the Core view tree's Service element.

You can publish any GreenVulcano® ESB core service using a generic Web Service interface. By means of this feature, you can invoke directly the following core service operations, depending on the how the GreenVulcano® ESB core service has been designed:

  • requestReply
  • request
  • getReply
  • getRequest
  • sendReply
  • execute
You can get the generic WSDL at location:
http://<host>:<port>/gvaxis2/services/GreenVulcanoWebservice?wsdl

In order to invoke the service, you have to set all required parameters. This can be done also using the Wizard Enable GreenVulcano Web Service.

GV Console Web service section

The Web Service section in GV Console contains five main pages:

  1. General parameter: shows the general configuration of business web services and the UDDI Registry's configuration,
  2. WSDL Section: allows to generate or delete WSDL files, and to deploy the Web Service
  3. UDDI Section: allows to publish Web Service in UDDI registry, if the UDDI registry has been configured.
  4. BPEL Deployed Processes
  5. BPEL Currently Available Instances

If you are familiar with Axis2 console it's possible to look up the following link:

http://ipaddredss:portnumber/gvaxis2

{{#w4grb_rate:}} <w4grb_ratinglist latestvotes items="5" nosort/>