Svet.PríkazovýRiadok

java.lang.Object
- podpora.ExecuteShellCommand
- - Svet.PríkazovýRiadok

Známe priame odvodené triedy:: Svet.PrikazovyRiadok

Nadradená trieda:: Svet

public static class Svet.PríkazovýRiadok
extends knižnica.podpora.ExecuteShellCommand

Hlavná časť implementácie jednoduchého príkazového riadka operačného systému. Dovoľuje spravovať jeden spustený proces. Verejné atribúty tejto triedy a vnútorné rozhranie na presmerovanie výstupov nemajú z dôvodu výrazného zjednodušenia celej implementácie definované aliasy bez diakritiky.

Príklad – grafická konzola:

Zobraziť dlhšiu verziu (s alternatívnou implementáciou ovládania konzoly v komentároch).

import knižnica.*;
import java.io.IOException;

public class GrafickáKonzola extends GRobot
{
    // Súčasť implementácie ukončenia spusteného procesu klávesovou
    // skratkou.
    private final static String kill = "kill";

    // Príznak aktivovania vnútorného príkazu pause.
    private boolean pause = false;

    // Konštruktor.
    private GrafickáKonzola()
    {
        skry();
        Svet.skratkyStropu(true);
        Svet.neskrývajVstupnýRiadok(true);
        Svet.príkazovýRiadok.output(Svet.príkazovýRiadok.getVersion());
        strop.automatickéZobrazovanieLíšt(true);
        strop.písmo("Consolas", 14);

        // Súčasť implementácie ukončenia spusteného procesu klávesovou
        // skratkou.
        Svet.pridajKlávesovúSkratku(kill, Kláves.VK_D);
    }

    // Súčasť implementácie ukončenia spusteného procesu klávesovou
    // skratkou. (Metóda je zároveň využitá v reakcii na ukončenie
    // aplikácie.)
    private void killProcess()
    {
        Process proces = Svet.príkazovýRiadok.getRunningProcess();
        if (null != proces)
            proces.destroy();
    }

    @Override public void klávesováSkratka()
    {
        String skratka = ÚdajeUdalostí.príkazSkratky();

        // Súčasť implementácie ukončenia spusteného procesu klávesovou
        // skratkou.
        if (skratka == kill) killProcess();
    }

    // Využitie vstupného riadka na vstup príkazového riadka.
    @Override public void potvrdenieVstupu()
    {
        if (pause)
        {
            pause = false;
            return;
        }

        String príkaz = Svet.prevezmiReťazec();
        if (!Svet.príkazovýRiadok.isProcessRunning())
        {
            Svet.príkazovýRiadok.output(Svet.príkazovýRiadok.expandPrompt());
            Svet.príkazovýRiadok.output(príkaz);
            if (príkaz.isEmpty()) return;

            // Prekrytie dvoch predvolene deaktivovaných príkazov:
            int[] zhoda = Svet.PríkazovýRiadok.matchCommand(
                príkaz, "pause", "exit");

            // Poznámka: Na to, aby niektoré príkazy fungovali rovnako ako
            //     v systémovej konzole, by musela byť na tomto mieste
            //     vykonaná dodatočná implementácia. Súvisí to najmä
            //     s príkazom na zmenu priečinka (cd/chdir). V príkazovom
            //     riadku Windows sa zvyknú používať tieto skrátené formy
            //     príkazu:
            // 
            //     cd\   chdir\
            // 
            //     (Podobne ako v iných OS tvary: cd/ a chdir/)
            // 
            //     Znamenajú prechod do koreňového priečinka aktuálnej
            //     jednotky. Tieto skrátené tvary nie sú spracované. Okrem
            //     tohto faktu samotný symbol \ alebo / nemá v tejto
            //     konzole význam koreňového priečinka. Implementácia
            //     metódy ExecuteShellCommand.changePath sa správa inak:
            //       1. prevezme zadaný reťazec,
            //       2. identifikuje, či ide o relatívnu alebo absolútnu
            //          cestu
            //       3. a podľa toho nastaví novú aktuálnu cestu.
            //     Samotné znaky \ a / nenesú informáciu o zmene
            //     priečinka, takže sú v podstate ignorované.
            // 
            //     Ďalšia odlišnosť je správanie sa príkazu cd/chdir
            //     bez parametrov. V súlade s opisom fungovania metódy
            //     ExecuteShellCommand.changePath spôsobí potvrdenie
            //     tohto príkazu návrat do aktuálneho štartovacieho
            //     priečinka virtuálneho stroja javy (JVM), to jest,
            //     cesta, na ktorej bola spustená aktuálna aplikácia
            //     (nemusí sa nevyhnutne zhodovať s cestou, na ktorej
            //     je aplikácia umiestnená).

            if (null != zhoda && 3 != zhoda[0])
            {
                String argumenty = príkaz.substring(zhoda[2]);

                switch (zhoda[1])
                {
                case 0: // pause
                    if (argumenty.isEmpty())
                        Svet.príkazovýRiadok.outputLine(riadok,
                            "Potvrďte ďalší príkazový riadok.");
                    else
                        Svet.príkazovýRiadok.outputLine(riadok,
                            Svet.príkazovýRiadok.expandVariables(argumenty));
                    pause = true;
                    return;

                case 1: // exit
                    Svet.koniec();
                    // (Prípadne by sa dala použiť metóda Svet.zavrieť.)
                    return;
                }
            }
        }

        Svet.príkazovýRiadok.updateTitle();
        Svet.spracujPríkaz(príkaz);
        Svet.príkazovýRiadok.updateTitle();
    }

    // Súčasť ukladania a čítania konfigurácie príkazového riadka.
    @Override public boolean konfiguráciaZmenená()
    {
        if (null == Svet.príkazovýRiadok) return false;
        return Svet.príkazovýRiadok.konfiguráciaZmenená;
    }

