NativeProcess  - AS3

Wskazuje, czy uruchamianie procesów natywnych jest obsługiwane w bieżącym profilu. Ta właściwość zwraca wartość true tylko wtedy, gdy aplikacja działa w profilu extendedDesktop. Ponadto parametr NativeProcess.isSupported ma zawsze wartość false dla aplikacji zainstalowanych jako pliki AIR. Aby używać klasy NativeProcess, należy spakować aplikację AIR przy użyciu flagi ADT -target native.

Wskazuje, czy ten proces natywny jest obecnie uruchomiony. Proces jest uruchomiony, jeśli wywołano metodę start(), a obiekt NativeProcess nie wywołał jeszcze zdarzenia exit. Wystąpienie klasy NativeProcess jest odpowiednikiem pojedynczego procesu w podstawowym systemie operacyjnym. Właściwość ma wartość true tak długo, jak wykonywany jest proces w systemie operacyjnym (w trakcie uruchamiania procesu i później, do momentu, aż proces zwróci kod wyjścia do systemu operacyjnego).

Udostępnia standardowy strumień błędów tego procesu natywnego. W miarę jak dane stają się dostępne w tym potoku, obiekt NativeProcess wywołuje zdarzenia ProgressEvent. Próba odczytania danych z tego strumienia, gdy nie ma dostępnych danych, powoduje, że obiekt NativeProcess generuje wyjątek EOFError.

Typem danych jest IDataInput, ponieważ z perspektywy bieżącego procesu dane są wprowadzane, mimo że strumień jest strumieniem wyjściowym procesu potomnego.

Powiązane elementy interfejsu API

Umożliwia dostęp do standardowego strumienia wejściowego tego procesu natywnego. Ten potok służy do wysyłania danych do procesu. Każdy zapis danych do właściwości input powoduje możliwie najszybsze zapisanie danych do potoku wejściowego procesu natywnego.

Typem danych jest IDataOutput, ponieważ z perspektywy bieżącego procesu dane są wyprowadzane, mimo że strumień jest strumieniem wejściowym procesu potomnego.

Powiązane elementy interfejsu API

Umożliwia dostęp do standardowego potoku wyjściowego tego procesu natywnego. Ten potok umożliwia odczytywanie danych ze standardowego strumienia wejściowego procesu natywnego. Gdy dane są dostępne w potoku, obiekt NativeProcess wywołuje zdarzenie ProgressEvent. Próba odczytania danych z tego strumienia, gdy nie ma dostępnych danych, powoduje, że obiekt NativeProcess generuje wyjątek EOFError.

Typem danych jest IDataInput, ponieważ z perspektywy bieżącego procesu dane są wprowadzane, mimo że strumień jest strumieniem wyjściowym procesu potomnego.

Powiązane elementy interfejsu API

Konstruuje niezainicjowany obiekt NativeProcess. W celu uruchomienia procesu należy wywołać metodę start().

Powiązane elementy interfejsu API

Zamyka strumień wejściowy tego procesu. Niektóre aplikacje wiersza poleceń czekają z rozpoczęciem pewnych operacji na zamknięcie strumienia wejściowego. Zamkniętego strumienia nie można ponownie otworzyć, dopóki proces nie zostanie zakończony i ponownie uruchomiony.

Podejmuje próbę zakończenia procesu natywnego.

Parametry

Uruchamia proces natywny wskazany przez podane informacje dotyczące uruchamiania. Po uruchomieniu procesu wszystkie strumienie wejściowe i wyjściowe zostaną otwarte. Powrót z tej metody następuje natychmiast po przesłaniu do systemu operacyjnego żądania uruchomienia określonego procesu. Obiekt NativeProcess generuje wyjątek IllegalOperationError, jeśli proces jest obecnie uruchomiony. Proces jest uruchomiony, jeśli właściwość running obiektu NativeProcess zwraca wartość true. Jeśli system operacyjny nie może uruchomić procesu, generowany jest wyjątek Error.

Instancja NativeProcess jest odpowiednikiem pojedynczego procesu w bazowym systemie operacyjnym. Aby współbieżnie wykonywać więcej niż jedną instancję tego samego procesu w systemie operacyjnym, można utworzyć po jednej instancji klasy NativeProcess na każdy proces potomny.

Metodę tę można wywołać zawsze, gdy właściwość running obiektu NativeProcess zwraca wartość false. Oznacza to, że obiektu NativeProcess można używać ponownie. Innymi słowy, można skonstruować instancję klasy NativeProcess, wywołać metodę start(), poczekać na zdarzenie exit, a następnie ponownie wywołać metodę start(). Jako wartości parametru info w następnym wywołaniu metody start() można użyć innego obiektu NativeProcessStartupInfo niż w poprzednim wywołaniu.

Klasa NativeProcess i jej możliwości dostępne są tylko dla aplikacji AIR zainstalowanych za pomocą natywnego programu instalacyjnego. Podczas debugowania można przekazać do programu argument -profile extendedDesktop w celu włączenia funkcji klasy NativeProcess. Można odczytać wartość właściwości NativeProcess.isSupported w celu ustalenia, czy obsługiwana jest komunikacja z procesami natywnymi.

Ważne uwagi na temat bezpieczeństwa:

Interfejs API procesu rodzimego może uruchamiać dowolne pliki wykonywalne w systemie użytkownika. Podczas konstruowania i wykonywania poleceń należy zachować szczególną ostrożność. Jeśli jakakolwiek część polecenia do wykonania pochodzi z zewnętrznego źródła, wówczas należy dokładnie sprawdzić, czy jej wykonanie jest bezpieczne. Analogicznie w aplikacji AIR użytkownika należy sprawdzić poprawność danych przekazywanych do działającego procesu.

Sprawdzanie poprawności danych wejściowych może być trudne. Najlepszym rozwiązaniem, które pozwala uniknąć trudności, jest utworzenie aplikacji rodzimej (np. pliku EXE w systemie Windows) zawierającej konkretne, charakterystyczne dla niej punkty wywołań interfejsu API. Interfejs API powinny przetwarzać tylko te polecenia, które są wymagane przez aplikację AIR. Na przykład: rodzima aplikacja może akceptować jedynie ograniczony zestaw instrukcji ze standardowego strumienia wejściowego.

Środowisko AIR w systemie Windows nie zezwala na bezpośrednie uruchamianie plików BAT. Pliki BAT systemu Windows są wykonywane w aplikacji interpretera poleceń (cmd.exe). Po wywołaniu pliku BAT ta aplikacja poleceń może zinterpretować argumenty przekazane do polecenia jako dodatkowe aplikacje do uruchomienia. Złośliwe wpisanie dodatkowych znaków w ciągu znaków argumentu może spowodować wykonanie przez interpreter cmd.exe szkodliwej lub niebezpiecznej aplikacji. Na przykład: brak sprawdzenia poprawności danych może spowodować, że aplikacja AIR wywoła polecenie myBat.bat myArguments c:/evil.exe. Aplikacja, poza plikiem wsadowym, uruchomi wówczas dodatkowo aplikację evil.exe.

Wywołanie metody start() z plikiem BAT powoduje zgłoszenie wyjątku przez obiekt NativeProcess. Właściwość message obiektu Error zawiera ciąg znaków "Error #3219: The NativeProcess could not be started.".

Parametry

Powiązane elementy interfejsu API

Sygnalizuje, że proces natywny zakończył działanie. Właściwość exitCode zawiera wartość, którą proces zwrócił do systemu operacyjnego hosta w momencie zakończenia działania. Jeśli aplikacja AIR zakończy proces, wywołując metodę exit() obiektu NativeProcess, właściwości exitCode zostanie przypisana wartość NaN.

Sygnalizuje, że obiekt NativeProcess zamknął swój strumień błędów.

Sygnalizuje, że proces natywny ma dane dostępne do odczytu ze standardowego strumienia błędów (stderror). Obiekt NativeProcess wywołuje to zdarzenie, gdy proces potomny opróżni swój standardowy strumień błędów lub gdy wewnętrzny bufor używany do komunikacji między procesami jest zapełniony. Nie należy uzależniać działania kodu od rozmiaru buforu wewnętrznego; rozmiar buforu jest różny w poszczególnych wersjach i systemach operacyjnych.

Sygnalizuje, że odczyt ze standardowego strumienia błędów (stderror) nie powiódł się. Obiekt NativeProcess może wywołać to zdarzenie, gdy środowisko wykonawcze nie będzie mogło odczytać danych ze standardowego potoku błędów procesu natywnego.

Sygnalizuje, że obiekt NativeProcess zamknął swój strumień wejściowy poprzez wywołanie metody closeInput(). Obiekt NativeProcess nie wywołuje tego zdarzenia, gdy proces natywny sam zamknie strumień wejściowy.

Sygnalizuje, że zapis do standardowego strumienia wejściowego (stdin) nie powiódł się. Obiekt NativeProcess wywołuje to zdarzenie, gdy wykonanie metody closeInput() nie powiedzie się lub gdy środowisko wykonawcze nie może zapisać danych w standardowym potoku wejściowym procesu natywnego.

Sygnalizuje, że obiekt NativeProcess zapisał dane do strumienia wejściowego procesów potomnych. Obiekt NativeProcess wywołuje to zdarzenie, gdy dane są zapisywane do strumienia. To zdarzenie nie wskazuje, czy proces odczytał jakieś dane.

Sygnalizuje, że obiekt NativeProcess zamknął swój strumień wyjściowy.

Sygnalizuje, że proces natywny ma dane dostępne do odczytu ze standardowego strumienia wyjściowego (stdout). Obiekt NativeProcess wywołuje to zdarzenie, gdy proces potomny opróżni swój standardowy strumień wyjściowy lub gdy wewnętrzny bufor używany do komunikacji między procesami jest zapełniony. Nie należy uzależniać działania kodu od rozmiaru buforu wewnętrznego; rozmiar buforu jest różny w poszczególnych wersjach i systemach operacyjnych.

Sygnalizuje, że odczyt ze strumienia stdout nie powiódł się. Obiekt NativeProcess może wywołać to zdarzenie, gdy środowisko wykonawcze nie będzie mogło odczytać danych ze standardowego potoku wyjściowego procesu natywnego.

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)