نام (NAME)

jrunscript-openjdk21 - شل خط فرمانی اسکریپت‌نویسی جاوا در OpenJDK 21

خلاصه دستور (SYNOPSIS)

توجه:

این ابزار آزمایشی بوده و پشتیبانی نمی‌شود.

jrunscript [گزینه‌ها] [آرگومان‌ها]

گزینه‌ها: نشان‌دهنده گزینه‌های خط فرمان قابل استفاده برای دستور jrunscript است. بخش گزینه‌ها (OPTIONS) را ببینید.
آرگومان‌ها: آرگومان‌ها در صورت استفاده، بلافاصله پس از گزینه‌ها یا نام دستور قرار می‌گیرند. بخش آرگومان‌ها را ببینید.

توضیحات (DESCRIPTION)

دستور jrunscript یک شل خط فرمانی اسکریپت‌نویسی مستقل از زبان است. دستور jrunscript از هر دو حالت تعاملی (read-eval-print) و حالت دسته‌ای (با گزینه -f) برای اجرای اسکریپت‌ها پشتیبانی می‌کند. به‌طور پیش‌فرض از زبان جاوااسکریپت (JavaScript) استفاده می‌شود، اما با استفاده از گزینه -l می‌توان زبان دیگری را تعیین کرد. دستور jrunscript با برقراری ارتباط میان جاوا و زبان اسکریپت‌نویسی، از سبک برنامه‌نویسی اکتشافی پشتیبانی می‌کند.

در صورت استفاده از جاوااسکریپت، دستور jrunscript پیش از ارزیابی اسکریپت کاربر، توابع و اشیاء درونی خاصی را مقداردهی اولیه می‌کند که در مشخصات API مربوط به توابع درونی جاوااسکریپت در jrunscript مستند شده‌اند.

گزینه‌ها (OPTIONS)

-cp path یا -classpath path: محل قرارگیری فایل‌های کلاسی (class files) که اسکریپت برای دسترسی به آن‌ها نیاز دارد را مشخص می‌کند.
-Dname=value: یک ویژگی سیستمی جاوا (Java system property) را مقداردهی می‌کند.
-Jflag: فلگ flag را مستقیماً به ماشین مجازی جاوا (JVM) که دستور jrunscript روی آن در حال اجرا است ارسال می‌کند.
-l language: از زبان اسکریپت‌نویسی مشخص‌شده استفاده می‌کند. به‌طور پیش‌فرض، جاوااسکریپت استفاده می‌شود. برای استفاده از سایر زبان‌های اسکریپت‌نویسی، باید فایل JAR موتور اسکریپت‌نویسی مربوطه را با گزینه -cp یا -classpath مشخص کنید.
-e script: اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند. از این گزینه می‌توان برای اجرای اسکریپت‌های تک‌خطی که کاملاً در خط فرمان مشخص شده‌اند استفاده کرد.
-encoding encoding: کدگذاری نویسه‌های مورداستفاده برای خواندن فایل‌های اسکریپت را مشخص می‌کند.
-f script-file: فایل اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند (حالت دسته‌ای).
-f -: وارد حالت تعاملی می‌شود تا اسکریپت را از ورودی استاندارد بخواند و ارزیابی کند.
-help یا -?: پیام راهنما را نمایش داده و خارج می‌شود.
-q: فهرست تمام موتورهای اسکریپت‌نویسی موجود را نمایش داده و خارج می‌شود.

آرگومان‌ها (ARGUMENTS)

اگر آرگومان‌هایی مشخص شوند و از هیچ‌یک از گزینه‌های -e یا -f استفاده نشده باشد، آرگومان اول فایل اسکریپت در نظر گرفته شده و سایر آرگومان‌ها (در صورت وجود) به عنوان آرگومان‌های اسکریپت ارسال می‌شوند. اگر آرگومان‌ها همراه با گزینه -e یا -f استفاده شوند، تمامی آرگومان‌ها به عنوان آرگومان‌های اسکریپت ارسال خواهند شد. اگر آرگومان‌ها و همچنین گزینه‌های -e و -f مشخص نشوند، از حالت تعاملی استفاده می‌شود.

مثال‌های اجرای اسکریپت‌های درون‌خطی (EXAMPLES)

jrunscript -e "print('hello world')"

jrunscript -e "cat('http://www.example.com')"

مثال استفاده از زبان مشخص‌شده و ارزیابی فایل اسکریپت

jrunscript -l js -f test.js

مثال حالت تعاملی


jrunscript
js> print('Hello World\n');
Hello World
js> 34 + 55
89.0
js> t = new java.lang.Thread(function() { print('Hello World\n'); })
Thread[Thread-0,5,main]
js> t.start()
js> Hello World
js>

اجرای فایل اسکریپت با آرگومان‌های اسکریپت

در این مثال، فایل test.js فایل اسکریپت است. آرگومان‌های arg1، arg2 و arg3 به اسکریپت ارسال می‌شوند. اسکریپت می‌تواند از طریق آرایه arguments به این آرگومان‌ها دسترسی پیدا کند.

jrunscript test.js arg1 arg2 arg3