بناء تطبيق on تعلّم Go بالاختبارات

مقدمة

Mon, 01 Jan 0001 00:00:00 +0000

بناء تطبيق

الآن، وبعد أن استوعبت — كما نأمل — قسم أساسيات Go، أصبحت لديك قاعدة صلبة في أغلب ميزات لغة Go وكيفية ممارسة التطوير الموجه بالاختبار.

سيتناول هذا القسم القادم بناء تطبيق.

كل فصل سيبني على الفصل السابق، موسّعًا وظائف التطبيق كما يملي علينا مالك المنتج (product owner).

سنقدّم مفاهيم جديدة تساعدك على كتابة كود رائع، لكن أغلب المادة الجديدة ستكون تعرّفًا بما يمكن إنجازه باستخدام المكتبة القياسية (standard library) في Go.

خادم HTTP

Mon, 01 Jan 0001 00:00:00 +0000

خادم HTTP

يمكنك العثور على كل كود هذا الفصل هنا

طُلب منك إنشاء خادم ويب يستطيع المستخدمون من خلاله تتبع عدد المباريات التي فاز بها اللاعبون.

GET /players/{name} ينبغي أن تُرجع رقمًا يدل على إجمالي عدد مرات الفوز
POST /players/{name} ينبغي أن تسجّل فوزًا لذلك الاسم، ويزيد العدد مع كل POST تالٍ

سنتبع نهج التطوير الموجه بالاختبار، فنصل إلى برنامج يعمل بأسرع ما نستطيع، ثم نجري تحسينات صغيرة متكررة حتى نصل إلى الحل. وباتباعنا هذا النهج:

JSON والتوجيه والدمج

Mon, 01 Jan 0001 00:00:00 +0000

JSON والتوجيه والدمج

يمكنك العثور على كل كود هذا الفصل هنا

في الفصل السابق أنشأنا خادم ويب لتخزين عدد المباريات التي فاز بها اللاعبون.

ولمالك المنتج (product owner) متطلب جديد: نقطة نهاية (endpoint) جديدة اسمها /league تُرجع قائمة بكل اللاعبين المخزَّنين. وتريد أن تُعاد هذه القائمة على هيئة JSON.

إليك الكود الذي وصلنا إليه حتى الآن

// server.go
package main

import (
	"fmt"
	"net/http"
	"strings"
)

type PlayerStore interface {
	GetPlayerScore(name string) int
	RecordWin(name string)
}

type PlayerServer struct {
	store PlayerStore
}

func (p *PlayerServer) ServeHTTP(w http.ResponseWriter, r *http.Request) {
	player := strings.TrimPrefix(r.URL.Path, "/players/")

	switch r.Method {
	case http.MethodPost:
		p.processWin(w, player)
	case http.MethodGet:
		p.showScore(w, player)
	}
}

func (p *PlayerServer) showScore(w http.ResponseWriter, player string) {
	score := p.store.GetPlayerScore(player)

	if score == 0 {
		w.WriteHeader(http.StatusNotFound)
	}

	fmt.Fprint(w, score)
}

func (p *PlayerServer) processWin(w http.ResponseWriter, player string) {
	p.store.RecordWin(player)
	w.WriteHeader(http.StatusAccepted)
}

// in_memory_player_store.go
package main

func NewInMemoryPlayerStore() *InMemoryPlayerStore {
	return &InMemoryPlayerStore{map[string]int{}}
}

type InMemoryPlayerStore struct {
	store map[string]int
}

func (i *InMemoryPlayerStore) RecordWin(name string) {
	i.store[name]++
}

func (i *InMemoryPlayerStore) GetPlayerScore(name string) int {
	return i.store[name]
}

// main.go
package main

import (
	"log"
	"net/http"
)

func main() {
	server := &PlayerServer{NewInMemoryPlayerStore()}
	log.Fatal(http.ListenAndServe(":5000", server))
}

يمكنك العثور على الاختبارات المقابلة في الرابط أعلى الفصل.

الـ IO والترتيب

Mon, 01 Jan 0001 00:00:00 +0000

الإدخال والإخراج والترتيب

يمكنك العثور على كل كود هذا الفصل هنا

في الفصل السابق واصلنا تطوير تطبيقنا بإضافة نقطة نهاية (endpoint) جديدة هي /league. وفي الطريق تعلّمنا كيفية التعامل مع JSON، وتضمين الأنواع (embedding types)، والتوجيه (routing).