    // Súčasť ukladania a čítania konfigurácie príkazového riadka.
    @Override public void zapíšKonfiguráciu(Súbor súbor) throws IOException
    {
        if (null == Svet.príkazovýRiadok) return;

        // Pozor‼ V čase zápisu konfigurácie by vlastnosti nastavení
        // príkazového riadka mali byť pre istotu zapísané bez ohľadu
        // na hodnotu príznaku „Svet.príkazovýRiadok.konfiguráciaZmenená.“
        // Nemáme istotu, že inštancia konfiguračného súboru nemá nastavenú
        // vlastnosť „odstraňujNepoužitéVlastnosti.“

        Svet.príkazovýRiadok.zapíšKonfiguráciu(súbor);
    }

    // Súčasť ukladania a čítania konfigurácie príkazového riadka.
    @Override public void čítajKonfiguráciu(Súbor súbor) throws IOException
    {
        if (null == Svet.príkazovýRiadok) return;
        Svet.príkazovýRiadok.čítajKonfiguráciu(súbor);
    }

    // (Prekresľovanie pomocou časovača, aby bola činnosť
    // konzoly svižnejšia.)
    @Override public void tik()
    {
        if (Svet.neboloPrekreslené())
            Svet.prekresli();
    }

    // Ukončenie.
    @Override public void ukončenie()
    {
        // Ak je náhodou spustený vnorený (detský) proces, nezostáva iné
        // riešenie ako ho ukončiť:
        killProcess();
    }

    // Hlavná (vstupná) metóda.
    public static void main(String[] args)
    {
        Svet.režimLadenia(true);
        Svet.skry();
        Svet.nekresli();
        Svet.aktivujHistóriuVstupnéhoRiadka();
        Svet.uchovajHistóriuVstupnéhoRiadka();
        Svet.použiKonfiguráciu("GrafickáKonzola.cfg");
        new GrafickáKonzola();
        Svet.spustiČasovač();
        Svet.zobraz();
    }
}

Zobraziť kratšiu verziu (bez komentárov obsahujúcich alternatívnu implementáciu ovládania konzoly).

import knižnica.*;
import java.io.IOException;

public class GrafickáKonzola extends GRobot
{
    // Súčasť alternatívnej implementácie rolovania a posúvania textov
    // vnútornej konzoly stropu pomocou klávesnice.
    // 
    // Poznámka: Nahradené príkazom Svet.skratkyStropu(true);
    // 
    /*private final static String home = "home";
    private final static String end  = "end";
    private final static String hore = "hore";
    private final static String dole = "dole";
    private final static String pgUp = "pgUp";
    private final static String pgDn = "pgDn";*/

    // Súčasť implementácie ukončenia spusteného procesu klávesovou
    // skratkou.
    private final static String kill = "kill";

    // Súčasť alternatívnej implementácie označovania a kopírovania
    // textov stropu.
    // 
    // Poznámka: Nahradené príkazom Svet.skratkyStropu(true);
    // 
    /*private final static String dAll1 = "dAll1";
    private final static String dAll2 = "dAll2";
    private final static String sAll = "sAll";
    private final static String copy = "copy";*/

    // Príznak aktivovania vnútorného príkazu pause.
    private boolean pause = false;

    // Konštruktor.
    private GrafickáKonzola()
    {
        skry();
        Svet.skratkyStropu(true);
        Svet.neskrývajVstupnýRiadok(true);
        Svet.príkazovýRiadok.output(Svet.príkazovýRiadok.getVersion());
        strop.automatickéZobrazovanieLíšt(true);
        strop.písmo("Consolas", 14);

        // Súčasť alternatívnej implementácie rolovania a posúvania textov
        // vnútornej konzoly stropu pomocou klávesnice.
        /*Svet.pridajKlávesovúSkratku(home, Kláves.HOME);
        Svet.pridajKlávesovúSkratku(end,  Kláves.END);
        Svet.pridajKlávesovúSkratku(hore, Kláves.HORE);
        Svet.pridajKlávesovúSkratku(dole, Kláves.DOLE);
        Svet.pridajKlávesovúSkratku(pgUp, Kláves.PAGE_UP, 0); // bez ctrl…
        Svet.pridajKlávesovúSkratku(pgDn, Kláves.PAGE_DOWN, 0);*/

        // Súčasť implementácie ukončenia spusteného procesu klávesovou
        // skratkou.
        Svet.pridajKlávesovúSkratku(kill, Kláves.VK_D);

        // Súčasť alternatívnej implementácie označovania a kopírovania
        // textov stropu.
        /*Svet.pridajKlávesovúSkratku(dAll1, Kláves.VK_A,
        	Kláves.SKRATKA_PONUKY | Kláves.SHIFT_MASK);
        Svet.pridajKlávesovúSkratku(dAll2, Kláves.ESCAPE, 0, false);
        Svet.pridajKlávesovúSkratku(sAll, Kláves.VK_A,
        	Kláves.SKRATKA_PONUKY, false);
        Svet.pridajKlávesovúSkratku(copy, Kláves.VK_C,
        	Kláves.SKRATKA_PONUKY, false);*/
    }

    // Súčasť implementácie ukončenia spusteného procesu klávesovou
    // skratkou. (Metóda je zároveň využitá v reakcii na ukončenie
    // aplikácie.)
    private void killProcess()
    {
        Process proces = Svet.príkazovýRiadok.getRunningProcess();
        if (null != proces)
            proces.destroy();
    }

    @Override public void klávesováSkratka()
    {
        String skratka = ÚdajeUdalostí.príkazSkratky();

        // Súčasť alternatívnej implementácie rolovania a posúvania textov
        // vnútornej konzoly stropu pomocou klávesnice.
        /*if (skratka == home) strop.posunutieTextov(
        	strop.posunutieTextovX(), strop.poslednáVýškaTextu());
        else if (skratka == end)
        	strop.posunutieTextov(strop.posunutieTextovX(), 0);
        else if (skratka == hore)
        	strop.rolujTexty(0, strop.výškaRiadka());
        else if (skratka == dole)
        	strop.rolujTexty(0, -strop.výškaRiadka());
        else if (skratka == pgUp)
        	strop.rolujTexty(0, Plátno.viditeľnáVýška() – 10);
        else if (skratka == pgDn)
        	strop.rolujTexty(0, 10 – Plátno.viditeľnáVýška());*/

        // Súčasť implementácie ukončenia spusteného procesu klávesovou
        // skratkou.
        /*else */if (skratka == kill) killProcess();

        // Súčasť alternatívnej implementácie označovania a kopírovania
        // textov stropu.
        /*else if (skratka == dAll1 || skratka == dAll2)
        	strop.zrušOznačenieTextov();
        else if (skratka == sAll) strop.označVšetkyTexty();
        else if (skratka == copy) strop.textyDoSchránky(true);*/
    }

    // Využitie vstupného riadka na vstup príkazového riadka.
    @Override public void potvrdenieVstupu()
    {
        if (pause)
        {
            pause = false;
            return;
        }

        String príkaz = Svet.prevezmiReťazec();
        if (!Svet.príkazovýRiadok.isProcessRunning())
        {
            Svet.príkazovýRiadok.output(Svet.príkazovýRiadok.expandPrompt());
            Svet.príkazovýRiadok.output(príkaz);
            if (príkaz.isEmpty()) return;

            // Prekrytie dvoch predvolene deaktivovaných príkazov:
            int[] zhoda = Svet.PríkazovýRiadok.matchCommand(
                príkaz, "pause", "exit");

            // Poznámka: Na to, aby niektoré príkazy fungovali rovnako ako
            //     v systémovej konzole, by musela byť na tomto mieste
            //     vykonaná dodatočná implementácia. Súvisí to najmä
            //     s príkazom na zmenu priečinka (cd/chdir). V príkazovom
            //     riadku Windows sa zvyknú používať tieto skrátené formy
            //     príkazu:
            // 
            //     cd\   chdir\
            // 
            //     (Podobne ako v iných OS tvary: cd/ a chdir/)
            // 
            //     Znamenajú prechod do koreňového priečinka aktuálnej
            //     jednotky. Tieto skrátené tvary nie sú spracované. Okrem
            //     tohto faktu samotný symbol \ alebo / nemá v tejto
            //     konzole význam koreňového priečinka. Implementácia
            //     metódy ExecuteShellCommand.changePath sa správa inak:
            //       1. prevezme zadaný reťazec,
            //       2. identifikuje, či ide o relatívnu alebo absolútnu
            //          cestu
            //       3. a podľa toho nastaví novú aktuálnu cestu.
            //     Samotné znaky \ a / nenesú informáciu o zmene
            //     priečinka, takže sú v podstate ignorované.
            // 
            //     Ďalšia odlišnosť je správanie sa príkazu cd/chdir
            //     bez parametrov. V súlade s opisom fungovania metódy
            //     ExecuteShellCommand.changePath spôsobí potvrdenie
            //     tohto príkazu návrat do aktuálneho štartovacieho
            //     priečinka virtuálneho stroja javy (JVM), to jest,
            //     cesta, na ktorej bola spustená aktuálna aplikácia
            //     (nemusí sa nevyhnutne zhodovať s cestou, na ktorej
            //     je aplikácia umiestnená).

            if (null != zhoda && 3 != zhoda[0])
            {
                String argumenty = príkaz.substring(zhoda[2]);

                switch (zhoda[1])
                {
                case 0: // pause
                    if (argumenty.isEmpty())
                        Svet.príkazovýRiadok.outputLine(riadok,
                            "Potvrďte ďalší príkazový riadok.");
                    else
                        Svet.príkazovýRiadok.outputLine(riadok,
                            Svet.príkazovýRiadok.expandVariables(argumenty));
                    pause = true;
                    return;

                case 1: // exit
                    Svet.koniec();
                    // (Prípadne by sa dala použiť metóda Svet.zavrieť.)
                    return;
                }
            }
        }

        Svet.príkazovýRiadok.updateTitle();
        Svet.spracujPríkaz(príkaz);
        Svet.príkazovýRiadok.updateTitle();
    }

    // Súčasť ukladania a čítania konfigurácie príkazového riadka.
    @Override public boolean konfiguráciaZmenená()
    {
        if (null == Svet.príkazovýRiadok) return false;
        return Svet.príkazovýRiadok.konfiguráciaZmenená;
    }

    // Súčasť ukladania a čítania konfigurácie príkazového riadka.
    @Override public void zapíšKonfiguráciu(Súbor súbor) throws IOException
    {
        if (null == Svet.príkazovýRiadok) return;

        // Pozor‼ V čase zápisu konfigurácie by vlastnosti nastavení
        // príkazového riadka mali byť pre istotu zapísané bez ohľadu
        // na hodnotu príznaku „Svet.príkazovýRiadok.konfiguráciaZmenená.“
        // Nemáme istotu, že inštancia konfiguračného súboru nemá nastavenú
        // vlastnosť „odstraňujNepoužitéVlastnosti.“

        Svet.príkazovýRiadok.zapíšKonfiguráciu(súbor);
    }

    // Súčasť ukladania a čítania konfigurácie príkazového riadka.
    @Override public void čítajKonfiguráciu(Súbor súbor) throws IOException
    {
        if (null == Svet.príkazovýRiadok) return;
        Svet.príkazovýRiadok.čítajKonfiguráciu(súbor);
    }

    // Súčasť alternatívnej implementácie označovania a kopírovania
    // textov stropu.
    /*private int počiatočnýRiadok, koncovýRiadok,
    	počiatočnýBlok, koncovýBlok;*/

    // Súčasť alternatívnej implementácie označovania a kopírovania
    // textov stropu.
    /*@Override public void stlačenieTlačidlaMyši()
    {
    	if (ÚdajeUdalostí.tlačidloMyši(PRAVÉ))
    	{
    		strop.textyDoSchránky(true);
    		strop.zrušOznačenieTextov();
    		Svet.pípni();
    	}
    	else
    	{
    		if (!ÚdajeUdalostí.myš().isControlDown())
    			strop.zrušOznačenieTextov();

    		int[] výpis = strop.výpisPriMyši();
    		if (null != výpis)
    		{
    			počiatočnýRiadok = koncovýRiadok = výpis[0];
    			počiatočnýBlok   = koncovýBlok   = výpis[1];
    		}
    	}
    }*/

