•3/20/2016

Practical Session Structure

1. Introduction
2. Building a business component
3. Building an admin GUI
4. Introducing .NET remoting
Practical Lecture 5 5. Creating a web service and client
Creating a Web website
Service and Client 6. Developing a Java client
Website
2

Overview Learning Objectives

• In order to start this session, you need to • Understand the concepts involved in Web
have completed all of the practical lecture Services
4 • Create a web service that acts as a façade
• In this lecture we will take the business to an existing business component
component built in practical lecture 2 and • Implement an ASP.NET website that
add a web service façade to it. communicates with the web service
• We will then build a website that uses the
web service
3 4

Introduction What are we building?

• In this practical session we will:
– Add code to the PTSLibrary component to
expose some of its methods as a web service.
We will in fact create two web services, one
for a customer client application and one for a
team leader application
– Implement a website using ASP.NET that
uses the customer web service to allow a user
to log in and view project details

5 6

•1
 •3/20/2016

What are we building? Distributed Systems in .NET

• As mentioned in the previous lecture, web

services work across platforms, so can be
used to provide services to clients that are
not under your control and could be written
in any language that supports web
services

7 8

Web services Web Services

• A new breed of Web application • Distributed computing model based on
• Self-contained, self-describing, modular asynchronous messaging (XML)
applications that can be published, located, and – Support dynamic application integration over the Web
invoked across the Web – Web Services connect computers and devices with
each other using the Internet to exchange data and
• Perform functions: anything from simple access services
requests to complicated business processes
– On-the-fly software creation through the use of
• Once a Web service is deployed, other loosely coupled, reusable software components
applications (and other Web services) can – Business services can be distributed over the Internet
discover and invoke the deployed service
IBM web service tutorial
9 10

Designing Web Services Web Services Framework

• Requirements • Framework can be described in terms of

– Based on standards (e.g. HTTP, SOAP)
– What goes “on the wire”:
– Minimal amount of required infrastructure is
assumed Formats and protocols
• Only a minimal set of standards must be implemented
– Very low level of application integration is expected – What describes what goes on the wire:
• But may be increased in a flexible way Description languages
– Focuses on messages and documents, not on APIs
– What allows us to find these descriptions:
Discovery of services

11 12

•2
 •3/20/2016

Web Service Architecture. Components Service-oriented architecture

• Service providers : server
– publish available services and offer bindings for
services Service Provider
• Service brokers
– allow service providers to publish their services
– provide mechanisms to locate services and their
providers
Find
• Service requestor Service Broker UDDI
Service Requestor
Naming service client
– uses the service broker to find a service and then
– invokes (or binds) the service offered by a service
provider
13 14

Web Services Description Language

XML Messaging: SOAP WSDL
• SOAP 1.1 defined: • Defines services as collections of network
– An XML envelope for XML messaging, endpoints or ports
• Headers + body
– An HTTP binding for SOAP messaging.
• Provides functional description of network
• SOAP is “transport independent”. services:
– A convention for doing RPC. – IDL description
– An XML serialization format for structured data – Protocol and deployment details
• SOAP Attachments adds – Platform independent description.
– How to carry and reference data attachments using – Extensible language.
in a MIME envelope and a SOAP envelope.

15 16

Using WSDL UDDI Overview

1. As extended IDL: WSDL allows tools to generate • Universal Description Discovery and
compatible client and server stubs.

Tool support for top-down, bottom-up and “meet in the
Integration protocol
middle” development. • UDDI defines the operation of a service registry:
2. Allows industries to define standardized service – Data structures for registering
interfaces. • Businesses
3. Allows advertisement of service descriptions, enables • Technical specifications: tModel is a keyed reference to a
dynamic discovery and binding of compatible services. technical specification.

Used in conjunction with UDDI registry • Service and service endpoints: referencing the supported
tModels
4. Provides a normalized description of heterogeneous
applications. – SOAP Access API
– Rules for the operation of a global registry
• “private” UDDI nodes are likely to appear, though.
17 18

•3
 •3/20/2016

For more information Visual Studio Development Server

– SOAP • Visual Studio .NET 2005 comes with an in-built
http://www.w3c.org/TR/soap ASP.NET development server
– WSDL
• This is great for development as you can test
http://www.w3c.org/TR/wsdl
your web services and websites without having
– UDDI
http://www.uddi.org
to deploy to a web server
– WSFL • The web server starts automatically when you
http://www.ibm.com/software/webservices run a web service or website project
• The address is http://localhost:port
– Where port is a port number chosen by Visual Studio

19 20

Creating the Web Service Creating the Web Service /2

• We will create the web service as an ASP.NET Web
Service in the PTSLibrary solution
• Open Visual Studio 2005
• Open the PTSLibrary solution created in lecture 2
• Go to File -> Add -> New WebSite
• Select ASP.NET Web Service as the template, location
to File System and Visual C# as the language
• Name the project PTSWebService and save it in a
suitable location

21 22

Creating the Web Service /3 Web Service Skeleton Code

• Visual Studio will automatically • The following code is generated:
create a web service file Web Service related
(Service.asmx) namespaces are imported

• Rename this to
PTSCustomerWebService.asmx Inherits from
– This will be our web service to be WebService
used by the Customer browser
website
– The only functionality this needs to
Any method you want to make
offer is authentication and retrieval available through the web
of project details service needs to be marked as
a [WebMethod]
23 24

•4
 •3/20/2016

Run the Web Service Running the Web Service

• Right-click on the
Our [WebMethod]
PTSCustomerWebService
file and select View in
Browser
• This should start the
development server and
open a web browser
displaying the operations
supported by the web
service (see next slide)
25 26

