javamission.com

JAX-WS Web Service :

JAX-WS web services are more powerful than JAX-RPC web services.JAX-WS web services have well defined security machanisum.In case of JAX-RPC web services the developer has to take care security aspects.

As we know Java EE 5 supports Anotations.Form Java EE 5 onwards we can use Annotations to define a web service.It is possible to define a web services in side its binding class itself.If we are using lower J2EE version than Java EE 5 we need to use WSDL as a separate XML document with wsdl as file extension.

In the bellow code sample I used Annotations to define my web service.Ofcorse I have also created WSDL for each of my Web Services.I used JAX-WS type web serviec.For the sake of simplicity i did' t use any security features.This web service performs credit history check up and generates credit score.

Important Point: My main intentions with this code sample is to explain how to use JAX-WS web service.So I am not going actual datails of how credit history is checked and credit score is evaluated like stuff.To put more light on technical aspects I used Random number generator to generate credit scores.

Source Code for Binding Class

package com.javamission.ws;

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;
import java.util.Random;

/**
 *
 * @author Murali
 */
@WebService()
public class CreditHistoryCheckupWS {

    /**
     * Web service operation
     */
    @WebMethod(operationName = "getCreditScore")
    public Integer operation(@WebParam(name = "firstName")
    String firstName, @WebParam(name = "middleName")
    String middleName, @WebParam(name = "lastName")
    String lastName, @WebParam(name = "ssn")
    String ssn, @WebParam(name = "driverseLicense")
    String driverseLicense) {
        Random dummyScore = new Random();
        /////////////////////////////////////////////////////////////
//    NOTE :  
//        To make the code sample simple I used 
//        random number generator to generate 
//        Some dummy Score                                                        
//        /////////////////////////////////////////////////////////////
        dummyScore.setSeed(100);
        
        if( dummyScore.nextInt()<= 100)
            return 100;
        else if( dummyScore.nextInt()<= 200)
            return 200;
        else if( dummyScore.nextInt()<= 300)
            return 300;
        else if( dummyScore.nextInt()<= 400)
            return 400;        
        else if( dummyScore.nextInt()<= 500)
            return 500;
        else if( dummyScore.nextInt()<= 600)
            return 600;
        else if( dummyScore.nextInt()<= 700)
            return 700;        
        else 
            return 800;        

    }

}

CreditHistoryCheckupWSService.wsdl

<!--
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.3.1-hudson-417-SNAPSHOT. -->
<definitions targetNamespace="http://ws.javamission.com/" name="CreditHistoryCheckupWSService" xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="http://ws.javamission.com/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
  <types>
    <xsd:schema>
      <xsd:import namespace="http://ws.javamission.com/" schemaLocation="CreditHistoryCheckupWSService_schema1.xsd"/>
    </xsd:schema>
  </types>
  <message name="getCreditScore">
    <part name="parameters" element="tns:getCreditScore"/>
  </message>
  <message name="getCreditScoreResponse">
    <part name="parameters" element="tns:getCreditScoreResponse"/>
  </message>
  <portType name="CreditHistoryCheckupWS">
    <operation name="getCreditScore">
      <input message="tns:getCreditScore"/>
      <output message="tns:getCreditScoreResponse"/>
    </operation>
  </portType>
  <binding name="CreditHistoryCheckupWSPortBinding" type="tns:CreditHistoryCheckupWS">
    <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
    <operation name="getCreditScore">
      <soap:operation soapAction=""/>
      <input>
        <soap:body use="literal"/>
      
      <output>
        <soap:body use="literal"/>
      </output>
    </operation>
  </binding>
  <service name="CreditHistoryCheckupWSService">
    <port name="CreditHistoryCheckupWSPort" binding="tns:CreditHistoryCheckupWSPortBinding">
      <soap:address location="REPLACE_WITH_ACTUAL_URL"/>
    </port>
  </service>
</definitions>


-->

For technical support please contact me at

murali@javamission.com