    // Súčasť alternatívnej implementácie označovania a kopírovania
    // textov stropu.
    /*@Override public void ťahanieMyšou()
    {
    	int[] výpis = strop.výpisPriMyši();

    	if (null != výpis)
    	{
    		strop.zrušOznačenieVýpisov(
    			počiatočnýRiadok, počiatočnýBlok,
    			koncovýRiadok, koncovýBlok);

    		koncovýRiadok = výpis[0];
    		koncovýBlok   = výpis[1];

    		strop.označVýpisy(
    			počiatočnýRiadok, počiatočnýBlok,
    			koncovýRiadok, koncovýBlok);
    	}
    }*/

    // Alternatívna implementácia klávesovej skratky ESC (bez držania
    // ktoréhokoľvek z modifikátorov), ktorá má význam zrušenia označenia
    // textov konzoly:
    /*@Override public void stlačenieKlávesu()
    {
    	// Tento príznak je platný len vtedy, ak nebol stlačený žiadny
    	// modifikátor:
    	boolean nACS = !(ÚdajeUdalostí.klávesnica().isAltDown() ||
    		ÚdajeUdalostí.klávesnica().isControlDown() ||
    		ÚdajeUdalostí.klávesnica().isMetaDown() ||
    		ÚdajeUdalostí.klávesnica().isShiftDown());

    	// Súčasť alternatívnej implementácie označovania a kopírovania
    	// textov stropu.
    	switch (ÚdajeUdalostí.kláves())
    	{
    	case Kláves.ESCAPE: if (nACS) strop.zrušOznačenieTextov(); break;
    	}
    }*/

    // (Prekresľovanie pomocou časovača, aby bola činnosť
    // konzoly svižnejšia.)
    @Override public void tik()
    {
        if (Svet.neboloPrekreslené())
            Svet.prekresli();
    }

    // Ukončenie.
    @Override public void ukončenie()
    {
        // Ak je náhodou spustený vnorený (detský) proces, nezostáva iné
        // riešenie ako ho ukončiť:
        killProcess();
    }

    // Hlavná (vstupná) metóda.
    public static void main(String[] args)
    {
        Svet.režimLadenia(true);
        Svet.skry();
        Svet.nekresli();
        Svet.aktivujHistóriuVstupnéhoRiadka();
        Svet.uchovajHistóriuVstupnéhoRiadka();
        Svet.použiKonfiguráciu("GrafickáKonzola.cfg");
        new GrafickáKonzola();
        Svet.spustiČasovač();
        Svet.zobraz();
    }
}

Do konfigurácie odporúčame (v OS Windows) pridať tieto riadky:

mapaKódovaní.počet=1
mapaKódovaní.príkaz[0]=cmd
mapaKódovaní.mapovanie[0]=windows-1250

mapaPríkazov.počet=1
mapaPríkazov.príkaz[0]=cmd
mapaPríkazov.mapovanie[0]=%0 /k chcp 1250>nul & %~

Prehľad vnorených tried

Vnorené triedy
Modifikátor a typ	Trieda a opis
`static interface`	`Svet.PríkazovýRiadok.PresmerovanieVýstupu` Toto rozhranie slúži na presmerovanie výstupov a denníkov inštancií príkazového riadka.

Vnorené triedy/rozhrania odvodené od triedy knižnica.podpora.ExecuteShellCommand
podpora.ExecuteShellCommand.StreamPrinter

Prehľad atribútov

Atribúty
Modifikátor a typ	Atribút a opis
`Svet.PríkazovýRiadok.PresmerovanieVýstupu`	`denník` Ak je definovaná (implementovaná) inštancia tohto atribútu, tak všetky (interné alebo externé) volania metódy `log` sú automaticky presmerované do metódy `spracuj` tejto implementácie (inštancie).
`Svet.PríkazovýRiadok.PresmerovanieVýstupu`	`denníkChýb` Ak je definovaná (implementovaná) inštancia tohto atribútu, tak všetky (interné alebo externé) volania metódy `err` sú automaticky presmerované do metódy `spracuj` tejto implementácie (inštancie).
`Color`	`farbaDenníka` Farebné odlíšenie textov denníka.
`Color`	`farbaDenníkaChýb` Farebné odlíšenie textov chybového denníka.
`Color`	`farbaChybovéhoVýstupu` Farebné odlíšenie chybových výstupov externých procesov.
`Color`	`farbaLadenia` Farebné odlíšenie textov ladenia.
`Color`	`farbaVýstupu` Farebné prekrytie všetkých textov štandardného výstupu zachytených touto inštanciou a výstupu niektorých vnútorných príkazov spracovaných metódou sveta `spracujPríkaz` (napríklad ECHO).
`Color`	`farbaVýstupuProcesu` Farebné odlíšenie výstupov externých procesov.
`Svet.PríkazovýRiadok.PresmerovanieVýstupu`	`chybovýVýstup` Ak je definovaná (implementovaná) inštancia tohto atribútu, tak všetky (interné alebo externé) volania metódy `error` sú automaticky presmerované do metódy `spracuj` tejto implementácie (inštancie).
`boolean`	`konfiguráciaZmenená` Príznak toho, že nastavenia inštancie príkazového riadka boli zmenené a mali by byť uložené do konfiguračného súboru.
`Svet.PríkazovýRiadok.PresmerovanieVýstupu`	`ladenie` Ak je definovaná (implementovaná) inštancia tohto atribútu, tak všetky (interné alebo externé) volania metódy `debug` sú automaticky presmerované do metódy `spracuj` tejto implementácie (inštancie; pozri aj triedu `PresmerovanieVýstupu`) a to bez ohľadu na to, či je alebo nie je zapnutý režim ladenia.
`Svet.PríkazovýRiadok.PresmerovanieVýstupu`	`vyčistenie` Toto presmerovanie je odlišné od ostatných.
`Svet.PríkazovýRiadok.PresmerovanieVýstupu`	`výstupProcesu` Ak je definovaná (implementovaná) inštancia tohto atribútu, tak všetky (interné alebo externé) volania metódy `output` sú automaticky presmerované do metódy `spracuj` tejto implementácie (inštancie).
`Color`	`zálohaFarby` Prípadná záloha farby uložená po spustení nového procesu.

