Primeros pasos con Node.js y Couchbase Server

He estado jugando con el SDK de Couchbase Node últimamente y pensé que sería divertido escribir en el blog mi progreso hacia la creación de una aplicación Node completa usando Couchbase como base de datos.

A lo largo de unas cuantas entradas, voy a construir una aplicación Node.js sencilla que utiliza Couchbase en el back-end. Empezaré con lo más básico, pasaré a algo que hace un poco más, introduciré vistas, traeré el ODM Ottoman y luego experimentaré con N1QL.

Instalación del SDK

La instalación es sencilla:

El cliente es una envoltura nativa de Node alrededor de libcouchbase, la librería C de Couchbase. Si estás en Windows, tendrás todo pre-construido. Si no, necesitarás nodo-gyp y un entorno de compilación. Debería echar un vistazo al página de instalación para hacerte una idea completa de lo que necesitas para tu entorno.

Poner algo en

Usando el cliente Node tienes tres formas de introducir datos en Couchbase:

• insertar: añadir un nuevo documento pero dar un error si ya existe una clave con esa clave (la C de CRUD)
• reemplazar: sobrescribir sólo un documento existente y lanzar un error si no existe una clave con ese nombre (la U de CRUD)
• upsert: independientemente de si existe una clave con ese nombre, escribe el documento (la C o la U de CRUD).

Por ahora, vamos a crear una demostración sencilla utilizando upsert. Las herramientas que necesitaremos son:

• Express.js
• el middleware separador de cuerpos para Express
• Servidor Couchbase funcionando localmente
• y por supuesto el cliente Couchbase Node que acabamos de instalar.

Conexión

Empezaremos requiriendo Express y body-parser, asumiendo que ya los has instalado con npm.

A continuación nos conectaremos primero al cluster de Couchbase y luego al bucket por defecto.

En aras de la simplicidad, aquí todavía no hay comprobación de errores.

Crear un formulario sencillo para capturar algunos datos

A continuación vamos a crear un par de rutas. En primer lugar vamos a tener una página de inicio con un simple formulario y luego algo para manejar la entrada del formulario.

Luego ejecutamos la aplicación en el puerto 3000 y, bueno, en realidad no pasa mucho más.

Nuestro formulario POST la entrada de nuevo a la página de inicio, pero no hemos hecho nada para manejarlo. Así que vamos a arreglar eso.

Tratamiento de la entrada del formulario

Como vamos a enviar por POST nuestro formulario a la página de inicio, necesitamos crear una ruta POST que se encargue de ello y le pasaremos el objeto urlEncodedParser para que nos proporcione el formulario en un estado que podamos utilizar. Lo pondremos directamente después de nuestra primera ruta.

A continuación, enviaremos un error 400 si no hay datos de formulario que analizar.

Luego convertiremos los datos del formulario a JSON y los guardaremos en un documento de Couchbase.

Ya está. Hemos puesto nuestro primer documento en Couchbase Server desde el cliente Node. El el código completo está en Github.

La próxima vez esbozaremos una aplicación más útil y empezaremos a pensar en cómo representaremos los datos en Couchbase.