مكتبة العلامات القياسية لـ JSP (JSTL) هي عبارة عن مجموعة من علامات JSP التي تحتوي على الوظائف الأساسية الشائعة لتطبيقات JSP.
يدعم JSTL المهام الشائعة والمنظمة، مثل التكرار والحكم الشرطي وعمليات مستند XML وعلامات التدويل وعلامات SQL. بالإضافة إلى ذلك، فإنه يوفر أيضًا إطارًا لاستخدام العلامات المخصصة المدمجة مع JSTL.
وفقا للوظائف التي توفرها علامات JSTL، يمكن تقسيمها إلى 5 فئات.
العلامات الأساسية
علامات التنسيق
علامة SQL
علامة XML
وظائف JSTL
خطوات تثبيت مكتبة JSTL على Apache Tomcat هي كما يلي:
تم تنزيل الحزمة الثنائية (jakarta-taglibs-standard-current.zip) من مكتبة العلامات القياسية الخاصة بـ Apache. عنوان التنزيل: http://archive.Apache.org/dist/jakarta/taglibs/standard/binaries/
قم بتنزيل الحزمة jakarta-taglibs-standard-1.1.1.zip وفك ضغطها، وانسخ ملفي jar الموجودين ضمن jakarta-taglibs-standard-1.1.1/lib/: ملفات Standard.jar وjstl.jar إلى /WEB- المعلومات /lib/تحت.
بعد ذلك نضيف التكوين التالي في ملف web.xml:
…
<
jsp
-
التكوين
>
<taglib>
<
تاجليب
-
أوري
>
http
:
//java.sun.com/jstl/fmt</taglib-uri>
<
تاجليب
-
موقع
>
/ويب-INF/
fmt
.
نطاق المستوى الأعلى
</
تاجليب
-
موقع
>
</
تاجليب
>
<taglib>
<
تاجليب
-
أوري
>
http
:
//java.sun.com/jstl/fmt-rt</taglib-uri>
<
تاجليب
-
موقع
>
/ويب-INF/
fmt
-
غ
.
نطاق المستوى الأعلى
</
تاجليب
-
موقع
>
</
تاجليب
>
<taglib>
<
تاجليب
-
أوري
>
http
:
//java.sun.com/jstl/core</taglib-uri>
<
تاجليب
-
موقع
>
/ويب-INF/
ج
.
نطاق المستوى الأعلى
</
تاجليب
-
موقع
>
</
تاجليب
>
<taglib>
<
تاجليب
-
أوري
>
http
:
//java.sun.com/jstl/core-rt</taglib-uri>
<
تاجليب
-
موقع
>
/ويب-INF/
ج
-
غ
.
نطاق المستوى الأعلى
</
تاجليب
-
موقع
>
</
تاجليب
>
<taglib>
<
تاجليب
-
أوري
>
http
:
//java.sun.com/jstl/sql</taglib-uri>
<
تاجليب
-
موقع
>
/ويب-INF/
SQL
.
نطاق المستوى الأعلى
</
تاجليب
-
موقع
>
</
تاجليب
>
<taglib>
<
تاجليب
-
أوري
>
http
:
//java.sun.com/jstl/sql-rt</taglib-uri>
<
تاجليب
-
موقع
>
/ويب-INF/
SQL
-
غ
.
نطاق المستوى الأعلى
</
تاجليب
-
موقع
>
</
تاجليب
>
<taglib>
<
تاجليب
-
أوري
>
http
:
//java.sun.com/jstl/x</taglib-uri>
<
تاجليب
-
موقع
>
/ويب-INF/
س
.
نطاق المستوى الأعلى
</
تاجليب
-
موقع
>
</
تاجليب
>
<taglib>
<
تاجليب
-
أوري
>
http
:
//java.sun.com/jstl/x-rt</taglib-uri>
<
تاجليب
-
موقع
>
/ويب-INF/
س
-
غ
.
نطاق المستوى الأعلى
</
تاجليب
-
موقع
>
</
تاجليب
>
</
jsp
-
التكوين
>
…
لاستخدام أي مكتبة، يجب عليك تضمين العلامة <taglib> في رأس كل ملف JSP.
العلامات الأساسية هي علامات JSTL الأكثر استخدامًا. بناء الجملة للإشارة إلى مكتبة العلامات الأساسية هو كما يلي:
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
| ملصق | يصف |
|---|---|
| <ج: خارج> | يستخدم لعرض البيانات في JSP، مثل <%= ...> |
| <ج: مجموعة> | تستخدم لحفظ البيانات |
| <ج: إزالة> | لحذف البيانات |
| <ج: قبض> | يستخدم لمعالجة الاستثناءات التي تسبب الأخطاء وتخزين معلومات الخطأ |
| <ج:إذا> | إنه نفس ما إذا استخدمنا في البرامج العامة |
| <ج: اختر> | يتم استخدامه فقط كعلامة أصل لـ <c:when> و<c:otherwise> |
| <ج:متى> | يتم استخدام العلامة الفرعية <c:choose> لتحديد ما إذا كان الشرط صحيحًا. |
| <ج:خلاف ذلك> | يتم توصيل العلامة الفرعية <c:choose> بعد العلامة <c:when> ويتم تنفيذها عندما يتم الحكم على العلامة <c:when> بأنها خاطئة. |
| <ج:استيراد> | قم باسترجاع عنوان URL المطلق أو النسبي واعرض محتوياته على الصفحة |
| <ج: لكل> | علامة التكرار الأساسية، وقبول أنواع مجموعة متعددة |
| <ج:للرموز> | محتوى منفصل بناءً على المحدد المحدد ومخرجات التكرار |
| <ج: المعلمة> | يستخدم لتمرير المعلمات إلى الصفحات المضمنة أو المعاد توجيهها |
| <ج: إعادة التوجيه> | إعادة التوجيه إلى عنوان URL جديد. |
| <ج: رابط> | استخدم معلمات الاستعلام الاختيارية لإنشاء عنوان URL |
تُستخدم علامات التنسيق JSTL لتنسيق وإخراج النص والتواريخ والأوقات والأرقام. بناء الجملة للرجوع إلى مكتبة علامات التنسيق كما يلي:
<%@
بادئة تاجليب
=
"إف إم تي"
أوري
=
"http://java.sun.com/jsp/jstl/fmt"
%>
| ملصق | يصف |
|---|---|
| <fmt:رقم التنسيق> | قم بتنسيق رقم باستخدام التنسيق أو الدقة المحددة |
| <fmt:رقم التحليل> | تحليل سلسلة تمثل رقمًا أو عملة أو نسبة مئوية |
| <fmt:formatDate> | تنسيق التاريخ والوقت باستخدام النمط أو النمط المحدد |
| <fmt:parseDate> | تحليل سلسلة تمثل التاريخ أو الوقت |
| <fmt:حزمة> | ربط الموارد |
| <fmt:setLocale> | المنطقة المحددة |
| <fmt:setBundle> | ربط الموارد |
| <fmt:المنطقة الزمنية> | تحديد المنطقة الزمنية |
| <fmt:setTimeZone> | تحديد المنطقة الزمنية |
| <fmt:رسالة> | عرض معلومات ملف تعريف الموارد |
| <fmt:requestEncoding> | ضبط ترميز الأحرف للطلب |
توفر مكتبة علامات JSTL SQL علامات للتفاعل مع قواعد البيانات العلائقية (Oracle، MySQL، SQL Server، وما إلى ذلك). بناء الجملة للإشارة إلى مكتبة علامات SQL كما يلي:
<%@ taglib prefix="sql" uri="http://java.sun.com/jsp/jstl/sql" %>
| ملصق | يصف |
|---|---|
| <sql:setDataSource> | تحديد مصدر البيانات |
| <اس كيو ال: استعلام> | تشغيل عبارة استعلام SQL |
| <اس كيو ال: تحديث> | قم بتشغيل بيان تحديث SQL |
| <سقل: بارام> | قم بتعيين المعلمات في عبارة SQL إلى القيمة المحددة |
| <sql:dateParam> | قم بتعيين معلمة التاريخ في عبارة SQL إلى قيمة كائن java.util.Date المحددة |
| <SQL:معاملة> | قم بتوفير عناصر سلوك قاعدة البيانات المتداخلة في اتصال قاعدة بيانات مشتركة لتشغيل كافة البيانات كمعاملة |
توفر مكتبة علامات JSTL XML علامات لإنشاء مستندات XML ومعالجتها. بناء الجملة للإشارة إلى مكتبة علامات XML كما يلي:
<%@ taglib prefix="x" uri="http://java.sun.com/jsp/jstl/xml" %>
قبل استخدام علامة xml، يجب عليك نسخ الحزم ذات الصلة بـ XML وXPath إلى <Tomcat Installation Directory>lib:
XercesImpl.jar:
عنوان التنزيل: http://www.apache.org/dist/xerces/j/
xalan.jar:
عنوان التنزيل: http://xml.apache.org/xalan-j/index.html
| ملصق | يصف |
|---|---|
| <س:خارج> | يشبه <%= ... >، ولكنه يُستخدم فقط في تعبيرات XPath |
| <x:تحليل> | تحليل بيانات XML |
| <س:مجموعة> | قم بتعيين تعبير XPath |
| <س:إذا> | حدد تعبير XPath إذا كان صحيحًا، فقم بتنفيذ المحتوى الموجود في الأنطولوجيا، وإلا قم بتخطي الأنطولوجيا. |
| <x:لكل> | التكرار عبر العقد في مستند XML |
| <س: اختر> | العلامات الأصلية لـ <x:when> و<x:otherwise> |
| <س:متى> | يتم استخدام العلامة الفرعية <x:choose> للحكم المشروط. |
| <x:وإلا> | يتم تنفيذ العلامة الفرعية <x:choose> عندما يتم الحكم على <x:when> بأنها خاطئة. |
| <x:التحويل> | تطبيق تحويلات XSL على مستندات XML |
| <س:المعلمة> | يُستخدم مع <x:transform> لتعيين أوراق أنماط XSL |
تحتوي JSTL على سلسلة من الوظائف القياسية، معظمها عبارة عن وظائف معالجة سلاسل للأغراض العامة. بناء الجملة للرجوع إلى مكتبة وظائف JSTL كما يلي:
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>
| وظيفة | يصف |
|---|---|
| الجبهة الوطنية: يحتوي على () | يختبر ما إذا كانت سلسلة الإدخال تحتوي على السلسلة الفرعية المحددة |
| الجبهة الوطنية: يحتوي علىIgnoreCase() | يختبر ما إذا كانت سلسلة الإدخال تحتوي على السلسلة الفرعية المحددة، وهي غير حساسة لحالة الأحرف |
| الجبهة الوطنية: ينتهي مع () | يختبر ما إذا كانت سلسلة الإدخال تنتهي باللاحقة المحددة |
| الجبهة الوطنية: الهروبXml() | تخطي الأحرف التي يمكن استخدامها كعلامات XML |
| الجبهة الوطنية: فهرس () | إرجاع الموضع الذي تظهر فيه السلسلة المحددة في سلسلة الإدخال |
| الجبهة الوطنية: الانضمام () | دمج العناصر الموجودة في المصفوفة في سلسلة وإخراجها |
| الجبهة الوطنية: الطول () | إرجاع طول السلسلة |
| الجبهة الوطنية: استبدال () | يستبدل الموضع المحدد في سلسلة الإدخال بالسلسلة المحددة ويعود |
| الجبهة الوطنية: تقسيم () | افصل السلسلة بالمحدد المحدد ثم قم بتكوين مصفوفة من السلاسل الفرعية ثم قم بالعودة |
| الجبهة الوطنية: يبدأ مع () | يختبر ما إذا كانت سلسلة الإدخال تبدأ بالبادئة المحددة |
| الجبهة الوطنية: سلسلة فرعية () | إرجاع مجموعة فرعية من السلسلة |
| الجبهة الوطنية: سلسلة فرعية () | إرجاع المجموعة الفرعية من السلسلة بعد السلسلة الفرعية المحددة |
| الجبهة الوطنية: سلسلة فرعية () | إرجاع المجموعة الفرعية من السلسلة قبل السلسلة الفرعية المحددة |
| الجبهة الوطنية: إلىLowerCase() | تحويل الأحرف في السلسلة إلى أحرف صغيرة |
| الجبهة الوطنية: إلىUpperCase() | تحويل الأحرف في سلسلة إلى أحرف كبيرة |
| الجبهة الوطنية: تقليم () | إزالة الأحرف البيضاء البادئة |