Atribúty zdedené z triedy knižnica.podpora.ExecuteShellCommand
CANNOT_EXECUTE, CLEARED, COMMAND, COMMAND_MAPPING, COMMANDS_MAP, dateFormat, DELETED, DUPLICATE_REQUEST, ENCODING, ENCODING_FOR, ENCODING_CHANGED, ENCODING_KEEPED, ENCODING_RESTORED, ENCODINGS_MAP, ERROR_MESSAGE, ERROR_OCCURED, EXECUTE, EXIT_CODE, INPUT, IS_EMPTY, langstring, MAPPED_COMMAND_USE, MAPPING, MORE_PROCESSES, SET, STREAM_READ_ERROR, STREAM_WRITE_ERROR, timeFormat

Prehľad konštruktorov

Konštruktory
Konštruktor a opis

PríkazovýRiadok()

Konštruktory
Konštruktor a opis
`PríkazovýRiadok()`

Prehľad metód

Všetky metódy Inštančné metódy Skutočne definované metódy
Modifikátor a typ	Metóda a opis
`void`	`citajKonfiguraciu(Súbor súbor)` Alias pre `čítajKonfiguráciu`.
`void`	`clearDebug(String metóda)` Automaticky spúšťaná metóda signalizujúca buď vyčistenie alebo začatie novej sekcie v prúde ladiacich informácií.
`void`	`clearErr(String metóda)` Automaticky spúšťaná metóda signalizujúca buď vyčistenie denníka chýb, alebo začatie novej sekcie záznamov.
`void`	`clearError()` Automaticky spúšťaná metóda signalizujúca vymazanie zásobníka (obrazovky), na ktorú je exportovaný chybový prúd procesu.
`void`	`clearLog(String metóda)` Automaticky spúšťaná metóda signalizujúca buď vyčistenie denníka, alebo začatie novej sekcie záznamov.
`void`	`clearOutput()` Automaticky spúšťaná metóda signalizujúca vymazanie zásobníka (obrazovky), na ktorú je exportovaný prúd štandardného výstupu procesu.
`void`	`čítajKonfiguráciu(Súbor súbor)` Prečíta rôzne vlastnosti tejto inštancie z konfiguračného súboru.
`void`	`debug(Object... texty)` Metóda vypisujúca ladiace informácie.
`void`	`err(Object... texty)` Metóda zapisujúca údaje do denníka chýb.
`void`	`error(Object... texty)` Metóda, do ktorej je automaticky presmerovaný štandardný chybový výstup spustených procesov.
`String`	`finishExtraInput(String hodnota)` Táto metóda je spúšťaná automaticky pri dokončení čakania na doplnkový vstup (pozri aj `startExtraInput`).
`String`	`getVersion()` Táto metóda je spúšťaná automaticky v priebehu práce tejto inštancie.
`void`	`log(Object... texty)` Metóda zapisujúca údaje do denníka.
`void`	`output(Object... texty)` Metóda, do ktorej je automaticky presmerovaný štandardný výstup spustených procesov.
`void`	`processEnded(int návratovýKód)` Táto metóda je vykonaná automaticky po ukončení externého procesu.
`String`	`startExtraInput(String návesť)` Táto metóda je spúšťaná automaticky pri začatí čakania na doplnkový vstup, napríklad pri čítaní hodnoty virtuálnej premennej %READ% z príkazového riadka.
`void`	`title(String titulok)` Táto metóda je spúšťaná automaticky v priebehu práce tejto inštancie.
`void`	`zapisKonfiguraciu(Súbor súbor)` Alias pre `zapíšKonfiguráciu`.
`void`	`zapíšKonfiguráciu(Súbor súbor)` Zapíše do konfiguračného súboru rôzne vlastnosti tejto inštancie.

Metódy zdedené z triedy knižnica.podpora.ExecuteShellCommand
debugLine, errLine, errorLine, escapeNewLines, execute, expandPrompt, expandTitle, expandVariables, getCommandArray, getCommandsMap, getCurrentPath, getDefaultEncoding, getDefaultPath, getDefaultPrompt, getDefaultTitle, getEncoding, getEncodingsMap, getInternalEnvironment, getPrompt, getRunArguments, getRunCommand, getRunEnvironment, getRunningProcess, getTitle, getVariable, changeEncoding, changePath, isInputActive, isProcessRunning, logLine, makeCommandArray, mapCommand, matchCommand, outputLine, quoteSpacedString, restoreDefaultEncoding, restoreDefaultPrompt, restoreDefaultTitle, setDefaultEncoding, setDefaultPrompt, setDefaultTitle, setPrompt, setTitle, setVariable, splitCommand, stackTraceToString, storeDefaultEncoding, storeDefaultPrompt, storeDefaultTitle, updateTitle, writeInput

Metódy zdedené z triedy java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Podrobnosti atribútov
  - konfiguráciaZmenená
```
public boolean konfiguráciaZmenená
```
    Príznak toho, že nastavenia inštancie príkazového riadka boli zmenené a mali by byť uložené do konfiguračného súboru. O využitie tohto atribútu sa musí postarať externá implementácia.
  - zálohaFarby
```
public Color zálohaFarby
```
    Prípadná záloha farby uložená po spustení nového procesu. Ak je nastavená, tak pre metódu výstupu output to znamená, že nemá použiť atribút farbaVýstupu.
  - farbaVýstupu