مالكة المنتج (product owner) منزعجة بعض الشيء لأن البرنامج يفقد النتائج عند إعادة تشغيل الخادم؛ والسبب أن تنفيذنا للمخزن (store) موجود في الذاكرة. وهي أيضًا غير راضية لأننا لم نستنتج أن نقطة النهاية /league ينبغي أن تُرجع اللاعبين مرتبين حسب عدد الانتصارات!

سطر الأوامر وهيكل المشروع

Mon, 01 Jan 0001 00:00:00 +0000

سطر الأوامر وهيكل المشروع

يمكنك العثور على كل كود هذا الفصل هنا

يريد مالك المنتج (product owner) الآن أن يتحوّل (pivot) بتقديم تطبيق ثانٍ - تطبيق سطر أوامر.

وفي الوقت الحالي، سيكفي أن يكون قادرًا على تسجيل فوز لاعب عندما يكتب المستخدم Ruth wins. والقصد أن يصبح في النهاية أداة تساعد المستخدمين على لعب البوكر.

ويريد مالك المنتج أن تكون قاعدة البيانات مشتركة بين التطبيقين، حتى يتحدّث الدوري وفق الانتصارات المسجّلة في التطبيق الجديد.

الوقت

Mon, 01 Jan 0001 00:00:00 +0000

الوقت

يمكنك العثور على كل كود هذا الفصل هنا

يريد منّا مالك المنتج (product owner) أن نوسّع وظائف تطبيق سطر الأوامر الخاص بنا بمساعدة مجموعة من الأشخاص على لعب البوكر تكساس هولدم (Texas-Holdem Poker).

معلومات بالقدر الكافي عن البوكر

لن تحتاج إلى معرفة الكثير عن البوكر، يكفي أن تعرف أنه في فترات زمنية معينة يجب إبلاغ جميع اللاعبين بقيمة “الرهان الإجباري” (blind) المتزايدة باطراد.

سيساعدنا تطبيقنا على تتبّع موعد ارتفاع قيمة الرهان الإجباري، ومقدارها الجديد.

إعادة زيارة الوقت مع testing/synctest

Mon, 01 Jan 0001 00:00:00 +0000

إعادة زيارة الوقت مع testing/synctest

يمكنك العثور على كل كود هذا الفصل هنا

في فصل الوقت منحنا تطبيق البوكر الطرفي (poker CLI) القدرة على جدولة تنبيهات “الرهان الأعمى يرتفع الآن” باستخدام time.AfterFunc. كان اختبار هذا صعبًا: فـ time.AfterFunc يشغّل دالة الاستدعاء (callback) في goroutine خاصة به بعد مرور مدة حقيقية، ولا يمكنك مقارنة الدوال في Go، لذا لم نستطع بسهولة فحص ما تمت جدولته.

حللنا ذلك بأداة مألوفة: حقن الاعتماديات (dependency injection). عرّفنا واجهة (interface) اسمها BlindAlerter، وفي اختباراتنا استبدلنا التنفيذ الحقيقي بـ spy يسجّل فقط ما طُلب منه جدولته، هكذا تقريبًا:

الـ WebSockets

Mon, 01 Jan 0001 00:00:00 +0000

الـ WebSockets

يمكنك العثور على كل كود هذا الفصل هنا

في هذا الفصل سنتعلّم كيف نستخدم WebSockets لتحسين تطبيقنا.

مراجعة سريعة للمشروع

لدينا تطبيقان في قاعدة كود البوكر

تطبيق سطر الأوامر. يطلب من المستخدم إدخال عدد اللاعبين في اللعبة. ومنذ تلك اللحظة يبلّغ اللاعبين بقيمة “الرهان الإجباري” (blind bet) التي تزداد بمرور الوقت. ويمكن للمستخدم في أي لحظة إدخال "{Playername} wins" لإنهاء اللعبة وتسجيل الفائز في مخزن (store).
تطبيق الويب. يتيح للمستخدمين تسجيل الفائزين في الألعاب ويعرض جدول الترتيب. ويتشارك المخزن نفسه مع تطبيق سطر الأوامر.

الخطوات التالية

مالكة المنتج (product owner) سعيدة جدًا بتطبيق سطر الأوامر، لكنها تفضّل لو استطعنا نقل تلك الوظائف إلى المتصفح. فهي تتخيّل صفحة ويب بها مربع نص يتيح للمستخدم إدخال عدد اللاعبين، وعندما يرسل النموذج (form) تعرض الصفحة قيمة الرهان الإجباري وتحدّثها تلقائيًا عند الحاجة. وكما في تطبيق سطر الأوامر، يمكن للمستخدم إعلان الفائز فيُحفظ في قاعدة البيانات.