Creacion de Un WebService en Java

Un servicio web (en inglés, Web service) es una pieza de software que utiliza un conjunto de protocolos y estándares que sirven para intercambiar datos entre programas. Distintas aplicaciones de software desarrolladas en lenguajes de programación diferentes, y ejecutadas sobre cualquier plataforma, pueden utilizar los servicios web para intercambiar datos en redes de ordenadores como Internet.

Los Web services representan la revolución informática de la nueva generación de aplicaciones que trabajan colaborativamente en las cuales el software esta distribuido en diferentes servidores; de esta manera se logra la creacion de grandes aplicaciones que pueden funcionar en una gran multitud de dispositivos, entre los que se encuentran los telefonos moviles, las tabletas y computadores personales, todos ellos interactuando con un servidor.

para comenzar el estudio de como se crean y utilizan los webservices, es necesario considerar tener claros algunos conceptos, como son:

WSDL

En ocasiones leído como como wisdel son las siglas de Web Services Description Language, un formato XML que se utiliza para describir servicios Web. WSDL describe la interfaz pública a los servicios Web. Está basado en XML y describe la forma de comunicación, es decir, los requisitos del protocolo y los formatos de los mensajes necesarios para interactuar con los servicios listados en su catálogo.

SOAP (Simple Object Access Protocol)

El protocolo estandar que se utiliza para enviar la información, es SOAP. Este define el formato del “envelope” que se intercambia entre cliente y servicio, así como las convenciones para representar invocaciones y respuestas Estos mensajes son transmitidos en formato XML, montado sobre HTTP.

Bien, esto es lo basico que hay que tener claro para comenzar a crear un web service, existe mucha teoria e informacion que se podria consultar de ser necesario, pero en este ejemplo solo hay que tener presente lo que hemos citado.

Para facilitar mas la comprension de lo que vamos a realizar diremos que (en terminos «coloquiales» de programacion) un webservice es aquel programa que esta comprendido por funciones o metodos que reciben parametros o valores, los procesan y arrojan una salida.

Ahora si, empezemos, debo aclarar que voy a utilizar netbeans 6.9.1 y el servidor apache tomcat que viene con dicha version de netbeans.

Primero, creamos un nuevo proyecto de netbeans, de tipo java web Application, tal y como se puede ver en la siguiente imagen:

Luego, definimos el nombre de nuestro proyecto:

Ahora presionamos el boton siguiente y escogemos el servidor Apache Tomcat 6.0.26 y presionamos el boton siguiente tal y como se observa en la siguiente imagen:

Volvemos a dar clic sobre el boton siguiente y en la ventana que aparece hacemos clic en terminar sin elegir ningun framework:

Listo ahora debe de aparecernos la siguinte ventana que corresponde a la pagina index del proyecto,

sin embargo dicha pagina no sera mostrada ya que no sera necesario visualizar ninguna informacion html, todo el proceso sera codificado en otro lugar.

Ahora hacemos clic derecho sobre nuestro Proyecto (Ejemplo_Servicio_web) y en la lista desplegable que aparece seleccionamos la opcion nuevo y en la sublista escogemos Paquete Java, tal y como se observa en la imagen:

y aqui esta nuestro paquete que almacenara el codigo java de nuestro webservice:

Ahora si, podemos crear el webservice como tal, para ello hacemos nuevamente clic derecho sobre el proyecto y en la lista desplegable que aparece, escogemos la opcion nuevo y en la sublista Web Service… tal y como podemos ver:

luego se abrirá una nueva ventana donde le colocaremos nombre a nuestro web service (proceso_wc) y seleccionamos el paquete que antes creamos:

y listo, ya esta creado nuestro web service (vacio), nos aparecerá la siguiente ventana:

el error que presenta o la linea subrayada es porque aun no se ha definido ninguna funcion o metodo dentro de la clase, todo web service debe tener por lo menos un metodo definido.

bueno, hasta este punto se han explicado los pasos para la creacion de un webservice en netbeans, pero aun no he mencionado para que quiero usar el webservice; Entonces les dire que nuestro webservice se usará para registrar usuarios en una base de datos, gestionar los datos de dichos usuarios almacenados con procesos de actualizacion, eliminacion y busquedas. Asi que surge la necesidad de usar el conector de MySql para java, dicho conector debe de ir en la carpeta Web-Inf del Proyecto, en mi caso yo estoy creando una subcarpeta llamada lib, tal y como se ve en la imagen:

