streamalism.org

Amint láttuk, az érvek nélküli opciók esetében a jelenlétüket vagy hiányukat mindig a-ra értékelik logikai érték.

Lehetséges azonban olyan argumentumok regisztrálása, amelyek argumentumokat tartalmaznak. Megtehetjük ezt egyszerűen úgy, hogy a mezőnket más típusúnak nyilvánítjuk. Tegyük hozzá a üzenet lehetőség a mi elkövetni parancs:

@Option (nevek = {"-m", "--message"}) privát karakterlánc-üzenet; @Orride public void run () {System.out.println ("Milyen csodálatos a fájlok végrehajtása az átmeneti területen?"); if (üzenet! = null) {System.out.println ("Az elkötelezett üzenet" + üzenet); }}

Nem meglepő, ha megadják a üzenet opciót, a parancs megjeleníti az elkövetési üzenetet a konzolon. A cikk későbbiben kitérünk arra, hogy mely típusokat kezeli a könyvtár, és hogyan kezeljük más típusokat.

5.3. Opció több érvvel

De most mi van, ha azt akarjuk, hogy a parancsunk több üzenetet is fogadjon, ahogyan a valódival történik git elkövetni parancs? Semmi gond, tegyük mezőnket egy sor vagy a Gyűjtemény, és nagyjából elkészültünk:

@Option (nevek = {"-m", "--message"}) privát karakterlánc [] üzenetek; @Orride public void run () {System.out.println ("Fájlok elkötelezése az átmeneti területen, milyen csodálatos?"); if (üzenetek! = null) {System.out.println ("Az elkötelezett üzenet az"); for (Karakterlánc üzenet: üzenetek) {System.out.println (üzenet); }}}

Most használhatjuk a üzenet opció többször:

elkövetni -m "Az elkötelezettségem nagyszerű" -m "Az elkötelezettségem gyönyörű"

Lehetséges azonban, hogy csak egyszer adjuk meg az opciót, és a különböző paramétereket egy regex elválasztóval választjuk el. Ezért használhatjuk a hasított paramétere @Választási lehetőség kommentár:

@Option (nevek = {"-m", "--message"}, split = ",") privát karakterlánc [] üzenetek;

Most átmehetünk -m „Nagy az elkötelezettségem”, „gyönyörű az elkötelezettségem” hogy a fentivel azonos eredményt érjünk el.

5.4. Szükséges opció

Előfordulhat, hogy van egy szükséges lehetőségünk. A kívánt argumentum, amely alapértelmezés szerint hamislehetővé teszi számunkra, hogy:

@Option (nevek = {"-m", "--message"}, kötelező = igaz) privát karakterlánc [] üzenetek;

Most lehetetlen felhívni a elkövetni parancsot a üzenet választási lehetőség. Ha megpróbáljuk ezt megtenni, pikocli hibát nyomtat:

Hiányzik a kötelező opció '--message =' Használat: git elkövetés -m = [-m =] ... -m, --message =

6. Pozíciós paraméterek kezelése

6.1. Helyzeti paraméterek rögzítése

Most koncentráljunk a sajátjainkra hozzá parancsot, mert még nem túl erős. Csak az összes fájl hozzáadásáról dönthetünk, de mi van, ha konkrét fájlokat akarunk hozzáadni?

Ehhez használhatnánk egy másik opciót is, de itt jobb választás lenne a helyzeti paraméterek használata. Valóban, A helyzeti paraméterek olyan parancs argumentumokat hivatottak rögzíteni, amelyek meghatározott pozíciókat foglalnak el, és amelyek sem alparancsok, sem opciók.

Példánkban ez lehetővé tenné számunkra, hogy ilyesmit tegyünk:

add fájl1 fájl2

A helyzeti paraméterek rögzítése érdekében ki fogjuk használni a @Paraméterek annotáció:

