القوالب في Ktor: مقارنة Pebble مع HTML DSL
نظرة على ما تكسبه وما تخسره مع القوالب الكلاسيكية المبنية على HTML مقابل DSL الآمن من حيث الأنواع في Kotlin عند التصيير على الخادم، مع التركيز على قابلية القراءة والتوسعة وسهولة الاستخدام اليومي لكل نهج.
خلال الأشهر الماضية، عاد التصيير على جانب الخادم (Server Side Rendering أو SSR) بقوة. وقد كان التراجع عن JSON كوسيلة للتخاطب مع الواجهة الأمامية منعشًا حقًا. يمكنك الاختيار من بين لغات قوالب كثيرة، وبمجرد أن تعرف إحداها، يكون الانتقال إلى أخرى سهلًا عادةً. ومنذ وقت ليس ببعيد صادفت واحدة أردت تجربتها – HTML DSL، وهي تكامل مع kotlinx.html يأتي مع Ktor، إطار عمل Kotlin لإنشاء تطبيقات العميل والخادم غير المتزامنة. وهي تتناول القوالب من زاوية مختلفة: تكتب HTML عاديًا داخل Kotlin، وتدرج المتغيرات في العروض، وتجمّع تخطيطات معقدة. أرى أن قابلية التوسعة من أعظم نقاط قوة HTML، ولدي شكوك حول ما إذا كان الأمان من حيث الأنواع سيتفق معها – فلنتعمق إذن ونقارن HTML DSL مع قوالب Pebble، وهي لغة قوالب أكثر تقليدية!
الصفحة الأساسية مع Pebble
كانت فكرتي مقارنة الاثنين باستخدام تطبيق نموذجي لدفتر عناوين لإدارة جهات الاتصال، بتنسيق خفيف باستخدام Pico. لكن لنمضِ خطوة خطوة، ولنبدأ بلا شيء ذي معنى داخل <body>. هنا، قالب pebble مطابق تمامًا لـ HTML العادي:
<!DOCTYPE html>
<html lang="en" data-theme="light">
<head>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css">
<link rel="stylesheet" href="/static/css/main.css">
<meta charset="UTF-8"/>
<title>Pebble vs HTML DSL</title>
</head>
<body>
<main class="container">
<h1>It works 🚀!</h1>
</main>
</body>
</html>
لا شيء غير عادي هنا، باستثناء المعامل المخصص data-theme من Pico في وسم <html>.
بعد ذلك يأتي استخراج الصفحة الأساسية. شكل من أشكال الوراثة أو التركيب أمر لا غنى عنه عند توليد صفحة HTML على الخادم – فهو يتيح لك استخراج جزء من الصفحة وحقن المحتوى الفعلي فيه لاحقًا. وفي Pebble يتحقق هذا بالوسوم (tags) (وهي ليست كوسوم HTML العادية):
{# base.peb #}
<!DOCTYPE html>
<html lang="en" data-theme="light">
<head>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css">
<link rel="stylesheet" href="/static/css/main.css">
<meta charset="UTF-8"/>
<title>Pebble vs HTML DSL</title>
<style>
</style>
</head>
<body>
<main class="container">
{% block content %}{% endblock %}
</main>
</body>
</html>
يمكننا بعد ذلك إعادة استخدامها لتصيير الصفحة الرئيسية هكذا:
{# index.peb #}
{% extends "base.peb" %}
{% block content %}
<h1>It works 🚀!</h1>
{% endblock %}
الصفحة الأساسية مع HTML DSL وتضييق النطاق
بعد أن تكوّن لدينا إحساس بكيفية عمل الصفحة الأساسية في لغة قوالب قياسية، يمكننا الانتقال إلى HTML DSL. بعد مراجعة الوثائق والنظر في المعاملات المخصصة، تبدو شيفرة التوجيه في Kotlin المكافئة لـ index.peb الأساسي كما يلي:
fun Application.configureRouting() {
routing {
staticResources("/static", "static") {
extensions("css")
preCompressed(CompressedFileType.GZIP)
}
get("/") {
call.respondHtml(HttpStatusCode.OK) {
lang = "en"
attributes["data-theme"] = "light"
head {
link {
href = "https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css"
rel = "stylesheet"
}
link {
href = "/static/css/main.css"
rel = "stylesheet"
}
meta {
charset = "UTF-8"
}
title {
+"Pebble vs HTML DSL"
}
}
body {
main {
classes = linkedSetOf("container")
h1 {
+"It works 🚀!"
}
}
}
}
}
}
}
هذا لا يشبه HTML العادي إطلاقًا! لكن هل هذه ميزة؟ بصراحة، لا أظن ذلك، وهذه مشكلاتي مع نهج DSL:
- حتى في صفحة بسيطة كهذه، ليس واضحًا على الفور أي أجزاء من الشيفرة تقابل أي أجزاء من HTML. وهذا قد يجعل تصحيح شيفرة JavaScript أصعب مما ينبغي.
- ولأن الشيفرة لا تشبه HTML، سيواجه من لا يعرفون Kotlin صعوبة في العمل على جانب الواجهة الأمامية من المشروع.
- لهذا الاختلاف عيب آخر – لا يمكن استخدام مكتبات مكونات HTML مع هذا النهج إلا ببذل جهد غير هيّن في ترجمتها إلى DSL
- قد يبدو استخدام
Setللخاصيةclassطريقة أنيقة لتجنب التكرار، لكنه قد يسبب آثارًا جانبية غير متوقعة، إذ قد يكسر محددات الخصائص لديك؛ فمثلًا يختلف[class="class1 class2"]عن[class="class2 class1"]. وكقاعدة، ينبغي استخدامlinkedSetOf - كما ذكرت في البداية، تُعدّ قابلية التوسعة من مبادئ تصميم HTML. وقد شككت في أن الأمان الصارم من حيث الأنواع يمكن أن يصمد في كل حالة، وبالفعل انكسر عند الوسم الأول، حين أردنا ضبط سمة Pico بواسطة سمة بيانات. كما تعتمد المكتبات كثيرًا على سمات مخصصة أخرى.
بعد ذلك، لنستخرج الجزء الأساسي من هذه الشيفرة إلى دالة منفصلة في الصنف HTML ليصبح جزءًا من DSL لدينا.
object Templates {
fun HTML.base(content: FlowContent.() -> Unit) {
lang = "en"
attributes["data-theme"] = "light"
...
body {
main {
classes = setOf("container")
content()
}
}
}
}
//Application.configureRouting
get("/") {
call.respondHtml(HttpStatusCode.OK) {
base {
h1 {
+"It works 🚀!"
}
}
}
}
تطلبت إعادة الهيكلة هذه قدرًا أكبر قليلًا من معرفة Kotlin، لكن الجهد لا ينبغي أن يختلف كثيرًا من حالة إلى أخرى.
عندما بدأت كتابة هذه المقالة، كانت لدي خطة طموحة – مقارنة Pebble وHTML DSL باستخدام تطبيق دفتر عناوين بسيط. ولسوء الحظ، جعل DSL حتى تطبيق القراءة فقط صعب القراءة، لذا قررت ألا أغطي الباقي في هذه التدوينة. وبالنسبة للنسخة النهائية للقراءة فقط، يبلغ عدد الأسطر 75 مقابل 128، وتكون Pebble هي الأقصر.
الخلاصة
أرى بعض مزايا HTML DSL:
- دعم كامل في IDEA، لأنها ببساطة شيفرة Kotlin
- وهي خيار القوالب الوحيد في Ktor الذي يعمل مع خادم native
- تعمل فورًا بمجرد إضافة الاعتمادية إلى البناء
- وتتجنب القيد المزعج لوسوم القوالب، التي يجب عادةً أن تكون في سطر واحد
لكنني شخصيًا لن ألجأ إليها قريبًا مرة أخرى – فأجد أنها، مقارنةً بلغات القوالب الراسخة، تجعل بناء تطبيقات الويب أكثر تعقيدًا مما ينبغي.