NativeProcess  - AS3

Geeft aan, of het uitvoeren van native processen in het huidige profiel wordt ondersteund. Deze eigenschap retourneert alleen true wanneer deze eigenschap wordt uitgevoerd in het extendedDesktop-profiel. Bovendien is de waarde van NativeProcess.isSupported altijd false voor toepassingen die als een AIR-bestand zijn geïnstalleerd. Als u de NativeProcess-klasse wilt gebruiken, moet u een pakket maken van een AIR-toepassing en daarbij de ADT-markering -target native toepassen.

Geeft aan of dit native proces op dit moment actief is. Het proces is actief als u de start()-methode hebt opgeroepen en het NativeProcess-object nog geen exit-gebeurtenis heeft verstuurd. Een NativeProcess-instantie komt overeen met één proces in het onderliggende besturingssysteem. Deze eigenschap blijft true zolang het onderliggende besturingssysteemproces wordt uitgevoerd (terwijl het native proces start en totdat het proces een afsluitcode naar het besturingssysteem retourneert.)

Geeft toegang tot de standaard foutuitvoer vanaf dit native proces. Wanneer er op deze pipe gegevens beschikbaar komen, verstuurt het NativeProcess-object een ProgressEvent-object. Als u gegevens probeert te lezen vanaf deze stream wanneer er geen gegevens beschikbaar zijn, geeft het NativeProcess-object een EOFError-uitzondering weer.

Het type is IDataInput, omdat gegevens invoer zijn vanuit het perspectief van het huidige proces, zelfs als het een uitvoerstream van het onderliggende proces is.

Verwante API-elementen

Biedt toegang tot de standaardinvoer van dit native proces. Gebruik deze pipe om gegevens naar dit proces te sturen. Telkens als er gegevens naar de Input-eigenschap worden geschreven, worden deze gegevens zo snel mogelijk geschreven naar de invoerpipe van het native proces.

Het type is IDataOutput, omdat gegevens uitvoer zijn vanuit het perspectief van het huidige proces, zelfs als het een invoerstream van het onderliggende proces is.

Verwante API-elementen

Biedt toegang tot de standaarduitvoer van dit native proces. Gebruik deze pipe om gegevens te lezen vanaf de standaarduitvoer van het native proces. Wanneer er op deze pipe gegevens aanwezig zijn, verstuurt het NativeProcess-object een ProgressEvent. Als u gegevens probeert te lezen vanaf deze stream wanneer er geen gegevens beschikbaar zijn, geeft het NativeProcess-object een EOFError weer.

Het type is IDataInput, omdat gegevens invoer zijn vanuit het perspectief van het huidige proces, zelfs als het een uitvoerstream van het onderliggende proces is.

Verwante API-elementen

Stelt een niet-geïnitialiseerd NativeProcess-object samen. Roep de start()-methode op om het proces te starten.

Verwante API-elementen

Sluit de invoerstream voor dit proces af. Sommige opdrachtregeltoepassingen wachten tot de invoerstream is gesloten, om een aantal bewerkingen te starten. Wanneer de stream gesloten is, kan deze niet opnieuw worden geopend, tot het proces wordt gesloten en opnieuw wordt opgestart.

Probeert het native proces af te sluiten.

Parameters

Start het native proces dat wordt genoemd in de opstartinformatie. Wanneer het proces start, worden alle invoer- en uitvoerstreams geopend. Deze methode wordt direct geretourneerd nadat de aanvraag voor het starten van het opgegeven proces aan het besturingssysteem is uitgevoerd. Het NativeProcess-object geeft een IllegalOperationError-uitzondering weer als het proces al actief is. Het proces is actief als de eigenschap running van het Nativeprocess-object true retourneert. Als het besturingssysteem het proces niet kan starten, wordt er een Error weergegeven.

Een NativeProcess-instantie komt overeen met één proces in het onderliggende besturingssysteem. Als u meer dan één instantie van hetzelfde besturingssysteemproces tegelijkertijd uitvoert, kunt u per onderliggend proces één NativeProcess-instantie maken.

U kunt deze methode oproepen wanneer de eigenschap running van het nativeProcess-object false retourneert. Dit betekent dat het NativeProcess-object opnieuw kan worden gebruikt. U kunt met andere woorden een NativeProcess-instantie samenstellen, de start()-methode oproepen, wachten op de exit-gebeurtenis en vervolgens de start() -methode opnieuw oproepen. U kunt een ander NativeProcessStartupInfo-object gebruiken dan de parameterwaarde info in de volgende oproep van de start()-methode.

De NativeProcess-klasse en zijn mogelijkheden zijn alleen beschikbaar voor AIR-toepassingen die met een native installatieprogramma zijn geïnstalleerd. Tijdens het opsporen van fouten kunt u het argument -profile extendedDesktop aan ADL verzenden om de functie NativeProcess in te schakelen. Controleer de eigenschap NativeProcess.isSupported om te bepalen of de native procescommunicatie wordt ondersteund.

Belangrijke beveiligingsoverwegingen

De API van het native proces kan elke uitvoerbare code op het systeem van een gebruiker uitvoeren. Wees zeer voorzichtig bij het opstellen en uitvoeren van opdrachten. Als een deel van een uit te voeren opdracht van een externe bron komt, moet u zorgvuldig controleren of de opdracht veilig is om uit te voeren. Uw AIR-toepassing moet ook gegevens controleren die in een actief proces worden doorgegeven.

Het valideren van invoer kan echter moeilijk zijn. Om zulke moeilijkheden te vermijden, kunt u het best een native toepassing (zoals een EXE-bestand in Windows) met specifieke API's te schrijven. Deze API's moeten alleen de opdrachten verwerken die specifiek voor een AIR-toepassing vereist zijn. De oorspronkelijke toepassing kan slechts een beperkt aantal instructies accepteren via de standaard invoerstroom.

AIR op Windows staat u niet toe om .bat-bestanden rechtstreeks uit te voeren. Windows .bat-bestanden worden uitgevoerd met behulp van de opdrachtverwerkingstoepassing (cmd.exe). Wanneer u dit .bat-bestand oproept, kan deze opdrachttoepassing argumenten verwerken die aan de opdracht doorgeeft om aanvullende toepassingen te starten. Een schadelijke invoeging van extra tekens in de argumenttekenreeks kan ertoe leiden dat cmd.exe een schadelijke of onveilige toepassing uitvoert. Zonder de juiste gegevensvalidatie kan uw AIR-toepassing bijvoorbeeld myBat.bat myArguments c:/evil.exe misschien oproepen. De opdrachttoepassing start de evil.exe-toepassing naast het uitvoeren van uw batchbestand.

Als u de start()-methode met een .bat-bestand oproept, genereert het nativeProcess-object een uitzondering. De message-eigenschap van het Error-object bevat de tekenreeks "Foutnummer #3219: Kan NativeProcess niet starten."

Parameters

Verwante API-elementen

Geeft aan dat het native proces is afgesloten. De eigenschap exitCode bevat de waarde die het proces bij het afsluiten retourneert naar het hostbesturingssysteem. Als de AIR-toepassing het proces beëindigt door de methode exit() van het NativeProcess-object op te roepen, wordt de eigenschap exitCode ingesteld op NaN.

Geeft aan dat het NativeProcess zijn foutstream heeft afgesloten.

Geeft aan dat het native proces gegevens beschikbaar heeft om te lezen op de standaard foutstream (stderror). Het NativeProcess-object verstuurt deze gebeurtenis wanneer het onderliggende proces zijn standaard foutstream leegt of wanneer de interne buffer die voor de communicatie tussen de processen gebruikt wordt vol is. Schrijf geen code die afhankelijk is van de grootte van deze interne buffer; deze is anders in verschillende versies en besturingssystemen.

Geeft aan dat het lezen vanaf de standaard foutstream (stderror) is mislukt. Het NativeProcess-object kan deze gebeurtenis verzenden wanneer de runtime geen gegevens kan lezen vanaf de standaardfoutpipe van het native proces.

Geeft aan dat het NativeProcess-object zijn invoerstream heeft gesloten door de closeInput()-methode op te roepen. Het NativeProcess-object verstuurt deze gebeurtenis niet wanneer het werkelijke native proces zelf de invoerstream sluit.

Geeft aan dat het schrijven naar de standaardinvoerstream (stdin) is mislukt. Het NativeProcess-object verstuurt deze gebeurtenis wanneer de methode closeInput() mislukt of wanneer de runtime geen gegevens kan schrijven naar de standaard invoerpipe van het native proces.

Geeft aan dat het NativeProcess gegevens naar de invoerstream voor het onderliggende proces heeft geschreven. Het NativeProcess-object verstuurt deze gebeurtenis wanneer er gegevens naar de stream worden geschreven. Deze gebeurtenis geeft niet aan of het onderliggende proces hiervan gegevens heeft gelezen.

Geeft aan dat het NativeProcess zijn uitvoerstream heeft afgesloten.

Geeft aan dat het native proces gegevens beschikbaar heeft om te lezen op de uitvoerstream. Het NativeProcess-object verstuurt deze gebeurtenis wanneer het onderliggende proces zijn stdout-stream leegt of wanneer de interne buffer die voor de communicatie tussen de processen gebruikt wordt; vol is. Schrijf geen code die afhankelijk is van de grootte van deze interne buffer; deze is anders in verschillende versies en besturingssystemen.

Geeft aan dat het lezen vanaf de stdout-stream is mislukt. Het NativeProcess-object kan deze gebeurtenis verzenden wanneer de runtime geen gegevens kan lezen vanaf de standaarduitvoerpipe van het native proces.

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)