{"id":2650,"date":"2018-02-13T02:53:38","date_gmt":"2018-02-13T02:53:38","guid":{"rendered":"http:\/\/codethataint.com\/blog\/?p=2650"},"modified":"2021-02-21T17:17:30","modified_gmt":"2021-02-21T17:17:30","slug":"soap-notes-from-java-brains","status":"publish","type":"post","link":"https:\/\/codethataint.com\/blog\/soap-notes-from-java-brains\/","title":{"rendered":"Notes on SOAP Web Services"},"content":{"rendered":"

SOAP(Simple Object Access Protocol)<\/strong> – SOAP is an XML-based protocol that lets you exchange info over a particular protocol (can be HTTP or SMTP, for example) between applications. It stands for Simple Object Access Protocol and uses XML for its messaging format to relay the information.<\/p>\n

WSDL(Web Services Definition Language)<\/strong> – A WSDL is an XML document that describes a web service. WSDL tells about the functions that you can implement or exposed to the client. For example: add, delete, subtract, and so on. what is the service called, which methods does it offer, what kind of in parameters and return values do these methods have?<\/p>\n

XSD(XML Schema Definition)<\/strong> – describes the static structure of the complex data types being exchanged by those service methods. It describes the types, their fields, any restriction on those fields (like max length or a regex pattern), and so forth.It’s a description of datatypes and thus static properties of the service – it’s about data.<\/p>\n

XSD definitions are part of WSDL in the tag<\/em><\/p>\n

UDDI(Universal Description, Discovery, and Integration)<\/strong>– It is directly that is used to publish and discover public web services. UDDI is an obsolete failure that is almost never used in practice.UDDI works just like a telephone directory where a business can be registered as per its name, geography and the web services it publishes.UDDI registers the WSDL address URL of a web service. A client of the web service searches and finds the WSDL in the UDDI registry. Once received the WSDL can be invoked by using the URL.<\/p>\n

WSDL: When we go to a restaurant we see the Menu Items, those are the WSDL’s.
\nProxy Classes: Now after seeing the Menu Items we make up our Mind (Process our mind on what to order): So, basically we make Proxy classes based on WSDL Document.
\nSOAP: Then when we actually order the food based on the Menu’s: Meaning we use proxy classes to call upon the service methods which is done using SOAP<\/p>\n

SEI(service endpoint interface)<\/strong>: The endpoint is a connection point where HTML files or active server pages are exposed. A web service endpoint is a URL that another program would use to communicate with your program. To see the WSDL, you add WSDL to the web service endpoint URL.<\/p>\n

Parts of WSDL<\/strong>
\nDefinitions <\/strong>– variables – ex: myVar, x, y, etc.<\/p>\n

Types <\/strong>– data types – ex: int, double, String, myObjectType<\/p>\n

Operations <\/strong>– methods\/functions – ex: myMethod(), myFunction(), etc.<\/p>\n

Messages <\/strong>– method\/function input parameters & return types<\/p>\n

ex: public myObjectType myMethod(String myVar)
\nPorttypes <\/strong>– classes (i.e. they are a container for operations) – ex: MyClass{}, etc.<\/p>\n

Example of a Endpoint URL<\/strong><\/p>\n

\r\nprotocol:\/\/host:port\/partOfThePath\r\n<\/pre>\n
where<\/p>\n
\r\nhost=someIp\r\nport=8080\r\npartOfThePath=\/some\/service\/path\r\n<\/pre>\n
serviceAEndpoint=http:\/\/host:port\/some\/service\/path?dynamicParam=<\/em><\/p>\n
Simple SOAP Request and Response<\/strong><\/p>\n
\r\n package com.mugil.org;\r\n\r\nimport java.util.ArrayList;\r\nimport java.util.List;\r\n\r\nimport javax.jws.WebService;\r\n\r\n@WebService\r\npublic class Products \r\n{\r\n  List<String> arrProducts = new ArrayList<String>();\r\n\t\r\n  public Products()\r\n  {\r\n\tarrProducts.add("Books");\r\n\tarrProducts.add("EReader");\r\n\tarrProducts.add("PDF");\t\r\n  }\r\n  \r\n  public String getProduct(int index)\r\n  {\r\n\treturn arrProducts.get(index);  \r\n  }\r\n}\r\n<\/pre>\n
SOAP Request<\/strong><\/p>\n
\r\n<soapenv:Envelope xmlns:soapenv="http:\/\/schemas.xmlsoap.org\/soap\/envelope\/" xmlns:org="http:\/\/org.mugil.com\/">\r\n   <soapenv:Header\/>\r\n   <soapenv:Body>\r\n \r\n      <org:getProduct>\r\n         <arg0>0<\/arg0>\r\n      <\/org:getProduct>\r\n   <\/soapenv:Body>\r\n<\/soapenv:Envelope>\r\n<\/pre>\n
SOAP Request<\/strong><\/p>\n
\r\n<soap:Envelope xmlns:soap="http:\/\/schemas.xmlsoap.org\/soap\/envelope\/">\r\n   <soap:Body>\r\n      <ns2:getProductResponse xmlns:ns2="http:\/\/org.mugil.com\/">\r\n         <return>Books<\/return>\r\n      <\/ns2:getProductResponse>\r\n   <\/soap:Body>\r\n<\/soap:Envelope>\r\n<\/pre>\n
Part of WSDL<\/strong>
\nTypical WSDL document contains the following tags<\/p>\n
    \n
  1. service<\/strong> – Contains the port which defines the Endpoint URL, port number<\/li>\n
  2. portType<\/strong> – Contains input and output for an operation.Though there are multiple input and output arguments they would be bundled together as one message<\/li>\n
  3. binding<\/strong> – Defines how the SOAP service could be accessed like over http,https<\/li>\n
  4. types<\/strong> – Type defined as complex type defines the Input and output<\/li>\n
  5. message<\/strong> – Kind of input and output taken as argument, mostly represented as Message<\/li>\n<\/ol>\n
    Service<\/strong><\/p>\n
    \r\n <wsdl:service name="ProductsService">\r\n  <wsdl:port binding="tns:ProductsServiceSoapBinding" name="ProductsPort">\r\n   <soap:address location="http:\/\/localhost:8096\/WebService1\/Products"\/>\r\n  <\/wsdl:port>\r\n  <\/wsdl:service>\r\n<\/pre>\n
    Porttype<\/strong><\/p>\n
    \r\n <wsdl:portType name="Products">\r\n   <wsdl:operation name="getProduct">\r\n    <wsdl:input message="tns:getProduct" name="getProduct"><\/wsdl:input>\r\n    <wsdl:output message="tns:getProductResponse" name="getProductResponse"><\/wsdl:output>\r\n   <\/wsdl:operation>\r\n  <\/wsdl:portType>\r\n<\/pre>\n
    Binding<\/strong><\/p>\n
    \r\n<wsdl:binding name="ProductsServiceSoapBinding" type="tns:Products">\r\n      <soap:binding style="document" transport="http:\/\/schemas.xmlsoap.org\/soap\/http" \/>\r\n      <wsdl:operation name="getProduct">\r\n         <soap:operation soapAction="" style="document" \/>\r\n         <wsdl:input name="getProduct">\r\n            <soap:body use="literal" \/>\r\n         <\/wsdl:input>\r\n         <wsdl:output name="getProductResponse">\r\n            <soap:body use="literal" \/>\r\n         <\/wsdl:output>\r\n      <\/wsdl:operation>\r\n   <\/wsdl:binding>\r\n<\/pre>\n
    Types<\/strong><\/p>\n
    \r\n <wsdl:types>\r\n      <xs:schema xmlns:xs="http:\/\/www.w3.org\/2001\/XMLSchema" elementFormDefault="unqualified" targetNamespace="http:\/\/org.mugil.com\/" version="1.0">\r\n         <xs:element name="getProduct" type="tns:getProduct" \/>\r\n         <xs:element name="getProductResponse" type="tns:getProductResponse" \/>\r\n         <xs:complexType name="getProduct">\r\n            <xs:sequence>\r\n               <xs:element name="arg0" type="xs:int" \/>\r\n            <\/xs:sequence>\r\n         <\/xs:complexType>\r\n         <xs:complexType name="getProductResponse">\r\n            <xs:sequence>\r\n               <xs:element minOccurs="0" name="return" type="xs:string" \/>\r\n            <\/xs:sequence>\r\n         <\/xs:complexType>\r\n      <\/xs:schema>\r\n<\/pre>\n
    Message<\/strong><\/p>\n
    \r\n <wsdl:message name="getProduct">\r\n      <wsdl:part element="tns:getProduct" name="parameters" \/>\r\n   <\/wsdl:message>\r\n   <wsdl:message name="getProductResponse">\r\n      <wsdl:part element="tns:getProductResponse" name="parameters" \/>\r\n   <\/wsdl:message>\r\n<\/pre>\n
    \"\"<\/p>\n
    \r\nService(Class name with @WebService Annotation) \r\n                | \r\nPort(has Binding which defines portType)\r\n                | \r\n    PortType(defines Operations)\r\n                | \r\nOperations(defines input and output Type)<\/strong>\r\n<\/pre>\n
    Annotations for WebService<\/strong><\/p>\n
    \r\n@Webservice(name=\"MartCatalogue\", portName=\"MartCataloguePort\", serviceName=\"ProductsService\", targetNamespace=\"MartProducts.com\")\r\n.\r\n.\r\n@WebMethod(action=\"fetch_products\", operationName=\"fetchProducts\")\r\n.\r\n<\/pre>\n
    name<\/strong><\/p>\n
    \r\n<wsdl:portType name="MartCatalogue">\r\n.\r\n.\r\n<\/pre>\n
    portName and serviceName<\/strong><\/p>\n
    \r\nwsdl:port binding="tns:productServiceSoapBinding" name="productPort">\r\n  <soap:address location="http:\/\/localhost:8096\/WebService1\/productService"\/>\r\n<\/wsdl:port>\r\n.\r\n.\r\n<\/pre>\n
    targetNamespace<\/strong>
    \nDefines unique set of operations under namespace.Defaults to package name in java in reverse order
    \ntargetNamespace=”MartProducts.com”<\/p>\n
    targetNamespace<\/strong><\/p>\n
    \r\n<wsdl:operation name="fetchProducts">\r\n.\r\n.\r\n<\/pre>\n
    \r\n <wsdl:operation name="fetchProducts">\r\n      <soap:operation soapAction="fetch_products" style="document" \/>\r\n  .\r\n  .\r\n<\/pre>\n","protected":false},"excerpt":{"rendered":"
    SOAP(Simple Object Access Protocol) – SOAP is an XML-based protocol that lets you exchange info over a particular protocol (can be HTTP or SMTP, for example) between applications. It stands for Simple Object Access Protocol and uses XML for its messaging format to relay the information. WSDL(Web Services Definition Language) – A WSDL is an… Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[220],"tags":[],"class_list":["post-2650","post","type-post","status-publish","format-standard","hentry","category-soap"],"_links":{"self":[{"href":"https:\/\/codethataint.com\/blog\/wp-json\/wp\/v2\/posts\/2650","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/codethataint.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/codethataint.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/codethataint.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/codethataint.com\/blog\/wp-json\/wp\/v2\/comments?post=2650"}],"version-history":[{"count":5,"href":"https:\/\/codethataint.com\/blog\/wp-json\/wp\/v2\/posts\/2650\/revisions"}],"predecessor-version":[{"id":4169,"href":"https:\/\/codethataint.com\/blog\/wp-json\/wp\/v2\/posts\/2650\/revisions\/4169"}],"wp:attachment":[{"href":"https:\/\/codethataint.com\/blog\/wp-json\/wp\/v2\/media?parent=2650"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/codethataint.com\/blog\/wp-json\/wp\/v2\/categories?post=2650"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/codethataint.com\/blog\/wp-json\/wp\/v2\/tags?post=2650"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}