मिडलवेयर सॉफ्टवेयर घटक हैं जो एप्लिकेशन पाइपलाइन में असेंबल होकर रिक्वेस्ट और रिस्पॉन्स को हैंडल करते हैं। प्रत्येक घटक तय करता है कि रिक्वेस्ट को पाइपलाइन में अगले घटक पर पास करना है या नहीं, और अगले घटक के इनवोक होने से पहले और बाद में कुछ कार्य कर सकता है।
Map एक्सटेंशन - पाइपलाइन ब्रांचिंग
Map एक्सटेंशन का उपयोग रिक्वेस्ट के पथ के आधार पर रिक्वेस्ट डेलीगेट्स को मैच करने के लिए किया जाता है। Map केवल एक पथ और एक फंक्शन स्वीकार करता है जो एक अलग मिडलवेयर पाइपलाइन कॉन्फिगर करता है।
Map() का मूल उदाहरण
private static void HandleMapTest(IApplicationBuilder app)
{
app.Run(async context =>
{
await context.Response.WriteAsync("Map Test Successful");
});
}
public void ConfigureMapping(IApplicationBuilder app)
{
// /maptest से शुरू होने वाली सभी रिक्वेस्ट HandleMapTest द्वारा हैंडल होंगी
app.Map("/maptest", HandleMapTest);
// मुख्य पाइपलाइन जारी रहती है
app.Run(async context => await context.Response.WriteAsync("Main Pipeline"));
}
MapWhen() - प्रेडिकेट-आधारित ब्रांचिंग
MapWhen मेथड प्रेडिकेट-आधारित मिडलवेयर ब्रांचिंग को सपोर्ट करता है, जिससे बहुत लचीले तरीके से अलग पाइपलाइन्स बनाई जा सकती हैं। Func<HttpContext, bool> टाइप का कोई भी प्रेडिकेट रिक्वेस्ट को पाइपलाइन की नई ब्रांच पर मैप करने के लिए उपयोग किया जा सकता है।
private static void HandleBranch(IApplicationBuilder app)
{
app.Run(async context =>
{
await context.Response.WriteAsync("Branch used.");
});
}
public void ConfigureMapWhen(IApplicationBuilder app)
{
// क्वेरी स्ट्रिंग में "branch" पैरामीटर होने पर ब्रांच करें
app.MapWhen(context => context.Request.Query.ContainsKey("branch"), HandleBranch);
// डिफ़ॉल्ट पाइपलाइन
app.Run(async context => await context.Response.WriteAsync("Main Pipeline"));
}
नेस्टेड Maps
Maps को नेस्ट भी किया जा सकता है:
app.Map("/level1", level1App =>
{
level1App.Map("/level2a", level2AApp =>
{
// "/level1/level2a" पथ को हैंडल करता है
level2AApp.Run(async context => await context.Response.WriteAsync("Level 2A"));
});
level1App.Map("/level2b", level2BApp =>
{
// "/level1/level2b" पथ को हैंडल करता है
level2BApp.Run(async context => await context.Response.WriteAsync("Level 2B"));
});
// /level1 पर लेकिन /level2a या /level2b नहीं
level1App.Run(async context => await context.Response.WriteAsync("Level 1 Root"));
});
MapExtensions का उपयोग कब करें
| परिदृश्य | उपयोग |
|---|---|
| एडमिन एरिया | app.Map("/admin", ...) - अलग ऑथ/मिडलवेयर |
| API वर्जनिंग | app.Map("/api/v1", ...) vs app.Map("/api/v2", ...) |
| हेल्थ चेक्स | app.Map("/health", ...) - हल्का, कोई ऑथ नहीं |
| सिग्नलआर हब्स | app.Map("/hubs", ...) - वेबसॉकेट मिडलवेयर |
| शर्त-आधारित रूटिंग | app.MapWhen(ctx => ctx.Request.Headers["X-Custom"] == "value", ...) |
Map() vs Use() vs Run()
| मेथड | उद्देश्य | पाइपलाइन व्यवहार |
|---|---|---|
Use() | मिडलवेयर चेन करना | इनलाइन - अगले को कॉल करता है |
Run() | टर्मिनल हैंडलर | पाइपलाइन समाप्त करता है |
Map() | पथ-आधारित ब्रांच | अलग सब-पाइपलाइन बनाता है |
MapWhen() | प्रेडिकेट-आधारित ब्रांच | शर्त के आधार पर सब-पाइपलाइन |
व्यावहारिक उदाहरण: मल्टी-टेनेंसी
public void Configure(IApplicationBuilder app)
{
// टेनेंट-आधारित ब्रांचिंग
app.MapWhen(context =>
{
var host = context.Request.Host.Host;
return host.StartsWith("tenant1.");
}, tenant1App =>
{
tenant1App.UseMiddleware();
tenant1App.Run(async ctx => await ctx.Response.WriteAsync("Tenant 1"));
});
app.MapWhen(context =>
{
var host = context.Request.Host.Host;
return host.StartsWith("tenant2.");
}, tenant2App =>
{
tenant2App.UseMiddleware();
tenant2App.Run(async ctx => await ctx.Response.WriteAsync("Tenant 2"));
});
// डिफ़ॉल्ट
app.Run(async context => await context.Response.WriteAsync("Default Tenant"));
}
नोट: Map और MapWhen दिए गए पथ/शर्त से मेल खाने पर रिक्वेस्ट पथ से मिलान किया गया सेगमेंट हटा देते हैं, इसलिए ब्रांच की गई पाइपलाइन शेष पथ देखती है।