4. TP 1: Gestión básica de una nómina
4.1. Introduction
Para poner en práctica lo visto anteriormente, proponemos ahora un trabajo que consiste en escribir una aplicación cliente para tableta Android que permita simular los cálculos de las nóminas de los empleados de una asociación.
La aplicación tendrá una arquitectura cliente/servidor:
- El servidor [1] ya está disponible;
- hay que desarrollar el cliente Android [2].
4.2. La base de datos
4.2.1. Definición
Los datos estáticos necesarios para generar la nómina se almacenarán en una base de datos a la que, en adelante, nos referiremos c e dbpam. Esta base de datos contiene las siguientes tablas:
Estructura:
clave primaria | |
N.º de versión: aumenta con cada modificación de la línea | |
Número de la Seguridad Social del empleado: único | |
nombre del empleado | |
su nombre | |
su dirección | |
su ciudad | |
su código postal | |
clave externa en el campo [ID] de la tabla [INDEMNITES] |
Su contenido podría ser el siguiente:
Estructura:
clave primaria | |
N.º de versión: aumenta con cada modificación de la línea | |
porcentaje: cotización social generalizada + contribución al reembolso de la deuda social | |
porcentaje: contribución social generalizada deducible | |
porcentaje: Seguridad Social, viudedad, vejez | |
porcentaje: pensión complementaria + seguro de desempleo |
Su contenido podría ser el siguiente:
Los tipos de las cotizaciones sociales son independientes del empleado. La tabla anterior solo tiene una línea.
clave primaria | |
N.º de versión: aumenta con cada modificación de la línea | |
Índice de procesamiento: único | |
Precio neto en euros por hora de guardia | |
Indemnización por manutención en euros por día de custodia | |
Indemnización por comida en euros por día de servicio | |
Indemnización por vacaciones pagadas. Se trata de un porcentaje que se aplica al salario base. |
Su contenido podría ser el siguiente:
Cabe señalar que las indemnizaciones pueden variar de una cuidadora a otra. De hecho, están vinculadas a una cuidadora concreta a través de su índice salarial. Así, la Sra. Marie Jouveinal, que tiene un índice salarial de 2 (tabla EMPLOYES), tiene un salario por hora de 2,1 euros (tabla INDEMNITES).
4.2.2. Generación
Se proporciona el script [dbpam_hibernate.sql] para la generación de la base de datos:
 |
Crea la base de datos [dbpam_hibernate] (este es el nombre de la base de datos BD que utiliza el servidor web / jSON) y asegúrese de que el usuario root, sin contraseña, pueda acceder a ella. Puede hacerlo de la siguiente manera:
Inicie MySQL y, a continuación, [PhpMyAdmin]:
 |  |
- [1-2]: importe el script [dbpam_hibernate.sql] y, a continuación, ejecútelo;
4.2.3. Modelado Java de la base de datos
Los elementos de las tablas [EMPLOYES], [INDEMNITES] y [COTISATIONS] se modelan mediante las siguientes clases:
[Employe]
package pam.entities;
import java.io.Serializable;
public class Employe implements Serializable {
private static final long serialVersionUID = 1L;
private Long id;
private int version;
private String SS;
private String nom;
private String prenom;
private String adresse;
private String ville;
private String codePostal;
private int idIndemnite;
private Indemnite indemnite;
public Employe() {
}
public Employe(String SS, String nom, String prenom, String adresse, String ville, String codePostal, Indemnite indemnite) {
...
}
// getters y setters
....
}
- líneas 8-15: estos campos se corresponden con las columnas de la tabla [EMPLOYES];
- línea 16: el campo [indemniteId] corresponde a la columna [INDEMNITE_ID], que es la clave externa de la tabla [EMPLOYES];
- línea 17: la indemnización del empleado. Este campo no siempre está rellenado:
- no lo está cuando se solicita el URL [/employes],
- sí lo está cuando se solicitan los campos URL y [/salaire];
[Indemnite]
package pam.entities;
import java.io.Serializable;
public class Indemnite implements Serializable {
private static final long serialVersionUID = 1L;
private Long id;
private int version;
private int indice;
private double baseHeure;
private double entretienJour;
private double repasJour;
private double indemnitesCp;
public Indemnite() {
}
public Indemnite(int indice, double baseHeure, double entretienJour, double repasJour, double indemnitesCP) {
...
}
// getters y setters
....
}
- líneas 8-14: los campos se corresponden con las columnas de la tabla [INDEMNITES];
[Cotisation]
package pam.entities;
import java.io.Serializable;
public class Cotisation implements Serializable {
private static final long serialVersionUID = 1L;
private Long id;
private int version;
private double csgrds;
private double csgd;
private double secu;
private double retraite;
public Cotisation() {
}
public Cotisation(double csgrds, double csgd, double secu, double retraite) {
...
}
// getters y setters
...
}
- líneas 8-13: los campos se corresponden con las columnas de la tabla [COTISATIONS];
4.3. Instalación del servidor web / jSON
 |
4.3.1. Instalación
Se le proporciona el binario Java del servidor web / jSON:
 |
Para iniciar el servidor web / jSON, siga estos pasos:
- ejecute el archivo SGBD MySQL;
- asegúrese de que existen los archivos BD y [dbpam_hibernate];
- abre una ventana DOS;
- ve a la carpeta del archivo .jar;
- escribe el comando:
Esto supone que el binario [java.exe] se encuentra en el directorio PATH de tu equipo. Si no es así, escribe la ruta completa de [java.exe], por ejemplo:
Aparecerán los siguientes registros:
- línea 16: se detecta el archivo URL [/salaire/{SS}/{ht}/{jt}];
- línea 17: se detecta el URL [/employes];
4.3.2. Los URL del servicio web/jSON
 |
