Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Descripcion Servicios Web PM
Descripcion Servicios Web PM
Febrero 2011
Descripción de los Servicios Web de Portal Mayores
0. INTRODUCCIÓN
El presente documento constituye la descripción técnica de los Servicios Web de Portal Mayores, cuya
finalidad es promover el acceso a la información sobre Gerontología y Geriatría de Portal Mayores. La
documentación contiene la descripción funcional y de interface, detallando los parámetros de entrada y
salida de cada una de las funciones. El conocimiento de estas funciones y su interface permite integrar
en terceras aplicaciones funcionalidades de consulta de nuestras bases de datos a través de Internet.
El término WebServices o Servicios Web engloba una serie de tecnologías que permiten el diálogo
de unos sistemas con otros utilizando los propios recursos de comunicación que ofrece Internet. Los
WebServices son uno de los ejemplos recientes de lo que ha dado en denominarse arquitecturas orien-
tadas a servicios, y constituyen uno de los pilares de la Web 2.0, para conseguir que no sólo los datos
sino también muchos tipos de operaciones puedan procesarse de forma distribuida, promoviendo así una
mayor participación y transparencia en la creación de contenidos por parte de usuarios y desarrolladores.
Algunas de las especificaciones públicas más utilizadas para implementar WebServices son CORBA,
XML-RPC, SOAP y, más recientemente, REST. Portal Mayores ofrece su WebService en SOAP 1.1.
3|
2|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
http://portalmayores.es/service/pmRecWS.wsdl
http://portalmayores.es/service/pmBiblioWS.wsdl
http://portalmayores.es/service/pmEvenWS.wsdl
http://portalmayores.es/service/pmLegWS.wsdl
http://portalmayores.es/service/pmProgWS.wsdl
http://portalmayores.es/service/pmProyWS.wsdl
3|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
- Operación "residencia"
a) Descripción funcional
Permite realizar diferentes tipos de consulta de residencias en función de los parámetros de entrada.
Nombre Tipo
residenciaRequest Objeto que contiene la consulta
5|
4|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
Nombre Tipo
resiResponse Lista de objetos responseContent
responseContent El objeto con los datos de salida
<soapenv:Envelope
xmlns:soapenv = “http://schemas.xmlsoap.org/soap/envelope/”
xmlns:sch = “http://portalmayores.es/service/schemas”>
<soapenv:Header/>
<soapenv:Body>
<sch:residenciaRequest>
<sch:requestContent>
<sch:denominacion>Ballesol</sch:denominacion>
<sch:cp></sch:cp>
<sch:municipio></sch:municipio>
<sch:provincia></sch:provincia>
<sch:ccaa></sch:ccaa>
<sch:gestion></sch:gestion>
<sch:tipologia></sch:tipologia>
<sch:titularidad></sch:titularidad>
<sch:plazas></sch:plazas>
<sch:servicios></sch:servicios>
</sch:requestContent>
</sch:residenciaRequest>
</soapenv:Body>
</soapenv:Envelope>
5|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
- Operación “ley”
a) Descripción funcional
Permite realizar diferentes tipos de consulta de leyes relacionadas con Gerontología y Geriatría en función de los
parámetros de entrada.
Nombre Tipo
leyRequest Objeto que contiene la consulta
requestContent Los datos de consulta
7|
6|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
Nombre Tipo
leyResponse Lista de objetos responseContent
responseContent El objeto con los datos de salida
7|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
<soapenv:Envelope
xmlns:soapenv = “http://schemas.xmlsoap.org/soap/envelope/”
xmlns:sch = “http://portalmayores.es/service/schemas”>
<soapenv:Header/>
<soapenv:Body>
<sch:leyRequest>
<sch:requestContent>
<sch:titulo></sch:titulo>
<sch:boletin></sch:boletin>
<sch:ambito></sch:ambito>
<sch:ccaa></sch:ccaa>
<sch:descriptor></sch:descriptor>
<sch:organismo></sch:organismo>
<sch:rango></sch:rango>
<sch:anyo1>2008</sch:anyo1>
<sch:anyo2>2010</sch:anyo2>
</sch:requestContent>
</sch:leyRequest>
</soapenv:Body>
</soapenv:Envelope>
- Operación “proyecto”
a) Descripción funcional
Permite realizar diferentes tipos de consulta de proyectos de investigación relacionadas con Gerontología y Geria-
tría en función de los parámetros de entrada.
Nombre Tipo
proyectoRequest Objeto que contiene la consulta
requestContent Los datos de consulta
9|
8|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
Nombre Tipo
proyResponse Lista de objetos responseContent
responseContent El objeto con los datos de salida
9|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
<soapenv:Envelope xmlns:soapenv=”http://schemas.xmlsoap.org/soap/envelope/”
xmlns:sch=”http://portalmayores.es/service/schemas”>
<soapenv:Header/>
<soapenv:Body>
<sch:proyectoRequest>
<sch:requestContent>
<sch:anyo>2010</sch:anyo>
<sch:centro></sch:centro>
<sch:ccaa></sch:ccaa>
<sch:descriptor></sch:descriptor>
<sch:investigador></sch:investigador>
<sch:resumen></sch:resumen>
<sch:denominacion></sch:denominacion>
<sch:areatematica></sch:areatematica>
</sch:requestContent>
</sch:proyectoRequest>
</soapenv:Body>
</soapenv:Envelope>
- Operación “biblio”
a) Descripción funcional
Permite realizar diferentes tipos de consulta de bibliografía y documentos relacionadas con Gerontología y Geria-
tría en función de los parámetros de entrada.
Nombre Tipo
biblioRequest Objeto que contiene la consulta
requestContent Los datos de consulta
11|
10|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
Nombre Tipo
biblioResponse Lista de objetos responseContent
responseContent El objeto con los datos de salida
11|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
<soapenv:Envelope xmlns:soapenv=”http://schemas.xmlsoap.org/soap/envelope/”
xmlns:sch=”http://portalmayores.es/service/schemas”>
<soapenv:Header/>
<soapenv:Body>
<sch:biblioRequest>
<sch:requestContent>
<sch:autor>Abellan</sch:autor>
<sch:titulo></sch:titulo>
<sch:descriptor></sch:descriptor>
<sch:clasificacion></sch:clasificacion>
<sch:revista></sch:revista>
<sch:tipodocumento></sch:tipodocumento>
<sch:anyoini></sch:anyoini>
<sch:anyofin></sch:anyofin>
</sch:requestContent>
</sch:biblioRequest>
</soapenv:Body>
</soapenv:Envelope>
- Operación “Agenda”
a) Descripción funcional
Permite realizar diferentes tipos de consulta de bibliografía y documentos relacionadas con Gerontología y Geria-
tría en función de los parámetros de entrada.
Nombre Tipo
evenRequest Objeto que contiene la consulta
requestContent Los datos de consulta
13|
12|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
Nombre Tipo
evenResponse Lista de objetos responseContent
responseContent El objeto con los datos de salida
http://portalmayores.es/service/pmEvenWS
<soapenv:Envelope xmlns:soapenv=”http://schemas.xmlsoap.org/soap/envelope/”
xmlns:sch=”http://portalmayores.es/service/schemas”>
<soapenv:Header/>
<soapenv:Body>
<sch:evenRequest>
<sch:requestContent>
<sch:anyo></sch:anyo>
<sch:contenido></sch:contenido>
<sch:descriptor></sch:descriptor>
<sch:lugar></sch:lugar>
<sch:tipo></sch:tipo>
<sch:organizacion>Alzheimer</sch:organizacion>
<sch:titulo></sch:titulo>
<sch:comunidad></sch:comunidad>
<sch:historico>TRUE</sch:historico>
</sch:requestContent>
</sch:evenRequest>
</soapenv:Body>
</soapenv:Envelope>
13|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
- Operación “prog”
a) Descripción funcional
Permite realizar diferentes tipos de consulta de programas relacionadas con Gerontología y Geriatría en función
de los parámetros de entrada.
Nombre Tipo
progRequest Objeto que contiene la consulta
requestContent Los datos de consulta
Nombre Tipo
progResponse Lista de objetos responseContent
responseContent El objeto con los datos de salida
15|
14|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
http://portalmayores.es/service/pmProgWS
<soapenv:Envelope xmlns:soapenv=”http://schemas.xmlsoap.org/soap/en-
velope/” xmlns:sch=”http://portalmayores.es/service/schemas”>
<soapenv:Header/>
<soapenv:Body>
<sch:progRequest>
<sch:requestContent>
<sch:titulo>madrid</sch:titulo>
<sch:ccaa></sch:ccaa>
<sch:provincia></sch:provincia>
<sch:municipio></sch:municipio>
<sch:descriptor></sch:descriptor>
<sch:entidad></sch:entidad>
<sch:materia></sch:materia>
<sch:submateria></sch:submateria>
</sch:requestContent>
</sch:progRequest>
</soapenv:Body>
</soapenv:Envelope>
A continuación adjuntamos como ejemplo el código en Java (los servicios web admiten además otras tecnologías)
que permite invocar el servicio web para obtener residencias por su denominación, municipio o provincia.
2.1 Index.html
15|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
<TR><TD>Denominacion</TD><TD><INPUT TYPE=TEXT
NAME=denominacion SIZE=20></TD></TR>
<TR><TD>CP</TD><TD>
<INPUT TYPE=TEXT NAME=cp SIZE=20></TD></TR>
<TR><TD>Municipio</TD><TD>
<INPUT TYPE=TEXT NAME=municipio SIZE=20></TD></TR>
<TR><TD>Provincia</TD><TD>
<INPUT TYPE=TEXT NAME=provincia SIZE=20></TD></TR>
</TABLE>
<P><INPUT TYPE=SUBMIT>
</FORM>
</body>
</html>
2.2 Invocador.java
import java.io.IOException;
import java.io.PrintWriter;
import java.util.List;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
/**
* @author Joaquin Siabra Nov 2010
*/
public class invocador extends HttpServlet {
protected void processRequest(HttpServletRequest request,
HttpServletResponse response) throws ServletException, IOException
{
response.setContentType( “text/html;charset=UTF-8” );
PrintWriter out = response.getWriter();
try {
out.println( “<html>” );
out.println( “<head>” );
out.println( “<title>Servlet invocador del Web Service PM</title>” );
out.println( “</head>” );
out.println( “<body>” );
out.println( “<h1>Resultado</h1>” );
17|
16|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001
Descripción de los Servicios Web de Portal Mayores
//Invocamos el servicio
es.portalmayores.service.schemas.ResidenciaResponse result = port.
residencia(req);
17|
Portal Mayores [http://www.portalmayores.es] Una iniciativa del IMSERSO y del CSIC © 2001