Prévia do material em texto
MEAN Stack
Parte III - Mongoose
Revisão
• Databases, Collections e Document
– MongoDB não tem tabelas. O banco possui “collections
of documents” (coleções de documentos)
• As coleções são análogas a tabelas em bancos de dados
relacionais e os documentos aos dados.
Coleção
Coleção
Coleção
Documento
Revisão
• Criando um Database e Collections
– Se um banco de dados não existir, o MongoDB cria o
banco de dados quando se armazena os dados para ele
pela primeira vez. (ou seja, quando se cria um coleção
com seu documento)
– Podemos mudar para um banco de dados inexistente e
executar a seguinte operação
use myBDuser
Banco
“myDBuser”
Coleção
“users”
Documento (dados)
Revisão
• Operação de Leitura
– As operações de leitura recuperam documentos de uma
coleção
• ou seja, consulta uma coleção para “pegar” os documentos.
Banco
“myDBuser”
Coleção
“users”
Seleciona o campo “age” cujo
valor seja maior ou igual 18
(Comparison Query Operators)
Apresenta o “name” e o
“address” como resultado da
consulta
Revisão
• Operação de Update
– As operações de atualização modificam os documentos
existentes em uma coleção .
• No MongoDB, as operações de update visam uma única coleção.
• Todas as operações de escrita no MongoDB são atômicas no nível de um
único documento.
Coleção
“users”
Determina o critério de busca do
elemento a ser atualizado. Neste
caso, “age” menor que “18”
Seleciona o campo “status”
cujo valor será atualizado
Banco
“myDBuser”
Revisão
• Operação de Delete
– As operações de delete remove documentos de uma
coleção.
• No MongoDB, as operações de delete visam uma única coleção.
• Todas as operações de escrita no MongoDB são atômicas no nível de um
único documento.
Banco
“myDBuser”
Coleção
“users”
Determina o critério de deleção
Neste caso, “status” igual a
“reject”
• s
Revisão
Mongoose
• Blz...
– Nós já temos o nosso MongoDB server OK
• E já “brincamos” um pouco com os seus comandos…
– Agora podemos trabalhar diretamente com o MongoDB
junto com o Node.js
– Para isso precisamos instalar e conversar sobre um novo
recurso que vai “ajudar a nossa vida”..
Usando o Mongoose para trabalhar com
Dados e Modelos
• Mas que raios é “Mongoose”
– É mais do que um simples “MongoDB client”
– É um pacote que também nos permite definir
“schemas” e modelos
• Por exemplo, o que um “Usuário” deve ter definido:
– Nome : String
– Idade: Inteiro
– etc..
– E criar objetos a partir desse modelo
• E uma vez criado é possível executar métodos na database, tais
como “save” ou “delete”
• De forma que não e necessário escrever “queries na mão”
Usando o Mongoose para trabalhar com
Dados e Modelos
• Mas que raios é “Mongoose”
– Também é possível realizar validações extras
• Por exemplo, se o dado criado “se encaixa” no modelo criado
– Oferece operações intuitivas para manipulação da base
de dados
Preparando o Projeto
• Para usá-lo, precisamos instalar o Mongoose no
nosso projeto
• Vamos fazer isso usando o “npm install –save
mongoose”
– O “save” vai atualizar o nosso arquivo “package.json”
Preparando o Projeto
• Uma vez que o processo de instalação tenha
terminado
• Podemos ver no “package.json” se ele foi
adicionado ao projeto
• Como vamos usá-lo..
Usando Mongoose com Node.js
• Objetivo: Nós vamos conectar nosso “MongoDB
Server” à “aplicação Node.js” usando o “pacote
Mongoose”
• Vamos começar pelo arquivo “app.js da raiz”
– Uma vez que queremos que requisições possam se
conectar ao banco
Usando Mongoose com Node.js
• Com o intuito de conectar as requisições, devemos
usar:
• Com essa função nós estabelecemos uma conexão
• Como parâmetro nós temos
– O “path:port” que é o caminho para o “MongoDB Server”
– O nome da base de dados que iremos usar.
Criando Modelos com Mongoose
• Agora podemos executar operações na base de
dados
– Mas para isso, temos que inicialmente trabalhar com os
“modelos”
– E com esses modelos, criar objetos baseados neles…
– Para finalmente usar esses objetos e acessar a base de
dados diretamente….
• E o legal dessa estória é que…
– o Mongoose irá criar as coleções apropriadas para nosso
modelo e gerenciar nossos dados lá…
Criando Modelos com Mongoose
• Do lado do servidor vamos criar uma
pasta “models”
• Dentro dele, vamos criar dois
modelos que vamos usar várias vezes
ao longo do curso
– Vamos criar dois arquivos: “message.js”
e “user.js”
Criando Modelos com Mongoose
• Reforçando…
– Nosso foco é criar uma aplicação que tem “Message” e
“User” que podem criar mensagens, logar, deslogar, etc..
• Logo precisamos ser capaz de manipular e armazenar
mensagens e usuários
User Message*1
• Um “User” pode ter várias “Message”
MAS
• Cada “Message” só pode ter sido criada por um “User”
Criando Modelos com Mongoose
• Agora como vamos criar os modelos com o
Mongoose??
• Precisamos
“importar” o
Mongoose para
o arquivo
• Com isso temos
acesso a ele
• Agora vamos criar uma variável “Schema” a
partir de “objeto Schema” do Mongoose
• “Schema” é basicamente um “helper
object” que permite criar um “projeto” do
meu modelo (design)
• A partir desse
“Schema” eu
posso criar o
“meu próprio
schema” e
configurá-lo
• O construtor irá
receber como
argumento o
modelo que
iremos definir
Criando Modelos com Mongoose
• Agora como vamos criar os modelos
com o Mongoose??
• Estes são os nomes dos
campos (“as
propriedades”) que serão
armazenados no MongoDB
• Estas são as definições
dos campos
(configurações)
• A sintaxe é do Mongoose
• O “required” quer dizer
que tal campo nunca
pode ser vazio
• “Schema.Types” acessa
todos os tipos que o
Mongoose conhece
• “ObjectId” é o tipo
interno que o Mongoose
usa para referenciar o ID
• O objeto “Message” terá
• O “content” como
“String”
• O “user” como “uma
referência” ao objeto
usuário que criou a
mensagem
• Essa referência é
modelado como
um “ObjectId”
Aqui vamos ter o “documents” esquematizado
Criando Modelos com Mongoose
• Agora que temos um “schema/projeto” podemos
efetivar a criação do “modelo”
– A gente não pode instanciar esse “schema/projeto”
– A gente precisa de um “modelo” para fazer isso
• Vamos exportar
o modelo por
meio do
Mongoose
• O método “model()” tem 2 argumentos:
• O nome do modelo
• O “schema” que queremos usar para o
modelo
• O “nome do modelo” é o que será utilizado
para criar uma “Collection” no MongoDB
• Em minúsculo e no plural: “messages”
• Com esse comando
nosso modelo
“Message” está
configurado e
poderemos
instancia-lo mais
pra frente
Criando Modelos com Mongoose
• O modelo para “User” seria:
• O objeto “User” terá
• O “firstName, lastName,
password, email” como
“String”
• O “messages” como “um
array de referências” aos
objetos mensagem que
foram criadas pelo
usuário
• Essa referência é
modelado como um
“ObjectId”
• O “nome do modelo” é o que será
utilizado para criar uma “Collection” no
MongoDB
• Em minúsculo e no plural: “users”
• Com esse comando
nosso modelo “User”
está configurado e
poderemos instancia-
lo mais pra frente
Criando Modelos com Mongoose
• Antes de mais nada.. Uma palavrinha sobre o
“unique”
• Queremos que o e-mail seja “único”
• E apesar de ser uma propriedade reconhecida pelo
Mongoose ela não é automaticamente validada
– Pode acontecer de ter várias e-mails iguais cadastrados
Criando Modelos com Mongoose
• Para resolver isso, precisamos instalar uma “pacote”
com “npm install --save mongoose-unique-
validator” no nosso projeto
• E para usar no programa precisamos:
• Acessar, por meio de “schema”,
o “método plugin” que
permite anexar um plugin no
“nosso schema”
• Importar o pacote
• É o “plug”
que
vamos
utilizar
Criando Modelos com Mongoose
• Falta só mais “uma coisa”..
• Precisamos dizer para o Mongoose como ele vai
efetivar a relação entre “User” e “Message”
• Como ele vai efetivamente “amarrar os dois
modelos”
Criando Modelos com Mongoose
• Para resolver isso temosque usar outro propriedade de
configuração. O “ref”
• “ref” diz para o Mongoose que o
campo tem uma conexão com
outro modelo.
• Temos que passar o “nome do
modelo” que queremos associar
Armazenando Dados no Banco
• Agora vamos “salvar” os dados do
“User” no MongoDB
• Para o exemplo, vamos fazer algumas
modificações na view do servidor:
“node.hbs”
• E no “app.js de routes”
Armazenando Dados no Banco
• O campo de texto vai conter o “email”
• Este é o valor que vamos obter para
salvar no banco
• Rota que vamos criar
para enviar o
formulário via “post”
• Vale lembrar o nome do banco
que iremos utilizar
Armazenando Dados no Banco
• xxxx
• Rota via get que renderiza
a página “node.hbs”
• Recupera o valor digitado no
formulário no campo “emailBody”
• A variável “User” permite
importar o nosso modelo para
ser instanciado posteriormente
• Instância um objeto baseado no
modelo “User” e preenche com dados
• Uma vez que já temos um
objeto criado, baseado no
nosso modelo “User”, e
populado, podemos usar
“save()” do Mongoose
para salvar os dados do
usuário no banco
Armazenando Dados no Banco
• xxxx
Armazenando Dados no Banco
• xxxx
Dica
• Para visualizar as transações (F12)
Armazenando Dados no Banco
Dica
• Ferramenta para ajudar a analisar
requisições, seja GET, POST, etc...
Armazenando Dados no Banco
• xxxx
Dica
• Ferramenta para ajudar a analisar
requisições, seja GET, POST, etc...
Buscando Dados no Banco
• Agora vamos “buscar” os dados do
“User” no MongoDB
• Para o exemplo, vamos fazer algumas
modificações na view do servidor:
“node.hbs”
• E no “app.js de routes”
Buscando Dados no Banco
• Este são os campos que terão os valores
que vamos recuperar do banco
• Vamos “imprimir” o resultado com
“{{ }}”
• Vale lembrar o nome do banco
que iremos utilizar
Buscando Dados no Banco
• Rota de busca via get que
renderiza a página “node.hbs”
• A variável “User” permite importar o nosso
modelo. Ela representa o nosso modelo de
usuário – “user.js”
• Permite renderizar a página
“node.hbs” passando como
valor para o parâmetro
“firstNameV” o documento
recuperado
• Caso ocorra algum
erro, um simples
texto é enviado. Caso
contrário, renderiza a
página
• Vamos chamar o método
“findOne()” de “User” com
os seguintes argumentos:
• Um filtro, que define o
critério de busca”.
Neste caso é o primeiro
registro que encontrar,
sem critério “{ }”
• Uma “função callback”
que nos retorna um
erro (“err”), caso
ocorra, e o “documents
recuperado”
(“documents”)
Buscando Dados no Banco
• Reparem que foi retornado todo o
“document” em uma única
representação
• Como se fosse um único objeto
• Logo precisamos fazer uma alteração
no “app.js de routes”
Buscando Dados no Banco
• A variável “User” permite
importar o nosso modelo
• Vamos extrair do “documents”
recuperado cada um dos campos do
modelo
Buscando Dados no Banco
Buscando Dados no Banco
• Alguns outros exemplos:
Dica:
• Use qualquer método para buscar dados no banco diretamente via o modelo
• E use o método com callback, incluindo a resposta renderizada
• Se você executar qualquer código fora do callback você não terá acesso aos
dados recuperados porque ele não estará mais lá...
Para se aprofundar bastante no assunto
• Mongoose Docs:
– http://mongoosejs.com/docs/guide.html
Atividades
• Para fechar
– Vamos criar um novo modelo para ser usado em uma página de
registro de usuário
• Crie um novo arquivo CSS na estrutura
– styleregister.css
• Crie um template “registro-usuario-salvar.hbs”
– Use como exemplo o “index.hbs” para pegar os imports do bootstrap além do CSS e
a estrutura base do HTML
• Coloque o código HTML de um “registro de dados” (register-parteI.txt)
• Acesse esse template pela rota “localhost/registro-usuario-salvar”
– Crie um novo modelo com os dados solicitados no registro
– Agora ao registrar,
• Redirecione para uma nova página template “registro-usuario-
consultar.hbs”
• E recupere e mostre os dados persistido.
Atividades
• IMAGENS...
Atividades
• Dado a base de dados abaixo (vc pode criar a sua tb),
construa uma página que:
– Recupere os dados a partir do email fornecido. (O filtro é o e-mail)
– E que a rota tenha esse email como “Request Params”
• Dicas: