1
Creazione e consumo di WS con NWDS – 1/2
http://desvino.altervista.org
Introduzione
In questo primo documento (1/2) affrontiamo la creazione, a partire da una semplice classe Java, di un
servizio Web, il suo depoly su un server J2EE ed il suo test di funzionamento sul Web Service Navigator. Nel
documento successivo (2/2) affronteremo la creazione di un client standalone ed il consumo del servizio
Web.
In generale lo scopo di tale attivitià è permettere all’utente di accedere a funzioni disponibili in EJB o classi
Java residenti su altri sistemi.
Creazione della classe Java
Dalla Java Perspective creiamo un nuovo progetto ProjServiceClass1. Al suo interno creiamo la classe
MyUserClass.
Creaiamo soltanto due metodi, main per testare la classe in locale e getUser() per restituire lo user come
stringa di testo.
it.videsoft.MyUserClass
2
Creazione e consumo di WS con NWDS – 1/2
http://desvino.altervista.org
Creazione del servizio Web
Per la creazione del servizio Web utilizziamo il WS Creation Wizard, in tal modo la visual interface, il Web
service definition, il servizio e il Web service configuration vengono creati automaticamente.
Creazione del servizio con il Wizard - step 1
Scegliamo come nome del servizio VdsUserService. L’Endpoint è la classe Java, mentre
UserServiceConfiguration come Configuration name.
utilizziamo
Creazione del servizio con il Wizard – step 2
Come Default configuration Type utilizziamo Simple SOAP (SOAP over HTTP, stateless
communication, no security). Consigliato per l’utilizzo del Web service su intranet aziendale.
3
Creazione e consumo di WS con NWDS – 1/2
Il metodo da esporre attraverso il servizio è getUser().
Creazione del servizio con il Wizard - step 3
Creazione del servizio con il Wizard - step 4
http://desvino.altervista.org
4
Creazione e consumo di WS con NWDS – 1/2
http://desvino.altervista.org
La virtual interface, la Web service definition, il Web service, e il Web service configuration vengono creati
automaticamente. Ecco come appare il progetto in Java Explorer della WS Perspective.
Ws Perspective – Java Explorer
In figura è visibile l’ear (enterprise archive – tasto destro sul nome del progetto -> BUILD EAR) da deployare
sul server.
Virtual Interface
Web Service Definition
5
Creazione e consumo di WS con NWDS – 1/2
http://desvino.altervista.org
Ecco come appare il progetto nella Java Perspective.
Java Perspective
ws-deployment-descriptior.xml
6
Creazione e consumo di WS con NWDS – 1/2
http://desvino.altervista.org
Test del servizio sul Web Services Navigator
Accediamo alla index.html del
http://<server>:<port>/index.html.
nostro
portale,
raggiungibile,
solitamente,
all’indirizzo
index.html
“Web Services Navigator is a tool that gives you a short overview of a specific Web service based on its
WSDL, and enables you to test your Web service by creating and sending a client request to the real end
point.”
Nella lista dei servizi Web selezioniamo il nostro VdsUserService deployato precedentemente.
Web Services disponibili
7
Creazione e consumo di WS con NWDS – 1/2
http://desvino.altervista.org
Cliccare sulla cartella oppure scegliere tra RPC, Document, RPC Encoded per aggiungere alla querystring
WDLS il relativo parametro, es. &style=RPC. Accediamo così alla pagina di overview del servizio Web.
Overview del servizio Web
Clicchiamo su “Test” in alto a destra e nella pagina successiva ccegliamo l’unico metodo disponibile per il
test, getUser().
8
Creazione e consumo di WS con NWDS – 1/2
http://desvino.altervista.org
Scelta del metodo da testare
Test getUser()
Avviamo la richiesta attraverso il tasto “Send”. Il metodo restiuisce correttamente la stringa “Vincenzo de
Stefano”.
Risultato del test.
