Constantemente en el mundo del desarrollo móvil las apps se conectan a un backend y naturalmente pensamos en una aplicación completa y la infraestructura para ejecutarla, pero que sucede en casos en los que no se necesita de una gran API o Servicio Web, optar por el ciclo natural podría volverse tedioso y trabajoso, para abordar esta problemática Microsoft nos ofrece el servicio en la nube denominado Azure Functions (Serverless).
Serverless hace referencia a computación sin servidor, un modelo de ejecución en el que el proveedor en la nube en este caso (Azure) es responsable de ejecutar un fragmento de código mediante la asignación dinámica de los recursos. Y cobrando solo por la cantidad de recursos utilizados para ejecutar el código. El código generalmente, se ejecuta dentro de contenedores sin estado que pueden ser activados por una variedad de eventos que incluyen solicitudes HTTP, eventos de base de datos, servicios de colas, alertas de monitoreo, carga de archivos, eventos programados (trabajos cron), etc. El código que se envía al proveedor en la nube para la ejecución es generalmente en forma de una función. Por lo tanto, serverless se denomina “Funciones como servicio” o “FaaS”.
En este Post crearemos una pequeña y sencilla Azure Function desde el portal web de Azure, esta función recibirá algunos parámetros para procesarlos y devolver un resultado esto hará el trabajo de un API, luego crearemos una aplicación móvil multiplataforma con Xamarin Forms para consumirla.
Problema a resolver con este proyecto: Calcular tu peso ideal
Para calcular el peso ideal hay que saber manejar el Índice de Masa Corporal (IMC), una medida que nos ayuda a detectar si nos encontramos dentro de los valores saludables o no.
La Organización Mundial de la Salud estima que un peso saludable es el que se sitúa entre valores de 18,5 y 24,9.
Los valores inferiores a 18,5 nos indican un peso demasiado bajo.
Si son iguales o superiores a 25 se consideraría ya sobrepeso. Si supera los 30 se trata de obesidad.
El peso ideal se calcula dividiendo el peso en kilogramos por el cuadrado de la altura en metros (kg/m2). Ejemplo: Si una persona pesa 60 kilos y mide 1,50 el resultado final sería 26, 6. Según Aragón, en este ejemplo la persona tendría ligero sobrepeso.
Hay que tener en cuenta que el cálculo del IMC “sólo es válido entre personas de 20 y 65 años y nunca para niños, embarazadas, madres lactantes o personas que realizan mucho deporte o de alta competición”.
Definición de tareas Azure Function y Aplicación móvil
Crearemos una aplicación móvil que calculará el peso ideal de una persona, esta recibirá los datos que necesitamos (peso y altura de una persona). Nuestra función de azure hará el procesamiento por medio de una petición HTTP Post, recibirá los datos serializados como un objeto JSON, realizará la operación para obtener el resultado final IMC para finalmente mostrar ese resultado en nuestra aplicación móvil.
Creando una función de Azure
En primera instancia necesitas una suscripción de Azure, puedes obtener una aquí https://azure.microsoft.com/es-es/free/
Después necesitamos crear el recurso, puedes buscarlo en la barra de búsqueda o en la sección de nuevo recurso, selecciona Azure Function.
Necesitamos completar la información obligatoria para crear nuestra Azure Function.
Una vez completados los datos Azure nos mostrará la información con las características de nuestra Azure Function, pulsamos en crear y esperamos a que se cree el recurso, Azure nos notificará cuando todo este listo.
Una vez creado el recurso necesitamos seguir unos pasos más.
Debemos elegir un entorno de desarrollo, en este caso seleccionamos en el Portal.
Seleccionamos WebHook y API.
-
Al crear una Azure Function esta se crea con código por defecto, eleminaremos ese código y lo sustituiremos por el siguiente y pulsaremos en el botón Guardar y Ejecutar.
Nota: Puedes encontrar el código para la función de Azure en el repositorio de github. Link al final de post.
Tenemos lista nuestra Azure Function!
Previo a consumirla desde Xamarin Forms haremos una prueba desde un cliente HTTP en este caso PostMan, necesitamos obtener la url para poder realizar la petición HTTP, da click en la opción Obtener la dirección URL de la función.
Ahora vamos a PostMan y utilizamos la Url obtenida en el paso anterior, debemos utilizar el verbo HTTP Post y enviar el objeto JSON en el cuerpo de la petición.
El resultado también es un objeto JSON que contiene una propiedad llamada result, el valor que tiene asignado result es lo que esperamos como respuesta.
Creando App Móvil Xamarin Forms
- Para este proyecto utilizaré Visual Studio 2019 Preview, y crearé un proyecto Xamarin Forms 4.3.
- Me apoyaré del patrón de arquitectura de Software MVVM para tratar de desacoplar lo máximo posible la interfaz de usuario de la lógica de la aplicación, buscando factorizar el código de la aplicación en las clases correctas y en establecer la interacción de clases entre sí.
Inicialmente estructuraremos los directorios de la Aplicación de la siguiente manera:
Nota: la página que se crea por defecto MainPage.xaml fue movida al directorio Views, no olvidar cambiar el namespace en el archivo MainPage.xaml.cs y modificar la referencia en el archivo xaml.
Seguidamente abrimos el administrador de paquetes nugets para la solución y vamos instalar el nuget Newtonsoft.Json en el proyecto NET-Standard.
Ahora vamos a crear 3 clases en el directorio Models, las clases modelo se llamaran Response, PesoIdealParam y PesoIdealResult.
Response.cs este modelo hace referencia al resultado que obtenemos al realizar una petición HTTP hacia nuestra Azure Function corriendo en Azure, consta de 4 propiedades: IsSucces toma un valor booleano que depende del éxito o excepción al realizar la petición HTTP, Message almacena el mensaje de respuesta al realizar la petición HTTP, StatusCode como toda petición HTTP retorna un StatusCode este se almacena en esta propiedad y por último DataResult un tipo Object que es capaz de almacenar cualquier tipo de objeto o lista de objetos que pueda retornar la petición HTTP.
PesoIdealParam.cs este modelo lo utilizaremos para enviar los valores recibidos en está app, vamos a serializarlos en formato JSON para luego enviarlos a nuestra Azure Function y se encargue de procesarlos, en este punto tendremos 3 propiedades que necesitaremos enviar: el nombre de la persona, el peso en kilogramos y la altura en metros, las propiedades de clase en C# las manejaremos con mayúsculas aunque en nuestra Azure Function están con minúscula, por eso es necesario utilizar las Anotaciones de Datos [Data Annotations] como decorador de cada propiedad de clase, los Data Annotations poseen el nombre de la propiedad como se gestiona en el backend y el nombre en mayúscula en la propiedad de clase es como gestionamos esa propiedad dentro de la app.
PesoIdealResult.cs este modelo únicamente posee una propiedad que se encargará de almacenar el resultado recibido del proceso que realiza nuestra Azure Function.
Ahora crearemos una clase llamada AzureFunctionService.cs en el directorio de Services, aquí encapsularemos la lógica para realizar la petición HTTP hacia nuestra Azure Function mediante un método asíncrono de retorna un Task de Response.
El siguiente paso es crear la clase ViewModel llamada MainViewModel.cs en el directorio ViewModels, este archivo encapsula la lógica de la aplicación encargada de utilizar diferentes clases que contienen diferentes responsabilidades.
MainViewModel.cs contiene las propiedades, atributos, validaciones, uso del servicio para utilizar Azure Function dentro de un método que responde al evento de ejecución dentro de un command de Xamarin Forms.
MainViewModel.cs hereda de BaseViewModel.cs una clase que contiene una implementación de INotifyPropertyChanged con el evento que notificará los cambios de cada propiedad en la ViewModel.
En este paso modificaremos la vista MainPage.xaml e inicialmente es necesario agregar la referencia al namespace al que pertenece la clase MainViewModel.cs y seguidamente establecemos el Binding Context para esta página, después creamos los controles necesarios para cada propiedad (Entry, Label, Button, Activity Indicator, etc) y establecemos el Binding correspondiente hacía cada una de las propiedades definidas en la clase ViewModel.
Ya tenemos todo el código necesario para ejecutar nuestra app, visualmente se ve de la siguiente manera:
Ahora ingresaremos los datos para que nuestra Azure Function pueda procesarlos y devolvernos un resultado, controlando todo desde nuestra app.
Como podemos observar nuestra aplicación funciona correctamente y podemos verificar los diferentes resultados que podemos obtener con base a la información enviada a nuestra Azure Function.
Conclusión
Tradicionalmente, las aplicaciones móviles estaban conectadas a servicios locales. La creación del nivel de servicio requería el conocimiento de la plataforma de servidor y un paradigma de programación. Los desarrolladores trabajaban en configurar los servidores de forma adecuada. A veces se dedicaban días o incluso semanas a la creación de una canalización de implementación confiable y segura, aunque esto se sigue haciendo.
Ahora sabemos que con Azure Functions podemos crear lógica de negocios sin necesidad de convertirnos en expertos en lo relacionado con el servidor, podemos crear un backend en cuestión de minutos y agilizar el desarrollo de nuestras apps móviles.
Link al Repositorio en GitHub
https://github.com/EbarriosCode/Xamarin-Azure-Functions
Referencias
https://docs.microsoft.com/en-us/azure/azure-functions/
https://docs.microsoft.com/en-us/xamarin/xamarin-forms/data-cloud/azure-services/azure-functions?tabs=windows
https://cuidateplus.marca.com/alimentacion/diccionario/indice-masa-corporal-imc.html
https://www.efesalud.com/aprende-calcular-peso-saludable/
Top comments (2)
Y cómo securizar la llamada al Azure Function ? OAuth ? Algún artículo paso a paso?
Puedes lograrlo inyectando un ClaimsPrincipal en métodos de función que se ha validado previamente con un token de acceso de OAuth generado externamente.
ben-morris.com/custom-token-authen...