Web Services in.net (6) cont d

Transcription

1 Web Services in.net (6) cont d These slides are meant to be for teaching purposes only and only for the students that are registered in CSE3403 and should not be published as a book or in any form of commercial product, unless written permission is obtained. 1

2 WSDL and SOAP for Employee Web Service Once the web service is compiled, a description of this service is also created: the WSDL (Web Service Definition Language). 2

3 Can always access the WSDL by supplying the URL suffixed with?wsdl. 3

4 The complete WSDL for the Employee WS <?xml version="1.0" encoding="utf-8"?> - <definitions xmlns:http=" =" xmlns:soap=" =" xmlns:s=" =" xmlns:s0=" =" xmlns:soapenc=" =" xmlns:tm=" =" xmlns:mime=" =" targetnamespace=" =" xmlns=" =" - <types types> - <s:schema elementformdefault=" ="qualified qualified" targetnamespace=" =" - <s:element name=" ="MakeEmployee MakeEmployee"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="name name" type=" ="s:string s:string" /> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="salary salary" type=" ="s:double s:double" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> - <s:element name=" ="MakeEmployeeResponse MakeEmployeeResponse"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="MakeEmployeeResult MakeEmployeeResult" type=" ="s0:employee s0:employee" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> Employee type is the return type of method MakeEmployee. Needs to be further defined. Web method MakeEmployee. 4

5 - <s:complextype name=" ="Employee Employee"> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="Name Name" type=" ="s:string s:string" /> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="Salary Salary" type=" ="s:double s:double" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:schema s:schema> </types types> - <message name=" ="MakeEmployeeSoapIn MakeEmployeeSoapIn"> <part name=" ="parameters parameters" element=" ="s0:makeemployee s0:makeemployee" /> </message message> - <message name=" ="MakeEmployeeSoapOut MakeEmployeeSoapOut"> <part name=" ="parameters parameters" element=" ="s0:makeemployeeresponse s0:makeemployeeresponse" /> </message message> - <porttype name=" ="EmployeeServiceSoap EmployeeServiceSoap"> - <operation name=" ="MakeEmployee MakeEmployee"> <documentation documentation>creates creates and returns an Employee with the specified name and salary</ </documentation documentation> <input message=" ="s0:makeemployeesoapin s0:makeemployeesoapin" /> <output message=" ="s0:makeemployeesoapout s0:makeemployeesoapout" /> </operation operation> </porttype porttype> - <binding name=" ="EmployeeServiceSoap EmployeeServiceSoap" type=" ="s0:employeeservicesoap s0:employeeservicesoap"> <soap:binding transport=" =" style=" ="document document" /> - <operation name=" ="MakeEmployee MakeEmployee"> <soap:operation soapaction=" =" style=" ="document document" /> - <input input> <soap:body use=" ="literal literal" /> </input input> - <output output> <soap:body use=" ="literal literal" /> </output output> </operation operation> </binding binding> Definition of type Employee. 5...

6 / - <service name=" ="EmployeeService EmployeeService"> - <port name=" ="EmployeeServiceSoap EmployeeServiceSoap" binding=" ="s0:employeeservicesoap s0:employeeservicesoap"> <soap:address location=" =" /> </port port> </service service> </definitions definitions> 6

7 SOAP for Employee WS :: Consumer to WebService POST /WebService1WithUserDefinedClass/EmployeeService.asmx HTTP/1.1 Host: localhost Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: " <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <MakeEmployee xmlns=" <name> string</name> <salary> double</salary> </MakeEmployee MakeEmployee> </soap:body> </soap:envelope> 7

8 SOAP for Employee WS :: WebService to Consumer HTTP/ OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <MakeEmployeeResponse xmlns=" <MakeEmployeeResult> <Name> string </Name> <Salary> double </Salary> </MakeEmployeeResult> </MakeEmployeeResponse> </soap:body> </soap:envelope> 8

9 A web service that uses multiple classes Our previous web service (Employee) uses only one class Employee. It is realistic that a web service may involve more than one class. Employee Date Manager Web Service 9

10 Web service with many classes Code structure 10

11 Code structure :: Date 11

12 Code :: Date.cs using System; namespace WebService3ClassSubclass /// <summary> /// Summary description for Class1. /// </summary> public class Date private int year; private int month; private int day; public Date() : this( 1970, 1, 1 ) public Date( int year, int month, int day) this.year = year; this.month = month; this.day = day; 12

13 / public Date (Date adate) this.year = adate.year; this.month = adate.month; this.day = adate.day; public override string ToString() return "year = " + this.year + ", month = " + this.month + ", day = " + this.day ; public int Year get return year; set year = value; public int Month get return month; set month = value; public int Day get return day; set day = value; // end Date class 13

14 Code structure :: Employee 14

15 Code :: Employee.cs using System; namespace WebService3ClassSubclass /// <summary> /// /// </summary> public class Employee private string name ; private double salary; private Date dob; // date of birth // not handled by SOAP? public Employee() : this ("no name", 0, new Date (1970, 1, 1)) public Employee ( string name, double salary, Date dob) this.name = name; this.salary = salary; this.dob = new Date( dob); 15

16 public string Name get return name; set name = value; Code :: Employee.cs public double Salary get return salary; set salary = value; public Date DOB get set return dob; dob = value; public virtual void raise ( double percent ) salary = salary * (1 + percent/100); public override string ToString() return "name = " + this.name + ", salary = " + this.salary + ", DOB = " + this.dob.tostring(); // end class Employee 16

17 Code structure :: Manager 17

18 Code :: Manager.cs using System; namespace WebService3ClassSubclass /// <summary> /// /// </summary> public class Manager : Employee private double bonus; public Manager() : base() public Manager ( string name, double salary, Date dob, double bonus) : base ( name, salary, dob) this.bonus = bonus; public double Bonus get return this.bonus; set this.bonus = value; 18

