WebService: Conexiones a base de datos Mysql desde Android. PARTE 1 (Insertar)

Buenas amigos, llevo un tiempo sin hacer nada por aquí, ya que estoy trabajando con un grupo de programadores en un proyecto, pero a petición popular, y a la cantidad de email que me han mandado pidiéndome información para realizar conexiones a Mysql desde android, voy a realizar este tema.



Bien, el tema en sí es complejo, ojo, no difícil de entender, si no complejo de realizar, vamos a realizar mucho código para lo que realmente necesitamos, interactuar con una base de datos mysql en un servidor.

Si habéis hecho conexiones a mysql desde java sabréis que con una clase que contenga 4 o 5 lineas de código podíamos realizar nuestra conexión a mysql, podéis comprobarlo aquí, posteriormente solo teníamos que manejar los datos obtenidos (7 u 8 lineas) y ya podíamos mostrar resultados en nuestro programa. Bien, esto en android cambia y se vuelve más complejo ya que, por seguridad, deberemos crear un webservice para que nos sirva de puente entre nuestra aplicación y nuestro servidor.

Un Webservice suele ser un archivo PHP que recibe peticiones de nuestra app y se las envía al servidor, posteriormente el servidor responde a nuestro webservice, y este, a su vez, responde a nuestra app. Os dejo una imagen para que lo entendáis mejor.

Un WebService no tiene porque ser un archivo PHP, también podríamos realizar en nuestro servidor un programa en java que escuche por socket nuestra app y pasarle parámetros para que se comunique con el servidor, o podríamos crear un archivo javascript, o cualquier otra cosa que nos valga para comunicar nuestra app con nuestro servidor, pero ya digo, que lo más fácil, rápido y sencillo es un archivo PHP, no os compliquéis.

Bien, para crear la conexión a mysql necesitaremos:

• Servidor con base de datos Mysql.
• Mi base de datos esta compuesta por una tabla "personas" con los siguientes campos:
• DNI---Varchar
• Nombre--Varchar
• Teléfono--Varchar
• Email.--Varchar
• Uno o varios WebService (según necesitemos). Yo voy a utilizar 2:
• Insert.php
• selectAll.php
• Una conexión mediante la clase HttpClient de la API de Apache
• No hay que agregar librerías, esta API va incluida en el repositorio android.
• Ejecutarlo todo mediante hilos AsyncTask.
• A partir de la versión 3 o superior, correrlo todo en AsyncTask es obligatorio.

Bueno, sabiendo esto, creamos un nuevo proyecto con su respectiva activity.

Mi activity va a ser muy simple:

Podéis observar que consta de:

• 4 TextView y 4 Edittext, para los campos a rellenar.
• 2 Button para insertar y mostrar.
• 2 ImageButton para pasar de una persona a otra y se nos vaya mostrando.

Bien, una vez tengamos nuestro diseño, nos vamos a nuestra clase.

Lo primero es ligar nuestra clase con el archivo xml y sus componentes:

Antes de continuar vamos a ir a nuestro archivo AndroidManifest y vamos a agregar permisos de INTERNET, muy importante.

Una vez hecho todo lo anterior vamos a crear un método que envíe la información que introducimos en los campos a nuestro WebService para que este se lo comunique al servidor y obtener una respuesta.

Bueno, no os asustéis de ver tanta linea, ante todo saber que solo trabajamos con 2 clases y un ArrayList:

• HttpClient: Clase encargada de enviar la información almacenada en httpPost a nuestro WebService.

• HttpPost: almacena los datos que serán enviados, por medio de HttpClient, a nuestro WebService.

• List: Almacena objetos de tipo "NameValuePair" el cual almacena por constructor (NameValuePair es una interfaz la cual implementa la clase BasicNameValuePair ) una variable y el valor que contendrá dicha variable, las cuales son las que obtendrá nuestro WebService.

Veamos:

• Implementamos las clases con las que vamos a trabajar:
• HttpClient httpclient=new DefaultHttpClient();

• HttpPost httppost=new HttpPost("URL DE NUESTRO WEBSERVICE EN EL SERVIDOR")
• Yo tengo puesto la ip local de mi pc, ya que si ponemos localhost o 127.0.0.1, el dispositivo va a buscar su propio localhost, el que va incluido en el móvil, y puede crear errores, lo mejor si estas probando, la ip local de tu pc. Si utilizas el emulador que trae el eclipse SDK android, tendrás que poner 10.0.0.2, ya que si no te dará fallo.

• List nameValuePairs=new ArrayList(4);
• En este caso le damos a nuestro ArrayList un tamaño (4) ya que son el número de variables con las que vamos a tratar, si quieres utilizar 3, pones 3, y así sucesivamente.

• Ya tenemos nuestras clases preparadas, ahora vamos a almacenar los datos de nuestros EditText en nuestro ArrayList:

• nameValuePairs.add(BasicNameValuePair("dni", dni.getText().toString().trim()));
• Bien, esto no tiene mucha historia, almacenamos objetos de BasicNameValuePair con una variable y el valor que va a tener que le pasamos por constructor. Agregamos a nuestro ArrayList un objeto de este tipo según el tamaño que le hayamos dado.

• Una vez almacenados los datos, le pasamos el ArrayList a nuestra clase HttpPost para que lo codifique:

• httppost.setEntity(new UrlEncodeForEntity(nameValuePairs));

• Bueno, una vez que lo tenemos codificado con la url del webservice y la información de nuestro ArrayList, hacemos que HttpClient lo envíe:

• httpclient.execute(httppost);

Bueno, no era tan difícil, si un poco complejo, pero no difícil.

Bien, ya hemos enviado nuestra información a nuestro WebService, veamoslo con lo que le hemos enviado:

Veamos, este es nuestro WebService, un archivo escrito en PHP que interactua con nuestro servidor, su funcionamiento sería de la siguiente manera:

• Rellenamos las variables del localhost con la información de nuestro servidor:

• Hostname: Nombre del host.
• Database: Nombre de nuestra base de datos.
• Username: Nombre de usuario del servidor.
• Password: Contraseña del servidor.

• Posteriormente, con los datos de servidor que hemos introducido, le pedimos que conecte al servidor y almacene la respuesta en otra variable:

• $localhost = mysql_connect($hostname_localhost,$username_localhost,$password_localhost)
• Si no puede conectar enviara un informe de error
• or trigger_error(mysql_error(),E_USER_ERROR);

• Una vez conectado al servidor, buscará nuestra base de datos y se conectará:

• mysql_select_db($database_localhost, $localhost);

• Posteriormente, y una vez encontrad la base de datos, obtendrá las variables que le pasamos por nuestra aplicación y las almacenará en otras variables que pueda manejar mejor.

• $nombre=$_POST['nombre'];
• $dni=$_POST['dni'];
• $telefono=$_POST['telefono'];
• $email=$_POST['email'];
• Daos cuenta de que los nombres entre comillas simples se llaman igual a las variables que les pasamos por nuestra app.

• Almacenadas las variables, introduce los valores en un sentencia sql para realizar una consulta al servidor:

• $query_search = "insert into personas(nombre,dni,telefono,email) values ('".$nombre."','".$dni."','".$telefono."','".$email."')";
• Cuidado con las comillas simples y dobles, que puede ser un follón jeje.

• Finalmente, y si todo ha ido bien, realizará la consulta a nuestro servidor, el cual, en caso de fallar la sentencia, nos enviará un informe de error.

• $query_exec = mysql_query($query_search) or die(mysql_error());

• Cerramos la conexión.

• mysql_close($localhost);

Bien, ya tenemos el código java para conectarnos a nuestro servidor por medio de android y tenemos un webservice escrito en PHP que hace de puente entre nuestra app y el servidor, pero aún nos queda un último paso, realizar la consulta por medio de una clase AsyncTask.

NOTA:No voy a hacer aquí una explicación sobre el funcionamiento de una clase AsyncTask, ya que me quedaría muy extenso el post, en el futuro crearé un tema para esta clase. En google puedes encontrar mucha información sobre esta clase.

Nos volvemos a nuestra clase, y creamos una clase interna que herede de AsyncTask:

Bien, en el método doInBackground creamos una condición if, en el cual introducimos como condición el método insertar() (por esa razón lo hice booleano) si se los datos han sido insertados, el método nos devuelve true y nos muestra un Toast con el éxito de la operación y limpiando nuestro formulario, todo esto debe correr en un hilo ya que si no bloquearía nuestro AsyncTask y nos funde a errores, si los datos no han podido ser insertados, el método insertar nos devolverá false, y nos mostrará un Toast corriendo en un hilo.

Bueno, ya lo tenemos todo:

• Un servidor. Bien!
• Un WebService. Bien!
• Un método para conectar con nuestro WebService. Bien!
• Una clase AsyncTsk que ejecuta nuestro código. Bien!

Solo nos falta ir al botón insertar y darle una acción, para cuando se pulse ejecute todo al mismo tiempo.

Finalmente ya lo tenemos, cuando pulsemos nuestro botón comprobará que no haya ningún campo vacío, si lo hay, enviará un mensaje y no insertará nada.

Bueno, mencionar que mi dispositivo android no me hace bien las capturas de fotos y nos puedo mostrar una captura con datos, pero si os puedo mostrar como los muestra mi tabla personas una vez insertado los datos.

También os dejo la clase, el archivo .xml y el webservice en este enlace:

https://www.mediafire.com/?qyrmwvks9cyl2rx

PD: No he mencionado nada de encriptación (MD5, Base64...) o los certificados SSL, quiero hacer una entrada acerca de la seguridad.

Continuaremos la lección en la PARTE 2.

Un saludo.