\/lib\/
\n\/lib\/models\/
\n\/lib\/app.js
\n\/lib\/database.js
\n\/package.json<\/div>\n<\/div>\n
De acordo com a estrutura normal do Node.js, come\u00e7amos com a pasta 'lib' para armazenar todos os nossos arquivos de origem, com um lib\/server.js para atuar como o arquivo principal e, por fim, nosso package.json para descrever as depend\u00eancias do projeto e outros metadados. Al\u00e9m disso, adicionamos um database.js que gerenciar\u00e1 centralmente nossa conex\u00e3o com o banco de dados para evitar que tenhamos de instanciar uma nova conex\u00e3o para cada solicita\u00e7\u00e3o, bem como a pasta \/lib\/models\/ que usaremos para manter o c\u00f3digo-fonte de nossos v\u00e1rios modelos de banco de dados.<\/p>\n
O b\u00e1sico<\/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\"licen\u00e7a\"<\/span> :<\/span> \"Apache2\"<\/span>,<\/span>
\n\"name\" (nome)<\/span>:<\/span> \"gameapi-couchbase\"<\/span>,<\/span>
\n\"dependencies\" (depend\u00eancias)<\/span>:<\/span> {<\/span>
\n\"couchbase\"<\/span>:<\/span> “~1.0.0”<\/span>,<\/span>
\n\"expresso\"<\/span>:<\/span> “~3.4.0”<\/span>,<\/span>
\n\"uuid\"<\/span>:<\/span> “~1.4.1”<\/span>
\n}<\/span>,<\/span>
\n\"devDependencies\"<\/span>:<\/span> {<\/span>
\n}<\/span>,<\/span>
\n\"vers\u00e3o\"<\/span>:<\/span> “0.0.1”<\/span>
\n}<\/span><\/div>\n<\/div>\nNossa pr\u00f3xima etapa \u00e9 configurar o n\u00facleo do nosso servidor de jogos. Isso \u00e9 colocado em nosso arquivo \/lib\/app.js. Examinarei as se\u00e7\u00f5es desse arquivo bloco por bloco e explicarei o que cada uma delas faz.<\/p>\n
Primeiro, precisamos importar os m\u00f3dulos de que precisaremos nesse arquivo. No momento, precisamos apenas do m\u00f3dulo express para roteamento e an\u00e1lise de HTTP, mas, mais adiante neste tutorial, adicionaremos mais coisas a ele.<\/p>\n
\n
<\/div>\n
var<\/span> expresso =<\/span> exigir(<\/span>\"expresso<\/span>)<\/span>;<\/span><\/div>\n<\/div>\nEm seguida, vamos configurar o Express. Al\u00e9m disso, anexamos o subm\u00f3dulo bodyParser do Express para que possamos analisar os corpos JSON POST e PUT. Isso ser\u00e1 \u00fatil mais tarde, quando nossos clientes de jogos precisarem nos passar blocos de dados JSON.<\/p>\n
\n
<\/div>\n
var<\/span> aplicativo =<\/span> expresso(<\/span>)<\/span>;<\/span>
\naplicativo.uso<\/span>(<\/span>expresso.bodyParser<\/span>(<\/span>)<\/span>)<\/span>;<\/span><\/div>\n<\/div>\nApenas para fins de demonstra\u00e7\u00e3o, vamos adicionar uma rota simples ao nosso servidor HTTP para lidar com solicita\u00e7\u00f5es \u00e0 raiz do nosso servidor.<\/p>\n
\n
<\/div>\n
aplicativo.
obter<\/span>(<\/span>‘\/’<\/span>,<\/span> fun\u00e7\u00e3o<\/span>(<\/span>req,<\/span> res,<\/span> pr\u00f3xima)<\/span> {<\/span>
\nres.enviar<\/span>(<\/span>{<\/span>lacaios:<\/span> Curvem-se diante de mim, pois eu sou a RAIZ!<\/span>}<\/span>)<\/span>;<\/span>
\n}<\/span>)<\/span>;<\/span><\/div>\n<\/div>\nPor fim, vamos colocar nosso servidor HTTP escutando na porta 3000.<\/p>\n
\n
<\/div>\n
aplicativo.
ouvir<\/span>(<\/span>3000<\/span>,<\/span> fun\u00e7\u00e3o<\/span> (<\/span>)<\/span> {<\/span>
\nconsole.registro<\/span>(<\/span>'Listening on port 3000' (Escutando na porta 3000)<\/span>)<\/span>;<\/span>
\n}<\/span>)<\/span>;<\/span><\/div>\n<\/div>\nEsta \u00e9 uma ideia aproximada de como deve ser seu app.js at\u00e9 o momento:<\/p>\n
\n
<\/div>\n
\n
var<\/span> expresso =<\/span> exigir(<\/span>\"expresso<\/span>)<\/span>;<\/span><\/p>\nvar<\/span> aplicativo =<\/span> expresso(<\/span>)<\/span>;<\/span>
\naplicativo.uso<\/span>(<\/span>expresso.bodyParser<\/span>(<\/span>)<\/span>)<\/span>;<\/span><\/p>\naplicativo.obter<\/span>(<\/span>‘\/’<\/span>,<\/span> fun\u00e7\u00e3o<\/span>(<\/span>req,<\/span> res,<\/span> pr\u00f3xima)<\/span> {<\/span>
\nres.enviar<\/span>(<\/span>{<\/span>lacaios:<\/span> Curvem-se diante de mim, pois eu sou a RAIZ!<\/span>}<\/span>)<\/span>;<\/span>
\n}<\/span>)<\/span>;<\/span><\/p>\naplicativo.ouvir<\/span>(<\/span>3000<\/span>,<\/span> fun\u00e7\u00e3o<\/span> (<\/span>)<\/span> {<\/span>
\nconsole.registro<\/span>(<\/span>'Listening on port 3000' (Escutando na porta 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> exigir(<\/span>'couchbase'<\/span>)<\/span>;<\/span><\/p>\n\/\/ Conectar-se ao nosso servidor Couchbase<\/span><\/p>\n<\/div>\nm\u00f3dulo.
exporta\u00e7\u00f5es<\/span>.mainBucket<\/span> =<\/span> novo<\/span> couchbase.Conex\u00e3o<\/span>(<\/span>{<\/span>balde:<\/span>'gameapi'<\/span>}<\/span>,<\/span> fun\u00e7\u00e3o<\/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
\u00c9 nesse ponto que sugiro que voc\u00ea instale um aplicativo que permita criar solicita\u00e7\u00f5es HTTP espec\u00edficas. Pessoalmente, adoro a extens\u00e3o POSTman para o Google Chrome. Isso ser\u00e1 importante mais tarde, quando voc\u00ea quiser testar endpoints que n\u00e3o sejam simples solicita\u00e7\u00f5es GET!<\/p>\n
Cria\u00e7\u00e3o de conta - Modelo de conta<\/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> exigir(<\/span>'uuid'<\/span>)<\/span>;<\/span>
\nvar<\/span> couchbase =<\/span> exigir(<\/span>'couchbase'<\/span>)<\/span>;<\/span>
\nvar<\/span> db =<\/span> exigir(<\/span>'.\/..\/database'<\/span>)<\/span>.mainBucket<\/span>;<\/span><\/div>\n<\/div>\nComo voc\u00ea pode ver, h\u00e1 quatro m\u00f3dulos de que precisaremos neste momento. Usaremos o m\u00f3dulo uuid para gerar UUIDs para nossos objetos de banco de dados. Vi muitas pessoas usando contadores de sequ\u00eancia implementados usando o sistema incr\/decr do Couchbase, mas prefiro muito mais o m\u00e9todo UUID que usarei aqui, pois ele evita a necessidade de fazer uma opera\u00e7\u00e3o adicional no banco de dados. Em seguida, importamos o m\u00f3dulo couchbase, que usaremos para acessar v\u00e1rias constantes de que precisaremos (principalmente erros). E, por fim, importamos o m\u00f3dulo de banco de dados e obtemos a conex\u00e3o com o bucket gameapi que criamos anteriormente.<\/p>\n
Em seguida, definimos uma fun\u00e7\u00e3o auxiliar simples que ajudar\u00e1 a remover quaisquer propriedades em n\u00edvel de banco de dados de que nosso modelo precise e que n\u00e3o sejam importantes para o restante do servidor. No momento, a propriedade \"type\" \u00e9 a \u00fanica propriedade que ser\u00e1 removida. Essa propriedade ser\u00e1 usada pela gameapi para identificar que tipo de objeto \u00e9 um determinado item em nosso balde ao fazer redu\u00e7\u00f5es de mapa posteriormente.<\/p>\n
\n
fun\u00e7\u00e3o<\/span> cleanUserObj(<\/span>obj)<\/span> {<\/span>
\nexcluir<\/span> obj.tipo<\/span>;<\/span>
\nretorno<\/span> obj;<\/span>
\n}<\/span><\/div>\n<\/div>\nAgora, definimos nossa classe AccountModel.<\/p>\n
\n
fun\u00e7\u00e3o<\/span> AccountModel(<\/span>)<\/span> {<\/span>
\n}<\/span><\/div>\n<\/div>\nE exportar a classe para outros arquivos que importam essa classe. Sugiro que voc\u00ea mantenha essa declara\u00e7\u00e3o sempre na parte inferior do arquivo para facilitar a localiza\u00e7\u00e3o quando estiver tentando identificar o que um determinado arquivo exporta.<\/p>\n
\n
<\/div>\n
m\u00f3dulo.
exporta\u00e7\u00f5es<\/span> =<\/span> AccountModel;<\/span><\/div>\n<\/div>\n<\/div>\n
Agora que nosso modelo boilerplate est\u00e1 pronto, podemos criar nossa fun\u00e7\u00e3o create, que nos permitir\u00e1 criar um objeto de usu\u00e1rio. Dividirei essa fun\u00e7\u00e3o em partes menores para simplificar a explica\u00e7\u00e3o.<\/p>\n
Vamos come\u00e7ar com a defini\u00e7\u00e3o da fun\u00e7\u00e3o em si.<\/p>\n
\n
AccountModel.criar<\/span>