19 Code :: Manager.cs public override void raise( double percent) base.raise(percent + bonus*.1); public override string ToString() return base.tostring() + ", bonus = " + this.bonus; //end Manager class 19

20 Code Structure :: Service1 Exposed web methods. 20

21 Code :: Service1.cs using System; using System.Collections; using System.ComponentModel; using System.Data; using System.Diagnostics; using System.Web; using System.Web.Services; namespace WebService3ClassSubclass /// <summary> /// Summary description for Service1. /// </summary> public class Service1 : System.Web.Services.WebService public Service1() //CODEGEN: This call is required by the ASP.NET Web Services Designer InitializeComponent(); 21

22 [ WebMethod (Description = "make Employee with specified name and salary") ] public Employee MakeEmployee ( string name, double salary, Date dob ) return new Employee ( name, salary, dob); [ WebMethod (Description="make Manager with specified name, salary, bonus") ] public Manager MakeManager ( string name, double salary, Date dob, double bonus ) return new Manager( name, salary, dob, bonus ); [ WebMethod (Description="return a string representation of the specified Employee") ] public string ToStringEmployee( Employee e) return e.tostring(); [ WebMethod (Description="return a string representation of the specified Manager") ] public string ToStringManager( Manager m) return m.tostring(); 22

23 [ WebMethod (Description = "Return a string rep of the specified Date") ] public string ToStringDate ( Date dd ) return dd.tostring(); [ WebMethod (Description = "Returns a Date with the specified year, month, day") d ] public Date MakeDate ( int year, int month, int day ) return new Date(year, month, day); [ WebMethod ( Description = "Raise salary of the specified Employee by the specified percentage.") ] public Employee RaiseEmployeeSalary( Employee ee, double percent) //ee.salary = ee.salary * ( 1 + percent/100); ee.raise( percent ); return ee; [ WebMethod ( Description = "Raise salary of the specified Manager by the specified percentage.") ] public Manager RaiseManagerSalary( Manager mm, double percent) mm.raise( percent ); return mm; 23

24 / #region Component Designer generated code //Required by the Web Services Designer private IContainer components = null; /// <summary> /// Required method for Designer support - do not modify /// the contents of this method with the code editor. /// </summary> private void InitializeComponent() /// <summary> /// Clean up any resources being used. /// </summary> protected override void Dispose( bool disposing ) if(disposing && components!= null) components.dispose(); base.dispose(disposing); #endregion 24

25 A windows app that uses the web service EmployeeManagerDate Pressing the buttons performs the indicated action (by calling a web method of the web service) and displays the outcome on the labels. 25

26 26

27 Web Services in.net (7) These slides are meant to be for teaching purposes only and only for the students that are registered in CSE3403 and should not be published as a book or in any form of commercial product, unless written permission is obtained. 27

28 Win app code structure The web service incorporated into our application. The win app Form. 28

29 The web service class Service1 and the supporting classes Date, Employee, Manager. 29

30 The properties exposed from the supporting classes. 30

31 The exposed WebMethods. 31

32 The code (Form1.cs) using System; using System.Drawing; using System.Collections; using System.ComponentModel; using System.Windows.Forms; using System.Data; namespace WindowsApplication1 /// <summary> /// Summary description for Form1. /// </summary> public class Form1 : System.Windows.Forms.Form private System.Windows.Forms.Button button1; private System.Windows.Forms.Button button2; private System.Windows.Forms.Label label1; private System.Windows.Forms.Label label2; private System.Windows.Forms.Button button3; private System.Windows.Forms.Label label3; private System.Windows.Forms.Button button4; private System.Windows.Forms.Label label4; /// <summary> /// Required designer variable. /// </summary> private System.ComponentModel.Container components = null; 32

33 public Form1() InitializeComponent(); protected override void Dispose( bool disposing ) if( disposing ) if (components!= null) components.dispose(); base.dispose( disposing ); // #region Windows Form Designer generated code private void InitializeComponent() #endregion /// <summary> /// The main entry point for the application. /// </summary> [STAThread] static void Main() Application.Run(new Form1()); 33

34 private EmployeeManagerDateService.Service1 myws ; private void button1_click(object sender, System.EventArgs e) myws = new EmployeeManagerDateService.Service1(); // EmployeeManagerDateService.Date dob = myws.makedate(1985,12, 23);// new EmployeeManagerDateService.Date(); /* alternatively call Date() and then do: dob.year = 1985; dob.month = 12; dob.day = 23; */ EmployeeManagerDateService.Employee ee = myws.makeemployee( "Joe Doe", 11111, myws.makedate(1985,12, 23)); label1.text = myws.tostringemployee( ee); /* alternatively... * label1.text = "Name = " + ee.name; label1.text += " Salary = " + ee.salary; label1.text += " DOB = " + myws.tostringdate( ee.dob); label1.text += " DOB year = " + ee.dob.year; label1.text += " month = " + ee.dob.month; label1.text += " day = " + ee.dob.day; */ 34

35 private void button2_click(object sender, System.EventArgs e) myws = new EmployeeManagerDateService.Service1(); EmployeeManagerDateService.Date dob = new EmployeeManagerDateService.Date(); dob.year = 1979; dob.month = 1; dob.day = 23; EmployeeManagerDateService.Manager mm = myws.makemanager( "Joe Doe II", 22222, dob, 500); label2.text = myws.tostringmanager( mm); /*alternatively... label2.text = "Name = " + mm.name + ", Salary = " + mm.salary + ", DOB.Year = " + mm.dob.year + ", DOB.Month = " + mm.dob.month + ", DOB.Day = " + mm.dob.day + ", Bonus = " + mm.bonus; */ 35