@Parameters private List fájlok; @Orride public void run () {if (allFiles) {System.out.println ("Az összes fájl hozzáadása az átmeneti területhez"); } if (fájlok! = null) {files.forEach (elérési út -> System.out.println ("+ útvonal +" hozzáadása az átmeneti területhez ")); }}

Most a korábbi parancsunk kinyomtatta:

File1 hozzáadása az átmeneti területhez File2 hozzáadása az átmeneti területhez

6.2. Rögzítse a pozícióparaméterek egy részhalmazát

A.-Nek köszönhetően pontosabban meg lehet határozni, hogy mely pozíciós paramétereket rögzítse index az annotáció paramétere. Az index nulla alapú. Így, ha meghatározzuk:

@Parameters (index = "2 .. *")

Ez olyan argumentumokat rögzítene, amelyek nem felelnek meg az opcióknak vagy az alparancsoknak, a harmadiktól a végéig.

Az index lehet tartomány vagy egyetlen szám, amely egyetlen pozíciót képvisel.

7. Egy szó a típusátalakításról

Amint azt az oktatóanyag korábban látta, pikocli valamilyen típusú átalakítást egyedül kezel. Például több értéket is leképez tömbök vagy Gyűjtemények, de az argumentumokat meghatározott típusokhoz is leképezheti, például amikor a Pálya osztály a hozzá parancs.

Ami azt illeti, pikocli csomó előre kezelt típus érkezik. Ez azt jelenti, hogy ezeket a típusokat közvetlenül használhatjuk anélkül, hogy saját magunk kellene átalakítanunk őket.

Előfordulhat azonban, hogy a parancs argumentumait a már kezelt típusoktól eltérő típusokra kell feltérképeznünk. Szerencsénkre ez a ITypeConverter interfész és a CommandLine # registerConverter metódus, amely egy típust társít egy átalakítóhoz.

Képzeljük el, hogy hozzá akarjuk adni a konfig alparancsnokság a mi git parancsot, de nem akarjuk, hogy a felhasználók megváltoztassanak egy nem létező konfigurációs elemet. Tehát úgy döntünk, hogy ezeket az elemeket egy enumra térképezzük fel:

public enum ConfigElement {USERNAME ("felhasználónév"), EMAIL ("user.email"); privát végső karakterlánc értéke; ConfigElement (String érték) {this.value = érték; } public String value () {return value; } public static ConfigElement from (String value) {return Arrays.stream (values ​​()) .filter (element -> element.value.equals (value)) .findFirst (). orElseThrow (() -> new IllegalArgumentException ("A "+ value +" argumentum nem egyezik meg a ConfigElement elemével ")); }}

Ráadásul az újonnan létrehozott GitConfigCommand osztály, adjunk hozzá két helyzeti paramétert:

@Parameters (index = "0") privát ConfigElement elem; @Parameters (index = "1") privát karakterlánc értéke; @Orride public void run () {System.out.println ("Setting" + element.value () + "to" + value); }

Így megbizonyosodunk arról, hogy a felhasználók nem módosíthatják a nem létező konfigurációs elemeket.

Végül regisztrálnunk kell a konverterünket. A legszebb az, hogy ha Java 8-at vagy újabbat használunk, nem is kell létrehoznunk egy osztályt a ITypeConverter felület. Csak átadhatunk egy lambda vagy módszer hivatkozást a registerConverter () módszer:

CommandLine commandLine = új CommandLine (új GitCommand ()); commandLine.registerConverter (ConfigElement.class, ConfigElement :: from); commandLine.parseWithHandler (új RunLast (), érvel);

Ez történik a GitCommand fő() módszer. Ne feledje, hogy el kellett engednünk a kényelmet CommandLine.run () módszer.

Kezeletlen konfigurációs elemnél használva a parancs megmutatja a súgó üzenetet és egy olyan információt, amely elmondja nekünk, hogy a paramétert nem lehet konvertálni ConfigElement:

A 0. index helyzeti paraméterének érvénytelen értéke (): nem lehet átalakítani a 'user.phone' fájlt ConfigElement-re (java.lang.IllegalArgumentException: A user.phone argumentum nem felel meg egyetlen ConfigElement-nek sem) Használat: git config 

8. Integrálás a tavaszi csomagtartóval

Végül lássuk, hogyan lehet mindezt ruganyosítani!

Valójában lehet, hogy egy Spring Boot környezetben dolgozunk, és a parancssori programunkban szeretnénk hasznot húzni belőle. Ennek érdekében létre kell hoznunk a SpringBootApplicationa CommandLineRunner felület:

@SpringBootApplication public class Application végrehajtja a CommandLineRunner {public static void main (String [] args) {SpringApplication.run (Application.class, args); } @Orride public void run (String ... args) {}}

Plusz, jegyezzük fel az összes parancsunkat és alparancsunkat a Tavaszra @Összetevő annotáció és írja be mindezt a miénkbe Alkalmazás:

privát GitCommand gitCommand; privát GitAddCommand addCommand; privát GitCommitCommand commCommand; privát GitConfigCommand configCommand; nyilvános alkalmazás (GitCommand gitCommand, GitAddCommand addCommand, GitCommitCommand commCommand, GitConfigCommand configCommand) {this.gitCommand = gitCommand; this.addCommand = addCommand; this.commitCommand = kötelezettségCommand; this.configCommand = configCommand; }

Ne feledje, hogy minden alparancsot automatikusan be kellett írnunk. Sajnos ez azért van, mert egyelőre pikocli még nem képes az alparancsok lekérésére a tavaszi kontextusból, amikor deklaratív módon (annotációkkal) deklarálják. Így ezt a vezetéket magunknak kell elvégeznünk, programozott módon:

@Orride public void run (String ... args) {CommandLine commandLine = new CommandLine (gitCommand); commandLine.addSubcommand ("add", addCommand); commandLine.addSubcommand ("elkövetés", kötelezettségCommand); commandLine.addSubcommand ("config", configCommand); commandLine.parseWithHandler (új CommandLine.RunLast (), érvel); }

És most a parancssori programunk varázslatként működik a Spring alkatrészekkel. Ezért létrehozhatunk néhány szolgáltatási osztályt, és felhasználhatjuk őket a parancsainkban, és hagyhatjuk, hogy Spring gondoskodjon a függőségi injekcióról.

9. Következtetés

Ebben a cikkben láttuk a pikocli könyvtár. Megtanultuk, hogyan kell új parancsot létrehozni, és hozzáadni néhány alparancsot. Számos módot láthattunk az opciók és a helyzeti paraméterek kezelésére. Ráadásul megtanultuk, hogyan kell saját típusú átalakítóinkat megvalósítani, hogy a parancsaink erőteljesen be legyenek írva. Végül láttuk, hogyan lehet a Spring Boot-ot bevinni a parancsokba.

Természetesen még sok mindent felfedezhetünk benne. A könyvtár teljes dokumentációt biztosít.

Ami a cikk teljes kódját illeti, megtalálható a GitHub-on.