Best link to learn Spring Framework

Start with this link…..
http://www.tutorialspoint.com/spring/index.htm
------------------------------------------------------------------------------------------------------------------------------------

http://kruders.com/hibernate/
http://www.mkyong.com/tutorials/spring-tutorials/
http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/beans.html
http://www.java4s.com/spring/what-is-spring-framework/
http://www.tutorialspoint.com/spring/index.htm
http://www.roseindia.net/spring/spring3/spring-3-hello-world.shtml
http://www.dzone.com/tutorials/java/spring/spring-tutorial/spring-tutorial.html

Developing Soap web service using Spring-WS framework (top down approach)

Developing web services(Spring-WS) that start with the XML Schema/WSDL contract first followed by the Java code second. Spring-WS focuses on this development style.

The most important thing when doing contract-first Web service development is to try and think in terms of XML. This means that Java-language concepts are of lesser importance. It is the XML that is sent across the wire, and you should focus on that. The fact that Java is used to implement the Web service is an implementation detail. 

Step-1
Creating dogs.xsd:-

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.gps.co.in/dogs"
    xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" jaxb:version="2.0"
    xmlns:tns="http://www.gps.co.in/dogs" elementFormDefault="qualified">
    <!-- Customization of JAXB conversion -->
    <annotation>
        <appinfo>
            <jaxb:globalBindings>
                <jaxb:javaType name="java.util.Date" xmlType="date" />
            </jaxb:globalBindings>
        </appinfo>
    </annotation>

    <simpleType name="DogTitle">
        <restriction base="string">
            <enumeration value="Good" />
            <enumeration value="Bad" />
            <enumeration value="Dangrous" />
            <enumeration value="KKKK" />
        </restriction>
    </simpleType>

    <simpleType name="DogID">
        <restriction base="string">
            <length value="7" />
            <pattern value="D[0-9]{7}" />
        </restriction>
    </simpleType>

    <complexType name="dog">
        <sequence>
            <element name="did" type="tns:DogID" minOccurs="1" maxOccurs="1" />
            <element name="name" type="string" maxOccurs="1" minOccurs="1" />
            <element name="dtitle" type="tns:DogTitle" maxOccurs="1"
                minOccurs="1" />
            <element name="email" type="string" maxOccurs="1" minOccurs="0" />
            <element name="color" type="string" maxOccurs="1" minOccurs="1" />
            <element name="owner" type="string" maxOccurs="1" minOccurs="0" />
            <element name="address" type="string" />
            <element name="dob" type="date" maxOccurs="1" minOccurs="1" />
        </sequence>
    </complexType>

    <element name="AddDogRequest">
        <complexType>
            <sequence>
                <element name="idogs" type="tns:dog" maxOccurs="unbounded"
                    minOccurs="0" />
            </sequence>
        </complexType>
    </element>

    <element name="AddDogResponse">
        <complexType>
            <sequence>
                <element name="dresponse" type="string" />
            </sequence>
        </complexType>
    </element>

    <element name="updateDogRequest">
        <complexType>
            <sequence>
                <element name="udog" type="tns:dog" maxOccurs="1" minOccurs="1" />
            </sequence>
        </complexType>
    </element>

    <element name="updateDogResponse">
        <complexType>
            <sequence>
                <element name="uresponse" type="string" />
            </sequence>
        </complexType>
    </element>

    <!-- Creating black input means no parameter as per java -->
    <element name="findAllDogsRequest">
        <complexType>
            <sequence />
        </complexType>
    </element>

    <element name="findAllDogsResponse">
        <complexType>
            <sequence>
                <element name="rdogs" type="tns:dog" maxOccurs="unbounded"
                    minOccurs="0" />
            </sequence>
        </complexType>
    </element>


    <!-- Creating black input means no parameter as per java -->
    <element name="deleteDogByIdRequest">
        <complexType>
            <sequence>
                <element name="pdid" type="tns:DogID" nillable="false" />
            </sequence>
        </complexType>
    </element>

    <element name="deleteDogByIdResponse">
        <complexType>
            <sequence>
                <element name="drdog" type="string" />
            </sequence>
        </complexType>
    </element>