36 private void button3_click(object sender, System.EventArgs e) / myws = new EmployeeManagerDateService.Service1(); EmployeeManagerDateService.Employee ee = myws.makeemployee( "Joe Doe", 10000, myws.makedate(1985,12, 23)); label3.text = myws.tostringemployee( ee); // alternative... but not very good //ee.salary = ee.salary * ( /100); ee = myws.raiseemployeesalary( ee, 20); label3.text += "---- new :: " + myws.tostringemployee( ee); private void button4_click(object sender, System.EventArgs e) myws = new EmployeeManagerDateService.Service1(); EmployeeManagerDateService.Manager mm = myws.makemanager( "Joe Doe II", 20000, myws.makedate(1985,12, 23), 500); label4.text = myws.tostringmanager( mm); mm = myws.raisemanagersalary( mm, 20); label4.text += "---- new :: " + myws.tostringmanager( mm); 36

37 Reference.cs (the glue code) // // <autogenerated> // This code was generated by a tool. // Runtime Version: // // Changes to this file may cause incorrect behavior and will l be lost if // the code is regenerated. // </autogenerated> // // // This source code was auto-generated by Microsoft.VSDesigner, Version // namespace WindowsApplication1.EmployeeManagerDateService using System.Diagnostics; using System.Xml.Serialization; using System; using System.Web.Services.Protocols; using System.ComponentModel; using System.Web.Services; 37

38 /// <remarks/> [System.Diagnostics.DebuggerStepThroughAttribute()] [System.ComponentModel.DesignerCategoryAttribute("code")] [System.Web.Services.WebServiceBindingAttribute(Name="Service1Soap", e1soap", Namespace=" public class Service1 : System.Web.Services.Protocols.SoapHttpClientProtocol ientprotocol /// <remarks/> public Service1() this.url = " s/service1.asmx"; /// <remarks/> [System.Web.Services.Protocols.SoapDocumentMethodAttribute(" loyee", RequestNamespace=" ResponseNamespace=" Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)] Wrapped)] public Employee MakeEmployee(string name, System.Double salary, Date dob) object[] results = this.invoke("makeemployee", new object[] o name, salary, dob); return ((Employee)(results[0])); /// <remarks/> 38

39 public System.IAsyncResult BeginMakeEmployee(string name, System.Double salary, Date dob, System.AsyncCallback callback, object asyncstate) return this.begininvoke("makeemployee", new object[] name, salary, dob, callback, asyncstate); /// <remarks/> public Employee EndMakeEmployee(System.IAsyncResult asyncresult) object[] results = this.endinvoke(asyncresult); return ((Employee)(results[0])); /// <remarks/> [System.Web.Services.Protocols.SoapDocumentMethodAttribute(" ager", RequestNamespace=" ResponseNamespace=" Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)] Wrapped)] public Manager MakeManager(string name, System.Double salary, Date dob, System.Double bonus) object[] results = this.invoke("makemanager", new object[] name, salary, dob, bonus); return ((Manager)(results[0])); 39

40 /// <remarks/> public System.IAsyncResult BeginMakeManager(string name, System.Double salary, Date dob, System.Double bonus, System.AsyncCallback callback, object asyncstate) return this.begininvoke("makemanager", new object[] name, salary, dob, bonus, callback, asyncstate); /// <remarks/> public Manager EndMakeManager(System.IAsyncResult asyncresult) object[] results = this.endinvoke(asyncresult); return ((Manager)(results[0])); /// <remarks/> [System.Web.Services.Protocols.SoapDocumentMethodAttribute(" gemployee", RequestNamespace=" ResponseNamespace=" Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)] Wrapped)] public string ToStringEmployee(Employee e) object[] results = this.invoke("tostringemployee", new object[] e); return ((string)(results[0])); /// <remarks/> public System.IAsyncResult BeginToStringEmployee(Employee e, System.AsyncCallback callback, object asyncstate) return this.begininvoke("tostringemployee", new object[] e, callback, asyncstate); 40

41 /// <remarks/> public string EndToStringEmployee(System.IAsyncResult asyncresult) object[] results = this.endinvoke(asyncresult); return ((string)(results[0])); /// <remarks/> [System.Web.Services.Protocols.SoapDocumentMethodAttribute(" Manager", RequestNamespace=" ResponseNamespace=" Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)] Wrapped)] public string ToStringManager(Manager m) object[] results = this.invoke("tostringmanager", new object[] m); return ((string)(results[0])); /// <remarks/> public System.IAsyncResult BeginToStringManager(Manager m, System.AsyncCallback callback, object asyncstate) return this.begininvoke("tostringmanager", new object[] m, callback, asyncstate); /// <remarks/> public string EndToStringManager(System.IAsyncResult asyncresult) object[] results = this.endinvoke(asyncresult); return ((string)(results[0])); /// <remarks/> 41