El servicio web / jSON está implementado por Spring MVC y expone dos URL:
@RequestMapping(value = "/employes", method = RequestMethod.GET, produces = "application/json; charset=UTF-8")
public EmployesResponse getEmployes() {
...
@RequestMapping(value = "/salaire/{SS}/{ht}/{jt}", method = RequestMethod.GET, produces = "application/json; charset=UTF-8")
public FeuilleSalaireResponse getFeuilleSalaire(@PathVariable("SS") String SS, @PathVariable("ht") double ht, @PathVariable("jt") int jt) {
El servicio web admite las dos URL siguientes:
- línea 1: /empleados: para obtener la lista de empleados;
- línea 4: /salaire/SS/ht/jt: para obtener la nómina del empleado con el n.º [SS] que ha trabajado [ht] horas durante [jt] días;
Aquí hay unas capturas de pantalla que lo muestran.
Se solicitan los empleados:
Se apaga la base de datos, se reinicia el servidor y se consultan los empleados:
Se consulta un salario:
Se solicita el salario de una persona que no existe:
4.3.3. Las respuestas jSON del servicio web/jSON
 |
 |
Los URL del servicio web / jSON envían respuestas del tipo [Response<T>]:
package client.android.dao.service;
import java.util.List;
public class Response<T> {
// ----------------- propiedades
// estado de la operación
private int status;
// posibles mensajes de estado
private List<String> messages;
// el cuerpo de la respuesta
private T body;
// constructores
public Response() {
}
public Response(int status, List<String> messages, T body) {
this.status = status;
this.messages = messages;
this.body = body;
}
// getters y setters
...
}
- el URL [/employes] devuelve un tipo Response<List<Employe>>;
- URL y [/salaire] devuelven un tipo Response<FeuilleSalaire>;
La clase [FeuilleSalaire] es la siguiente:
package pam.entities;
import java.io.Serializable;
public class FeuilleSalaire implements Serializable {
private static final long serialVersionUID = 1L;
// campos privados
private Employe employe;
private Cotisation cotisation;
private ElementsSalaire elementsSalaire;
// constructores
public FeuilleSalaire() {
}
public FeuilleSalaire(Employe employe, Cotisation cotisation, ElementsSalaire elementsSalaire) {
...
}
// getters y setters
...
}
- línea 9: la clase [Employe] se ha presentado en el apartado 4.2.3;
- línea 10: la clase [Cotisation] se ha presentado en el apartado 4.2.3;
La clase [ElementsSalaire] (línea 11) es la siguiente:
package pam.entities;
import java.io.Serializable;
public class ElementsSalaire implements Serializable {
private static final long serialVersionUID = 1L;
// campos privados
private double salaireBase;
private double cotisationsSociales;
private double indemnitesEntretien;
private double indemnitesRepas;
private double salaireNet;
// constructores
public ElementsSalaire() {
}
public ElementsSalaire(double salaireBase, double cotisationsSociales, double indemnitesEntretien, double indemnitesRepas, double salaireNet) {
...
}
// getters y setters
...
}
4.4. Pruebas del cliente Android
 |
A continuación se muestra el binario ejecutable del cliente de Android ya compilado:
 |
Arrastra con el ratón el archivo binario [pam-client.apk] que aparece arriba hasta un emulador de tableta [GenyMotion]. Se guardará y, a continuación, se ejecutará. Inicia también el servidor web / jSON si aún no lo has hecho. El cliente de Android tiene como objetivo recuperar la información enviada por el servidor web / jSON y darle formato. Las diferentes vistas del cliente de Android son las siguientes:
En primer lugar, hay que conectarse al servicio web / jSON:
- en [1], se introduce el URL del servicio web / jSON. Con el emulador, introduce una de las direcciones IP o PC (pero no 127.0.0.1). Si utilizas una tableta, introduce la dirección Wi-Fi del equipo del servidor web / jSON y desactiva el cortafuegos del servidor, si lo tiene, ya que podría bloquear las conexiones entrantes;
- En [2], nos conectamos;
A continuación, se accede a la página de simulación:
- En [3], se selecciona un empleado;
- en [4], se indica un número de horas;
- En [5], se indica un número de días;
- en [6], se solicita la simulación;
La página de simulación obtenida es la siguiente:
- en [7], la simulación obtenida;
- en [8], se guarda;
- en [9], la lista de simulaciones;
- en [10], se elimina una simulación;
- en [11], ya no hay simulaciones;
- en [12], se vuelve al formulario de simulación;
- en [13], se vuelve a mostrar el formulario;
- en [14], se vuelve a la página de configuración;
- en [15], volvemos al formulario de inicio de sesión inicial.
4.5. Tarea a realizar
Se le proporciona el esqueleto del cliente para Android presentado anteriormente. Se ha creado a partir del proyecto [client-android-skel] descrito en el apartado 2.
 |
El proyecto es ejecutable y ya cuenta con las vistas necesarias. Solo hay que añadir código para que la aplicación haga lo que tiene que hacer. El procedimiento a seguir es el siguiente:
- ejecuta la versión completa para familiarizarte con el trabajo que hay que realizar;
- ejecuta la versión simplificada y estudia su código. Este respeta los métodos de diseño utilizados en las páginas anteriores;
- añade el código que falta;