تقدير المشروع
← كل المقالات

دعم Apache Tiles في Apache Struts

يجعل Apache Tiles إعادة استخدام مكونات الويب في تطبيقك أسهل بكثير، خاصة مع دعم Struts، بحيث يمكنك الجمع بين Struts وTiles في أعمالك المستقبلية بثقة أكبر

4 دقائق قراءة
تقنيات المؤسساتJavaApache StrutsApache Tiles

دعم Apache Tiles جزء من Apache Struts منذ اليوم الأول. ومن المفارقات أن Tiles بدأ فعلاً داخل Struts. فقد بُني أولاً داخل Struts 1، واستمر Struts 2 في دعمه عبر إضافة Tiles.

وفي النهاية، رُقّي Apache Tiles إلى مشروع من المستوى الأعلى، يُعرف بـ TLP، في مؤسسة Apache Software Foundation. ومنذ ذلك الحين صار بإمكانه العمل كإطار عمل مستقل لقوالب الويب دون أي اعتماد على Struts.

كيف تستخدم Tiles

إذا أردت Tiles في مشروع مبني على Struts، فعليك إضافة إضافة Struts Tiles مع كل اعتماديات Tiles التي تتطلبها. ومع Apache Maven، يكفي التصريح باعتمادية على الإضافة، كما يظهر هنا:

<dependency>
    <groupId>org.apache.struts</groupId>
    <artifactId>struts2-tiles-plugin</artifactId>
    <version>${struts2.version}</version>
</dependency>

حيث يمثل ${struts2.version} إصدار Struts في مشروعك (نأمل أن يكون الأحدث :) )

بعد ذلك، عليك التصريح عن مستمع ويب (Web listener) في ملف web.xml، هكذا:

<listener>
  <listener-class>org.apache.struts2.tiles.StrutsTilesListener</listener-class>
</listener>

نصيحتي أن تختار نسخة Struts من المستمع، لأنها توفر تكاملاً أوثق بين Struts وTiles. وهذا يتيح لك استخدام خصائص التوطين التي يوفرها Struts، أو حتى الوصول إلى سمات خاصة بـ Struts عبر البادئتين I18N وS2 داخل تعريفات Tiles لديك. ولمعرفة المزيد عن تكاملات Tiles–Struts المتاحة وكيفية تطبيقها، راجع الوثائق.

بعد إعداد الإضافة والمستمع، يمكنك الانتقال إلى تعريف البلاطات (tiles). أي تقسيم واجهاتك إلى أجزاء أصغر، أو بلاطات، تتيح تعريفات Tiles تجميعها ديناميكياً وإعادة استخدامها.

تعريف Tiles هو ملف XML مثل الملف التالي:

<!DOCTYPE tiles-definitions PUBLIC
    "-//Apache Software Foundation//DTD Tiles Configuration 3.0//EN"
    "https://tiles.apache.org/dtds/tiles-config_3_0.dtd">

<tiles-definitions>

    <definition name="fooLayout" template="/WEB-INF/tiles/layout.jsp">
        <put-attribute name="title" value="Tiles Sample"/>
        <put-attribute name="header" value=".header"/>
        <put-attribute name="body" value=".body"/>
    </definition>

    <definition name="tilesWorks" extends="fooLayout">
        <put-attribute name="header" value="/WEB-INF/tiles/header.jsp"/>
        <put-attribute name="body" value="/WEB-INF/tiles/body.jsp"/>
    </definition>

</tiles-definitions>

تلميح: يتيح Struts أيضاً تعريف البلاطات بالتعليقات التوضيحية (annotations)، لكن ذلك يربط الإجراءات (actions) لديك بمنطق متعلق بـ Tiles. وقد يسبب هذا مشكلات أحياناً، فاختر ما يناسبك أكثر – التعليقات التوضيحية أم ملفات XML.