Bien, teniendo alojado el conector de mysql en la carpeta correcta del proyecto se puede pasar a agregar el jar como referencia de la siguiente manera, hacer clic derecho sobre el proyecto y escojer la opcion propiedades:

despues, en la siguiente ventana que aparece se presiona el boton Add Jar/folder y en la nueva ventana que aparece buscamos la libreria en el directorio de proyectos de netbeans, tal y como vemos en la siguiente imagen:

Teniendo ubicada la libreria se procede a hacer clic sobre el boton abrir.

Bien, Ahora es necesario definir la base de datos y la tabla que vamos a usar para almacenar la informacion.

Abrimos nuestro administrador de bases de datos, en mi caso yo estoy usando php myadmin del appserv y creamos una base de datos llamada datos_almacenados_ws y luego dentro de ella una tabla llamada usuarios con los campos que se ven en la siguiente imagen:

un vistazo a nuestra tabla creada sera de la siguiente manera:

listo, ya esta definida nuestra tabla, ahora si podemos pasar directamente a codificar en Java nuestro Web Service.

Estando en nuestro proyecto en Netbeans, Importamos las siguientes librerias en el archivo llamado proceso_wc:

import javax.jws.WebService;

import java.io.*;

import java.sql.*;

import javax.jws.WebMethod;

import javax.swing.JOptionPane;

Luego dentro de la clase proceso_wc debemos declarar las siguientes variables:

 @WebService()
public class proceso_wc {

private int id;

private String cedula;

private String nombre;

private String apellido;

private String direccion;

private String sexo;
// Ojo, aqui van las funciones que usara el webservice para realizar los diferentes procesos con los datos
// Dichas funciones se explican a continuacion.
 }

Bien Ahora si definamos los metodos o funciones que constituiran nuestro Web Service, comencemos con insertarUsuario:

@WebMethod

public boolean insertarUsuario(String ce,String no,String ap, String dir, String se){

String conexionBD="jdbc:mysql://127.0.0.1/datos_almacenados_ws";

Connection conexion=null;

boolean funciono=false;

String con;

try{

// JOptionPane.showMessageDialog(null,"entro");

Class.forName("com.mysql.jdbc.Driver");//el driver de mysql

conexion=DriverManager.getConnection(conexionBD, "root","12345");//conexion a la base de datos

Statement s = conexion.createStatement();

// JOptionPane.showMessageDialog(null,no+" "+ap);

con= "INSERT INTO USUARIOS VALUES (NULL,'"+ce+"','"+no+"','" + ap +"','"+ dir +"','"+se+"')";

s.executeUpdate(con);

funciono=true;

}

catch(Exception e){

System.out.println("No se ha completado la petición...");

}

return funciono;

}

Ahora pasemos a desarrollar el procedimiento de busqueda, el cual recibe como parametro la cedula de un usuario y luego a travez de una consulta sql se determina si el usuario existe, dicha funcion se llama buscarUsuarioCedula y se muestra a continuacion:

@WebMethod

public boolean buscarUsuarioCedula(String ced){

String conexionBD="jdbc:mysql://127.0.0.1/datos_almacenados_ws";

Connection conexion=null;

boolean funciono=false;

String con;

ResultSet rs;

try{

// JOptionPane.showMessageDialog(null,"entro");

Class.forName("com.mysql.jdbc.Driver");//el driver de mysql

conexion=DriverManager.getConnection(conexionBD, "root","12345");//conexion a la base de datos

Statement s = conexion.createStatement();

// JOptionPane.showMessageDialog(null,no+" "+ap);

con="SELECT * FROM usuarios where cedula = '" + ced + "'" ;

rs = s.executeQuery (con); {

while (rs.next()) {

cedula=rs.getString("cedula");

nombre=rs.getString("nombre");

apellido=rs.getString("apellido");

direccion=rs.getString("direccion");

sexo=rs.getString("sexo");

funciono=true;

MostrarCedula();

MostrarNombre();

MostrarApellido();

MostrarDireccion();

MostrarSexo();

break;

//JOptionPane.showMessageDialog(null, "si");

}

}

}

catch(Exception e){

System.out.println("No se ha completado la petición...");

}

return funciono;

}