</schema> 



Step-2

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
    xmlns:sws="http://www.springframework.org/schema/web-services"
    xsi:schemaLocation="http://www.springframework.org/schema/beans  
    http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context.xsd
    http://www.springframework.org/schema/web-services                     
    http://www.springframework.org/schema/web-services/web-services-2.0.xsd">
    <!-- To generate dynamic wsdl This configuration is for WSDL generation
        as per the XSD -->

    <sws:dynamic-wsdl id="dogs" portTypeName="DogsService"
        locationUri="/dogsService" targetNamespace="http://www.gps.co.in/dogs"
        createSoap12Binding="true" serviceName="DogsServiceImpl">

        <sws:xsd location="/WEB-INF/schema/dogs.xsd" />


</sws:dynamic-wsdl>

</beans>    

id- represent the name of WSDL file i.e. wsdl file name would be = dogs.wsdl

DogsService= name of the interface


dogsService=location URL where web service would be published



Step-3 

Creating Web Service Endpoint

package com.spring.ws.endpoint;

import in.co.gps.dogs.AddDogRequest;
import in.co.gps.dogs.AddDogResponse;
import in.co.gps.dogs.Dog;
import in.co.gps.dogs.DogTitle;
import in.co.gps.dogs.FindAllDogsRequest;
import in.co.gps.dogs.FindAllDogsResponse;

import javax.annotation.PostConstruct;

import org.springframework.ws.server.endpoint.annotation.Endpoint;
import org.springframework.ws.server.endpoint.annotation.PayloadRoot;
import org.springframework.ws.server.endpoint.annotation.RequestPayload;
import org.springframework.ws.server.endpoint.annotation.ResponsePayload;

@Endpoint //marking this class as a web service endpoint
public class DogsEndpoint {
   

   @PayloadRoot(localPart = "AddDogRequest", namespace = "http://www.gps.co.in/dogs")
   @ResponsePayload
       public AddDogResponse  addDog(@RequestPayload AddDogRequest request) {
           AddDogResponse addDogResponse =new AddDogResponse();
           addDogResponse.setDresponse("I am fine here!!!");
           return addDogResponse;
       }
  
 @PayloadRoot(localPart = "findAllDogsRequest", namespace = "http://www.gps.co.in/dogs")
  @ResponsePayload
       public FindAllDogsResponse  findAllDogs(@RequestPayload FindAllDogsRequest request) {
           FindAllDogsResponse findAllDogsResponse =new FindAllDogsResponse();
           Dog dog1=new Dog();
           dog1.setDid("G8282");
           dog1.setName("D1");
           dog1.setColor("white");
           dog1.setDtitle(DogTitle.GOOD);
           findAllDogsResponse.getRdogs().add(dog1);
           return findAllDogsResponse;
       }

}


Step - 4

