ArgsOptionParser

public class ArgsOptionParser
extends OptionSetter

فیلدهای Option را از آرگومان های خط فرمان تجزیه شده پر می کند.

رشته های موجود در رشته ارسال شده[] از چپ به راست تجزیه می شوند. هر رشته به عنوان یک گزینه کوتاه (مانند "-v")، یک گزینه طولانی (مانند "--verbose")، یک آرگومان برای یک گزینه (مانند "out.txt" در "-f out.txt" طبقه بندی می شود. ")، یا یک آرگومان موقعیتی غیر اختیاری.

هر آرگومان گزینه باید به یک یا چند فیلد Option نگاشت شود. یک گزینه طولانی به نام Option و یک Option کوتاه به نام کوتاه گزینه نگاشت می شود. نام هر گزینه و نام کوتاه گزینه باید با توجه به سایر فیلدهای Option در همان شی منحصر به فرد باشد.

یک آرگومان گزینه واحد می تواند به چندین فیلد Option با نام یکسان در چندین شیء نگاشت شود. آرگومان‌های Option را می‌توان برای ارجاع منحصربه‌فرد به یک فیلد Option در یک شی منفرد با استفاده از نام کلاس کامل آن شی یا مقدار نام مستعار OptionClass آن که با «:» از هم جدا شده است، استفاده کرد. یعنی

 --classname:optionname optionvalue or
 --optionclassalias:optionname optionvalue.
 

یک گزینه کوتاه ساده یک "-" است که با یک کاراکتر گزینه کوتاه همراه است. اگر گزینه به آرگومان نیاز دارد (که در مورد هر گزینه غیر بولی صدق می کند)، ممکن است به عنوان یک پارامتر جداگانه نوشته شود، اما لازم نیست. یعنی «-f out.txt» و «-fout.txt» هر دو قابل قبول هستند.

می توان چند گزینه کوتاه را بعد از یک "-" مشخص کرد تا زمانی که همه (به جز احتمالاً آخرین) به آرگومان نیاز نداشته باشند.

یک گزینه طولانی با "--" و به دنبال آن چندین کاراکتر شروع می شود. اگر گزینه ای به آرگومان نیاز دارد، ممکن است مستقیماً بعد از نام گزینه، با «="» یا به عنوان آرگومان بعدی جدا شود. (یعنی "--file=out.txt" یا "--file out.txt".)

یک گزینه طولانی بولی '--name' به طور خودکار یک همراه '--no-name' دریافت می کند. با در نظر گرفتن گزینه "--flag"، سپس، "--flag"، "--no-flag"، "--flag=true" و "--flag=false" همگی معتبر هستند، هر چند نه "--flag" درست است یا «--پرچم نادرست» مجاز هستند (از آنجایی که «--پرچم» به خودی خود کافی است، «درست» یا «نادرست» زیر به طور جداگانه تفسیر می شود). می توانید از «بله» و «نه» به عنوان مترادف «درست» و «نادرست» استفاده کنید.

هر رشته ای که با یک "-" شروع نمی شود و آرگومان مورد نیاز گزینه قبلی نیست، مانند همه رشته های متوالی، یک آرگومان موقعیتی غیر گزینه ای است. هر رشته بعد از "--" یک آرگومان موقعیتی غیر گزینه ای است.

فیلدهای مربوط به گزینه ها با پردازش گزینه های آنها به روز می شوند. هر آرگومان موقعیتی باقیمانده به صورت List<String> برگردانده می شود.

در اینجا یک مثال ساده آورده شده است:

 // Non-@Option fields will be ignored.
 class Options {
     @Option(name = "quiet", shortName = 'q')
     boolean quiet = false;

     // Here the user can use --no-color.
     @Option(name = "color")
     boolean color = true;

     @Option(name = "mode", shortName = 'm')
     String mode = "standard; // Supply a default just by setting the field.

     @Option(name = "port", shortName = 'p')
     int portNumber = 8888;

     // There's no need to offer a short name for rarely-used options.
     @Option(name = "timeout" )
     double timeout = 1.0;

     @Option(name = "output-file", shortName = 'o' })
     File output;

     // Multiple options are added to the collection.
     // The collection field itself must be non-null.
     @Option(name = "input-file", shortName = 'i')
     List<File> inputs = new ArrayList<File>();

 }

 Options options = new Options();
 List<String> posArgs = new OptionParser(options).parse("--input-file", "/tmp/file1.txt");
 for (File inputFile : options.inputs) {
     if (!options.quiet) {
        ...
     }
     ...

 }

 

• صفحه man getopt(1).
• ماژول "optparse" پایتون (http://docs.python.org/library/optparse.html)
• POSIX "دستورالعمل های نحوی کاربردی" (http://www.opengroup.org/onlinepubs/000095399/basedefs/xbd_chap12.html#tag_12_02)
• "استانداردهای رابط های خط فرمان" گنو (http://www.gnu.org/prep/standards/standards.html#Command_002dLine-Interfaces)

خلاصه

سازندگان عمومی

public ArgsOptionParser ( optionSources)

public ArgsOptionParser (Object... optionSources)

روش های عمومی

public  getInopOptions ()

public static String getOptionHelp (boolean importantOnly, 
                Object optionObject)

   [-option_shortname, --option_name]          [option_description] Default:
   [current option field's value in optionObject]
 

public  parse (String... args)

public  parse ( args)

public  parseBestEffort ( args)

public  parseBestEffort ( args, 
                boolean forceContinue)

public  parseBestEffort (String... args)

public void validateMandatoryOptions ()