Como se Puede ver, la funcion buscarUsuarioCedula utliza varias subfunciones para permitir la visualizacion de los datos como son, MostrarCedula(), MostrarNombre(), MostrarApellido(), MostrarDireccion(), MostrarSexo().
A continuacion Definiremos cada funcion para que retorne el valor correspondiente tal y como se aprecia luego:

@WebMethod

public String MostrarNombre(){

String nomb;

nomb="";

nomb=nombre;

return nomb;

}

@WebMethod

public String MostrarApellido(){

String apell;

apell="";

apell=apellido;

return apell;

}

@WebMethod

public String MostrarCedula(){

String codi;

codi="";

codi=cedula;

return codi;

}

@WebMethod

public String MostrarDireccion(){

String dire;

dire="";

dire=direccion;

return dire;

}

@WebMethod

public String MostrarSexo(){

String se;

se="";

se=sexo;

return se;

}

Ahora Vamos a desarrollar el procedimiento para actualizar usuario, como se ha notado, cada funcion recibe parametros y retorna un valor para que otra aplicacion que interactue con el web service determine si el proceso se realizo de forma correcta.

@WebMethod

public boolean actualizarUsuario(String ced, String no,String ap, String dir, String se){

String conexionBD="jdbc:mysql://127.0.0.1/datos_almacenados_ws";

Connection conexion=null;

boolean funciono=false;

String con;

try{

// JOptionPane.showMessageDialog(null,"entro");

Class.forName("com.mysql.jdbc.Driver");//el driver de mysql

conexion=DriverManager.getConnection(conexionBD, "root","12345");//conexion a la base de datos

Statement s = conexion.createStatement();

// JOptionPane.showMessageDialog(null,no+" "+ap);

con= "update usuarios set nombre='"+no+"',apellido='"+ap+"',direccion='"+dir+"',sexo='"+se+"' where cedula='"+ced+"'";

s.executeUpdate(con);

funciono=true;

}

catch(Exception e){

System.out.println("No se ha completado la petición...");

}

return funciono;

}

Por Ultimo, solo hace falta definir el procedimiento para eliminar Usuario, que lo podemos ver a continuacion:

@WebMethod

public boolean eliminarUsuario(String ced){

String conexionBD="jdbc:mysql://127.0.0.1/datos_almacenados_ws";

Connection conexion=null;

boolean funciono=false;

String con;

try{

// JOptionPane.showMessageDialog(null,"entro");

Class.forName("com.mysql.jdbc.Driver");//el driver de mysql

conexion=DriverManager.getConnection(conexionBD, "root","12345");//conexion a la base de datos

Statement s = conexion.createStatement();

// JOptionPane.showMessageDialog(null,no+" "+ap);

con= "delete from usuarios where cedula='"+ced+"'";

s.executeUpdate(con);

funciono=true;

}

catch(Exception e){

System.out.println("No se ha completado la petición...");

}

return funciono;

}

Bien, Hasta aqui ya esta listo nuestro servicio web, llego la hora de probarlo, para ello debemos hacer lo siguiente:
Presionar clic derecho sobre el proyecto Ejemplo_servicio_web y en el menu desplegable que aparece seleccionamos la opcion Limpiar y construir, como se observa en la imagen:

Luego volvemos a presionar clic derecho sobre el proyecto y seleccionamos la opcion deploy para que el proyecto se despliegue, es decir se compile y se coloque en funcionamiento:

A continuacion nos dirigimos a la carpeta webservice del directorio de nuestro proyecto y presionamos clic derecho sobre el archivo proceso_wc y en la lista desplegable que aparece seleccionamos la opcion Test Web service como se ve en la imagen:

listo de esa manera se pone en marcha nuestro web service en el navegador como veremos a continuacion:

Alli podemos observar la WSDL de nuestro servicio web, esa direccion es la que necesitamos para poder interactuar desde otra aplicacion (realizada en cuelaquier lenguaje y dispositivo) con nuestro Web Service.
Espero y le sea util a quien lo necesite.

Descargar Aplicacion