NF1 - Web Services
Contingut
Què són els Serveis Web?
https://statickidz.com/proyectos/traductor-google-api-php-gratis/
https://jnjsite.com/symfony-como-montar-una-api-rest-de-tu-plataforma-completa-en-menos-de-1-hora/
Els serveis web són aplicacions client i servidor que es comuniquen sobre (WWW) Protocol de transferència d'hipertext de la World Wide Web (HTTP). Segons el descrit pel World Wide Web Consortium (W3C), serveis web proporcionen un mitjà estàndard d'interoperabilitat entre aplicacions de programari que s'executen en una varietat de plataformes i marcs. Els serveis web es caracteritzen per la seva gran interoperabilitat i extensibilitat, així com les seves descripcions processable per màquina, gràcies a la utilització de XML. Els serveis web es poden combinar d'una manera precisa per aconseguir operacions complexes.
Tipus de Serveis Web
En el pla conceptual, un servei és un component de programari que es proporciona de la xarxa.
A nivell tècnic, els serveis web es poden implementar de diverses maneres. Els dos tipus de serveis web analitzats en aquesta secció es poden distingir com a Big Web Services i serveis web RESTful.
Big Web Services En Java EE 6, JAX-WS proporciona la funcionalitat de Big Web Services. Serveis web Grans utilitzen missatges XML que segueixen el protocol d'accés a objectes estàndard (SOAP), un llenguatge XML que defineix una arquitectura de missatges i formats de missatges. Aquests sistemes sovint contenen una descripció llegible per les màquines de les operacions que ofereix el servei, escrit en la Web Services Description Language (WSDL), un llenguatge XML per a definir sintàcticament interfícies.
El format del missatge SOAP i WSDL llenguatge de definició d'interfície han guanyat l'adopció generalitzada. Moltes de les eines de desenvolupament, com NetBeans IDE, poden reduir la complexitat del desenvolupament d'aplicacions de serveis web.
Serveis Web REST En Java EE 6, JAX-RS proporciona la funcionalitat per a la Transferència d'estat representacional (REST Web Services). REST és molt adequat per a escenaris bàsics. Serveis web RESTful sovint estan millor integrats amb HTTP que els serveis basats en SOAP ja que no requereixen de missatges XML o definicions servei API WSDL.
Projecte Jersey és la implementació de referència de l'especificació JAX-RS. Jersei implementa suport per a les anotacions definides en l'especificació JAX-RS, el que facilita als desenvolupadors crear serveis web RESTful amb Java i la màquina virtual de Java (JVM).
SOAP Web Services
Simple Object Access Protocol (SOAP)és un protocol estàndard per l'intercanvi de missatges XML. La comunicació entre el client i el servei succeeix utilitzant missatges XML.
Què és el WSDL?
WSDL: Web Service Description Language. És un arxiu XML que descriu els detalls tècnics de com s'implementa un servei web, més específicament la URI, port, nom dels mètodes, els paràmetres i els tipus de dades. Llegint el WSDL poden veure:
- Ports / EndPoint - URL del servei web
- Format del missatge d'entrada
- Format del missatge de sortida
- Protocol de seguretat que s'ha de seguir
- El protocol de servei web utilitzat
Exemple:
<?xml version='1.0' encoding='UTF-8'?><!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.2-hudson-740-. --><!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.2-hudson-740-. --><definitions xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://ws/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://ws/" name="Hola">
<wsp:Policy wsu:Id="HolaPortBindingPolicy" />
<types>
<xsd:schema>
<xsd:import namespace="http://ws/" schemaLocation="http://localhost:8084/webServiceProject/Hola?xsd=1" />
</xsd:schema>
</types>
<message name="hello">
<part name="parameters" element="tns:hello" />
</message>
<message name="helloResponse">
<part name="parameters" element="tns:helloResponse" />
</message>
<message name="adeu">
<part name="parameters" element="tns:adeu" />
</message>
<message name="adeuResponse">
<part name="parameters" element="tns:adeuResponse" />
</message>
<portType name="Hola">
<operation name="hello">
<input wsam:Action="http://ws/Hola/helloRequest" message="tns:hello" />
<output wsam:Action="http://ws/Hola/helloResponse" message="tns:helloResponse" />
</operation>
<operation name="adeu">
<input wsam:Action="http://ws/Hola/adeuRequest" message="tns:adeu" />
<output wsam:Action="http://ws/Hola/adeuResponse" message="tns:adeuResponse" />
</operation>
</portType>
<binding name="HolaPortBinding" type="tns:Hola">
<wsp:PolicyReference URI="#HolaPortBindingPolicy" />
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document" />
<operation name="hello">
<soap:operation soapAction="" />
<input>
<soap:body use="literal" />
</input>
<output>
<soap:body use="literal" />
</output>
</operation>
<operation name="adeu">
<soap:operation soapAction="" />
<input>
<soap:body use="literal" />
</input>
<output>
<soap:body use="literal" />
</output>
</operation>
</binding>
<service name="Hola">
<port name="HolaPort" binding="tns:HolaPortBinding">
<soap:address location="http://localhost:8084/webServiceProject/Hola" />
</port>
</service>
</definitions>
Existeixen dues maneres per accedir a un servei web:
- 'El proveïdor de serveis web coneix al client:El proveïdor de serveis web proporcionarà el WSDL al client i el client podrà accedir als serveis web.
- El proveïdor de serveis registri la WSDL com a UDDI. UUID (Universal Description, Discover and Integration). Els WSDL es poden convertir a un UDDI i així, poden estar disponibles mitjançant un directori de serveis per a la seva utilització.
Creació d'un Servei Web amb Netbeans
Per crear un servei web soap (wsdl) es poden seguir els següents passos:
- Creació d'un projecte nou de tipus Web Application
- Seleccionar el servidor apache Tomcat
- Una vegada creat el projecte, crear un nou servei web
- Introduïr les dades del servei web (nom, package,...)
- Utilitzar la implementació METRO per la creació del WS
- Implementar el servei web. Es pot fer mitjançant codi únicament:
- o bé, podem fer servir l'eina gràfica per crear nous serveis i modificar els paràmetres dels serveis creats
- Compila i desplega el servei
- Accedeix al wsdl del servei web
Creació d'un client JAVA per fer servir un WebService
Es farà una implementació d'un servei web client utilitzant JAVA SWING. Segueix aquests passos:
- Crea un nou projecte de tipus Java Application.
- Crea un formulari SWING per afegir els camps elements necessaris (buttons, labels, text fields, etc)
- Una vegada tinguis el formulari, afegeix la funcionalitat de web-service client
- Omple el camp wsdl a l'hora de configurar el client. Deixa en blanc el camp package:
- Una vegada generat, ja es pot utilitzar el client del WS des del formulari Swing. Per tal d'utilitzar-lo, genera el codi necessari insertant-lo des del netbeans:
- Podem veure el codi generat. Él nom de la funció generada correspon al nom del servei web:
- Ja podem utilitzar la crida al servei web associant-la al click d'un botó. El resultat de la execució del servei web es mostrarà en un Dialog.
- Resultat de l'execució:
Accedir a un servei Web des de un client php
Per accedir a un servei web, és molt fàcil, només s'ha de donar el WSDL a la classe SoapClient de PHP. L'objecte generat conté tots els serveis webs que estan implementat en el WSDL. Per passar els paràmetres, es fa servir un Array associatiu on la clau és el nom del paràmetre configurat en el WS i el valor és el que es vol enviar al servei web. Exemple:
$client = new SoapClient("http://192.168.56.1:8084/webServiceProject/Hola?wsdl");
$result = $client->hello(array("name"=>"alex"));
echo $result->return;
Per accedir al resultat del WebService, hem de veure en el WSDL el nom del camp corresponent al resultat del WS i així podrem accedir al valor.
Es pot crear un formulari amb php i en el controlador, fer la crida al servei Web corresponent.
Resultat execució codi anterior (Es recorda que es necessari una màquina virtual amb php + apache2):
WebService
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpFoundation\JsonResponse;
.....
class ApiController extends Controller
{
/**
* @Route("/api/listarTodos", methods={"GET"})
*/
public function listarTodosAction()
{
$repositorio = $this->getDoctrine()->getRepository('AppBundle:Producto');
$datos=$repositorio->findAll();
$almacenar= array();
foreach ($datos as $key => $value) {
$temporal=array();
$temporal['id']=$value->getId();
$temporal['nombre']=$value->getNombre();
$temporal['cantidad']=$value->getCantidad();
$temporal['fecha']=$value->getFecha();
$almacenar[]=$temporal;
}
// print_r($datos);
$response = new JsonResponse($almacenar);
return $response;
// return new Response("Usuario Registrado");
}
/**
* @Route("/api/listarProductos/{id}", methods={"GET"})
*/
public function listarProductosAction($id)
{
return new Response("Usuario Registrado");
}
/**
* @Route("/api/insertarProductos/{nombre}/{cantidad}/{fecha}", methods={"POST"})
*/
public function insertarProductosAction($nombre="",$cantidad="",$fecha="")
{
if(strlen($nombre)>0){
$producto= new Producto();
$producto->setNombre($nombre);
$producto->setCantidad($cantidad);
$producto->setFecha($fecha);
$em = $this->getDoctrine()->getManager();
$em->persist($producto);
$em->flush();
$categoriasArray=array();
$categoriasArray['id']=$producto->getId();
$categoriasArray['Nombre']=$producto->getNombre();
$categoriasArray['cantidad']=$producto->getCantidad();
$categoriasArray['fecha']=$producto->getFecha();
$almacenar[]=$categoriasArray;
$response = new JsonResponse($almacenar);
return $response;
}
throw new BadRequestHttpException("Falta nombre",null, 400);
}
https://symfony.com/doc/3.4/components/http_foundation.html#creating-a-json-response https://symfony.com/doc/3.4/routing/requirements.html
https://www.youtube.com/watch?v=BeY1bQzMeAk
Exercici Web Service SOAP
- Crea un servei web que permeti Sumar, Restar, Multiplicar i Dividir.
- Busca un servei web a internet que utilitzi SOAP.
- Crea un servei web que façi dos consultes a una base de dades que tingui informació.
- Crea una aplicació client en Swing que utilitzi el servei web anterior
- Crea una aplicació client en PHP que també utilitzi aquest servei.
Webgrafia
- NetBeans soap: https://netbeans.org/kb/docs/websvc/jax-ws.html
- JAX-WS http://docs.oracle.com/javaee/6/tutorial/doc/bnayl.html
- JAX-RS http://docs.oracle.com/javaee/6/tutorial/doc/giepu.html
- http://www.java2blog.com/2013/03/soap-web-service-tutorial.html
http://frikibloggeo.blogspot.com/2017/01/crear-un-web-service-api-rest-con-php-y.html