پرش به محتوای اصلی

راهنمای قالب‌بندی XML و آزمایشگر XPath

زمان مطالعه: ۲ دقیقه

این ابزار چیست؟

XML هنوز در بسیاری از جاها هست: فاکتور الکترونیکی و وب‌سرویس‌های SOAP، فایل‌های پیکربندی Java و Android، نقشه‌ی سایت و خوراک RSS. فایل XML که در یک خط آمده تقریباً خواندنی نیست و پیدا کردن یک مقدار در آن سخت است. این ابزار XML را مرتب یا فشرده می‌کند و عبارت XPath را روی آن اجرا می‌کند تا عنصرها، ویژگی‌ها یا متن موردنظر را با مسیر دقیقشان پیدا کنید.

فضاهای نام اعلام‌شده خودکار شناخته می‌شوند و می‌توانید برای هر کدام پیشوند دلخواه در XPath بگذارید. همه‌چیز در مرورگر شما انجام می‌شود.

گام‌به‌گام

  1. XML را بچسبانید

    متن را در «XML ورودی» بگذارید. اگر ساختارش درست نباشد، پیام «XML معتبر نیست» با توضیح خطا می‌آید.

  2. مرتب یا فشرده کنید

    در «XML مرتب‌شده» نسخه‌ی تورفته را می‌بینید؛ با «زیباسازی» و «فشرده‌سازی» شکل خروجی را عوض کنید و آن را کپی کنید.

  3. XPath بنویسید

    عبارتی مثل //book[@id='2']/title را بنویسید؛ گره‌های پیدا‌شده با نوع و مسیرشان فهرست می‌شوند و عبارت‌هایی مثل count() یک مقدار ساده برمی‌گردانند.

  4. فضای نام را تنظیم کنید

    اگر XML فضای نام دارد، در جدول فضاهای نام برای هر نشانی یک «پیشوند در XPath» تعیین کنید و در عبارت از همان پیشوند استفاده کنید.

نمونه‌های کاربردی

  • متن یک عنصر با شرط روی ویژگی

    عنوان کتابی که ویژگی id آن ۲ است.

    <catalog><book id="1"><title>A</title></book><book id="2"><title>B</title></book></catalog>

    نتیجه: B · مسیر /catalog[1]/book[2]/title[1]/text()[1]

  • شمارش عنصرها

    تابع count یک عدد برمی‌گرداند، نه فهرست گره.

    <catalog><book id="1"><title>A</title></book><book id="2"><title>B</title></book></catalog>

    نتیجه: 2

اشتباه‌های رایج

  • نادیده گرفتن فضای نام پیش‌فرض: اگر ریشه xmlns دارد، //book چیزی پیدا نمی‌کند، چون نام کامل عنصر شامل فضای نام است. برای آن پیشوند بگذارید و بنویسید //x:book.
  • شمارش از صفر: در XPath شماره‌ی موقعیت از ۱ شروع می‌شود؛ book[1] اولین کتاب است.
  • فراموش کردن @ برای ویژگی: id بدون @ به عنصر فرزندی به نام id اشاره می‌کند، نه به ویژگی.
  • فشرده کردن XML که فاصله‌هایش معنا دارد: در برخی قالب‌ها فاصله‌ی داخل متن مهم است؛ پیش از جایگزینی فایل اصلی، خروجی را بررسی کنید.

XPath در چند خط

/ از ریشه شروع می‌کند و // در هر عمقی می‌گردد. داخل کروشه شرط می‌آید، مثل [@id='2'] برای ویژگی یا [price>10] برای عنصر فرزند. text() متن داخل عنصر و @name مقدار ویژگی را برمی‌گرداند.

تابع‌هایی مثل count()، contains() و starts-with() هم در دسترس‌اند. مسیرهایی که این ابزار برای هر گره نشان می‌دهد، خودشان عبارت XPath درستی‌اند و می‌توانید در کد استفاده کنید.

پرسش‌های متداول

XML در صفحه اجرا می‌شود؟
خیر. XML فقط با یک تجزیه‌گر متنی خوانده می‌شود و هیچ‌وقت به DOM صفحه افزوده نمی‌شود.
موجودیت‌های خارجی (XXE) چه می‌شوند؟
هیچ فایل یا نشانی بارگذاری نمی‌شود. اگر XML تعریف ENTITY داشته باشد، پردازش متوقف می‌شود و هشدار می‌گیرید.
فضای‌نام پیش‌فرض را چطور در XPath بنویسم؟
XPath 1.0 برای فضای‌نام پیش‌فرض پیشوند لازم دارد. این ابزار آن را با پیشوند d در جدول فضای‌نام‌ها تعریف می‌کند؛ مثلاً //d:item.

ابزارهای مرتبط