```
public Color farbaVýstupu
```
    Farebné prekrytie všetkých textov štandardného výstupu zachytených touto inštanciou a výstupu niektorých vnútorných príkazov spracovaných metódou sveta spracujPríkaz (napríklad ECHO). Ak je nastavené, tak je použité v tele metódy výstupu output, okrem prípadu, keď je zároveň nastavená inštancia zálohy farby: zálohaFarby.
  - farbaVýstupuProcesu
```
public Color farbaVýstupuProcesu
```
    Farebné odlíšenie výstupov externých procesov. Ak je nastavené, tak je použité pri spustení externého procesu metódou sveta spracujPríkaz.
  - farbaChybovéhoVýstupu
```
public Color farbaChybovéhoVýstupu
```
    Farebné odlíšenie chybových výstupov externých procesov. Ak je nastavené, tak je použité metódou chybového výstupu error.
  - farbaLadenia
```
public Color farbaLadenia
```
    Farebné odlíšenie textov ladenia. Ak je nastavené a ak je zároveň aktívny režim ladenia, tak je použité metódou výstupu textov ladenia príkazového riadka debug.
  - farbaDenníka
```
public Color farbaDenníka
```
    Farebné odlíšenie textov denníka. Ak je nastavené, tak je použité metódou výstupu denníka log.
  - farbaDenníkaChýb
```
public Color farbaDenníkaChýb
```
    Farebné odlíšenie textov chybového denníka. Ak je nastavené, tak je použité metódou výstupu chybového denníka err.
  - vyčistenie
```
public Svet.PríkazovýRiadok.PresmerovanieVýstupu vyčistenie
```
    Toto presmerovanie je odlišné od ostatných. Ak je definované, tak sú do neho presmerované všetky udalosti vyčistenia alebo resetu denníkov, výstupných prúdov a podobne. Vstupné pole parametrov pritom bude obsahovať najmenej jeden prvok, ktorý slúži na odlíšenie typu udalosti. Je to objekt typu Integer, ktorého hodnota môže byť: 0 – clearDebug, 1 – clearLog, 2 – clearErr, 3 – clearError, 4 – clearOutput. Druhý prvok je relevantný len pre prvé tri udalosti a jeho hodnota je reťazec s názvom metódy, ktorá udalosť spustila. Predvolené správanie súvisiacich metód je výpis prázdneho riadka pre denník (clearLog), vymazanie vnútornej konzoly metódami štandardných výstupov (clearError a clearOutput) a ignorovanie zvyšných dvoch udalostí (clearDebug a clearErr).
  - ladenie
```
public Svet.PríkazovýRiadok.PresmerovanieVýstupu ladenie
```
    Ak je definovaná (implementovaná) inštancia tohto atribútu, tak všetky (interné alebo externé) volania metódy debug sú automaticky presmerované do metódy spracuj tejto implementácie (inštancie; pozri aj triedu PresmerovanieVýstupu) a to bez ohľadu na to, či je alebo nie je zapnutý režim ladenia.
  - denník
```
public Svet.PríkazovýRiadok.PresmerovanieVýstupu denník
```
    Ak je definovaná (implementovaná) inštancia tohto atribútu, tak všetky (interné alebo externé) volania metódy log sú automaticky presmerované do metódy spracuj tejto implementácie (inštancie). Pozri aj triedu PresmerovanieVýstupu.
  - denníkChýb
```
public Svet.PríkazovýRiadok.PresmerovanieVýstupu denníkChýb
```
    Ak je definovaná (implementovaná) inštancia tohto atribútu, tak všetky (interné alebo externé) volania metódy err sú automaticky presmerované do metódy spracuj tejto implementácie (inštancie). Pozri aj triedu PresmerovanieVýstupu.
  - chybovýVýstup
```
public Svet.PríkazovýRiadok.PresmerovanieVýstupu chybovýVýstup
```
    Ak je definovaná (implementovaná) inštancia tohto atribútu, tak všetky (interné alebo externé) volania metódy error sú automaticky presmerované do metódy spracuj tejto implementácie (inštancie). Pozri aj triedu PresmerovanieVýstupu.
  - výstupProcesu
```
public Svet.PríkazovýRiadok.PresmerovanieVýstupu výstupProcesu
```
    Ak je definovaná (implementovaná) inštancia tohto atribútu, tak všetky (interné alebo externé) volania metódy output sú automaticky presmerované do metódy spracuj tejto implementácie (inštancie). Pozri aj triedu PresmerovanieVýstupu.
- Podrobnosti konštruktorov
  - PríkazovýRiadok
```
public PríkazovýRiadok()
```
- Podrobnosti metód
  - title
```
public void title(String titulok)
```
    Táto metóda je spúšťaná automaticky v priebehu práce tejto inštancie. Účelom je nastavenie titulku okna (konzoly), ktorým je v tomto prípade okno sveta. (Mechanizmus je implementovaný v rodičovskej triede ExecuteShellCommand.)
    
    Poznámka: Na zlepšenie dojmu pri používaní programovacieho rámca bolo využitie tohto príkazu eliminované len na prípady vykonania vnútorného príkazu príkazového riadka TITLE. Titulok okna (konzoly) by inak mal byť aktualizovaný po každom vykonaní príkazu príkazového riadka (prípadne aj pred ním), pretože definícia titulku môže obsahovať referencie na (virtuálne) premenné prostredia, ktorých hodnoty sa menia (napríklad %CD% – aktuálna cesta, %TIME% – aktuálny čas…).
    
    Definované:
    
    title v triede podpora.ExecuteShellCommand
    
    Parametre:
    
    titulok – priebežne (niekedy automaticky) aktualizovaná verzia titulku okna
  - getVersion
```
public String getVersion()
```
    Táto metóda je spúšťaná automaticky v priebehu práce tejto inštancie. (Mechanizmus je implementovaný v rodičovskej triede ExecuteShellCommand.) Jej účelom je poskytnúť aktuálnu verziu programovacieho rámca.
    
    Definované:
    
    getVersion v triede podpora.ExecuteShellCommand
    
    Návratová hodnota:
    
    aktuálna verzia programovacieho rámca
  - startExtraInput
