Why Route handlers (GET, POST, PUT, DELETE) in NestJS? - Purpose & Use Cases

The Big Idea

Discover how simple decorators can save you hours of messy code and bugs!

The Scenario

Imagine building a web app where you manually check the URL and HTTP method for every request to decide what to do.

You write long if-else chains to handle GET, POST, PUT, and DELETE requests all mixed together.

The Problem

This manual approach quickly becomes messy and hard to maintain.

It's easy to make mistakes, forget to handle some methods, or mix logic for different actions.

Debugging and adding new routes takes a lot of time and effort.

The Solution

Route handlers in NestJS let you clearly separate logic for GET, POST, PUT, and DELETE requests using simple decorators.

This keeps your code organized, easy to read, and maintain.

Each handler focuses on one task, making your app more reliable and scalable.

Before vs After

✗ Before

if (req.method === 'GET' && req.url === '/items') { /* get items */ } else if (req.method === 'POST' && req.url === '/items') { /* add item */ }

✓ After

@Get('/items')
getItems() { /* get items */ }
@Post('/items')
addItem() { /* add item */ }

What It Enables

You can build clean, maintainable APIs that clearly separate different actions by HTTP method.

Real Life Example

Think of an online store backend where GET fetches products, POST adds new products, PUT updates product details, and DELETE removes products.

Key Takeaways

Manual request handling is confusing and error-prone.

Route handlers organize code by HTTP methods with clear decorators.

This makes APIs easier to build, read, and maintain.

Practice

1. Which decorator is used in NestJS to create a route handler that responds to HTTP GET requests?

easy

A. @Get

B. @Post

C. @Put

D. @Delete

Solution

1. Step 1: Understand HTTP methods and their decorators

   In NestJS, each HTTP method has a specific decorator: @Get for GET, @Post for POST, @Put for PUT, and @Delete for DELETE.

2. Step 2: Match the decorator to the GET method

   The decorator @Get is specifically designed to handle HTTP GET requests.

3. Final Answer:

   @Get -> Option A

4. Quick Check:

   GET method uses @Get decorator [OK]

Hint: GET requests use @Get decorator in NestJS [OK]

Common Mistakes:

• Confusing @Post or @Put with @Get
• Using @Delete for GET requests
• Not using any decorator

2. Which of the following is the correct syntax to define a POST route handler in a NestJS controller?

easy

A. @Post('/create') createItem() {}

B. Post('/create') createItem() {}

C. @post('/create') createItem() {}

D. @Put('/create') createItem() {}

Solution

1. Step 1: Check the decorator syntax

   Decorators in NestJS start with '@' and are case-sensitive. The correct decorator for POST is '@Post'.

2. Step 2: Verify the route path and method name

   The route path '/create' is correctly passed as a string argument, and the method name is valid.

3. Final Answer:

   @Post('/create') createItem() {} -> Option A

4. Quick Check:

   Correct decorator syntax uses '@Post' with parentheses [OK]

Hint: Decorators start with '@' and are case-sensitive [OK]

Common Mistakes:

• Missing '@' before decorator
• Using lowercase '@post' instead of '@Post'
• Using wrong decorator like '@Put' for POST

3. Given the following NestJS controller code, what will be the HTTP method and route path to access the handler?

@Controller('users')
export class UserController {
  @Put(':id')
  updateUser() {
    return 'User updated';
  }
}

medium

A. GET /users/:id

B. DELETE /users/:id

C. PUT /users/:id

D. POST /users/:id

Solution

1. Step 1: Identify the controller base path

   The @Controller('users') decorator sets the base route path to '/users'.

2. Step 2: Identify the route handler method and path

   The @Put(':id') decorator means this handler responds to HTTP PUT requests at the path '/users/:id', where ':id' is a route parameter.

3. Final Answer:

   PUT /users/:id -> Option C

4. Quick Check:

   @Put with ':id' means PUT method at /users/:id [OK]

Hint: Decorator @Put means HTTP PUT method [OK]

Common Mistakes:

• Confusing @Put with @Get or @Post
• Ignoring the controller base path
• Misreading ':id' as a literal string

4. What is wrong with this NestJS route handler code?

@Controller('items')
export class ItemController {
  @Delete('/remove')
  removeItem() {
    console.log('Item removed');
  }
}

medium

A. The method name must be 'deleteItem' for @Delete decorator

B. The decorator @Delete cannot have a path argument

C. The controller path 'items' is invalid

D. The method should return a value, not just console.log

Solution

1. Step 1: Check the decorator and path usage

   @Delete can have a path argument like '/remove', so this is valid.

2. Step 2: Check the method implementation

   The method only logs to console but does not return any response. HTTP handlers should return a response to the client.

3. Final Answer:

   The method should return a value, not just console.log -> Option D

4. Quick Check:

   Route handlers must return a response [OK]

Hint: Route handlers must return a response, not just log [OK]

Common Mistakes:

• Assuming console.log sends response
• Thinking decorator cannot have path
• Believing method name must match decorator

5. You want to create a NestJS controller with a route handler that updates a product by its ID using HTTP PUT. The handler should accept the ID as a route parameter and the updated data in the request body. Which code snippet correctly implements this?

hard

A. @Put updateProduct(@Param('id') id: string, @Body() data: any) { return `Updated product ${id}`; }

B. @Put(':id') updateProduct(@Param('id') id: string, @Body() data: any) { return `Updated product ${id}`; }

C. @Put(':id') updateProduct(id: string, data: any) { return `Updated product ${id}`; }

D. @Post(':id') updateProduct(@Param('id') id: string, @Body() data: any) { return `Updated product ${id}`; }

Solution

1. Step 1: Use the correct HTTP method and route parameter

   Updating a resource uses HTTP PUT, so @Put(':id') is correct to capture the ID as a route parameter.

2. Step 2: Use parameter decorators to access route and body data

   @Param('id') extracts the ID from the route, and @Body() extracts the request body data. Both are required for this handler.

3. Step 3: Check method signature and return

   The method correctly returns a string confirming the update with the ID.

4. Final Answer:

   @Put(':id') updateProduct(@Param('id') id: string, @Body() data: any) { return `Updated product ${id}`; } -> Option B

5. Quick Check:

   Use @Put with ':id' and @Param plus @Body [OK]

Hint: Use @Put(':id') with @Param and @Body for updates [OK]

Common Mistakes:

• Missing route parameter in @Put decorator
• Not using @Param or @Body decorators
• Using wrong HTTP method like @Post for update