ما هي إجراءات الخادم؟
جزء من قسم أساسيات Next.js في رحلة React على Coddy. الدرس 29 من 47.
يمكنك الآن قراءة البيانات على الخادم. حان وقت النصف الآخر: تغييرها.
حتى وقت قريب، كان حفظ سطر واحد من النص يتطلب قدرًا مفاجئًا من الإجراءات. كنت تكتب نقطة نهاية:
// app/api/items/route.js
export async function POST(request) {
const body = await request.json();
saveItem(body.text);
return Response.json({ ok: true });
}…ثم استدعيناها من المتصفح:
await fetch('/api/items', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ text }),
});ملفان، ورابط URL، وطريقة، وترويسات، وJSON في كلا الاتجاهين، لنقل سلسلة نصية واحدة من نموذج إلى قاعدة بيانات.
يحذف إجراء الخادم كل ذلك. اكتب دالة غير متزامنة في ملف يكون سطره الأول 'use server':
// app/actions.js
'use server';
import { saveItem } from '../lib/db';
export async function addItem(formData) {
saveItem(formData.get('text'));
}… ومرّر تلك الدالة إلى نموذج:
<form action={addItem}>
<input name="text" />
<button type="submit">Add</button>
</form>هذا كل شيء. هناك ثلاث نقاط يجدر ذكرها:
- يجب أن يكون
'use server'السطر الأول في الملف: فهو علامة من النوع نفسه مثل'use client'، لكنها تشير إلى الاتجاه الآخر. وهي تعني أن كل ما يُصدَّر هنا يعمل على الخادم. - لا يصل جسم الدالة إلى المتصفح أبدًا. بيانات اعتماد قاعدة البيانات آمنة بداخلها: لا يحصل المتصفح إلا على مرجع يمكنه استدعاؤه.
- لم تكتب عنوان URL مطلقًا. ينشئ Next.js نقطة النهاية نيابةً عنك؛ و
action={addItem}هو ما يربطها.
أحد أوجه الاختلاف عن الأساسيات: مدخلات النموذج هذه غير مُتحكَّم بها. لا يوجد useState، ولا value، ولا onChange: يحتفظ المتصفح بالنص، وتُستخدم سمة name لتتمكن الدالة من العثور عليه عند الإرسال.
جرّب بنفسك
لا يتضمّن هذا الدرس تحدّيًا برمجيًا.
يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس أساسيات Next.js
4الخادم والعميل
نوعان من المكوّناتقراءة رسالة الخطأسطر 'use client'اجعل أجزاء العميل صغيرةالخادم داخل العميلمراجعة: الخادم والعميل7التنقل بين صفحات العميل
الرابط النشطالتوجيه البرمجيالتصفية باستخدام URLمعالجات المساراتمراجعة: التنقل2التوجيه والروابط
المجلدات هي مساراتالمسارات المتداخلةربط الصفحاتالمسارات الديناميكيةصفحات غير موجودةمراجعة: التوجيه3التخطيطات والبيانات الوصفية
التخطيط الجذرالتنقل المشتركالتخطيطات المتداخلةالبيانات الوصفية للصفحةالبيانات الوصفية الديناميكيةمراجعة: التخطيطات6إجراءات الخادم
ما هي إجراءات الخادم؟نماذج تتفاعلقراءة بيانات النموذجتحديث الصفحةمراجعة: إجراءات الخادم