pom.xml
 
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>apache</groupId>
  <artifactId>spring-ws-it</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>spring-ws-it Maven Webapp</name>
  <url>http://maven.apache.org</url>
 <dependencies>
        <dependency>
            <groupId>javax.xml.bind</groupId>
            <artifactId>jaxb-api</artifactId>
            <version>2.0</version>
        </dependency>
        <dependency>
            <groupId>com.sun.xml.bind</groupId>
            <artifactId>jaxb-impl</artifactId>
            <version>2.0.3</version>
        </dependency>
        <dependency>
            <groupId>org.apache.xmlbeans</groupId>
            <artifactId>xmlbeans</artifactId>
            <version>2.4.0</version>
        </dependency>

        <dependency>
            <groupId>org.apache.ws.commons.schema</groupId>
            <artifactId>XmlSchema</artifactId>
            <version>1.4.4</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.8.1</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <scope>compile</scope>
            <version>1.2.16</version>
        </dependency>
        <!--  Spring ws specific dependency 
        -->
        <dependency>
            <groupId>org.springframework.ws</groupId>
            <artifactId>spring-ws-core</artifactId>
            <version>2.0.1.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-orm</artifactId>
            <version>3.0.5.RELEASE</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-orm</artifactId>
            <version>3.0.5.RELEASE</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>

        <!-- Hibernate dependency -->
        <dependency>
            <groupId>commons-digester</groupId>
            <artifactId>commons-digester</artifactId>
            <version>2.1</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>commons-collections</groupId>
            <artifactId>commons-collections</artifactId>
            <version>3.2.1</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-core</artifactId>
            <version>3.3.2.GA</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>javax.persistence</groupId>
            <artifactId>persistence-api</artifactId>
            <version>1.0</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>c3p0</groupId>
            <artifactId>c3p0</artifactId>
            <version>0.9.1.2</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.6.1</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
            <version>1.6.1</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>cglib</groupId>
            <artifactId>cglib-nodep</artifactId>
            <version>2.2</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-annotations</artifactId>
            <version>3.4.0.GA</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>jboss</groupId>
            <artifactId>javassist</artifactId>
            <version>3.7.ga</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.14</version>
            <type>jar</type>
            <scope>compile</scope>
        </dependency>
    </dependencies>
   
     <build>
    <finalName>spring-ws-it</finalName>
     <plugins>
         <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>jaxb2-maven-plugin</artifactId>
                <executions>
                    <execution>
                        <goals>
                            <goal>xjc</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <schemaDirectory>src/main/webapp/WEB-INF/schema</schemaDirectory>
                     <generatePackage>com.spring.ws.jaxb</generatePackage>
                    <generateDirectory>src/main/java</generateDirectory>
                </configuration>
            </plugin>
    
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.0.2</version>
                <configuration>
                    <source>1.6</source>
                    <target>1.6</target>
                </configuration>
            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                  <artifactId>maven-eclipse-plugin</artifactId>
                  <configuration>
                         <downloadSources>false</downloadSources> 
                   </configuration>     
             </plugin>
        </plugins>
  </build>
</project>




 
For the WSDL generation, the web.xml has to be modified as well, just add the init-param lines:



<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
         version="2.4">

    <display-name>Archetype Created Web Application</display-name>
   
     <context-param>
             <param-name>contextConfigLocation</param-name>
             <param-value>/WEB-INF/applicationContext.xml</param-value>
       </context-param>
      
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>


  <!-- Controller for Spring -WS web service -->
    <servlet>
        <servlet-name>spring-ws-vehicle</servlet-name>
        <servlet-class>org.springframework.ws.transport.http.MessageDispatcherServlet</servlet-class>
       
        <init-param>
           <param-name>contextConfigLocation</param-name>
           <param-value>/WEB-INF/spring-ws-vehicle-servlet.xml</param-value>
        </init-param>
         <init-param>
            <param-name>transformWsdlLocations</param-name>
            <param-value>true</param-value>
        </init-param>
  </servlet>

    <servlet-mapping>
        <servlet-name>spring-ws-vehicle</servlet-name>
        <url-pattern>/ws/*</url-pattern>
    </servlet-mapping>

</web-app>

 

Difference between XML Schema(XSD) and DTD

 

Web Security :=

#########

Email Content for reference purpose only

http://localhost:8090/JAX-TOP-DOWN/details?wsdl

Step-1 Creating Dynamic project and copying all the jar into lib folder.

Step-2 .

Creating WSDL (contract)

Step-3 . generating artifacts

Artifacts are java files which will be used to created Service Provider and Web Service Client.

Step-4 . Creating Service Provider

@WebService(name = "AccountDetailsService",

                       portName = "AccountDetailsPort",

                       endpointInterface = "com.mg.ws.AccountDetailsPortType",

                       wsdlLocation = "WEB-INF/wsdl/accounts.wsdl",

                       targetNamespace="http://gognamunish.com/accounts")

public class AccountDetailsServiceImpl implements AccountDetailsPortType {

          @Override

          public AccountDetailsTO getAccountDetails(GeAccountDetailsINTO parameters,

                             SecurityToken requestHeader) throws AccountDetailsFault_Exception {

                   AccountDetailsTO detailsTO = new AccountDetailsTO();

Step-5 .
Create an another required web service deployment descriptor(sun-jaxws.xml) under the WEB-INF folder.
This file is needed by the JAX-WS reference implementation(Service Provider) to map the service implementation class

 with the service interface.

<?xml version="1.0" encoding="UTF-8"?>

<endpoints

  xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime"

  version="2.0">

  <endpoint name="AccountDetailsServiceEndPoint"

            service ="{http://gognamunish.com/accounts}AccountDetailsService"

      port="{http://gognamunish.com/accounts}AccountDetailsPort"

      implementation="com.mg.ws.impl.AccountDetailsServiceImpl"

      url-pattern="/details"

      wsdl="WEB-INF/wsdl/accounts.wsdl"/>

</endpoints>

sun-jaxws.xml descriptor: Each endpoint definition, in this descriptor indicates the name of the web service, implementation class and the url-pattern

that routes to this web service invocation. This is read by the context listener and handed-over to the web service delegate created by it,

so that the delegate knows which implementation class to invoke when a web service request came-in.

Step-6

web.xml

<listener>

                   <listener-class>

                             com.sun.xml.ws.transport.http.servlet.WSServletContextListener

        </listener-class>

          </listener>

Note : above listener will read sun-jaxws.xml.

Step-7

The servlet definition and it’s mapping is used to intercept the url-pattern
that should be considered as web service request.

The class(com.sun.xml.ws.transport.http.servlet.WSServlet) acts as a dispatching servlet that routes the request to appropriate implementation class through the delegate received from the servlet context created by the listener as stated above.

web.xml

    <servlet>

                   <servlet-name>AccountDetailsService</servlet-name>

                   <servlet-class>

                             com.sun.xml.ws.transport.http.servlet.WSServlet

        </servlet-class>

                   <load-on-startup>1</load-on-startup>

          </servlet>

          <servlet-mapping>

                   <servlet-name>AccountDetailsService</servlet-name>

                   <url-pattern>/details</url-pattern>

          </servlet-mapping>

http://localhost:8090/JAX-TOP-DOWN/details?wsdl

Generating Client Program

wsimport http://localhost:8090/JAX-TOP-DOWN/details?wsdl  -p com.mg.ws -keep –Xnocompile

AccessDataClient.java

package com.mg.ws;

import java.util.Date;

import java.util.GregorianCalendar;

import javax.xml.datatype.DatatypeConfigurationException;

import javax.xml.datatype.DatatypeFactory;

import javax.xml.datatype.XMLGregorianCalendar;

public class AccessDataClient {

          public static void main(String[] args) {

                  

                   AccountDetailsService accountDetailsService=new AccountDetailsService();

                   AccountDetailsPortType accountDetailsPortType=accountDetailsService.getAccountDetailsPort();

                   GeAccountDetailsINTO parameters=new GeAccountDetailsINTO();

                   parameters.setAccountNo("23234234");

                   SecurityToken requestHeader=new SecurityToken();

                   requestHeader.setToken("83711070");

                  

                   Date date=new Date();

                   GregorianCalendar gc = new GregorianCalendar();

        gc.setTimeInMillis(date.getTime());

        DatatypeFactory df = null;

        try {

                             df = DatatypeFactory.newInstance();

                   } catch (DatatypeConfigurationException e1) {

                             e1.printStackTrace();

                    }

        XMLGregorianCalendar xgc= df.newXMLGregorianCalendar(gc);

                   requestHeader.setValidTill(xgc);

                   try {

                             AccountDetailsTO accountDetailsTO=accountDetailsPortType.getAccountDetails(parameters, requestHeader);

                             System.out.println(accountDetailsTO.getAccType());

                   } catch (AccountDetailsFault_Exception e) {

                             e.printStackTrace();

                   }

          }

}