Yönlendirme ve Ara Katman Yazılımı
Worker API'nizi düzenlemek ve geliştirmek için yönlendirme kitaplıklarından ve ara katman yazılımı kalıplarından yararlanın.
Yönlendirme ve Ara Katman Yazılımı, CoddyKit'te ücretsiz bir Edge Computing with Cloudflare Workers & Deno dersidir. Bu, 3 dersinin 2. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, Edge Computing with Cloudflare Workers & Deno öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. Edge Computing with Cloudflare Workers & Deno kursu toplamda 3 dersten oluşur.
Bu dersin bazı bölümleri henüz çevrilmemiş olup İngilizce olarak gösterilmektedir.
API Routing Essentials
When building APIs, we need a way to direct incoming requests to the correct functions based on their URL path and HTTP method (GET, POST, etc.). This process is called routing.
Think of it like a receptionist for your API. When a request comes in, the router checks its destination and sends it to the right department (your code handler).
Manual Worker Routing
In a Cloudflare Worker, all incoming requests are handled by the fetch event listener. You can manually inspect the request's URL and method to decide what to do.
While possible for simple cases, this approach quickly becomes complex and hard to manage as your API grows.
export default {
async fetch(request) {
const url = new URL(request.url);
if (url.pathname === '/hello' && request.method === 'GET') {
return new Response('Hello from manual route!');
}
return new Response('Not Found', { status: 404 });
}
}Introducing itty-router
To simplify routing, we use lightweight libraries. For Cloudflare Workers, itty-router is a popular choice. It's tiny, fast, and designed for the edge.
It provides a clean, expressive way to define routes and handlers, making your Worker code much more organized.
Basic GET Routes
With itty-router, you can define routes using methods like router.get() for GET requests. Each route takes a path and a handler function.
Let's create a simple Worker that responds to / and /greet.
import { Router } from 'itty-router';
const router = Router();
router.get('/', () => new Response('Welcome to the API!'));
router.get('/greet', () => new Response('Hello there!'));
export default {
fetch: router.handle
};Handling All HTTP Methods
itty-router allows you to define routes for specific HTTP methods like .post(), .put(), .delete(), and more.
You can also use .all() to match any HTTP method for a given path, useful for middleware or generic handlers.
import { Router } from 'itty-router';
const router = Router();
router.get('/data', () => new Response('GET data'));
router.post('/data', () => new Response('POST data', { status: 201 }));
router.all('*', () => new Response('Method Not Allowed', { status: 405 }));
export default {
fetch: router.handle
};Dynamic Route Parameters
Often, you need to extract dynamic values from the URL, like an item ID or a username. These are called route parameters.
itty-router uses a colon (:) to define parameters in a route path. The values are then available in the handler's request.params object.
import { Router } from 'itty-router';
const router = Router();
router.get('/users/:id', ({ params }) => {
return new Response(`Fetching user ${params.id}`);
});
export default {
fetch: router.handle
};What is Middleware?
Middleware functions are code snippets that run before or after your main route handler. They can modify the request, perform logging, check authentication, or add headers to the response.
They act as a pipeline, allowing you to add common functionalities across multiple routes without duplicating code.
Implementing Simple Middleware
With itty-router, middleware can be added to specific routes or globally. A middleware function receives the request and can return a response (ending the chain) or continue to the next handler.
Let's add a simple logging middleware that runs for every request.
import { Router } from 'itty-router';
const router = Router();
const loggerMiddleware = async (request, event) => {
console.log(`Request: ${request.method} ${request.url}`);
// To proceed to the next handler, don't return a Response.
// If you return a Response, the chain stops.
};
router.all('*', loggerMiddleware);
router.get('/hello', () => new Response('Hello from route!'));
export default {
fetch: router.handle
};Chaining Middleware
You can chain multiple middleware functions. Each middleware executes in order. If a middleware doesn't return a response, the next one in the chain (or the final route handler) is called.
This allows for powerful, modular processing of requests, like authentication, data parsing, and logging.
import { Router } from 'itty-router';
const router = Router();
const authMiddleware = async (request) => {
if (request.headers.get('Authorization') !== 'Bearer token123') {
return new Response('Unauthorized', { status: 401 });
}
};
const headerMiddleware = async (request, event) => {
// Add a custom header to the response later
event.response = new Response('', { headers: { 'X-Powered-By': 'CoddyKit' } });
};
router.get('/secure', authMiddleware, (request) => {
return new Response('Access granted!');
});
router.get('/info', headerMiddleware, (request) => {
return new Response('Info page');
});
export default {
fetch: async (request, env, ctx) => {
const response = await router.handle(request, env, ctx);
// Merge headers from middleware if present
if (ctx.response && response) {
for (let [key, value] of ctx.response.headers.entries()) {
response.headers.set(key, value);
}
}
return response;
}
};Routing & Middleware Check
Consider a Cloudflare Worker using itty-router. You want to ensure that all requests to /admin/* paths require an X-Admin-Key header, and if it's missing, return a 403 Forbidden response. Other paths should not be affected.
Recap: Routing & Middleware
You've mastered the fundamentals of organizing your edge API with routing and middleware!
- Routing directs requests to the right handlers.
- Libraries like
itty-routersimplify route definition, including dynamic parameters. - Middleware functions enhance requests/responses, adding common logic like logging or authentication before (or after) the main handler.
These patterns are crucial for building scalable and maintainable serverless APIs at the edge.
Sıkça Sorulan Sorular
“Yönlendirme ve Ara Katman Yazılımı” dersi ücretsiz mi?
Evet — “Yönlendirme ve Ara Katman Yazılımı” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve Edge Computing with Cloudflare Workers & Deno kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. Edge Computing with Cloudflare Workers & Deno kursu toplamda 3 dersten oluşur.
“Yönlendirme ve Ara Katman Yazılımı” dersinde ne öğreneceğim?
Worker API'nizi düzenlemek ve geliştirmek için yönlendirme kitaplıklarından ve ara katman yazılımı kalıplarından yararlanın. Edge Computing with Cloudflare Workers & Deno ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.
Edge Computing with Cloudflare Workers & Deno öğrenmeye başlamak için deneyim gerekli mi?
Önceden deneyim gerekmez. CoddyKit'te Edge Computing with Cloudflare Workers & Deno, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 3 dersinin 2. dersidir.
“Yönlendirme ve Ara Katman Yazılımı” dersi ne kadar sürer?
Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.
Bu Edge Computing with Cloudflare Workers & Deno dersinde kod yazıp çalıştırabilir miyim?
Evet. Her Edge Computing with Cloudflare Workers & Deno dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.
Bu kursun tüm dersleri
- RESTful API Tasarlama
- Yönlendirme ve Ara Katman Yazılımı
- Doğrulama ve Hata Yönetimi