```
public String startExtraInput(String návesť)
```
    Táto metóda je spúšťaná automaticky pri začatí čakania na doplnkový vstup, napríklad pri čítaní hodnoty virtuálnej premennej %READ% z príkazového riadka. (Mechanizmus je implementovaný v rodičovskej triede ExecuteShellCommand.)
    
    Definované:
    
    startExtraInput v triede podpora.ExecuteShellCommand
    
    Parametre:
    
    návesť – návesť, ktorá má byť zobrazená pred začatím čakania na doplnkový vstup
    
    Návratová hodnota:
    
    prípadná predvolená hodnota doplnkového vstupu, ktorá okamžite ukončí čakanie na vstup a spustí metódu finishExtraInput
  - finishExtraInput
```
public String finishExtraInput(String hodnota)
```
    Táto metóda je spúšťaná automaticky pri dokončení čakania na doplnkový vstup (pozri aj startExtraInput). Metóda poskytuje externej implementácii poslednú možnosť kontroly, úpravy alebo zrušenia doplnkového vstupu. (Mechanizmus automatického spúšťania tejto metódy je implementovaný v rodičovskej triede ExecuteShellCommand.)
    
    Definované:
    
    finishExtraInput v triede podpora.ExecuteShellCommand
    
    Parametre:
    
    hodnota – hodnota potvrdená používateľom (prípadne odoslaná iným procesom)
    
    Návratová hodnota:
    
    upravená hodnota alebo null na zrušenie vstupu
  - clearDebug
```
public void clearDebug(String metóda)
```
    Automaticky spúšťaná metóda signalizujúca buď vyčistenie alebo začatie novej sekcie v prúde ladiacich informácií.
    
    Volanie tejto metódy je predvolene ignorované. Dá sa mu však definovať akcia v rámci presmerovania výstupu vyčistenie, ktoré (ak je definované) je touto metódou volané takto: vyčistenie.spracuj(0, metóda);
    
    Definované:
    
    clearDebug v triede podpora.ExecuteShellCommand
    
    Parametre:
    
    metóda – názov metódy, ktorá udalosť vyvolala
  - clearLog
```
public void clearLog(String metóda)
```
    Automaticky spúšťaná metóda signalizujúca buď vyčistenie denníka, alebo začatie novej sekcie záznamov.
    
    Predvolene táto metóda vypíše na konzulu sveta prázdny riadok. To sa dá zmeniť akciou presmerovania výstupu vyčistenie, ktoré (ak je definované) je touto metódou volané takto: vyčistenie.spracuj(1, metóda);
    
    Definované:
    
    clearLog v triede podpora.ExecuteShellCommand
    
    Parametre:
    
    metóda – názov metódy, ktorá udalosť vyvolala
  - clearErr
```
public void clearErr(String metóda)
```
    Automaticky spúšťaná metóda signalizujúca buď vyčistenie denníka chýb, alebo začatie novej sekcie záznamov.
    
    Volanie tejto metódy je predvolene ignorované. Dá sa mu však definovať akcia v rámci presmerovania výstupu vyčistenie, ktoré (ak je definované) je touto metódou volané takto: vyčistenie.spracuj(2, metóda);
    
    Definované:
    
    clearErr v triede podpora.ExecuteShellCommand
    
    Parametre:
    
    metóda – názov metódy, ktorá udalosť vyvolala
  - clearError
```
public void clearError()
```
    Automaticky spúšťaná metóda signalizujúca vymazanie zásobníka (obrazovky), na ktorú je exportovaný chybový prúd procesu. Táto implementácia vymaže vnútornú konzolu sveta (stropu).
    
    Ak je definované presmerovanie výstupu vyčistenie, tak vnútorná konzola nie je vymazaná a namiesto toho je spustená metóda presmerovania: vyčistenie.spracuj(3);
    
    Definované:
    
    clearError v triede podpora.ExecuteShellCommand
  - clearOutput
```
public void clearOutput()
```
    Automaticky spúšťaná metóda signalizujúca vymazanie zásobníka (obrazovky), na ktorú je exportovaný prúd štandardného výstupu procesu. Táto implementácia vymaže vnútornú konzolu sveta (stropu).
    
    Ak je definované presmerovanie výstupu vyčistenie, tak vnútorná konzola nie je vymazaná a namiesto toho je spustená metóda presmerovania: vyčistenie.spracuj(4);
    
    Definované:
    
    clearOutput v triede podpora.ExecuteShellCommand
  - debug
```
public void debug(Object... texty)
```
    Metóda vypisujúca ladiace informácie. Jej automatické spúšťanie súvisí napríklad so spúšťaním a ukončovaním procesov metódou ExecuteShellCommand.execute. Jej použitie je otvorené aj pre externé implementácie. Predvolene funguje tak, že vypisuje texty na vnútornú konzolu sveta (stropu) len v prípade zapnutého režimu ladenia (môže pri tom využiť atribút farbaLadenia).
    
    Ak je definované presmerovanie výstupu ladenie, tak sú všetky informácie presmerované do jeho metódy: ladenie.spracuj(texty);
    
    Definované:
    
    debug v triede podpora.ExecuteShellCommand
    
    Parametre:
    
    texty – ladiace informácie
  - log
```
public void log(Object... texty)
```
    Metóda zapisujúca údaje do denníka. Môže byť volaná s cieľom zápisu informácií do denníka, ale je spúšťaná aj automaticky – vnútornými príkazmi inštancie príkazového riadka, ktoré ňou poskytujú informácie o sebe.
    
    Metóda predvolene vypisuje prijaté informácie na vnútornú konzolu sveta (môže pri tom využiť atribút farbaDenníka). Predvolené správanie sa dá zmeniť definovaním presmerovania výstupu denník, ktoré bude volané takto: denník.spracuj(texty);
    
    Definované:
    
    log v triede podpora.ExecuteShellCommand
    
    Parametre:
    
    texty – texty, ktoré majú byť zapísané do denníka
  - err
