مراجعة - نماذج REST API

جزء من قسم Object Oriented Programming في رحلة GO على Coddy. الدرس 78 من 107.

التحدي

سهل

لنقم ببناء نظام نماذج REST API لمنصة مدونة! ستقوم بإنشاء أنواع منظمة بشكل جيد يتم تسلسلها إلى JSON وتوفر تمثيلات نصية مقروءة — تماماً كما ستحتاج عند بناء استجابات API حقيقية.

ستقوم بتنظيم الكود الخاص بك عبر ملفين:

models.go: قم بتعريف نماذج بيانات API الخاصة بك مع وسوم JSON المناسبة والتمثيلات النصية.
أنشئ هيكل Author مع حقول ID (int)، و Name (string)، و Email (string). قم بربط هذه الحقول بمفاتيح JSON وهي "id"، و "name"، و "email". قم بتنفيذ String() لتعيد التنسيق [Name] <[Email]>.

أنشئ هيكل Post مع حقول ID (int)، و Title (string)، و Content (string)، و Author (هيكل Author متداخل)، و Published (bool). قم بربط هذه الحقول بـ "id"، و "title"، و "content"، و "author"، و "published". يجب أن يستخدم حقل Content الخاصية omitempty بحيث لا يظهر المحتوى الفارغ في JSON. قم بتنفيذ String() لتعيد "[Title]" by [Author's String representation].

أنشئ هيكل APIResponse مع حقول Success (bool)، و Message (string)، و Data (Post). قم بربطها بـ "success"، و "message"، و "data". يجب أن يستخدم حقل Message الخاصية omitempty.
main.go: قم ببناء استجابات API واستعرض كلاً من مخرجات JSON والتمثيلات النصية.
اقرأ نوع العملية (json أو display)، ثم اقرأ تفاصيل المنشور: معرف المنشور، العنوان، المحتوى، معرف الكاتب، اسم الكاتب، بريد الكاتب الإلكتروني، وحالة النشر (true أو false).

بالنسبة لـ json: أنشئ APIResponse مع Success: true والمنشور (Post) كبيانات (اترك Message فارغاً). قم بتحويله إلى JSON واطبعه.

بالنسبة لـ display: أنشئ المنشور (Post) واطبعه باستخدام تابع String الخاص به، ثم اطبع الكاتب (Author) بشكل منفصل في سطر جديد.

سيتم توفير المدخلات التالية:

السطر 1: نوع العملية (json أو display)
السطر 2: معرف المنشور (Post ID)
السطر 3: العنوان
السطر 4: المحتوى (قد يكون فارغاً)
السطر 5: معرف الكاتب (Author ID)
السطر 6: اسم الكاتب
السطر 7: بريد الكاتب الإلكتروني
السطر 8: حالة النشر (true أو false)

على سبيل المثال، إذا أعطينا:

json
1
Getting Started with Go
Learn the basics of Go programming
101
Jane Smith
jane@example.com
true

يجب أن تكون مخرجاتك:

{"success":true,"data":{"id":1,"title":"Getting Started with Go","content":"Learn the basics of Go programming","author":{"id":101,"name":"Jane Smith","email":"jane@example.com"},"published":true}}

وإذا أعطينا:

json
2
Draft Post

102
John Doe
john@example.com
false

يجب أن تكون مخرجاتك:

{"success":true,"data":{"id":2,"title":"Draft Post","author":{"id":102,"name":"John Doe","email":"john@example.com"},"published":false}}

لاحظ كيف تم حذف حقل المحتوى الفارغ من مخرجات JSON.

وإذا أعطينا:

display
3
Advanced Interfaces
Deep dive into Go interfaces
103
Alice Chen
alice@example.com
true

يجب أن تكون مخرجاتك:

"Advanced Interfaces" by Alice Chen <alice@example.com>
Alice Chen <alice@example.com>

جرّب بنفسك

package main

import (
	"bufio"
	"encoding/json"
	"fmt"
	"os"
	"strconv"
	"strings"
)

func main() {
	reader := bufio.NewReader(os.Stdin)

	// قراءة نوع العملية
	operation, _ := reader.ReadString('\n')
	operation = strings.TrimSpace(operation)

	// قراءة post ID
	postIDStr, _ := reader.ReadString('\n')
	postID, _ := strconv.Atoi(strings.TrimSpace(postIDStr))

	// قراءة العنوان
	title, _ := reader.ReadString('\n')
	title = strings.TrimSpace(title)

	// قراءة المحتوى
	content, _ := reader.ReadString('\n')
	content = strings.TrimSpace(content)

	// قراءة author ID
	authorIDStr, _ := reader.ReadString('\n')
	authorID, _ := strconv.Atoi(strings.TrimSpace(authorIDStr))

	// قراءة اسم الكاتب
	authorName, _ := reader.ReadString('\n')
	authorName = strings.TrimSpace(authorName)

	// قراءة البريد الإلكتروني للكاتب
	authorEmail, _ := reader.ReadString('\n')
	authorEmail = strings.TrimSpace(authorEmail)

	// قراءة حالة النشر
	publishedStr, _ := reader.ReadString('\n')
	published := strings.TrimSpace(publishedStr) == "true"

	// TODO: إنشاء Author struct بالقيم المقروءة

	// TODO: إنشاء Post struct بالقيم المقروءة والـ Author

	// TODO: التعامل مع نوع العملية
	// إذا كانت العملية "json":
	//   - إنشاء APIResponse مع Success: true والـ Post كـ Data
	//   - التحويل إلى JSON باستخدام json.Marshal
	//   - طباعة نص الـ JSON
	// إذا كانت العملية "display":
	//   - طباعة الـ Post باستخدام طريقة String الخاصة به
	//   - طباعة الـ Author في سطر جديد

	// مكان محجوز لاستخدام المتغيرات (يُحذف عند التنفيذ)
	_ = postID
	_ = title
	_ = content
	_ = authorID
	_ = authorName
	_ = authorEmail
	_ = published
	_ = operation
	_ = json.Marshal
	fmt.Println("TODO: Implement the solution")
}