STATISTICS

Parte hecha por Joaquín Pineda Gutiérrez.

Interface: Interface

API: Servlet STATISTICS

ATRAS: GUIAS

INICIO: HOME

Descripción:

Este servicio proporciona los datos del número totales de moviles por pais y año.
Además del numero de estos también proporciona el numero de habitantes y la renta
per capita para motivos de estadisticas y comparación.

FUNCIONAMIENTO:

A continuacion se procede a explicar el funcionamiento concreto de cada método.
Para comunicarse con la api el objeto JSON debe tener el siguiente formato:

{"nombre":"Alemania","poblacion":400000,"renta":8000,"numTlf":100000000,"anno":2010}

Los nombres de los campos explican que es cada dato. El campo "anno" es para el año
pero por motivos de compatibilidad se ha eliminado la ñ en favor de la doble n para
evitar errores. Todos los campos numericos son de tipo entero.

Tenga en cuenta este fallo con los caracteres especiales a la hora de añadir/conultar
un país cuyo nombre los incluya ya que podría ser que no obtenga los resultados esperados.

NOTA:

Pulse en las imagenes para verlas en grande. En estas se ve una
maquetacion html para hacer mas comprensible el ejemplo de dichas imagenes,en
ningun momento la API devolvera eso, solo se devulven o los JSON o los
codigos de estado http

MÉTODO GET:

Este método devuelve la lista de todos las estatisticas de los paises en todos los años que se encuentran en el dataStore.

Si se realiza sobre un pais en concreto devuelve unicamente las entradas referentes a dicho pais.

Tenga encuenta que para acceder a un pais se realiza de la forma XXX-YYY, siendo las xxx el nombre del pais y la yyy el año en concreto

CODIGOS:
Codigo devuelto: 200 OK
Codigo devuelto (sobre una estatistica): 200 OK
OTROS CODIGOS:
Codigo cuando la estadistica no existe: 404 NOT FOUND

respuesta get respuesta get

MÉTODO POST:

Este método se usa para añadir una estadistica nueva que no estuviera ya en el dataStore.

El uso de este método sobre una estadistica en concreto no está permitido devolviendo un codigo de error.

Para usar el metodo POST en los datos pasado debe ir un objeto JSON con el formato descrito anteriormente o de lo contrario será devuelto un error.

CODIGOS:
Codigo devuelto: 201 CREATED
Codigo devuelto (sobre una estadistica): 405 METHOD NOT ALLOWED

OTROS CODIGOS:
Codigo cuando ya existe: 409 CONFLICT
Codigo cuando el JSON está mal formado: 406 NOT ACCEPTABLE

respuesta post error post

MÉTODO PUT:

Este método se usa para actualizar una estadistica nueva que ya estuviera en el dataStore.

El funcionamiento consiste en pasar con los datos el JSON de la estidistica que se quiere modificar con los parametros ya actualizados.

Los put solo estan permitidos sobre una estadistica en concreto, realizarlos sobre toda la lista no esta contemplado y dara un codigo de error.

CODIGOS:
Codigo devuelto: 405 METHOD NOT ALLOWED
Codigo devuelto (sobre una estadistica): 200 OK
OTROS CODIGOS:
Codigo cuando el JSON no corresponde a la estadistica: 409 CONFLICT
Codigo cuando el JSON está mal formado: 406 NOT ACCEPTABLE

respuesta put error put

MÉTODO DELETE:

Este método se usa para borrar una estadistica o el dataStore completamente.
Ejecutar el método sobre la URL de statistics borrará el dataStore completamente y si se realiza sobre una estadistica en concreto se borrara solamente esta.

Este método no requiere que se le pasen datos JSON.

CODIGOS:
Codigo devuelto: 405 METHOD NOT ALLOWED
Codigo devuelto (sobre una estadistica): 200 OK
OTROS CODIGOS:
Codigo cuando el JSON no corresponde a la estadistica: 409 CONFLICT
Codigo cuando el JSON está mal formado: 406 NOT ACCEPTABLE

respuesta delete respuesta delete