42 [System.Web.Services.Protocols.SoapDocumentMethodAttribute(" ", RequestNamespace=" ResponseNamespace=" tp://tempuri.org/", Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)] Wrapped)] public string ToStringDate(Date dd) object[] results = this.invoke("tostringdate", new object[] dd); return ((string)(results[0])); /// <remarks/> public System.IAsyncResult BeginToStringDate(Date dd, System.AsyncCallback callback, object asyncstate) return this.begininvoke("tostringdate", new object[] dd, callback, asyncstate); /// <remarks/> public string EndToStringDate(System.IAsyncResult asyncresult) object[] results = this.endinvoke(asyncresult); return ((string)(results[0])); /// <remarks/> [System.Web.Services.Protocols.SoapDocumentMethodAttribute(" ", RequestNamespace=" ResponseNamespace=" tp://tempuri.org/", Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)] Wrapped)] public Date MakeDate(int year, int month, int day) object[] results = this.invoke("makedate", new object[] year, month, day); return ((Date)(results[0])); 42

43 /// <remarks/> public System.IAsyncResult BeginMakeDate(int year, int month, int day, System.AsyncCallback callback, object asyncstate) return this.begininvoke("makedate", new object[] year, month, day, callback, asyncstate); /// <remarks/> public Date EndMakeDate(System.IAsyncResult asyncresult) object[] results = this.endinvoke(asyncresult); return ((Date)(results[0])); /// <remarks/> [System.Web.Services.Protocols.SoapDocumentMethodAttribute(" loyeesalary", RequestNamespace=" ResponseNamespace=" Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)] Wrapped)] public Employee RaiseEmployeeSalary(Employee ee, System.Double percent) object[] results = this.invoke("raiseemployeesalary", new object[] ee, percent); return ((Employee)(results[0])); 43

44 /// <remarks/> public System.IAsyncResult BeginRaiseEmployeeSalary(Employee ee, System.Double percent, System.AsyncCallback callback, object asyncstate) return this.begininvoke("raiseemployeesalary", new object[] o ee, percent, callback, asyncstate); /// <remarks/> public Employee EndRaiseEmployeeSalary(System.IAsyncResult asyncresult) object[] results = this.endinvoke(asyncresult); return ((Employee)(results[0])); /// <remarks/> [System.Web.Services.Protocols.SoapDocumentMethodAttribute(" gersalary", RequestNamespace=" ResponseNamespace=" Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)] Wrapped)] public Manager RaiseManagerSalary(Manager mm, System.Double percent) object[] results = this.invoke("raisemanagersalary", new object[] mm, percent); return ((Manager)(results[0])); /// <remarks/> public System.IAsyncResult BeginRaiseManagerSalary(Manager mm, System.Double S percent, System.AsyncCallback callback, object asyncstate) return this.begininvoke("raisemanagersalary", new object[] mm, percent, callback, asyncstate); 44

45 public Manager EndRaiseManagerSalary(System.IAsyncResult asyncresult) sult) object[] results = this.endinvoke(asyncresult); return ((Manager)(results[0])); /// <remarks/> [System.Xml.Serialization.XmlTypeAttribute(Namespace=" /tempuri.org/")] public class Date /// <remarks/> public int Year; /// <remarks/> public int Month; /// <remarks/> public int Day; /// <remarks/> [System.Xml.Serialization.XmlTypeAttribute(Namespace=" /tempuri.org/")] [System.Xml.Serialization.XmlIncludeAttribute(typeof(Manager))] typeof(manager))] public class Employee /// <remarks/> public string Name; /// <remarks/> public System.Double Salary; /// <remarks/> public Date DOB; 45

46 / /// <remarks/> [System.Xml.Serialization.XmlTypeAttribut e(namespace=" public class Manager : Employee /// <remarks/> public System.Double Bonus; 46

47 WSDL MakeEmployee web method. <?xml version="1.0" encoding="utf-8"?> - <definitions xmlns:http=" =" xmlns:soap=" =" xmlns:s=" =" xmlns:s0=" =" xmlns:soapenc=" =" xmlns:tm=" =" xmlns:mime=" =" targetnamespace=" =" xmlns=" =" - <types types> - <s:schema elementformdefault=" ="qualified qualified" targetnamespace=" =" - <s:element name=" ="MakeEmployee MakeEmployee"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="name name" type=" ="s:string s:string" /> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="salary salary" type=" ="s:double s:double" /> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="dob dob" type=" ="s0:date s0:date" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> - <s:complextype name=" ="Date Date"> - <s:sequence s:sequence> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="Year Year" type=" ="s:int s:int" /> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="Month Month" type=" ="s:int s:int" /> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="Day Day" type=" ="s:int s:int" /> </s:sequence s:sequence> </s:complextype s:complextype> - Definition of class Date. 47

48 <s:element name=" ="MakeEmployeeResponse MakeEmployeeResponse"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="MakeEmployeeResult MakeEmployeeResult" type=" ="s0:employee s0:employee" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> - <s:complextype name=" ="Employee Employee"> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="Name Name" type=" ="s:string s:string" /> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="Salary Salary" type=" ="s:double s:double" /> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="DOB DOB" type=" ="s0:date s0:date" /> </s:sequence s:sequence> </s:complextype s:complextype> - <s:element name=" ="MakeManager MakeManager"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="name name" type=" ="s:string s:string" /> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="salary salary" type=" ="s:double s:double" /> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="dob dob" type=" ="s0:date s0:date" /> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="bonus bonus" type=" ="s:double s:double" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> - <s:element name=" ="MakeManagerResponse MakeManagerResponse"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="MakeManagerResult MakeManagerResult" type=" ="s0:manager s0:manager" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> MakeManager web method Definition of class Employee. 48

49 - <s:complextype name=" ="Manager Manager"> - <s:complexcontent mixed=" ="false false"> - <s:extension base=" ="s0:employee s0:employee"> - <s:sequence s:sequence> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="Bonus Bonus" type=" ="s:double s:double" /> </s:sequence s:sequence> </s:extension s:extension> </s:complexcontent s:complexcontent> </s:complextype s:complextype> - <s:element name=" ="ToStringEmployee ToStringEmployee"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="e" type=" ="s0:employee s0:employee" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> - <s:element name=" ="ToStringEmployeeResponse ToStringEmployeeResponse"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="ToStringEmployeeResult ToStringEmployeeResult" type=" ="s:string s:string" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> - <s:element name=" ="ToStringManager ToStringManager"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="m" type=" ="s0:manager s0:manager" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> Definition of class Manager as subclass of Employee. 49

50 - <s:element name=" ="ToStringManagerResponse ToStringManagerResponse"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="ToStringManagerResult ToStringManagerResult" type=" ="s:string s:string" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> - <s:element name=" ="ToStringDate ToStringDate"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="dd dd" type=" ="s0:date s0:date" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> - <s:element name=" ="ToStringDateResponse ToStringDateResponse"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="ToStringDateResult ToStringDateResult" type=" ="s:string s:string" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> - <s:element name=" ="MakeDate MakeDate"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="year year" type=" ="s:int s:int" /> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="month month" type=" ="s:int s:int" /> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="day day" type=" ="s:int s:int" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> 50

51 - <s:element name=" ="MakeDateResponse MakeDateResponse"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="MakeDateResult MakeDateResult" type=" ="s0:date s0:date" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> - <s:element name=" ="RaiseEmployeeSalary RaiseEmployeeSalary"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="ee ee" type=" ="s0:employee s0:employee" /> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="percent percent" type=" ="s:double s:double" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> - <s:element name=" ="RaiseEmployeeSalaryResponse RaiseEmployeeSalaryResponse"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="RaiseEmployeeSalaryResult RaiseEmployeeSalaryResult" type=" ="s0:employee s0:employee" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> - <s:element name=" ="RaiseManagerSalary RaiseManagerSalary"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="mm mm" type=" ="s0:manager s0:manager" /> <s:element minoccurs=" ="1" maxoccurs=" ="1" name=" ="percent percent" type=" ="s:double s:double" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> 51

52 - <s:element name=" ="RaiseManagerSalaryResponse RaiseManagerSalaryResponse"> - <s:complextype s:complextype> - <s:sequence s:sequence> <s:element minoccurs=" ="0" maxoccurs=" ="1" name=" ="RaiseManagerSalaryResult RaiseManagerSalaryResult" type=" ="s0:manager s0:manager" /> </s:sequence s:sequence> </s:complextype s:complextype> </s:element s:element> </s:schema s:schema> </types types> - <message name=" ="MakeEmployeeSoapIn MakeEmployeeSoapIn"> <part name=" ="parameters parameters" element=" ="s0:makeemployee s0:makeemployee" /> </message message> - <message name=" ="MakeEmployeeSoapOut MakeEmployeeSoapOut"> <part name=" ="parameters parameters" element=" ="s0:makeemployeeresponse s0:makeemployeeresponse" /> </message message> - <message name=" ="MakeManagerSoapIn MakeManagerSoapIn"> <part name=" ="parameters parameters" element=" ="s0:makemanager s0:makemanager" /> </message message> - <message name=" ="MakeManagerSoapOut MakeManagerSoapOut"> <part name=" ="parameters parameters" element=" ="s0:makemanagerresponse s0:makemanagerresponse" /> </message message> - <message name=" ="ToStringEmployeeSoapIn ToStringEmployeeSoapIn"> <part name=" ="parameters parameters" element=" ="s0:tostringemployee s0:tostringemployee" /> </message message> - <message name=" ="ToStringEmployeeSoapOut ToStringEmployeeSoapOut"> <part name=" ="parameters parameters" element=" ="s0:tostringemployeeresponse s0:tostringemployeeresponse" /> </message message> - <message name=" ="ToStringManagerSoapIn ToStringManagerSoapIn"> <part name=" ="parameters parameters" element=" ="s0:tostringmanager s0:tostringmanager" /> </message message> 52

53 - <message name=" ="ToStringManagerSoapOut ToStringManagerSoapOut"> <part name=" ="parameters parameters" element=" ="s0:tostringmanagerresponse s0:tostringmanagerresponse" /> </message message> - <message name=" ="ToStringDateSoapIn ToStringDateSoapIn"> <part name=" ="parameters parameters" element=" ="s0:tostringdate s0:tostringdate" /> </message message> - <message name=" ="ToStringDateSoapOut ToStringDateSoapOut"> <part name=" ="parameters parameters" element=" ="s0:tostringdateresponse s0:tostringdateresponse" /> </message message> - <message name=" ="MakeDateSoapIn MakeDateSoapIn"> <part name=" ="parameters parameters" element=" ="s0:makedate s0:makedate" /> </message message> - <message name=" ="MakeDateSoapOut MakeDateSoapOut"> <part name=" ="parameters parameters" element=" ="s0:makedateresponse s0:makedateresponse" /> </message message> - <message name=" ="RaiseEmployeeSalarySoapIn RaiseEmployeeSalarySoapIn"> <part name=" ="parameters parameters" element=" ="s0:raiseemployeesalary s0:raiseemployeesalary" /> </message message> - <message name=" ="RaiseEmployeeSalarySoapOut RaiseEmployeeSalarySoapOut"> <part name=" ="parameters parameters" element=" ="s0:raiseemployeesalaryresponse s0:raiseemployeesalaryresponse" /> </message message> - <message name=" ="RaiseManagerSalarySoapIn RaiseManagerSalarySoapIn"> <part name=" ="parameters parameters" element=" ="s0:raisemanagersalary s0:raisemanagersalary" /> </message message> - <message name=" ="RaiseManagerSalarySoapOut RaiseManagerSalarySoapOut"> <part name=" ="parameters parameters" element=" ="s0:raisemanagersalaryresponse s0:raisemanagersalaryresponse" /> </message message> - <porttype name=" ="Service1Soap Service1Soap"> - <operation name=" ="MakeEmployee MakeEmployee"> <documentation documentation>make make Employee with specified name and salary</ </documentation documentation> <input message=" ="s0:makeemployeesoapin s0:makeemployeesoapin" /> <output message=" ="s0:makeemployeesoapout s0:makeemployeesoapout" /> </operation operation> 53

54 - <operation name=" ="MakeManager MakeManager"> <documentation documentation>make make Manager with specified name, salary, bonus</ </documentation documentation> <input message=" ="s0:makemanagersoapin s0:makemanagersoapin" /> <output message=" ="s0:makemanagersoapout s0:makemanagersoapout" /> </operation operation> - <operation name=" ="ToStringEmployee ToStringEmployee"> <documentation documentation>return a string representation of the specified Employee</ </documentation documentation> <input message=" ="s0:tostringemployeesoapin s0:tostringemployeesoapin" /> <output message=" ="s0:tostringemployeesoapout s0:tostringemployeesoapout" /> </operation operation> - <operation name=" ="ToStringManager ToStringManager"> <documentation documentation>return a string representation of the specified Manager</ </documentation documentation> <input message=" ="s0:tostringmanagersoapin s0:tostringmanagersoapin" /> <output message=" ="s0:tostringmanagersoapout s0:tostringmanagersoapout" /> </operation operation> - <operation name=" ="ToStringDate ToStringDate"> <documentation documentation>return a string rep of the specified Date</ </documentation documentation> <input message=" ="s0:tostringdatesoapin s0:tostringdatesoapin" /> <output message=" ="s0:tostringdatesoapout s0:tostringdatesoapout" /> </operation operation> - <operation name=" ="MakeDate MakeDate"> <documentation documentation>returns a Date with the specified year, month, day</ </documentation documentation> <input message=" ="s0:makedatesoapin s0:makedatesoapin" /> <output message=" ="s0:makedatesoapout s0:makedatesoapout" /> </operation operation> - <operation name=" ="RaiseEmployeeSalary RaiseEmployeeSalary"> <documentation documentation>raise salary of the specified Employee by the specified percentage.</ </documentation documentation> <input message=" ="s0:raiseemployeesalarysoapin s0:raiseemployeesalarysoapin" /> <output message=" ="s0:raiseemployeesalarysoapout s0:raiseemployeesalarysoapout" /> </operation operation> 54

55 - <operation name=" ="RaiseManagerSalary RaiseManagerSalary"> <documentation documentation>raise salary of the specified Manager by the specified percentage.</ </documentation documentation> <input message=" ="s0:raisemanagersalarysoapin s0:raisemanagersalarysoapin" /> <output message=" ="s0:raisemanagersalarysoapout s0:raisemanagersalarysoapout" /> </operation operation> </porttype porttype> - <binding name=" ="Service1Soap Service1Soap" type=" ="s0:service1soap s0:service1soap"> <soap:binding transport=" =" style=" ="document document" /> - <operation name=" ="MakeEmployee MakeEmployee"> <soap:operation soapaction=" =" style=" ="document document" /> - <input input> <soap:body use=" ="literal literal" /> </input input> - <output output> <soap:body use=" ="literal literal" /> </output output> </operation operation> - <operation name=" ="MakeManager MakeManager"> <soap:operation soapaction=" =" style=" ="document document" /> - <input input> <soap:body use=" ="literal literal" /> </input input> - <output output> <soap:body use=" ="literal literal" /> </output output> </operation operation> 55

56 - <operation name=" ="ToStringEmployee ToStringEmployee"> <soap:operation soapaction=" =" style=" ="document document" /> - <input input> <soap:body use=" ="literal literal" /> </input input> - <output output> <soap:body use=" ="literal literal" /> </output output> </operation operation> - <operation name=" ="ToStringManager ToStringManager"> <soap:operation soapaction=" =" style=" ="document document" /> - <input input> <soap:body use=" ="literal literal" /> </input input> - <output output> <soap:body use=" ="literal literal" /> </output output> </operation operation> - <operation name=" ="ToStringDate ToStringDate"> <soap:operation soapaction=" =" style=" ="document document" /> - <input input> <soap:body use=" ="literal literal" /> </input input> - <output output> <soap:body use=" ="literal literal" /> </output output> </operation operation> 56

57 - <operation name=" ="MakeDate MakeDate"> <soap:operation soapaction=" =" style=" ="document document" /> - <input input> <soap:body use=" ="literal literal" /> </input input> - <output output> <soap:body use=" ="literal literal" /> </output output> </operation operation> - <operation name=" ="RaiseEmployeeSalary RaiseEmployeeSalary"> <soap:operation soapaction=" =" style=" ="document document" /> - <input input> <soap:body use=" ="literal literal" /> </input input> - <output output> <soap:body use=" ="literal literal" /> </output output> </operation operation> - <operation name=" ="RaiseManagerSalary RaiseManagerSalary"> <soap:operation soapaction=" =" style=" ="document document" /> - <input input> <soap:body use=" ="literal literal" /> </input input> - <output output> <soap:body use=" ="literal literal" /> </output output> </operation operation> </binding binding> 57

58 / - <service name=" ="Service1 Service1"> - <port name=" ="Service1Soap Service1Soap" binding=" ="s0:service1soap s0:service1soap"> <soap:address location=" =" /> </port port> </service service> </definitions definitions> 58

59 SOAPs there are two soap messages for each exposed method. SOAP Request this is the SOAP message from the consumer to the web service SOAP response this is the SOAP message from the web service to the consumer 59

60 SOAP :: MakeDate :: request (consumer to web service) POST /WebService3ClassSubclass/Service1.asmx HTTP/1.1 Host: localhost Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: " <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <MakeDate xmlns=" <year>int</year> <month>int</month> Consumer calls <day>int</day> MakeDate ( year, month, day) </MakeDate> </soap:body> </soap:envelope> 60

61 SOAP :: MakeDate :: response (web service to consumer) HTTP/ OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <MakeDateResponse xmlns=" <MakeDateResult> <Year>int</Year> <Month>int</Month> <Day>int</Day> </MakeDateResult> </MakeDateResponse> </soap:body> </soap:envelope> Web service responds with a Date object which is sent serialized as Year, Month, Day. 61

62 SOAP :: MakeEmployee :: request POST /WebService3ClassSubclass/Service1.asmx HTTP/1.1 Host: localhost Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: " <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <MakeEmployee xmlns=" <name>string</name> <salary>double</salary> Consumer calls <dob> MakeEmployee ( name, salary, <Year>int</Year> <Month>int</Month> dob). <Day>int</Day> dob is a Date and is </dob> serialized as Year, Month, </MakeEmployee> Day. </soap:body> </soap:envelope> 62

63 SOAP :: MakeEmployee :: response HTTP/ OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <MakeEmployeeResponse xmlns=" <MakeEmployeeResult> <Name>string</Name> <Salary>double</Salary> <DOB> <Year>int</Year> <Month>int</Month> <Day>int</Day> </DOB> </MakeEmployeeResult> </MakeEmployeeResponse> </soap:body> </soap:envelope> Web service responds with an Employee object which is sent serialized as Name, Salary, DOB (which is serialized as Year, Month, Day). 63

64 SOAP :: MakeManager :: request POST /WebService3ClassSubclass/Service1.asmx HTTP/1.1 Host: localhost Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: " <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <MakeManager xmlns=" <name>string</name> <salary>double</salary> <dob> <Year>int</Year> <Month>int</Month> <Day>int</Day> </dob> <bonus>double</bonus> </MakeManager> </soap:body> </soap:envelope> Consumer calls MakeManager(name, salary, dob, bonus). Dob is a Date object and is serialized to Year, Month, Day. 64

65 SOAP :: MakeManager :: response HTTP/ OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <MakeManagerResponse xmlns=" <MakeManagerResult> <Bonus>double</Bonus> </MakeManagerResult> </MakeManagerResponse> </soap:body> </soap:envelope> Notice that the response shows Bonus only. The Employee part of the Manager is also sent, but not shown in the SOAP! 65

66 SOAP :: ToStringEmployee :: request POST /WebService3ClassSubclass/Service1.asmx HTTP/1.1 Host: localhost Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: " <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <ToStringEmployee xmlns=" <e> <Name>string</Name> <Salary>double</Salary> <DOB> <Year>int</Year> <Month>int</Month> <Day>int</Day> </DOB> </e> </ToStringEmployee> </soap:body> </soap:envelope> Consumer calls ToStringEmployee( Name, Salary, DOB). DOB is serialized to Year, Month, Day. 66

67 SOAP :: ToStringEmployee :: response HTTP/ OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <ToStringEmployeeResponse xmlns=" <ToStringEmployeeResult>string</ToStringEmployeeResult> </ToStringEmployeeResponse> </soap:body> </soap:envelope> 67

68 SOAP :: ToStringDate :: request POST /WebService3ClassSubclass/Service1.asmx HTTP/1.1 Host: localhost Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: " <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <ToStringDate xmlns=" <dd> <Year>int</Year> <Month>int</Month> <Day>int</Day> </dd> </ToStringDate> </soap:body> </soap:envelope> Consumer calls ToStringDate( Year, Month, Day). 68

69 SOAP :: ToStringDate :: response HTTP/ OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <ToStringDateResponse xmlns=" <ToStringDateResult>string</ToStringDateResult> </ToStringDateResponse> </soap:body> </soap:envelope> 69

70 SOAP ToStringManager :: request POST /WebService3ClassSubclass/Service1.asmx HTTP/1.1 Host: localhost Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: " <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <ToStringManager xmlns=" <m> <Bonus>double</Bonus> </m> </ToStringManager> </soap:body> </soap:envelope> <m> is of type Manager (see WSDL). This allows the web service to understand the received SOAP. Consumer calls ToStringManager( ManagerObject) ManagerObject is [Employee, Bonus]. Only Bonus is shown in SOAP message! 70

71 SOAP ToStringManager :: response HTTP/ OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <ToStringManagerResponse xmlns=" <ToStringManagerResult>string</ToStringManagerResult> </ToStringManagerResponse> </soap:body> </soap:envelope> 71

72 SOAP :: RaiseManagerSalary :: request POST /WebService3ClassSubclass/Service1.asmx HTTP/1.1 Host: localhost Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: " <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <RaiseManagerSalary xmlns=" <mm> <Bonus>double</Bonus> </mm> <percent>double</percent> </RaiseManagerSalary> </soap:body> </soap:envelope> 72

73 SOAP :: RaiseManagerSalary :: response HTTP/ OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <RaiseManagerSalaryResponse xmlns=" <RaiseManagerSalaryResult> <Bonus>double</Bonus> </RaiseManagerSalaryResult> </RaiseManagerSalaryResponse> </soap:body> </soap:envelope> 73

74 SOAP :: RaiseEmployeeSalary :: request POST /WebService3ClassSubclass/Service1.asmx HTTP/1.1 Host: localhost Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: " <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <RaiseEmployeeSalary xmlns=" <ee> <Name>string</Name> <Salary>double</Salary> <DOB> <Year>int</Year> <Month>int</Month> <Day>int</Day> </DOB> </ee> <percent>double</percent> </RaiseEmployeeSalary> </soap:body> </soap:envelope> 74

75 SOAP :: RaiseEmployeeSalary :: HTTP/ OK Content-Type: text/xml; charset=utf-8 Content-Length: length response <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap=" <soap:body> <RaiseEmployeeSalaryResponse xmlns=" <RaiseEmployeeSalaryResult> <Name>string</Name> <Salary>double</Salary> <DOB> <Year>int</Year> <Month>int</Month> <Day>int</Day> </DOB> </RaiseEmployeeSalaryResult> </RaiseEmployeeSalaryResponse> </soap:body> </soap:envelope> 75

76 Web Services in.net (8) These slides are meant to be for teaching purposes only and only for the students that are registered in CSE3403 and should not be published as a book or in any form of commercial product, unless written permission is obtained. 76

77 Asynchronous web service method calls When using (consuming) a web service, and call its exposed methods, we can call them either Synchronously (), myws.add( a, b), Asynchronously (). ( a, b), for the Math service Use the BeginAdd() and EndAdd() alternatives that are provided by the glue code. (Reference.cs file). 77

78 The difference Synchronous call [ Add() ] The consumer is waiting (doing nothing) until method Add returns. easy to implement, not efficient usage of resources Asynchronous call [ BeginAdd() EndAdd() ] The consumer does not wait until method Add returns. ( and, therefore, the consumer can engage in other activities, e.g., call other methods in the mean time). The system creates a separate thread and assigns the call of the method Add to that thread. When method Add returns, the consumer is notified and it receives the result. harder to implement, more efficient usage of resources. 78

79 How it is done :: Synchronous Execution thread. int r = myws.add(7, 11); consumer myws.add( 7,11); Web Service <Idle.> Receive result 79

80 How it is done :: Asynchronous consumer myws.beginadd( a, b, new AsyncCallback( DoneAdd), null); Web Service private void DoneAdd(IAsyncResult ar) int r = myws.endadd(ar); Receive result Two separate execution threads! 80

81 Example After pressing the Add button Aftre pressing the Minus button 81

82 Code structure Use Add() for synchronous calls. Use BeginAdd(), EndAdd() pair for Asynchrono us calls. 82

83 The glue code (Reference.cs) [System.Web.Services.Protocols.SoapDocumentMethodAttribute(" p://tempuri.org/add", RequestNamespace=" ResponseNamespace=" Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)] Wrapped)] public int Add(int a, int b) object[] results = this.invoke("add", new object[] a, b); return ((int)(results[0])); public System.IAsyncResult BeginAdd (int a, int b, System.AsyncCallback callback, object asyncstate) return this.begininvoke("add", new object[] a, b, callback, asyncstate); /// <remarks/> public int EndAdd( System.IAsyncResult asyncresult) object[] results = this.endinvoke(asyncresult); return ((int)(results[0])); Notice, Add and EndAdd are the only two with the compatible (desired) return type! When use asynchronous calls, EndAdd is the one that actually performs the addition. Notice, the return type of BeginAdd is the required parameter type of EndAdd. 83

