JAX-WS: differenze tra le versioni

Versione delle 21:01, 22 ago 2020

Versione delle 21:01, 22 ago 2020

Riga 1:

'''JAX-WS''' ('''Java API for XML Web Services''') è un insieme di interfacce ([[Application programming interface|API]]) del linguaggio di programmazione [[Java (linguaggio di programmazione)|Java]] dedicate allo sviluppo di [[Web service|servizi web]]. L'insieme fa parte della piattaforma [[Java EE]]. Come altre API della Java EE, JAX-WS usa [[Annotazione (Java)|annotazioni]], introdotte nella Java SE 5, per semplificare lo sviluppo e implementazioni di client e terminali di servizi web. JAX-WS fa parte del kit di sviluppo Java per Web service ([[Java Web Service Development Pack]] – JWSDP) e include [[Java Architecture for XML Binding]] (JAXB) e [[SOAP]].

Uno dei grandi vantaggi di questa implementazione è quella di poter riutilizzare gran parte delle funzionalità, senza toccare server enterprise come il progetto Glassfish.

==Descrizione==

JAX-WS è un nuovo modello di programmazione che semplifica lo sviluppo delle applicazioni attraverso il supporto di un modello standard, ''annotation-based'', per sviluppare Web service application e client. Le specifiche di JAX-WS si allineano strategicamente con la tendenza attuale del settore verso un modello di messaggistica più ''document-centric'' e sostituisce il modello di chiamata di procedura remota (''object-centric'' model) come definito da JAX-RPC.

Riga 120 ⟶ 123:

** operationName: specifica il nome di wsdl: operation per il metodo (nome del metodo)

* @SOAPBinding Specifica la mappatura del Web service nel protocollo di messaggi [[SOAP]]. In particolare si vede nel costrutto tra parentesi lo stile dei messaggi scelto. In caso i metodi del Web service utilizzino tipi semplici come String o int è possibile utilizzare l'annotazione “@SOAPBinding(style=Style.RPC)” come nel nostro esempio.

==Wsgen==

Il comando della riga comandi wsgen genera gli artefatti portatili usati nei servizi web JAX-WS. Questo strumento legge una classe endpoint di un servizio web e genera tutti gli artefatti richiesti per la generazione e invocazione del Web service. Wsgen genererà un file WSDL solo quando viene richiesto.

L'opzione -cp specifica dove trovare la classe di implementazione del servizio.

Questo tool genererà un certo numero di file sorgenti in una sottocartella chiamata wsgen, che poi compila. Sebbene non sia richiesto modificare questi file, è possibile vedere come il JAX-WS crei i file stub che usa nella pubblicazione del Web service cercando i loro codici sorgenti. I file originali devono trovarsi nel rispettivo package quando si chiama lo strumento Wsgen.

In caso contrario è possibile che si manifesti un errore che dice che la classe in cui è presente l'annotazione “@WebService”, come FunzioniCerchio, debba dichiarare separatamente javax.jws.Webservice.targetNamespace element perché i file dei codici sorgenti non fanno parte del package.

==JAX-WS handlers==