```
public void err(Object... texty)
```
    Metóda zapisujúca údaje do denníka chýb. Môže byť volaná s cieľom zápisu informácií do denníka chýb, ale je spúšťaná aj automaticky – vnútornými príkazmi inštancie príkazového riadka, ktoré ňou poskytujú informácie o chybách.
    
    Metóda predvolene vypisuje prijaté informácie na vnútornú konzolu sveta (môže pri tom využiť atribút farbaDenníkaChýb). Predvolené správanie sa dá zmeniť definovaním presmerovania výstupu denníkChýb, ktoré bude volané takto: denníkChýb.spracuj(texty);
    
    Definované:
    
    err v triede podpora.ExecuteShellCommand
    
    Parametre:
    
    texty – texty, ktoré majú byť zapísané do denníka chýb
  - error
```
public void error(Object... texty)
```
    Metóda, do ktorej je automaticky presmerovaný štandardný chybový výstup spustených procesov. (V niektorých prípadoch môže byť spustená aj pri iných príležitostiach, ale to je viac-menej výnimočné.)
    
    Metóda predvolene vypisuje prijaté informácie na vnútornú konzolu sveta (môže pri tom využiť atribút farbaChybovéhoVýstupu). Predvolené správanie sa dá zmeniť definovaním presmerovania výstupu chybovýVýstup, ktoré bude volané takto: chybovýVýstup.spracuj(texty);
    
    Definované:
    
    error v triede podpora.ExecuteShellCommand
    
    Parametre:
    
    texty – zachytené riadky chybového prúdu
  - output
```
public void output(Object... texty)
```
    Metóda, do ktorej je automaticky presmerovaný štandardný výstup spustených procesov. V niektorých prípadoch môže byť táto metóda spustená aj pri iných príležitostiach (napríklad vnútorným príkazom ECHO).
    
    Metóda predvolene vypisuje prijaté informácie na vnútornú konzolu sveta (môže pri tom využiť atribút farbaVýstupu). Predvolené správanie sa dá zmeniť definovaním presmerovania výstupu výstupProcesu, ktoré bude volané takto: výstupProcesu.spracuj(texty);
    
    Definované:
    
    output v triede podpora.ExecuteShellCommand
    
    Parametre:
    
    texty – zachytené riadky výstupného prúdu
  - processEnded
```
public void processEnded(int návratovýKód)
```
    Táto metóda je vykonaná automaticky po ukončení externého procesu. Návratový kód je nositeľom informácie o spôsobe ukončenia procesu alebo o chybe. Obvykle túto informáciu tvorí spustený proces pri svojom ukončení, ale môže ísť aj o informáciu odovzdanú spúšťajúcim procesom (príkazovým riadkom systému alebo programovacieho rámca). Hodnota nula obvykle znamená korektné ukončenie procesu. Interpretácia iných hodnôt závisí od konkrétneho procesu – o tom by mala informovať jeho dokumentácia.
    
    V tomto programovacom rámci je jediná výnimka, keď túto hodnotu negeneruje spustený proces a to pri pokuse spustenia nového procesu v čase, keď je skôr spustený proces stále v činnosti. Jedna inštancia príkazového riadka dovoľuje v jednom čase spustenie iba jedného procesu. V prípade pokusu o konfliktné spustenie vygeneruje rámec túto udalosť s návratovým kódom −1.
    
    Definované:
    
    processEnded v triede podpora.ExecuteShellCommand
    
    Parametre:
    
    návratovýKód – kód, ktorý vrátil externý proces pri ukončení; prípadne kód generovaný nadradeným procesom
  - zapíšKonfiguráciu
```
public void zapíšKonfiguráciu(Súbor súbor)
                       throws IOException
```
    Zapíše do konfiguračného súboru rôzne vlastnosti tejto inštancie. Sú to hodnoty vnútorných premenných prostredia, aktuálne kódovanie, definícu náveste, titulku okna a mapy príkazov a kódovaní.
    
    Parametre:
    
    súbor – inštancia konfiguračného súboru
    
    Výnimky:
    
    IOException – v prípade vzniku vstupno-výstupnej chyby
  - zapisKonfiguraciu
```
public void zapisKonfiguraciu(Súbor súbor)
                       throws IOException
```
    Alias pre zapíšKonfiguráciu.
    
    Výnimky:
    
    IOException
  - čítajKonfiguráciu
```
public void čítajKonfiguráciu(Súbor súbor)
                       throws IOException
```
    Prečíta rôzne vlastnosti tejto inštancie z konfiguračného súboru. Pozri aj zapíšKonfiguráciu.
    
    Parametre:
    
    súbor – inštancia konfiguračného súboru
    
    Výnimky:
    
    IOException – v prípade vzniku vstupno-výstupnej chyby
  - citajKonfiguraciu
```
public void citajKonfiguraciu(Súbor súbor)
                       throws IOException
```
    Alias pre čítajKonfiguráciu.
    
    Výnimky:
    
    IOException

Trieda Svet.PríkazovýRiadok

Prehľad vnorených tried

Vnorené triedy/rozhrania odvodené od triedy knižnica.podpora.ExecuteShellCommand

Prehľad atribútov

Atribúty zdedené z triedy knižnica.podpora.ExecuteShellCommand

Prehľad konštruktorov

Prehľad metód

Metódy zdedené z triedy knižnica.podpora.ExecuteShellCommand

Metódy zdedené z triedy java.lang.Object

Podrobnosti atribútov

konfiguráciaZmenená

zálohaFarby

farbaVýstupu

farbaVýstupuProcesu

farbaChybovéhoVýstupu

farbaLadenia

farbaDenníka

farbaDenníkaChýb

vyčistenie

ladenie

denník

denníkChýb

chybovýVýstup

výstupProcesu

Podrobnosti konštruktorov

PríkazovýRiadok

Podrobnosti metód

title

getVersion

startExtraInput

finishExtraInput

clearDebug

clearLog

clearErr

clearError

clearOutput

debug

log

err

error

output

processEnded

zapíšKonfiguráciu

zapisKonfiguraciu

čítajKonfiguráciu

citajKonfiguraciu