Scribd Logo
Upload

Welcome to Scribd!

  • 87 views

    Axis2-Services Clase 1

    Uploaded by

    cr1525
    Web services are a resource that - is accessed via HTTP (or HTTPS) - Returns XML (SOAP) Developed and taught by well-known author and developer. A Web service is a software system whose public interfaces and bindings are defined and described using XML.

    Copyright:

    Attribution Non-Commercial (BY-NC)
    Download as PDF, TXT or read online from Scribd

    Axis2-Services Clase 1

    Uploaded by

    cr1525
    87 views26 pages
    Web services are a resource that - is accessed via HTTP (or HTTPS) - Returns XML (SOAP) Developed and taught by well-known author and developer. A Web service is a software system whose public interfaces and bindings are defined and described using XML.

    Copyright

    © Attribution Non-Commercial (BY-NC)

    Available Formats

    PDF, TXT or read online from Scribd

    Did you find this document useful?

    Is this content inappropriate?

    Web services are a resource that - is accessed via HTTP (or HTTPS) - Returns XML (SOAP) Developed and taught by well-known author and developer. A Web service is a software system whose public interfaces and bindings are defined and described using XML.

    Copyright:

    Attribution Non-Commercial (BY-NC)
    Download as PDF, TXT or read online from Scribd
    Download as pdf or txt
    87 views26 pages

    Axis2-Services Clase 1

    Uploaded by

    cr1525
    Web services are a resource that - is accessed via HTTP (or HTTPS) - Returns XML (SOAP) Developed and taught by well-known author and developer. A Web service is a software system whose public interfaces and bindings are defined and described using XML.

    Copyright:

    Attribution Non-Commercial (BY-NC)
    Download as PDF, TXT or read online from Scribd
    Download as pdf or txt
    You are on page 1of 26

    2009 Marty Hall

    Building g Web Services S with Apache Axis2


    Part I: Java Java-First First (Bottom (Bottom-Up) Up) Services

    Customized Java EE Training: http://courses.coreservlets.com/


    Servlets, JSP, Struts, JSF/MyFaces/Facelets, Ajax, GWT, Spring, Hibernate/JPA, Java 5 & 6. Developed and taught by well-known author and developer. At public venues or onsite at your location.

    Agenda
    Overview of Web Services Installing Apache Axis2 Making Java-First (Bottom-Up) Web S Services i Deploying and testing your services

    2009 Marty Hall

    Overview of Web Services


    Customized Java EE Training: http://courses.coreservlets.com/
    Servlets, JSP, Struts, JSF/MyFaces/Facelets, Ajax, GWT, Spring, Hibernate/JPA, Java 5 & 6. Developed and taught by well-known author and developer. At public venues or onsite at your location.

    What are Web Services? (Short Answer)


    A Web Service is a resource that
    Is accessed via HTTP (or HTTPS) Returns XML (SOAP)

    What are Web Services? (Long Answer from W3C)


    A Web service is a software system
    identified by a URI whose public interfaces and bindings are defined and described using XML. XML Its definition can be discovered by other software systems.
    These systems may then interact with the Web service in a manner prescribed by its definition, using XML based messages conveyed by Internet protocols.

    Definition from http://www.w3.org/TR/wsa-reqs/#id2604831


    8

    Web Applications vs. Web Services


    Web Apps
    Return HTML Take GET or POST data as input Result intended for a human (via a browser) Informal (at best) description of data that resource accepts and result that resource returns Return XML (SOAP) Take XML (SOAP) as input Result intended for a program Formal definition of data that resource accepts and result that resource returns

    Web Services

    9

    Web Service Advantages


    Language neutrality
    W Web b Services S i define d fi the h message format, f not the h programming i language used A client does not know the language used by the service; a service i does d not t know k the th language l used d by b the th client li t

    Interoperability
    Definition of request q and response p data lets any y Web service interact with any other.

    Low barrier to entry


    Very simple tools for Java, Java Ruby, Ruby Microsoft languages, languages etc. etc Can write services without knowing WSDL or SOAP!

    Industry support
    V Very widely id l adopted. d d No N d danger of fi investing i in i short-lived h li d fad f d ala l Ada and CORBA.
    10

    Web Service Components


    SOAP
    XML-based XML b d structure used d to send d and d receive i messages Originally stood for Simple Object Access Protocol
    Misleading acronym dropped in SOAP version 1.2

    WSDL
    XML-based description of a Web service
    Where it resides What it can do How to invoke it

    Stands for Web Service Description Language

    UDDI
    XML-based registry g y to list and find Web Services Stands for Universal Description, Discovery and Integration
    11

    Apache Axis2
    Set of tools to simplify Web Services
    Services S i
    Create a Web service from any Java class Create Web service stubs from WSDL files Build B ild WAR file fil for f deployment d l t on any Java-based J b d server

    Clients
    Create client stubs from WSDL files

    Usage
    Eclipse plugins
    Integrated into Java EE version of Eclipse Download free from http://www.eclipse.org/downloads/
    Choose Eclipse IDE for Java EE Developers

    These tutorials will use Eclipse plugins

    Command-line tools
    Windows and Unix
    12

    Uses of Axis2
    Java-First (Bottom-Up) Services
    Start with a normal Java class (POJO) Expose methods as Web Services Covered in this lecture

    Clients from Java-First Java First Services


    Build client for service built with Java-first (bottom-up) approach Covered in second lecture

    WSDL-First WSDL First (Top (Top-Down) Down) Services


    Start with a WSDL file Create Java stubs automatically Add b business i logic l i Covered in third lecture

    Clients from WSDL-First Services


    Build B ild client li for f service i built b il with i h WSDL-first WSDL fi (top-down) ( d ) approach h Covered in fourth lecture
    13

    2009 Marty Hall

    Axis2 Setup
    Customized Java EE Training: http://courses.coreservlets.com/
    Servlets, JSP, Struts, JSF/MyFaces/Facelets, Ajax, GWT, Spring, Hibernate/JPA, Java 5 & 6. Developed and taught by well-known author and developer. At public venues or onsite at your location.

    Download and Install Axis2


    Download
    Start at http://ws.apache.org/axis2/download.cgi Choose latest version
    This tutorial uses 1 1.4 4

    Choose "zip" under Standard Binary Distribution i ib i

    Install
    Unzip into directory of your choice
    This tutorial uses C:\, resulting lti i in C C:\axis2-1.4 \ i 214
    15

    Tell Eclipse about Axis2


    Window Preferences Web Services A i 2P Axis2 Preferences f
    For Axis2 runtime location, enter location install path from previous slide Press Apply l Press OK

    16

    2009 Marty Hall

    Building a Java-First (Bottom-Up) ( p) Service


    Customized Java EE Training: http://courses.coreservlets.com/
    Servlets, JSP, Struts, JSF/MyFaces/Facelets, Ajax, GWT, Spring, Hibernate/JPA, Java 5 & 6. Developed and taught by well-known author and developer. At public venues or onsite at your location.

    Idea
    Take normal Java class (POJO)
    public class Blah { public int doFoo(String arg) { ... } public String doBar(double arg) { ... } }

    No special interfaces, parent classes, packages, or method names

    Automatically expose methods as Web Services


    Bl Blah h becomes b service i name doFoo and doBar accessible via HTTP and SOAP
    18

    Make Dynamic Web Project


    Make base project
    File New Project Web Dynamic Web Project
    Press Next

    Shortcut
    If you have previously made a Dynamic y Web Project in that workspace, you can just do New Dynamic Web Project

    19

    Add Axis2 Support to Dynamic Web Project


    Make custom config
    Enter a Project name Choose custom configuration Press Modify

    Add Axis2 facet


    Select checkbox for Axis2 Web Services Press OK Press Finish on Dynamic Web Project sc ee screen
    20

    Make Service Bean (Java Class with Regular Methods)


    Create normal Java class
    No special requirements for
    Package Interfaces Superclass Names of methods (need not be getBlah and setBlah)

    Public P blic methods will ill later become part of Web Service Ser ice
    Added automatically when you make bottom-up Web Service

    Lifecycle
    Class will be reinstantiated on each request
    So, So needs zero zero-argument argument constructor Fields are not persistent unless they are static
    21

    Service Bean: Example


    public class StockSymbolService { public String findCompany(String symbol) { if ((isEmpty(symbol))) { return("Missing stock symbol"); } String company = symbolMap.get(symbol.toUpperCase()); if (company != null) { return(company); ( p y); } else { return(String.format("Unknown symbol: %s.", symbol)); } } public void updateCompany(String symbol, String company) { symbolMap.put(symbol.toUpperCase(), company); }
    22

    Service Bean: Example (Continued)


    private static String[][] companies = { { "AAPL", "Apple Inc." }, { "IBM", "International Business Machines Corp." }, { "JAVA", "Sun Microsystems Inc." }, { "MSFT", "Microsoft Corp." }, Class instantiated (via zero-arg constructor) on every request. So, persistent data should be static. { "ORCL", "Oracle Corp." }, If data does not change, change making it static improves { "RHT", "Red Hat Inc." } performance. But in this case, updateCompany changes the data, so it would not work at all };
    if the Map was a non-static instance variable.

    private static Map<String,String> symbolMap = new HashMap<String,String>(); static { for(String[] g company: p y companies) p { symbolMap.put(company[0], company[1]); } } private boolean isEmpty(String val) { return((val == null) || val.trim().equals("")); }
    23

    Make Web Service from Service Bean


    Use bottom-up service
    R R-click click StockSymbolService.java StockSymbolService java New Other Web Services Web Service Press Next
    You can also select StockSymbolService.java and do File New Other Web Services Web Service

    Verify settings on Web Services wizard


    Bottom up service service.StockSymbolService as implementation class Apache Axis2 as service runtime

    Press Finish
    In future, you can deploy app normally (R-click (R click server server, Add and Remove Projects, select project, start server)
    24

    Verify Service is Deployed


    http://host/app-name/axis2-web/

    25

    Click Services. For your service, you should see a list of the public methods, now exposed as Web Service operations.

    Test Operations
    http://host/app-name/services/service-name/op-name?param=value

    26

    View WSDL
    http://host/app-name/ services/service-name service name ?wsdl
    You can also click on service name in the listServices page shown earlier

    Save this URL


    You will use it when you make a client (see next section)

    27

    Summary
    Make dynamic Web project
    File Fil New N Project P j t Web W b Dynamic D i W Web b Project P j t

    Add Axis2 support


    Choose custom configuration, press Modify Select checkbox for Axis2 Web Services

    Create normal Java class


    No special p requirements q

    Expose class as Web Service


    R-click Java class New Other Web Services Web Service

    Deploy
    R-click server, Add and Remove Projects, select project, start server

    Test
    http://host/app-name/axis2-web/
    28

    2009 Marty Hall

    Questions?
    Customized Java EE Training: http://courses.coreservlets.com/
    Servlets, JSP, Struts, JSF/MyFaces/Facelets, Ajax, GWT, Spring, Hibernate/JPA, Java 5 & 6. Developed and taught by well-known author and developer. At public venues or onsite at your location.

    You might also like