NativeProcess  - AS3

Anger om körning av inbyggda processer stöds i den aktuella profilen. Den här egenskapen returnerar bara värdet true när den körs i profilen extendedDesktop. Dessutom är NativeProcess.isSupported alltid false för program som installerats som AIR-filer. Du måste paketera ett AIR-program med ADT-flaggan -target native för att kunna använda klassen NativeProcess.

Anger om den här inbyggda processen körs just nu. Processen körs om du har anropat metoden start() och NativeProcess-objektet inte har skickat en exit-händelse än. En NativeProcess-instans motsvarar en enda process i det underliggande operativsystemet. Egenskapen fortsätter att vara true så länge den underliggande operativsystemsprocessen körs (från det att den inbyggda processen startar tills processen skickar en exit-kod till operativsystemet).

Ger tillgång till standardfelutdata från den här inbyggda processen. NativeProcess-objektet skickar ett ProgressEvent-objekt när data blir tillgängliga i detta rör. NativeProcess-objektet genererar ett EOFError-undantag om du försöker läsa data från strömmen när data saknas.

Typen är IDataInput eftersom data matas in från den aktuella processen trots att det är en utdataström från den underordnade processen.

Relaterade API-element

Ger tillgång till standardindata för den här inbyggda processen. Använd detta rör för att sända data till processen. Varje gång data skrivs till egenskapen input skrivs dessa data till den inbyggda processens indatarör så fort som möjligt.

Typen är IDataOutput eftersom data matas ut från den aktuella processen trots att det är en indataström från den underordnade processen.

Relaterade API-element

Ger tillgång till standardutdataröret för den här inbyggda processen. Använd det här röret för att läsa data från den inbyggda processens standardutdataström. NativeProcess-objektet skickar ett ProgressEvent när det finns data i detta rör. NativeProcess-objektet genererar ett EOFError om du försöker läsa data från strömmen när data saknas.

Typen är IDataInput eftersom data matas in från den aktuella processen trots att det är en utdataström från den underordnade processen.

Relaterade API-element

Skapar ett oinitierat NativeProcess-objekt. Starta processen genom att anropa metoden start().

Relaterade API-element

Stänger indataströmmen för den här processen. Vissa kommandoradsprogram väntar tills indataströmmen stängts innan vissa åtgärder startar. När strömmen är stängd kan den inte öppnas igen förrän processen avslutas och startas igen.

Försöker avsluta den inbyggda processen.

Parametrar

Startar den inbyggda process som identifieras av angiven startinformation. Alla in- och utdataströmmar öppnas när processen startar. Den här metoden returneras omedelbart efter det att en begäran att starta den angivna processen har skickats till operativsystemet. NativeProcess-objektet genererar ett IllegalOperationError-undantag om processen redan körs. Processen körs om egenskapen running i NativeProcess-objektet returnerar värdet true. Error genereras om operativsystemet inte kan starta processen.

En NativeProcess-instans motsvarar en enda process i det underliggande operativsystemet. Om du vill köra mer än en instans av samma operativsystemsprocess samtidigt kan du skapa en NativeProcess-instans för varje underordnad process.

Du kan anropa den här metoden när egenskapen running i NativeProcess-objektet returnerar värdet false. Det innebär att NativeProcess-objektet kan återanvändas. Med andra ord kan du skapa en NativeProcess-instans, anropa start()-metoden, vänta på exit-händelsen och sedan anropa start()-metoden igen. Du kan använda ett annat NativeProcessStartupInfo-objekt som värde för parametern info i det efterföljande anropet av metoden start().

Klassen NativeProcess och dess funktioner är bara tillgängliga för AIR-program som installerats med det inbyggda installationsprogrammet. Vid felsökning kan du skicka argumentet -profile extendedDesktop till ADL för att aktivera NativeProcess-funktionen. Du kan kontrollera egenskapen NativeProcess.isSupported för att avgöra om inbyggd processkommunikation stöds.

Viktiga säkerhetsaspekter:

API:t för inbyggda processer kan köra alla körbara filer på användarens system. Du bör vara mycket försiktig när du konstruerar och kör kommandon. Om någon del av ett kommando som ska köras kommer från en extern källa kontrollerar du noga att det kommandot är säkert att köra. Ditt AIR-program bör dessutom också verifiera data som skickas till en process som körs.

Det kan dock vara svårt att verifiera indata. För att slippa den här typen av problem är det bäst att skriva ett inbyggt program (t.ex. en EXE-fil i Windows) med specifika API:er. De här API:erna bör bara bearbeta de kommandon som krävs för AIR-programmet. Till exempel kanske det inbyggda programmet bara accepterar en begränsad mängd instruktioner via standardindataströmmen.

Med AIR på Windows kan du inte köra .bat-filer direkt. I Windows körs .bat-filer av kommandotolken (cmd.exe). När du anropar en .bat-fil kan den här kommandotolken tolka de argument som skickas till kommandot som fler program som ska startas. Skadliga extratecken i argumentsträngen kan medföra att cmd.exe kör ett skadligt eller osäkert program. Utan korrekt dataverifiering kan ditt AIR-program till exempel anropa myBat.bat myArguments c:/evil.exe. Kommandotolken skulle då starta programmet evil.exe utöver din .bat-fil.