Adding References Adding References /2

• As the web service just • Because the PTSLibrary project is in the same
provides a façade for access project, we can just select it from the Projects tab
to functionality in PTSLibrary,
this project needs to be
added as a reference
• Righ-click on the
PTSWebService project and
select Add Reference…

27 28

Accessing PTSLibrary Calling the Façade Methods

• Add the code to access the PTSCustomerFacade:
• The methods defined here will only act as a
level of indirection of the methods in the
PTSCustomerFacade class
Both methods will be available
to call on the web service

29 30

•5
 •3/20/2016

No-Argument Constructors Testing the Web Service

• Our business classes will be serialised and deserialised • Make sure the database server is running and the
by the web service database is available
• This process requires them to have no-argument
• Run the web service in a browser and invoke the
constructors
Authenticate and GetListOfProjects web methods
• Introduce empty no-argument constructors for the
business classes:
– Project
– Team
Notice how expected
– Task parameters are passed into
– Customer the web method
– TeamLeader

31 32

Testing the Web Service /2 Creating a Second Web Service

• When a web method is invoked, the message is • Now that you have seen how easy it is to
returned in XML (SOAP) create a web service, let’s create a second
Notice how containment web service, to be used by the Java
reveals the structure of a
returned object clients (the team leader’s application, that
we will build in the next session)
• The same two methods as for the
customer web service will be created
– The only difference is that the
GetListOfProjects takes the teamId as a
parameter, not the customerId
33 34

Creating a Second Web Service /2 Creating a Second Web Service /3

• Select the Web Service template and name it
• Right-click on the PTSWebService project PTSClientWebService
and select Add New Item…

35 36

•6
 •3/20/2016

Creating a Second Web Service /4 Creating a Second Web Service /5

• Add the code to access PTSClientFacade • Add the two web methods as shown here:

Remember, it’s
PTSClientFacade now, not
PTSCustomerFacade

37 38

Building the Customer Website Building the Customer Website /2

• Now we want to build a website that will
allow customers to log in and view the
details of the project(s) they commissioned
• The website will be built as an ASP.NET
Website project (still in the PTSLibrary
solution)
• Go to File -> Add -> New Website…
• Select the ASP.NET Web Site template
and name it CustomerWebSite
39 40

Adding a Web Reference Adding a Web Reference /2

• Click on Web services in this solution
• In order to access our newly created web
service from the website, it has to be
added as a web reference
• Righ-click on the CustomerWebSite
project in the solution explorer and select
Add Web Reference…

41 42

•7
 •3/20/2016

Adding a Web Reference /3 Adding a Web Reference /4

• Once the web service has been found, name the reference
• Select the PTSCustomerWebService: customerwebservice and click Add Reference

43 44

Source and Design Structure of an ASP.NET Web Form

• When we created the web site project, a • An ASP.NET web form actually consists of two
files:
default web form called Default.aspx was – XXX.aspx – this file contains HTML-like markup code,
created which is used to design the layout of the web form
(you can see the code when you are in Source view)
– Double-click on this file to open it
– XXX.aspx.cs – this is the C# code behind the
• You will notice that you can toggle XXX.aspx page. It contains the business logic driving
between Design and Source view the display laid out in the visual design surface and
mark-up.
– Code behind is a direct attempt to separate display
from business logic
45 46

Design of Default.aspx
• Change to Design view and add the
following controls: Design of Default.aspx /2
– 2 Labels saying Username and Password
– 2 TextBoxes (txtUsername, txtPassword)
– 1 Button (btnLogin), saying Login
– 1 Label (lblMessage) with text set to nothing
• Have a look at the next slide to see what it
should look like
47 48

•8
 •3/20/2016

Adding Code The btnLogin_Click Method

• Double-click on the btnLogin button
– This will take you to the code-behind file • This code is run when the user tries to
– Skeleton code for handling the event will login Call on the web service

automatically be generated
• Start by declaring an instance of the web
service class Saves id Successful
in session authentication redirects
the user to the
ProjectDetails.aspx page

49 50

Add ProjectDetails.aspx Web Form ProjectDetails.aspx

• Right-click on the CustomerWebSite project and
select Add New Item • On this web form we will display the name of
each of the customer’s projects. For each
project, we will list all tasks and display the
Select Web Form
task’s status
• To do this we will write a method that obtains all
this information, concatenates it as a string and
Name the file writes it on the page
ProjectDetails.aspx
• Right-click on ProjectDetails.aspx and choose
View Code, which will open the code-behind file
– Add the using directive
• using customerwebservice;
51 52

ProjectDetails.aspx /2 ProjectDetails.aspx /3
If the page is • Double-click on the ProjectDetails.aspx form and
accessed without
being logged in, change to Source view
redirect to login
page

List each project This is all the

code that needs
to be added. Just
List tasks for each a call to our
project method

Response.Write
writes to current
HTTP output 53 54

•9
 •3/20/2016

Testing the Customer Website Testing the Customer Website /2

• Right-click on ProjectDetails.aspx and select • If all goes well, you should see something like
View in Browser this:
• If everything goes well then you should be
redirected to Default.aspx
• Enter wrong login details and check that an error
message is displayed
• Then enter valid login details for a customer you
entered in the database
– Make sure that there is a project created for this
customer and that there are tasks created for the
project
55 56

Summary
• In this session we have looked at what
web services are and how they work
• We built two web services to be used by
the customer website and the Java client
• No-argument constructors were introduced
in the business classes of the PTSLibrary
• A customer website was created
• In the next session we will create a Java
client that uses the client web service
57

•10