84 The code (Form1.cs) using System; using System.Drawing; using System.Collections; using System.ComponentModel; using System.Windows.Forms; using System.Data; namespace WindowsApplication2UseMathAsynch public class Form1 : System.Windows.Forms.Form private System.Windows.Forms.TextBox textbox1; private System.Windows.Forms.Button button1; private System.Windows.Forms.TextBox textbox2; private System.Windows.Forms.TextBox textbox3; private System.Windows.Forms.Label label1; private System.Windows.Forms.Label label2; private System.Windows.Forms.Label label3; private System.Windows.Forms.Label label4; private System.Windows.Forms.Label label5; private System.Windows.Forms.Button button2; /// <summary> /// Required designer variable. /// </summary> private System.ComponentModel.Container components = null; 84

85 // [STAThread] static void Main() Application.Run(new Form1()); private MathService.MathService myws; private void button1_click(object sender, System.EventArgs e) myws = new MathService.MathService(); int a = Int32.Parse( textbox1.text); int b = Int32.Parse( textbox2.text); myws.beginadd( a, b, new AsyncCallback( DoneAdd), null); private void DoneAdd(IAsyncResult ar ) int result = myws.endadd(ar); textbox3.text = "" + result; label4.text = "Done Add!"; new AsyncCallback() needs as parameter a method that returns void and has IAsyncResult parameter. The programmer defined method DoneAdd is crafted to be so. In fact, this is especially convenient, since DoneAdd() calls EndAdd(), and EndAdd() needs an IAsyncResult type parameter! [ indirect threading ]. 85

86 private void button2_click(object sender, System.EventArgs e) myws = new MathService.MathService(); int a = Int32.Parse( textbox1.text); int b = Int32.Parse( textbox2.text); int result = myws.endminus( textbox3.text = "" + result; / myws.endminus(myws.beginminus( myws.beginminus( a, b, new AsyncCallback( DoneMinus ), null) ); private void DoneMinus(IAsyncResult ar ) label5.text = "Done Minus!"; An alternative way to call EndMinus(). [ direct threading ]. BeginMinus() returns type compatible with the expected parameter type of EndMinus. Method DoneMinus() does not do anything but it is required since new AsyncCallback() needs a method (returning void and with parameter type IAsyncResult) as a parameter. 86

87 UDDI UDDI: Universal Description, Discovery and Integration. A standard (uddi.xml.org) [ previously ] for organizing/cataloging Web Services. UDDI is commonly regarded as a cornerstone of Web services, defining a standard method for publishing and discovering network-based software components in a service-oriented architecture (from the UDDI standard). 87

88 Purpose of UDDI UDDI is a project to speed interoperability and adoption for web services. "As the adoption of Web services by businesses worldwide continues to grow, it's becoming more important to effectively provide reliable and standardsbased discovery of these services. Along with advances in the standards for management and security of Web services, these latest enhancements to UDDI will help enterprises address these challenges and will, therefore, promote broader adoption of Web services and drive development of business solutions that take advantage of interoperability between multiple Web services," (Toby J Weiss, Senior Vice President of etrust Product Management at Computer Associates.) 88

89 89

90 What Problems Are Solved? Broader B2B Smarter Search Easier Aggregation A mid-sized manufacturer needs to create 400 online relationships with customers, each with their own set of standard and protocols A flower shop in Australia wants to be plugged in to every marketplace in the world, but doesn t know how A B2B marketplace wants catalog data for relevant suppliers in its industry, along with connections to shippers, insurers, etc. Describe Services Discover Services Integrate Them Together 90

91 How UDDI Works SW companies, standards bodies, and programmers populate the registry with descriptions of different types of services UDDI Business Registry 4. Marketplaces, search engines, and business apps query the registry to discover services at other companies Businesses populate the registry with descriptions of the services they support 3. Business Registrations Service Type Registrations UBR assigns a programmatically unique identifier to each service and business registration 5. Business uses this data to facilitate easier integration with each other over the Web 91

92 UDDI as part of the big picture 92