\/lib\/
\n\/lib\/models\/
\n\/lib\/app.js
\n\/lib\/database.js
\n\/paquete.json<\/div>\n<\/div>\n
Siguiendo la estructura normal de Node.js, empezamos con nuestra carpeta 'lib' para guardar todos nuestros archivos fuente, con lib\/server.js para actuar como archivo principal y finalmente nuestro package.json para describir las dependencias del proyecto y otros metadatos. Adem\u00e1s, a\u00f1adimos un database.js que gestionar\u00e1 de forma centralizada nuestra conexi\u00f3n a la base de datos para evitar que tengamos que instanciar una nueva conexi\u00f3n para cada solicitud, as\u00ed como la carpeta \/lib\/models\/ que utilizaremos para guardar el c\u00f3digo fuente de nuestros distintos modelos de base de datos.<\/p>\n
Conceptos b\u00e1sicos<\/h1>\n
Here is some content for your package.json. We give our project a name, point to its main Javascript file and then define a couple of prerequisite modules we will need later on. Once you have saved this file, executing `npm install` in your project root directory should install the referenced dependancies.<\/p>\n
\n
{<\/span>
\n\"principal\"<\/span>:<\/span> \".\/lib\/app\"<\/span>,<\/span>
\n\"licencia\"<\/span> :<\/span> \"Apache2\"<\/span>,<\/span>
\n\"nombre\"<\/span>:<\/span> \"gameapi-couchbase\"<\/span>,<\/span>
\n\"dependencias\"<\/span>:<\/span> {<\/span>
\n\"couchbase\"<\/span>:<\/span> \u201c~1.0.0\u201d<\/span>,<\/span>
\n\"express\"<\/span>:<\/span> \u201c~3.4.0\u201d<\/span>,<\/span>
\n\"uuid\"<\/span>:<\/span> \u201c~1.4.1\u201d<\/span>
\n}<\/span>,<\/span>
\n\"devDependencias\"<\/span>:<\/span> {<\/span>
\n}<\/span>,<\/span>
\n\"version\"<\/span>:<\/span> \u201c0.0.1\u201d<\/span>
\n}<\/span><\/div>\n<\/div>\nNuestro siguiente paso es configurar el n\u00facleo de nuestro servidor de juegos. Esto se coloca en nuestro \/lib\/app.js. Voy a ir a trav\u00e9s de las secciones de este archivo bloque por bloque, y proporcionar una explicaci\u00f3n de lo que est\u00e1 haciendo para cada uno.<\/p>\n
Primero tenemos que importar los m\u00f3dulos que vamos a necesitar en este archivo. En este momento s\u00f3lo necesitamos el m\u00f3dulo express para el enrutamiento HTTP y el an\u00e1lisis sint\u00e1ctico, pero m\u00e1s adelante en este tutorial vamos a a\u00f1adir m\u00e1s.<\/p>\n
\n
<\/div>\n
var<\/span> express =<\/span> requiere(<\/span>expr\u00e9s<\/span>)<\/span>;<\/span><\/div>\n<\/div>\nA continuaci\u00f3n, vamos a configurar express, adem\u00e1s adjuntamos el sub-m\u00f3dulo bodyParser de express para que podamos analizar los cuerpos JSON POST y PUT. Esto nos ayudar\u00e1 m\u00e1s adelante cuando nuestros clientes de juegos necesiten pasarnos bloques de datos JSON.<\/p>\n
\n
<\/div>\n
var<\/span> aplicaci\u00f3n =<\/span> express(<\/span>)<\/span>;<\/span>
\napp.utilice<\/span>(<\/span>expr\u00e9s.bodyParser<\/span>(<\/span>)<\/span>)<\/span>;<\/span><\/div>\n<\/div>\nPara el \u00fanico prop\u00f3sito de demostraci\u00f3n, vamos a a\u00f1adir una ruta simple a nuestro servidor HTTP para manejar las peticiones a la ra\u00edz de nuestro servidor.<\/p>\n
\n
<\/div>\n
app.
consiga<\/span>(<\/span>\u2018\/\u2019<\/span>,<\/span> funci\u00f3n<\/span>(<\/span>consulte,<\/span> res,<\/span> siguiente)<\/span> {<\/span>
\nres.enviar<\/span>(<\/span>{<\/span>esbirros:<\/span> \"\u00a1Incl\u00ednate ante m\u00ed porque soy la RA\u00cdZ!<\/span>}<\/span>)<\/span>;<\/span>
\n}<\/span>)<\/span>;<\/span><\/div>\n<\/div>\nPor \u00faltimo, vamos a hacer que nuestro servidor HTTP escuche en el puerto 3000.<\/p>\n
\n
<\/div>\n
app.
escuche<\/span>(<\/span>3000<\/span>,<\/span> funci\u00f3n<\/span> (<\/span>)<\/span> {<\/span>
\nconsola.registro<\/span>(<\/span>Escuchando en el puerto 3000<\/span>)<\/span>;<\/span>
\n}<\/span>)<\/span>;<\/span><\/div>\n<\/div>\nAqu\u00ed tienes una idea aproximada de c\u00f3mo deber\u00eda ser tu app.js hasta ahora:<\/p>\n
\n
<\/div>\n
\n
var<\/span> express =<\/span> requiere(<\/span>expr\u00e9s<\/span>)<\/span>;<\/span><\/p>\nvar<\/span> aplicaci\u00f3n =<\/span> express(<\/span>)<\/span>;<\/span>
\napp.utilice<\/span>(<\/span>expr\u00e9s.bodyParser<\/span>(<\/span>)<\/span>)<\/span>;<\/span><\/p>\napp.consiga<\/span>(<\/span>\u2018\/\u2019<\/span>,<\/span> funci\u00f3n<\/span>(<\/span>consulte,<\/span> res,<\/span> siguiente)<\/span> {<\/span>
\nres.enviar<\/span>(<\/span>{<\/span>esbirros:<\/span> \"\u00a1Incl\u00ednate ante m\u00ed porque soy la RA\u00cdZ!<\/span>}<\/span>)<\/span>;<\/span>
\n}<\/span>)<\/span>;<\/span><\/p>\napp.escuche<\/span>(<\/span>3000<\/span>,<\/span> funci\u00f3n<\/span> (<\/span>)<\/span> {<\/span>
\nconsola.registro<\/span>(<\/span>Escuchando en el puerto 3000<\/span>)<\/span>;<\/span>
\n}<\/span>)<\/span>;<\/span><\/p>\n<\/div>\n<\/div>\nFor the last bit of our project basics, lets set up our database connection. The code is fairly straightforward, we import the couchbase module and subsequently export a new connection to our locally hosted server and the bucket ‘gameapi’ through a property of the module named `mainBucket`.<\/p>\n
\n
<\/div>\n
\n
var<\/span> couchbase =<\/span> requiere(<\/span>couchbase<\/span>)<\/span>;<\/span><\/p>\n\/\/ Conectar con nuestro servidor Couchbase<\/span><\/p>\n<\/div>\nm\u00f3dulo.
exportaciones<\/span>.cubo principal<\/span> =<\/span> nuevo<\/span> couchbase.Conexi\u00f3n<\/span>(<\/span>{<\/span>cubo:<\/span>gameapi<\/span>}<\/span>,<\/span> funci\u00f3n<\/span>(<\/span>)<\/span>{<\/span>}<\/span>)<\/span>;<\/span><\/div>\n<\/div>\nAt this point if you open a terminal in your project root and execute `node lib\/app.js`, you should see the message “Listening on port 3000”. You can also now point your browser to `https:\/\/localhost:3000` and see our work so far in action.<\/p>\n
Es en este punto donde te sugiero que instales una aplicaci\u00f3n que te permita elaborar peticiones HTTP espec\u00edficas, a m\u00ed personalmente me encanta la extensi\u00f3n POSTman para Google Chrome. Esto ser\u00e1 importante m\u00e1s adelante cuando quieras probar endpoints que no sean simples peticiones GET.<\/p>\n
Creaci\u00f3n de cuentas - Modelo de cuenta<\/h1>\n
Now that we have our basic server running, lets starting working on the ‘game’ portion of our game server. We are going to start by implementing the account creation endpoint which will be accessible by doing a POST request to the `\/users` URI. To start this process, we are going to first build a model for our endpoint handler to deal with to abstract some of the details of our database implementation. These models are where the bulk of our interactions with Couchbase Server will happen.<\/p>\n
Lets first start by creating a new file in our `\/lib\/models` folder called ‘accountmodel.js’. Once you’ve got your accountmodel.js file ready and opened, lets start by importing some of the modules we will need.<\/p>\n
\n
var<\/span> uuid =<\/span> requiere(<\/span>uuid<\/span>)<\/span>;<\/span>
\nvar<\/span> couchbase =<\/span> requiere(<\/span>couchbase<\/span>)<\/span>;<\/span>
\nvar<\/span> db =<\/span> requiere(<\/span>'.\/..\/base de datos'<\/span>)<\/span>.cubo principal<\/span>;<\/span><\/div>\n<\/div>\nComo puedes ver, hay 4 m\u00f3dulos que vamos a necesitar en este momento. Usaremos el m\u00f3dulo uuid para generar UUID's para nuestros objetos de base de datos. He visto a mucha gente usando contadores de secuencia implementados usando el sistema incr\/decr de Couchbase, pero prefiero el m\u00e9todo UUID que usar\u00e9 aqu\u00ed ya que evita la necesidad de hacer una operaci\u00f3n adicional en la base de datos. A continuaci\u00f3n importamos el m\u00f3dulo couchbase que utilizaremos para acceder a varias constantes que necesitaremos (errores principalmente). Y por \u00faltimo importamos el m\u00f3dulo de base de datos y cogemos la conexi\u00f3n a nuestro bucket gameapi que creamos anteriormente.<\/p>\n
A continuaci\u00f3n definiremos una sencilla funci\u00f3n de ayuda que nos ayudar\u00e1 a eliminar cualquier propiedad a nivel de base de datos que nuestro modelo necesite y que no sea importante para el resto del servidor. En este momento la propiedad 'type' es la \u00fanica propiedad que vamos a eliminar. Esta propiedad ser\u00e1 utilizada por el gameapi para identificar qu\u00e9 tipo de objeto es un elemento en particular en nuestro cubo al hacer map-reduces m\u00e1s adelante.<\/p>\n
\n
funci\u00f3n<\/span> cleanUserObj(<\/span>obj)<\/span> {<\/span>
\nborrar<\/span> obj.tipo<\/span>;<\/span>
\ndevolver<\/span> obj;<\/span>
\n}<\/span><\/div>\n<\/div>\nAhora definimos nuestra clase AccountModel.<\/p>\n
\n
funci\u00f3n<\/span> AccountModel(<\/span>)<\/span> {<\/span>
\n}<\/span><\/div>\n<\/div>\nY exportar la clase a otros archivos que importan este. Le sugiero que mantenga esta declaraci\u00f3n siempre en la parte inferior de su archivo para que sea m\u00e1s f\u00e1cil de encontrar cuando usted est\u00e1 tratando de identificar lo que exporta un archivo en particular.<\/p>\n
\n
<\/div>\n
m\u00f3dulo.
exportaciones<\/span> =<\/span> AccountModel;<\/span><\/div>\n<\/div>\n<\/div>\n
Ahora que nuestro Modelo est\u00e1 hecho, podemos construir nuestra funci\u00f3n de creaci\u00f3n que nos permitir\u00e1 crear objetos de usuario. Voy a dividir esta funci\u00f3n en trozos m\u00e1s peque\u00f1os para simplificar su explicaci\u00f3n.<\/p>\n
Empecemos por la definici\u00f3n de la propia funci\u00f3n.<\/p>\n
\n
Modelo de cuenta.crear<\/span>