Хранимые данные (persistent data) являются неотъемлемой частью современных веб-приложений. Они нужны нам для сохранения информации о пользователях, предоставления платежной информации и многого-многого другого. Теперь вы можете подключать свои любимые технологии хранения данных (Prisma, Mongoose, MySQL и другие) через npm и в Deno!
Этот пост продемонстрирует вам, как быстро начать работу в Deno со следующими npm-модулями:
Больше руководств по началу работы с npm-модулями для хранения данных вы можете найти в нашем мануале.
Повышенная безопасность хранения данных с Deno
Атаки через цепочку поставок (supply chain attacks) — известная проблема безопасности в npm. Node устанавливает и запускает npm-модули с доступом ко всему по умолчанию, что позволяет всего одной вредоносной зависимости незаметно скомпрометировать миллионы конечных пользователей.
Хранилище данных подвержено еще большему риску атак через цепочку поставок, поскольку к конфиденциальным производственным данным, необходимым для ведения бизнеса, можно получить доступ через переменные окружения.
Модель явного предоставления разрешений Deno гарантирует, что вы точно знаете, к чему вашим зависимостям требуется доступ. Система разрешений достаточно детализирована, чтобы вы могли предоставить доступ к переменным окружения, файловой системе и даже FFI.
Prisma
Prisma, современная ORM, способная похвастаться непревзойденным опытом разработки, была одним из наших наиболее востребованных модулей. Ниже приведено краткое руководство по началу работы с Prisma в Deno.
В следующем разделе показано, как быстро подключить Prisma к Deno.
Вы можете изучить исходный код здесь или посмотреть видеоруководство на нашем YouTube-канале.
Настройка приложения
Давайте создадим папку deno-prisma и переместимся туда.
mkdir deno-prisma & cd deno-prismaЗатем запустим prisma init с помощью Deno:
deno run --allow-read --allow-env --allow-write npm:prisma@^4.5 initЭто сгенерирует prisma/schema.prisma. Давайте обновим его следующим образом:
generator client { provider = "prisma-client-js" previewFeatures = ["deno"] output = "../generated/client" } datasource db { provider = "postgresql" url = env("DATABASE_URL") } model Dinosaur { id Int @id @default(autoincrement()) name String @unique description String }Prisma также должна была сгенерировать .env файл с DATABASE_URL. Давайте присвоим DATABASE_URL строку подключения PostreSQL. В этом примере мы будем использовать бесплатную базу данных PostgreSQL от Supabase.
После того, как мы обновили .env файл, нам нужно создадать схему базы данных в Prisma:
deno run npm:prisma@^4.5 db pushПосле этого нам нужно сгенерировать клиент Prisma для Data Proxy:
deno run npm:prisma@ ^4.5 generate --data-proxyНастройка Prisma Data Platform
Чтобы использовать Prisma Data Platform, нам нужно создать и подключить репозиторий GitHub. Итак, давайте инициализируем локальный репозиторий, создадим новый репозиторий на GitHub, добавим удаленный источник и запушим локальный репозиторий.
После этого создайте бесплатную учетную запись Prisma Data Platform.
Кликните “New Project” и выберите “Import a Prisma Repository”.
Он запросит строку подключения PostgreSQL, которая должна быть в вашем .env файле. Скопируйте ее сюда. Затем кликните “Create Project”.
Вы получите новую строку подключения, начинающуюся с prisma://. Давайте присвоим ее DATABASE_URL в вашем .env файле, тем самым заменив нашу строку PostgreSQL из Supabase.
Использование Prisma и PrismaClient
Теперь вы сможете импортировать Prisma и PrismaClient в свой Deno-проект:
import { Prisma, PrismaClient } from "../generated/client/deno/edge.ts";Далее вы можете заполнить свою базу данных, запросить данные и так далее.
Ознакомьтесь с нашим более подробным руководством по использованию Prisma или узнайте, как развернуть Prisma с помощью Deno Deploy.
Mongoose
Mongoose — популярная использующая схему библиотека, которая моделирует данные для MongoDB. Ниже приведено краткое руководство по началу работы с ней.
Вы можете изучить исходный код здесь или посмотреть видеоруководство на нашем YouTube-канале.
Определение модели
Давайте определим модель в Mongoose. В новый файл Dinosaur.ts добавим:
import { model, Schema } from "npm:mongoose@^6.7"; // Определение схемы. const dinosaurSchema = new Schema({ name: { type: String, unique: true }, description: String, createdAt: { type: Date, default: Date.now }, updatedAt: { type: Date, default: Date.now }, }); // Проверки dinosaurSchema.path("name").required(true, "Dinosaur name cannot be blank."); dinosaurSchema.path("description").required( true, "Dinosaur description cannot be blank.", ); // Экспорт модели. export default model("Dinosaur", dinosaurSchema);Создание нового динозавтра
Давайте создадим новый файл main.ts, который будет:
-
подключаться к MongoDB
-
создавать нового
Dinosaur -
извлекать динозавра с именем «Deno»
-
console.logполученного динозавра
import mongoose from "npm:mongoose@^6.7"; import Dinosaur from "./model/Dinosaur.ts"; await mongoose.connect("mongodb://localhost:27017"); // Создание нового динозавра. const deno = new Dinosaur({ name: "Deno", description: "The fastest dinosaur ever lived.", }); // Внедрение deno. await deno.save(); // Поиск по имени Deno. const denoFromMongoDb = await Dinosaur.findOne({ name: "Deno" }); console.log( `Finding Deno in MongoDB -- \n ${denoFromMongoDb.name}: ${denoFromMongoDb.description}`, );Вывод должен быть следующим:
Finding Deno in MongoDB -- Deno: The fastest dinosaur ever lived.Отлично!
Ознакомьтесь с нашим более подробным руководством по работе с Mongoose.
Apollo
Apollo — это GraphQL-сервер, который можно настроить за считанные минуты и использовать с существующим источником данных (или REST API). Вы можете подключить к нему любой GraphQL-клиент, чтобы получить доступ к данным и воспользоваться всеми преимуществами проверки типов и эффективного фетчинга.
Давайте настроим и запустим простой сервер Apollo, который позволит нам запрашивать некоторые локальные данные. Для этого нам понадобятся только три файла:
-
schema.ts, что настроить нашу модель данных, -
resolvers.tsдля настройки того, как мы собираемся заполнять поля данных в нашей схеме -
и наш
main.tsгде будет запускаться сервер.
И начнем мы с их создания:
touch schema.ts resolvers.ts main.tsДавайте разберемся с настройкой каждого из них.
Определяем наши данные с помощью schema.ts
Файл schema.ts описывает наши данные. В данном случае наши данные представляют собой список динозавров. Мы хотим, чтобы наши пользователи могли получить имя и краткое описание каждого динозавра. На языке GraphQL это означает, что Dinosaur — это наш тип, а name (имя) и description (описание) — это наши поля. Мы также можем определить тип данных для каждого поля. В данном случае оба поля будут строками.
Здесь мы также описываем запросы, которые мы разрешаем для наших данных, используя специальный тип Query GraphQL. У нас будут два запроса:
-
dinosaurs, который получает список всех динозавров -
dinosaur, который принимает имя динозавра в качестве аргумента и возвращает информацию об этом типе динозавра
Мы собираемся экспортировать все это в наши typeDefs переменные:
export const typeDefs = ` type Dinosaur { name: String description: String } type Query { dinosaurs: [Dinosaur] dinosaur(name: String): Dinosaur } `;Если бы мы хотели записать данные, нам бы также нужно было описать мутацию для этого. Мутации (Mutation) — это то, как вы записываете данные с помощью GraphQL. Поскольку мы используем здесь статический набор данных, мы не будем писать ничего такого.
Заполнение данными в resolvers.ts
Резолвер отвечает за заполнение данных для каждого запроса. Здесь у нас есть наш список динозавров, и все, что будет делать резолвер, это либо а) передавать весь этот список клиенту, если пользователь формирует запрос dinosaurs, либо б) передавать только одного из них, если пользователь запрашивает dinosaur.
const dinosaurs = [ { name: "Aardonyx", description: "An early stage in the evolution of sauropods.", }, { name: "Abelisaurus", description: '"Abel\'s lizard" has been reconstructed from a single skull.', }, ]; export const resolvers = { Query: { dinosaurs: () => dinosaurs, dinosaur: (_: any, args: any) => { return dinosaurs.find((dinosaur) => dinosaur.name === args.name); }, }, };В последнем случае мы передаем аргументы от клиента в функцию, чтобы сопоставить полученное имя с именем в нашем наборе данных.
Настройка main.ts
В наш main.ts мы будем импортировать ApolloServer, graphql и наши typeDef из схемы и наших резолверов:
import { ApolloServer } from "npm:@apollo/server@^4.1"; import { startStandaloneServer } from "npm:@apollo/server@^4.1/standalone"; import { graphql } from "npm:graphql@^16.6"; import { typeDefs } from "./schema.ts"; import { resolvers } from "./resolvers.ts"; const server = new ApolloServer({ typeDefs, resolvers, }); const { url } = await startStandaloneServer(server, { listen: { port: 8000 }, }); console.log(`Server running on: ${url}`);Мы передаем наши typeDefs и resolvers в ApolloServer, необходимые для запуска нашего нового сервера. Наконец, startStandaloneServer — это вспомогательная функция, позволяющая быстро запустить сервер.
Запуск сервера
Все, что осталось сделать, это запустить сервер:
deno run --allow-net --allow-read --allow-env main.tsВы должны увидеть Server running on: 127.0.0.1:8000 в вашем терминале. Если вы перейдете по этому адресу, вы увидите сэндбокс Apollo, где мы можем ввести наш запрос dinosaurs:
query { dinosaurs { name description } }Это вернет наш набор данных:
{ "data": { "dinosaurs": [ { "name": "Aardonyx", "description": "An early stage in the evolution of sauropods." }, { "name": "Abelisaurus", "description": "\"Abel's lizard\" has been reconstructed from a single skull." } ] } }Или, если нам нужен только один dinosaur:
query { dinosaur(name:"Aardonyx") { name description } }Что возвращает:
{ "data": { "dinosaur": { "name": "Aardonyx", "description": "An early stage in the evolution of sauropods." } } }Потрясающе!
Ознакомьтесь с нашим более подробным руководством по работе с Apollo.
Что дальше?
В этом посте мы продемонстрировали, как начать работу с Prisma, Mongoose и Apollo. У нас также есть руководства по другим npm-модулям хранения данных, таким как PlanetScale, Redis и MySQL2, и мы продолжим добавлять новые.
Что-то не получается? Обращайтесь за помощью в наш Discord.
Приглашаем всех желающих на открытое занятие «Хуки и мемоизация», на котором участники научатся эффективно использовать возможности React.js и избегать лишних рендеров. Регистрация открыта на странице курса «React.js Developer».
ссылка на оригинал статьи https://habr.com/ru/company/otus/blog/712614/
Добавить комментарий