Configurar la función Advanced I/O

La función Advanced I/O contiene la lógica que acortará la URL que el usuario proporcione y maneja el enrutamiento en la aplicación. Puedes aprender más sobre este tipo de función en esta página de ayuda.

Ya hemos proporcionado el código completo de esta aplicación alojado en nuestro repositorio de GitHub en la sección de Introducción del tutorial. En caso de que lo hayas pasado por alto, ahora puedes descargar el código desde este enlace.

Agregaremos archivos de este repositorio descargado a nuestro directorio del proyecto.

Primero analicemos el componente de función en detalle.

• El archivo urlshorten.js en /catly/routers realiza las principales operaciones de enrutamiento y acortamiento. Hay dos paquetes npm incluidos en este archivo para realizar las tareas requeridas:

  • valid-url: El módulo valid URL se usa para verificar la validez de la URL original ingresada por el usuario. Si se encuentra que la URL es inválida, no se acortará.
  • shortid: El módulo shortid se usa para generar un ID único corto compatible con navegadores para la URL original ingresada por el usuario.

  Hay tres rutas definidas en este archivo para que el componente cliente utilice:

  • /item/all: Para obtener todos los datos del Data Store.
  • /:code: Para redirigir a la URL original de una URL acortada en particular
  • /item: Para insertar la URL original y generar su ID corto Accedemos al cache cuando usamos /:code y /item para recuperar datos, para un procesamiento más rápido. Sin embargo, una nueva URL ingresada por el usuario se persiste primero en el Data Store.

• El archivo helper.js en /catly/utils define los procedimientos para acceder al Data Store y al cache, para obtener datos de ellos o para persistir datos en ellos. Ejecuta consultas ZCQL para obtener datos de la tabla en el Data Store.

• El archivo constants.js en /catly/utils se usa para almacenar los valores constantes utilizados por los otros archivos, como el ID del segmento de cache y el nombre de la tabla que almacena las URLs originales y sus IDs cortos. También define la página de error a cargar cuando se encuentra que la URL es inválida desde el directorio del cliente.

• El index.js es el archivo principal del servidor que define los parámetros de solicitud y respuesta, e importa el framework express de Node.js y el middleware body-parser de npm.

• Además de estos archivos, el directorio de funciones contiene package.json y package-lock.json en la carpeta catly. El archivo catalyst-config.json en la raíz de la función contiene la configuración de la función. Puedes aprender más sobre estos archivos en la página de ayuda de la estructura de directorios del proyecto.

Ahora reemplazaremos la carpeta functions en la raíz del directorio del proyecto con la carpeta functions del repositorio descargado.

El directorio de tu proyecto ahora debería contener la siguiente estructura:

Sigue los pasos a continuación para completar el proceso de configuración de la función:

El repositorio que descargaste no contiene los módulos de node requeridos para la aplicación. Por lo tanto, debes instalar NPM en la carpeta catly.

1. Navega a functions/catly desde tu CLI y ejecuta el siguiente comando:

Esto instalará los módulos de node requeridos para la aplicación y actualizará los archivos de dependencias.

2. Ahora, abre el archivo package.json usando cualquier IDE y reemplaza el valor de author (que es emma@zylker.com) con tu dirección de correo electrónico.

3. Abre utils/constants.js y reemplaza el valor de short_url_segment con el Segment ID del segmento de cache que creaste en el proyecto Catly.

Puedes encontrar el Segment ID de tu segmento de cache desde la página Segments navegando al componente Cache en tu consola de Catalyst.

Esto es esencial, ya que la URL original y el ID corto recibidos de la aplicación Cat.ly deben almacenarse en, u obtenerse de, un segmento de cache válido.

El directorio de funciones está ahora correctamente configurado.