Exemple of Spring WS EndPoint using @XPathParam annotation

ReleveNotesEndpoint.java

package iaws.relevenotes.ws.contractfirst;

import iaws.relevenotes.domain.Evaluation;
import iaws.relevenotes.domain.nomenclature.AnneeScolaire;
import iaws.relevenotes.domain.nomenclature.Niveau;
import iaws.relevenotes.domain.nomenclature.Semestre;
import iaws.relevenotes.services.ReleveNoteService;
import org.springframework.ws.server.endpoint.annotation.*;
import org.w3c.dom.Element;


import java.util.List;

/**
 * @author franck Silvestre
 */
@Endpoint
public class ReleveNotesEndpoint {
    private ReleveNoteService releveNotesService;

    private static final String NAMESPACE_URI = "http://iaws/ws/contractfirst/exemple";

    public ReleveNotesEndpoint(ReleveNoteService releveNotesService) {
        this.releveNotesService = releveNotesService;
    }

    @PayloadRoot(namespace = NAMESPACE_URI, localPart = "ReleveNotesRequest")
    @Namespace(prefix="rn",uri=NAMESPACE_URI)
    @ResponsePayload
    public Element handleReleveNotesRequest(@XPathParam("/rn:ReleveNotesRequest/rn:annee_scolaire") String anneeScol,
                                            @XPathParam("/rn:ReleveNotesRequest/rn:niveau") String niveauCode,
                                            @XPathParam("/rn:ReleveNotesRequest/rn:semestre") Integer semestreId) throws Exception {

        // parse le XML de ReleveNotesRequest pour extraire les informations de
        // l'année scolaire, du niveau et du semestre  et creer les objets ad-hoc
        AnneeScolaire anneeScolaire = new AnneeScolaire(anneeScol);
        Niveau niveau = new Niveau(niveauCode);
        Semestre semestre = new Semestre(semestreId);


        // invoque le service "releveNoteService" pour récupérer les objets recherchés
        //
        List<Evaluation> evals = releveNotesService.findAllEvaluationsForAnneeScolaireNiveauAndSemestre(anneeScolaire, niveau, semestre);

        // Transforme en élément XML ad-hoc pour le retour
        //
        Element elt = XmlHelper.getRootElementFromFileInClasspath("ReleveNotes.xml") ;
        return  elt;

    }

}