نام (NAME)

jrunscript - اجرای یک پوستهٔ اسکریپت خط فرمانی با پشتیبانی از حالت‌های تعاملی و دسته‌ای

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

نکته:

این ابزار آزمایشی است و پشتیبانی نمی‌شود. این ابزار منسوخ شده است و در نسخه‌های آینده حذف خواهد شد.

jrunscript [options] [arguments]

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

توضیحات (DESCRIPTION)

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

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

گزینه‌های دستور JRUNSCRIPT (OPTIONS FOR THE JRUNSCRIPT COMMAND)

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

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

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

مثال اجرای اسکریپت‌های درون‌خطی (EXAMPLE OF EXECUTING INLINE SCRIPTS)

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

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

مثال استفاده از زبان مشخص‌شده و ارزیابی فایل اسکریپت (EXAMPLE OF USING SPECIFIED LANGUAGE AND EVALUATE THE SCRIPT FILE)

jrunscript -l js -f test.js

مثال حالت تعاملی (EXAMPLE OF INTERACTIVE MODE)

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>

اجرای فایل اسکریپت با آرگومان‌های اسکریپت (RUN SCRIPT FILE WITH SCRIPT ARGUMENTS)

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

jrunscript test.js arg1 arg2 arg3