NestJS ਵਿੱਚ controllers ਕੀ ਹਨ?

Question

Accepted Answer

**Controllers** ਆਉਣ ਵਾਲੇ **HTTP requests** ਨੂੰ ਸੰभालਦੇ ਹਨ ਅਤੇ responses ਵਾਪਸ ਕਰਦੇ ਹਨ। ਉਹ ਆਪਣੀ ਅਪਲੀਕੇਸ਼ਨ ਦੇ routes ਨੂੰ ਪਰਿਭਾਸ਼ਿਤ ਕਰਦੇ ਹਨ ਅਤੇ entry point ਵਜੋਂ ਕੰਮ ਕਰਦੇ ਹਨ — requests ਪ੍ਰਾਪਤ ਕਰਦੇ ਹਨ, ਡਾਟਾ ਨਿਕਾਲਦੇ ਹਨ, services ਨੂੰ ਸੌਂਪਦੇ ਹਨ, ਅਤੇ ਨਤੀਜੇ ਵਾਪਸ ਕਰਦੇ ਹਨ। ਉਹ routing ਚਿੰਤਾਵਾਂ ਨੂੰ business logic ਤੋਂ ਵੱਖ ਰੱਖਦੇ ਹਨ।

## ਇੱਕ controller ਨੂੰ ਪਰਿਭਾਸ਼ਿਤ ਕਰਨਾ

```ts
import { Controller, Get, Post, Body, Param } from "@nestjs/common";

@Controller("users")          // the route PREFIX → all routes start with /users
export class UsersController {
  constructor(private usersService: UsersService) {}   // inject a service via DI

@Get()                       // GET /users
  findAll() {
    return this.usersService.findAll();
  }

@Get(":id")                  // GET /users/:id
  findOne(@Param("id") id: string) {        // extract the route param
    return this.usersService.findOne(id);
  }

@Post()                      // POST /users
  create(@Body() dto: CreateUserDto) {       // extract the request body
    return this.usersService.create(dto);
  }
}
```

## ਇਹ ਕਿਵੇਂ ਕੰਮ ਕਰਦਾ ਹੈ: decorators methods ਨੂੰ routes ਤਕ ਮੈਪ ਕਰਦੇ ਹਨ

```text
@Controller("users") → route prefix /users
@Get() / @Post() / @Put() / @Patch() / @Delete() → HTTP method + sub-path
Combined: @Get(":id") inside @Controller("users") → GET /users/:id
```

Decorators ਕਲਾਸ methods ਨੂੰ declaratively HTTP routes ਨਾਲ ਬੰਨ੍ਹਦੇ ਹਨ — ਸਾਫ਼ ਅਤੇ ਪੜ੍ਹਨਯੋਗ, ਕੋਈ ਦਸਤੀ route registration ਨਹੀਂ।

## Parameter decorators request data ਨਿਕਾਲਦੇ ਹਨ

```ts
@Get(":id")
example(
  @Param("id") id: string,        // route parameter (/users/:id)
  @Query("sort") sort: string,    // query string (?sort=name)
  @Body() body: CreateUserDto,    // request body
  @Headers("authorization") auth: string,  // a header
  @Req() req: Request,            // the raw request object (rarely needed)
) {}
```

Nest ਦੇ parameter decorators (`@Param`, `@Query`, `@Body`, `@Headers`) ਸਾਫ਼ੇ ਤੌਰ ਤੇ ਬਿਲਕੁਲ ਉਹੀ ਡਾਟਾ ਨਿਕਾਲਦੇ ਹਨ ਜਿਸ ਦੀ ਤੁਹਾਨੂੰ ਲੋੜ ਹੈ — `req` ਦੀ ਕੋਈ ਦਸਤੀ parsing ਨਹੀਂ।

## Controllers ਬਾਰੀਕ ਹੋਣੇ ਚਾਹੀਦੇ ਹਨ

```ts
// ✅ controller delegates to a service — stays thin
@Post()
create(@Body() dto: CreateUserDto) {
  return this.usersService.create(dto);   // business logic lives in the SERVICE
}
// ❌ don't put database queries / business logic directly in the controller
```

ਸਰਵਓਤਮ ਅਭਿਆਸ: controllers ਨੂੰ **ਬਾਰੀਕ** ਰੱਖੋ — ਉਹ HTTP ਚਿੰਤਾਵਾਂ (routing, ਡਾਟਾ ਨਿਕਾਲਨਾ, responses ਵਾਪਸ ਕਰਨਾ) ਨੂੰ ਸੰभालਦੇ ਹਨ ਅਤੇ ਸਾਰੀ business logic ਨੂੰ **services** ਤਕ ਸੌਂਪਦੇ ਹਨ। ਇਹ ਵੱਖਰਨ ਕੋਡ ਨੂੰ testable ਅਤੇ ਸੰਗਠਿਤ ਰੱਖਦਾ ਹੈ।

## ਇਹ ਮਹੱਤਵਪੂਰਨ ਕਿਉਂ ਹੈ

Controllers ਇੱਕ ਬੁਨਿਆਦੀ NestJS ਬਲਾਕ ਹਨ — ਸਾਰੇ HTTP requests ਲਈ entry point ਅਤੇ ਜਿੱਥੇ ਤੁਹਾਡੇ API ਦੇ routes ਨਿਰਧਾਰਤ ਹਨ।

ਇਹ ਸਮਝਣਾ ਕਿ ਕਿਵੇਂ decorators (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) methods ਨੂੰ routes ਤਕ ਮੈਪ ਕਰਦੇ ਹਨ ਅਤੇ request data ਨੂੰ declaratively ਨਿਕਾਲਦੇ ਹਨ ਇੱਕ ਜ਼ਰੂਰੀ ਰੋਜ਼ਮਰੀ ਦਾ NestJS ਗਿਆਨ ਹੈ — ਇਹ ਹੈ ਕਿ ਤੁਸੀਂ ਕਿਸੇ ਵੀ endpoint ਨੂੰ ਕਿਵੇਂ ਬਣਾਉਂਦੇ ਹੋ।

ਬਰਾਬਰ ਮਹੱਤਵਪੂਰਨ controllers ਨੂੰ **ਬਾਰੀਕ** ਰੱਖਣ ਦਾ ਸਿਧਾਂਤ ਹੈ (ਸਿਰਫ HTTP ਚਿੰਤਾਵਾਂ ਨੂੰ ਸੰभालਦੇ ਹੋਏ ਅਤੇ business logic ਨੂੰ injected services ਵਿੱਚ ਸੌਂਪਦੇ ਹੋਏ), ਜੋ NestJS ਦੇ separation-of-concerns ਦਰਸ਼ਨ ਨੂੰ ਪ੍ਰਤਿਬਿੰਬਿਤ ਕਰਦਾ ਹੈ ਅਤੇ ਕੋਡ ਨੂੰ ਕਾਰਜ ਅਤੇ testable ਰੱਖਦਾ ਹੈ।

Controllers, services ਅਤੇ modules ਦੇ ਨਾਲ, ਹਰੇਕ NestJS ਐਪਲੀਕੇਸ਼ਨ ਦੀ ਮੂਲ ਢਾਂਚਾ ਬਣਾਉਂਦੇ ਹਨ, ਜੋ ਉਨ੍ਹਾਂ ਨੂੰ ਸ਼ੁਰੂਆਤ ਤੋਂ ਪਰਤ ਕਰਨ ਲਈ ਜ਼ਰੂਰੀ ਬਣਾਉਂਦਾ ਹੈ।