ArgsOption Ayrıştırıcı

public class ArgsOptionParser
extends OptionSetter

Ayrıştırılmış komut satırı bağımsız değişkenlerindeki Option alanlarını doldurur.

İletilen Dize[] içindeki dizeler soldan sağa doğru ayrıştırılır. Her bir Dize kısa seçenek ("-v" gibi), uzun bir seçenek ("--ayrıntılı" gibi), bir seçeneğin bağımsız değişkeni (ör. "out.txt" "-f out.txt") veya isteğe bağlı olmayan bir konum bağımsız değişkeni kullanın.

Her seçenek bağımsız değişkeni bir veya daha fazla Option alanıyla eşlenmelidir. Uzun bir seçenek, Option adı ve kısa bir seçenek, Option kısa ada karşılık geliyor. Her bir seçeneğin adı ve seçenek kısa adı, diğer tüm seçeneklere kıyasla benzersiz olmalıdır Aynı nesne içinde Option alanı var.

Tek bir seçenek bağımsız değişkeni, aynı ada sahip birden fazla Option alanıyla eşlenebilir birden fazla nesnede birleştirin. Option bağımsız değişkenleri, bir Option alanına, bu nesnenin tam sınıf adını veya ":" ile ayrılmış OptionClass takma ad değeri. ör.

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

Basit bir kısa seçenek, "-" ve ardından kısa bir seçenek karakteri gelir. Seçenek, bağımsız değişkeni (boole olmayan herhangi bir seçenek için geçerlidir) bağımsız bir parametre olarak ancak şart değildir. Yani, "-f out.txt" ve "-fout.txt" kabul edilebilir.

Tek bir "-" işaretinden sonra birden çok kısa seçenek belirtilebilir olduğu sürece ( ikincisi) bağımsız değişken gerekmez.

Uzun bir seçenek "--" ile başlar ve ardından birkaç karakter gelir. Seçenek, bağımsız değişkeni, doğrudan seçenek adından sonra, "=" ile ayrılmış olarak veya bağımsız değişkeninin önüne geçer. (Yani, "--file=out.txt" veya "--file out.txt".)

Uzun bir boole seçeneği olan "--name" otomatik olarak bir '--no-name' alır yardımcı olur. Bir seçenek sunuluyorsa "--flag", ardından, "--flag", "--no-flag", "--flag=true", ve "--flag=false" hepsi geçerlidir ancak "--flag true" yok veya "--flag false" izin verilir ("--flag" tek başına yeterli olduğundan "true" ifadesinden sonra veya "false" ayrı yorumlanır). "Evet" yazabilirsiniz. ve "no" eş anlamlılar olarak "true" (doğru) için ve "false" olarak ayarlayın.

Her Dize "-" ile başlamıyor ve önceki seçeneğin zorunlu bir bağımsız değişkeni değil, ve sonraki tüm Dizeler için olduğu gibi, isteğe bağlı olmayan konumsal bağımsız değişkendir. "--" işaretinden sonra gelen her Dize bir isteğe bağlı olmayan konumsal bağımsız değişkendir.

Seçeneklere karşılık gelen alanlar, seçenekler işlendikçe güncellenir. Kalanların sayısı konum bağımsız değişkenleri List<String> olarak döndürülür.

Aşağıda basit bir örnek verilmiştir:

 // 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) {
        ...
     }
     ...

 }

 

• getopt(1) kılavuz sayfası
• Python'un "optparse" modül (http://docs.python.org/library/optparse.html)
• POSIX "Yardımcı Program Söz Dizimi Yönergeleri" (http://www.opengroup.org/onlinepubs/000095399/basedefs/xbd_chap12.html#tag_12_02)
• GNU "Komut Satırı Arayüzleri Standartları" (http://www.gnu.org/prep/standards/standards.html#Command_002dLine-Interfaces)

Özet

Kamu inşaatçıları

public ArgsOptionParser ( optionSources)

public ArgsOptionParser (Object... optionSources)

Herkese açık yöntemler

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 ()