ఆన్-డిమాండ్ రీవాలిడేషన్ (ISR) ఎలా పనిచేస్తుంది?

Question

Accepted Answer

**ఆన్-డిమాండ్ రీవాలిడేషన్** మీకు **డేటా మారినప్పుడు సరిగ్గా ক్యాష్‌ చేసిన/స్టాటిక్ పేజీలను చెల్లంగా చేయడానికి** అనుమతిస్తుంది — సమయ-ఆధారిత విరామం కోసం సమయం చేయడానికి బదులుగా. ఇది సమయ-ఆధారిత ISR (`revalidate: N`) కు సరిగ్గా పూరక.

## సమయ-ఆధారిత vs ఆన్-డిమాండ్

```tsx
// Time-based: page refreshes on a fixed schedule (may serve stale data up to N seconds)
export const revalidate = 3600; // every hour

// On-demand: refresh the INSTANT the underlying data changes — no waiting, no waste
```

సమయ-ఆధారిత ISR సరళమైనది కానీ అసంపూర్ణమైనది: చాలా చిన్నది = అనవసర పునరుత్పత్తి; చాలా పొడవు = పాతన సামగ్రి. ఆన్-డిమాండ్ మీ సొంత కోడ్ నుండి పునరుద్ధారణను ట్రిగర్ చేయడం ద్వారా దీనిని సరిచేస్తుంది మార్పు వాస్తవానికి సంభవించినప్పుడు.

## రెండు ఆన్-డిమాండ్ API

```tsx
import { revalidatePath, revalidateTag } from "next/cache";

// 1. Tag your fetches, then invalidate by tag
await fetch("https://api/posts", { next: { tags: ["posts"] } });
revalidateTag("posts");      // refresh EVERY page/fetch tagged "posts"

// 2. Or invalidate a specific path
revalidatePath("/blog/my-post");
```

## ఒక నిజమైన వర్క్‌ఫ్లో: CMS webhook

```ts
// app/api/revalidate/route.ts — called by your CMS when an editor publishes
import { revalidateTag } from "next/cache";
import { NextRequest, NextResponse } from "next/server";

export async function POST(req: NextRequest) {
  const secret = req.nextUrl.searchParams.get("secret");
  if (secret !== process.env.REVALIDATE_SECRET) {       // verify it's really your CMS
    return NextResponse.json({ ok: false }, { status: 401 });
  }
  revalidateTag("posts");                                // rebuild affected pages now
  return NextResponse.json({ revalidated: true });
}
```

ప్రవాహం: సంపాదకుడు CMS లో ప్రచురిస్తాడు → CMS మీ webhook కు కాల్ చేస్తుంది → `revalidateTag("posts")` క్యాష్‌ను చెల్లంగా చేస్తుంది → తరువాతి సందర్శకుడు ताజా పునర్నిర్మితమైన స్టాటిక్ HTML ను పొందుతాడు. పేజీలు స్టాటిక్-వేగవంతమైనవిగా **మరియు** ప్రచురణ వద్ద వెంటనే తాజాకరించబడతాయి.

## Server Action మ్యూటేషన్ తర్వాత

```tsx
"use server";
export async function createPost(data) {
  await db.post.create({ data });
  revalidateTag("posts"); // user sees their new post immediately
}
```

## ఎందుకు ఇది ముఖ్యమైనది

ఆన్-డిమాండ్ రీవాలిడేషన్ మీకు పవిత్ర గ్రేల్ ఇస్తుంది: **స్టాటిక్ పనితీరు రియల్-టైమ్ తాజాతనతో**.

పునరుద్ధారణ విరామం ఊహించిన బదులుగా, సమగ్రి మార్పుల సమయంలో సరిగ్గా చెల్లంగా చేస్తారు — webhooks (CMS ప్రచురణ) లేదా Server Action మ్యూటేషన్‌ల తర్వాత — `revalidateTag`/`revalidatePath` ను ఉపయోగించి.

ఇది పాతన సామగ్రి మరియు బహుమతి-పునరుత్పత్తిని రద్దు చేస్తుంది, ISR ను అనూహ్యంగా నవీకరించే సామగ్రి కోసం ఆచరణీయమైనదిగా చేస్తుంది.