MongoDB for Web Developers

## Why MongoDB? MongoDB is a document-oriented NoSQL database that stores data as flexible JSON-like documents. For web developers, this means your application objects map naturally to database records without an impedance mismatch. Unlike relational databases, MongoDB lets you evolve your schema as your application grows, making it ideal for rapid iteration and agile development cycles. ## Connecting from Node.js The official MongoDB driver and Mongoose ODM are the most common ways to interact with MongoDB from Node.js applications. ```javascript // Using the official MongoDB driver import { MongoClient } from "mongodb"; const client = new MongoClient(process.env.MONGODB_URI); async function connect() { try { await client.connect(); const db = client.db("myapp"); console.log("Connected to MongoDB"); return db; } catch (err) { console.error("Connection failed:", err); process.exit(1); } } ``` ```javascript // Using Mongoose for schema-based modeling import mongoose from "mongoose"; const userSchema = new mongoose.Schema({ name: { type: String, required: true }, email: { type: String, required: true, unique: true }, role: { type: String, enum: ["admin", "user", "moderator"], default: "user" }, profile: { avatar: String, bio: String, socialLinks: [{ platform: String, url: String }] }, createdAt: { type: Date, default: Date.now } }); const User = mongoose.model("User", userSchema); ``` ## Document Modeling Strategies MongoDB offers two primary strategies for organizing related data-removed: embedding and referencing. ### Embedding (Denormalization) Embed related data within a single document when the data is frequently accessed together and grows in a bounded way. ```javascript // Blog post with embedded comments const postSchema = new mongoose.Schema({ title: { type: String, required: true }, content: String, author: { type: mongoose.Schema.Types.ObjectId, ref: "User" }, comments: [ { user: { type: mongoose.Schema.Types.ObjectId, ref: "User" }, text: String, likes: [mongoose.Schema.Types.ObjectId], createdAt: { type: Date, default: Date.now } } ] }); ``` ### Referencing (Normalization) Reference other documents when the related data is large, unbounded, or accessed independently. ```javascript // Separate collections with references const orderSchema = new mongoose.Schema({ customer: { type: mongoose.Schema.Types.ObjectId, ref: "Customer", required: true }, items: [ { product: { type: mongoose.Schema.Types.ObjectId, ref: "Product" }, quantity: Number, unitPrice: Number } ], totalAmount: Number, status: { type: String, enum: ["pending", "shipped", "delivered"], default: "pending" } }); ``` ## Querying Data MongoDB's query API is expressive and supports complex operations directly in the database. ```javascript // Find active users with pagination const users = await User.find({ role: "user" }) .sort({ createdAt: -1 }) .skip(0) .limit(20) .select("name email profile.avatar"); // Aggregation pipeline: top 5 customers by order total const topCustomers = await Order.aggregate([ { $match: { status: "delivered" } }, { $group: { _id: "$customer", totalSpent: { $sum: "$totalAmount" } } }, { $sort: { totalSpent: -1 } }, { $limit: 5 }, { $lookup: { from: "customers", localField: "_id", foreignField: "_id", as: "customer" } }, { $unwind: "$customer" }, { $project: { name: "$customer.name", totalSpent: 1 } } ]); ``` ## Indexing for Performance Without proper indexes, MongoDB performs full collection scans. Strategic indexing is critical for performance. ```javascript // Create a compound index for common query patterns await Order.collection.createIndex({ customer: 1, createdAt: -1 }); // Text search index await Post.collection.createIndex({ title: "text", content: "text" }); // Sparse index: only index documents that have the field await User.collection.createIndex({ "profile.avatar": 1 }, { sparse: true }); // Unique index for email validation at the database level await User.collection.createIndex({ email: 1 }, { unique: true }); ``` ## Transactions MongoDB supports multi-document ACID transactions, essential for operations that must be atomic. ```javascript const session = await client.startSession(); try { await session.withTransaction(async () => { // Debit buyer's wallet await Wallet.updateOne( { userId: buyerId, balance: { $gte: amount } }, { $inc: { balance: -amount } }, { session } ); // Credit seller's wallet await Wallet.updateOne( { userId: sellerId }, { $inc: { balance: amount } }, { session } ); // Record the transfer await Transfer.create([{ from: buyerId, to: sellerId, amount, timestamp: new Date() }], { session }); }); } finally { await session.endSession(); } ``` ## Working with ORMs and ODMs Tools like Prisma and Mongoose provide schema validation, type safety, and migration workflows on top of MongoDB. ```typescript // Prisma schema for MongoDB // schema.prisma generator client { provider = "prisma-client-js" } datasource db { provider = "mongodb" url = env("DATABASE_URL") } model Post { id String @id @default(auto()) @map("_id") @db.ObjectId title String content String? published Boolean @default(false) author User @relation(fields: [authorId], references: [id]) authorId String @db.ObjectId tags String[] @@index([authorId]) } ``` ## Aggregation Pipeline Patterns The aggregation framework is MongoDB's most powerful analytical tool. ```javascript // E-commerce analytics: monthly revenue by category const m Product.aggregate([ { $lookup: { from: "orders", localField: "_id", foreignField: "items.product", as: "orders" } }, { $unwind: "$orders" }, { $unwind: "$orders.items" }, { $group: { _id: { category: "$category", month: { $month: "$orders.createdAt" }, year: { $year: "$orders.createdAt" } }, revenue: { $sum: { $multiply: ["$orders.items.quantity", "$orders.items.unitPrice"] } } } }, { $sort: { "_id.year": 1, "_id.month": 1, revenue: -1 } } ]); ``` ## Best Practices - Design your schema around your query patterns, not your data entities. - Use projection to return only the fields your application needs. - Monitor slow queries with `db.collection.explain()` and the MongoDB Atlas performance advisor. - Set connection pool sizes appropriately for your serverless or long-running environment. - Use change streams for real-time features like notifications and live dashboards. ## Next Steps Explore MongoDB Atlas for managed hosting, Change Streams for real-time event processing, and Time Series Collections for IoT and analytics workloads. For schema validation and type safety in TypeScript, consider pairing MongoDB with Prisma.