Controller pattern for route handlers in Express

Introduction

The controller pattern helps organize your code by separating route logic from business logic. This makes your app easier to read and maintain.

When your Express app has many routes and you want to keep code clean.

When you want to reuse logic across different routes.

When you want to test route logic separately from routing setup.

When you want to keep route files simple and focused on routing only.

Syntax

Express

const controller = {
  methodName: (req, res) => {
    // handle request
    res.send('response');
  }
};

app.get('/route', controller.methodName);

Controllers are usually objects with methods for each route action.

Route files import controllers and assign methods as handlers.

Examples

Example of a controller with two methods for GET and POST routes.

Express

const userController = {
  getUser: (req, res) => {
    res.send('User data');
  },
  createUser: (req, res) => {
    res.send('User created');
  }
};

app.get('/user', userController.getUser);
app.post('/user', userController.createUser);

Simple controller function used directly as route handler.

Express

function getProduct(req, res) {
  res.send('Product info');
}

app.get('/product', getProduct);

Sample Program

This Express app uses a controller object to handle two routes: one to list products and one to show product details by ID.

Express

import express from 'express';
const app = express();

const productController = {
  list: (req, res) => {
    res.send('List of products');
  },
  detail: (req, res) => {
    const id = req.params.id;
    res.send(`Details of product ${id}`);
  }
};

app.get('/products', productController.list);
app.get('/products/:id', productController.detail);

app.listen(3000, () => {
  console.log('Server running on http://localhost:3000');
});

Important Notes

Controllers keep your route files clean and focused on routing only.

Use descriptive method names in controllers for clarity.

Controllers make testing easier by isolating logic from routing.

Summary

The controller pattern separates route handling logic from routing setup.

It improves code organization and readability.

Controllers help reuse logic and simplify testing.

Practice

1. What is the main purpose of using the controller pattern in Express route handlers?

easy

A. To separate route logic from routing setup for better organization

B. To combine all route handlers into a single file

C. To directly write SQL queries inside route handlers

D. To avoid using middleware functions in routes

Solution

1. Step 1: Understand the controller pattern concept

   The controller pattern means moving the logic that handles requests out of the route definitions into separate functions or files.

2. Step 2: Identify the benefit of separation

   This separation improves code organization, making it easier to read and maintain.

3. Final Answer:

   To separate route logic from routing setup for better organization -> Option A

4. Quick Check:

   Controller pattern = separation of concerns [OK]

Hint: Controllers keep route files clean and logic separate [OK]

Common Mistakes:

• Thinking controllers combine all routes in one file
• Believing controllers write database queries directly
• Confusing controllers with middleware avoidance

2. Which of the following is the correct way to import and use a controller function named getUser in an Express route?

easy

A. router.get('/user', getUser());

B. router.get('/user', () => getUser);

C. router.get('/user', getUser => {});

D. router.get('/user', getUser);

Solution

1. Step 1: Understand how to pass controller functions

   In Express, route handlers expect a function reference, not the result of calling the function.

2. Step 2: Identify correct syntax

   Passing getUser without parentheses passes the function itself. Using parentheses calls it immediately, which is incorrect here.

3. Final Answer:

   router.get('/user', getUser); -> Option D

4. Quick Check:

   Pass function reference without () [OK]

Hint: Pass controller as function reference, no parentheses [OK]

Common Mistakes:

• Calling the controller function immediately with ()
• Using arrow functions incorrectly wrapping the controller
• Returning the function instead of calling it

3. Given this controller function and route setup, what will be the response when a GET request is made to /hello?

const sayHello = (req, res) => {
  res.send('Hello from controller!');
};

router.get('/hello', sayHello);

medium

A. Hello from controller!

B. Error: sayHello is not a function

C. No response, request hangs

D. 404 Not Found

Solution

1. Step 1: Analyze the controller function behavior

   The sayHello function sends a plain text response 'Hello from controller!' when called.

2. Step 2: Check route setup correctness

   The route uses sayHello correctly as the handler for GET requests to '/hello'.

3. Final Answer:

   Hello from controller! -> Option A

4. Quick Check:

   Controller sends response text [OK]

Hint: Controller sends response, route calls it correctly [OK]

Common Mistakes:

• Forgetting to call res.send inside controller
• Passing controller incorrectly causing runtime error
• Misreading route path causing 404

4. Identify the error in this Express controller pattern usage:

const userController = {
  getUser: (req, res) => {
    res.json({ name: 'Alice' });
  }
};

router.get('/user', userController.getUser());

medium

A. res.json should be res.send

B. Missing import statement for router

C. Calling userController.getUser() immediately instead of passing function

D. Route path should be '/users' not '/user'

Solution

1. Step 1: Check how controller function is passed

   The code calls userController.getUser() immediately, which runs the function and passes its result, not the function itself.

2. Step 2: Understand correct usage

   Express expects a function reference as the route handler, so it should be userController.getUser without parentheses.

3. Final Answer:

   Calling userController.getUser() immediately instead of passing function -> Option C

4. Quick Check:

   Pass function reference, not call it [OK]

Hint: Don't add () when passing controller to route [OK]

Common Mistakes:

• Calling controller function instead of passing it
• Confusing res.json and res.send (both valid here)
• Assuming route path naming causes error

5. You want to organize your Express app using the controller pattern. You have multiple routes for users: getUser, createUser, and deleteUser. Which approach best follows the controller pattern for clean code?

hard

A. Put all route definitions and logic inside a single routes.js file without controllers

B. Define all user-related functions in a separate userController.js file and import them in the router file

C. Write all user route handlers directly inside the main app.js file

D. Use inline anonymous functions for each route in the router file

Solution

1. Step 1: Understand controller pattern best practice

   Controllers group related route logic into separate files or modules to keep code organized and reusable.

2. Step 2: Evaluate options for clean code

   Defining all user-related functions in a dedicated userController.js file and importing them into the router file follows the pattern well.

3. Final Answer:

   Define all user-related functions in a separate userController.js file and import them in the router file -> Option B

4. Quick Check:

   Separate logic into controller files [OK]

Hint: Group related handlers in controller files, import in routes [OK]

Common Mistakes:

• Putting all logic in main app file making it messy
• Mixing routes and logic in one file without separation
• Using anonymous functions inline reduces reusability