لم يبق سوى كتابة بعض ملفات JSP؛ ابدأ بـ layout.jsp، كما هو مشار إليه في التعريف أعلاه:

<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles" %>
<%@ taglib prefix="s" uri="/struts-tags" %>

<%-- Show usage; Used in Header --%>
<tiles:importAttribute name="title" scope="request"/>
<html>
    <head><title>Struts2 Showcase - <tiles:getAsString name="title"/></title></head>
<body>
    <tiles:insertAttribute name="header"/>
    <tiles:insertAttribute name="body"/>
    <p>Notice that this is a layout made in JSP</p>
</body>
</html>

بعد ذلك، أنشئ بقية ملفات JSP التي تشكل بلاطتك، أي: header.jsp وbody.jsp. وهناك خيارات أخرى كثيرة لتركيب الواجهات. يمكنك استخدام مجموعات مختلفة من القوالب ومجموعة منفصلة من ملفات JSP لكل واجهة. ومدى تعقيد واجهتك متروك لك بالكامل.

نقل Tiles إلى الأرشيف (attic)

للأسف، تم إيقاف مشروع Apache Tiles ونقله إلى Apache Attic. عملياً، المشروع لم يعد مصانًا، ولا ينبغي توقع أي تحديثات أو إصدارات أخرى.

وقد يكون هذا صدمة وضربة إذا كان مشروعك يعتمد بشدة على Tiles. وبما أن المشروع مرخص بموجب Apache 2.0، فأنت حر في إجراء أي تغييرات تحتاجها بنفسك. ومع ذلك، فإن إبقاء نسخة مشتقة (fork) حية أمر بعيد عن السهولة وعرضة للأخطاء. ولهذا كان من الأفضل إبقاء المشروع حياً، ولو في وضع الصيانة فقط.

إعادة Tiles إلى Struts

عادت الأمور إلى نقطة البداية: فقد اختار فريق Struts إعادة شيفرة Tiles المصدرية إلى إضافة Struts Tiles. وتم ذلك في إصدار Struts 6.3.0، بحيث يمكنك الآن الاعتماد على أن Tiles محدّث ومدعوم.

وقد تسأل لماذا لم نبذل جهدنا في إبقاء المشروع الأصلي مستمراً. في رأينا، كان من الأسهل نسخ الشيفرة وتكييفها بما يناسب Struts أكثر. وإضافة إلى ذلك، فإن التعامل مع كل اعتماديات Tiles التي لا يستخدمها Struts لن يزيد إلا التعقيد دون أن يقدم شيئاً لمستخدمي Struts.

وهناك فائدة أخرى هي أننا نستطيع رفع اعتماديات Tiles فور صدور إصدارات جديدة. وهذا يبسّط دورة الإصدار ويمنحنا تحكماً كاملاً فيما يدخل وكيف يُستخدم.

وهناك فائدة أخرى مرتبطة بخطتنا للانتقال إلى Jakarta EE، التي تتطلب أن يدعم كل مكون الإصدار نفسه من مواصفات Jakarta EE. وعندما تأتي تلك اللحظة، سيكون ترحيل Struts وTiles معاً إلى Jakarta EE أسهل بكثير بالنسبة إلينا.

الملخص

Apache Tiles برنامج مفيد للغاية يجعل بناء مكونات ويب قابلة لإعادة الاستخدام في تطبيق الويب أكثر سلاسة. والآن وقد صار مجتمع Struts يدعمه أيضاً، يمكنك الجمع بين Struts وTiles في مشاريعك القادمة بثقة أكبر.

وفي رأيي، حان الوقت لترك مصطلح Apache Tiles والاكتفاء بقول Struts Tiles أو ببساطة Tiles :)

إذا كنت بحاجة إلى متخصصين في Struts أو خبراء في JavaEE، فلا تتردد في التواصل معنا. يمكننا مساعدتك في صيانة شيفرتك المصدرية أو دعم أعمال الترحيل لديك.