Om du anropar metoden start() med en .bat-fil genererar NativeProcess-objektet ett undantagsfel. Egenskapen message i Error-objektet innehåller strängen "Fel #3219: Det gick inte att starta NativeProcess."

Parametrar

Relaterade API-element

Anger att den inbyggda processen har avslutats. Egenskapen exitCode innehåller det värde som processen returnerar till värdoperativsystemet när den avslutas. Om AIR-programmet avslutar processen genom att anropa metoden exit() för NativeProcess-objektet anges egenskapen exitCode som NaN.

Anger att NativeProcess har stängt sin felström.

Anger att den inbyggda processen har data som är tillgängliga för läsning i standardfelströmmen (stderror). NativeProcess-objektet skickar den här händelsen när den underordnade processen tömmer sin standardfelström eller när den interna bufferten som används för kommunikation mellan processerna är full. Skriv inte kod som är beroende av storleken på den här interna bufferten, eftersom den skiljer sig mellan olika versioner och operativsystem.

Anger att läsning från standardfelströmmen (stderror) har misslyckats. NativeProcess-objektet kan skicka den här händelsen när miljön inte kan läsa data från den inbyggda processens standardfeldatarör.

Anger att NativeProcess-objektet har stängt sin indataström genom att anropa metoden closeInput(). NativeProcess-objektet skickar inte händelsen när den inbyggda processen själv stänger indataströmmen.

Anger att skrivning till standardindataströmmen (stdin) har misslyckats. NativeProcess-objektet skickar händelsen när metoden closeInput() misslyckas eller när körningen inte kan skriva data till den inbyggda processens standardindatarör.

Anger att NativeProcess har skrivit data till indataströmmen för den underordnade processen. NativeProcess-objektet skickar den här händelsen när data skrivs till strömmen. Händelsen betyder inte att den underordnade processen har läst några data.

Anger att NativeProcess har stängt sin utdataström.

Anger att den inbyggda processen har data som är tillgängliga för läsning i utdataströmmen. NativeProcess-objektet skickar den här händelsen när den underordnade processen tömmer sin stdout-ström eller när den interna bufferten som används för kommunikation mellan processerna är full. Skriv inte kod som är beroende av storleken på den här interna bufferten, eftersom den skiljer sig mellan olika versioner och operativsystem.

Anger att läsning från standardutdataströmmen (stdout) har misslyckats. NativeProcess-objektet kan skicka den här händelsen när miljön inte kan läsa data från den inbyggda processens standardutdatarör.

package
{
    import flash.display.Sprite;
    import flash.desktop.NativeProcess;
    import flash.desktop.NativeProcessStartupInfo;
    import flash.events.Event;
    import flash.events.ProgressEvent;
    import flash.events.IOErrorEvent;
    import flash.events.NativeProcessExitEvent;
    import flash.filesystem.File;
    
    public class NativeProcessExample extends Sprite
    {
        public var process:NativeProcess;

        public function NativeProcessExample()
        {
            if(NativeProcess.isSupported)
            {
                setupAndLaunch();
            }
            else
            {
                trace("NativeProcess not supported.");
            }
        }
        
        public function setupAndLaunch():void
        {     
            var nativeProcessStartupInfo:NativeProcessStartupInfo = new NativeProcessStartupInfo();
            var file:File = File.applicationDirectory.resolvePath("test.py");
            nativeProcessStartupInfo.executable = file;

            var processArgs:Vector.<String> = new Vector.<String>();
            processArgs[0] = "foo";
            nativeProcessStartupInfo.arguments = processArgs;

            process = new NativeProcess();
            process.start(nativeProcessStartupInfo);
            process.addEventListener(ProgressEvent.STANDARD_OUTPUT_DATA, onOutputData);
            process.addEventListener(ProgressEvent.STANDARD_ERROR_DATA, onErrorData);
            process.addEventListener(NativeProcessExitEvent.EXIT, onExit);
            process.addEventListener(IOErrorEvent.STANDARD_OUTPUT_IO_ERROR, onIOError);
            process.addEventListener(IOErrorEvent.STANDARD_ERROR_IO_ERROR, onIOError);
        }

        public function onOutputData(event:ProgressEvent):void
        {
            trace("Got: ", process.standardOutput.readUTFBytes(process.standardOutput.bytesAvailable)); 
        }
        
        public function onErrorData(event:ProgressEvent):void
        {
            trace("ERROR -", process.standardError.readUTFBytes(process.standardError.bytesAvailable)); 
        }
        
        public function onExit(event:NativeProcessExitEvent):void
        {
            trace("Process exited with ", event.exitCode);
        }
        
        public function onIOError(event:IOErrorEvent):void
        {
             trace(event.toString());
        }
    }
}

 #!/usr/bin/python
 # ------------------------------------------------------------------------------
 # Sample Python script
 # ------------------------------------------------------------------------------
 
 import sys
 
 for word in sys.argv: #echo the command line arguments
     print word
 
 print "HI FROM PYTHON"
 print "Enter user name" 
 line = sys.stdin.readline()
 
 sys.stdout.write("hello," + line)