NativeProcess  - AS3

Указывает, поддерживает ли текущий профиль выполнение собственных процессов. Это свойство возвращает значение true только при выполнении в профиле extendedDesktop. Кроме того, значением NativeProcess.isSupported всегда является false для программ, установленных в качестве файла AIR. Для использования класса NativeProcess необходимо упаковать программу AIR с использование флага ADT -target native.

Указывает, выполняется ли этот собственный процесс в настоящее время. Процесс выполняется, если был вызван метод start() и объект NativeProcess еще не отправил события exit. Экземпляр NativeProcess соответствует одному процессу в операционной системе. Это свойство сохраняет значение true, пока выполняется основной процесс операционной системы (с момента запуска собственного процесса и до возвращения процессом кода выхода операционной системе).

Обеспечивает доступ к стандартному выводу ошибок из этого собственного процесса. По мере того как через этот поток поступают данные, объект NativeProcess отправляет объект события ProgressEvent. При попытке прочитать данные этого потока, когда они еще не доступны, объект NativeProcess выдает исключение EOFError.

Применяется тип IDataInput, так как с точки зрения текущего процесса выполняется ввод данных, несмотря на то что для этого используется поток вывода дочернего процесса.

Связанные элементы API

Обеспечивает доступ к стандартному вводу этого собственного процесса. Этот канал используется для отправки данных этому процессу. Каждый раз при записи данных в свойство input они при первой возможности записываются в поток ввода собственного процесса.

Применяется тип IDataOutput, потому что с точки зрения текущего процесса выполняется вывод данных, несмотря на то что для этого используется поток ввода дочернего процесса.

Связанные элементы API

Обеспечивает доступ к стандартному потоку вывода этого собственного процесса. Этот поток служит для чтения данных из стандартного потока вывода собственного процесса. Когда в этом потоке есть данные, объект NativeProcess отправляет объект события ProgressEvent. При попытке прочитать данные этого потока, когда они еще не доступны, объект NativeProcess выдает исключение EOFError.

Применяется тип IDataInput, потому что с точки зрения текущего процесса выполняется ввод данных, несмотря на то что для этого используется поток вывода дочернего процесса.

Связанные элементы API

Создает неинициализированный объект NativeProcess. Чтобы запустить процесс, необходимо вызвать метод start().

Связанные элементы API

Закрывает поток ввода этого процесса. Некоторые программы командной строки ожидают закрытия потока ввода для запуска других операций. Закрытый поток нельзя открыть снова, пока процесс не завершит работу и будет запущен снова.

Попытка завершить собственный процесс.

Параметры

Запускает собственный процесс, указанный в предоставленных данных о запуске. После запуска процесса открываются все потоки ввода и вывода. Этот метод возвращает результат сразу после того, как операционной системе отправляется запрос на запуск указанного процесса. Объект NativeProcess выдает исключение IllegalOperationError, если в данное время выполняется процесс. Процесс выполняется, если свойство running объекта NativeProcess имеет значение true. Если операционная система не может запустить процесс, отправляется исключение Error.

Экземпляр NativeProcess соответствует одному процессу в операционной системе. Если требуется одновременно выполнить несколько экземпляров одного процесса операционной системы, можно создать по одному экземпляру NativeProcess для каждого дочернего процесса.

Этот метод можно вызывать каждый раз, когда свойство running объекта NativeProcess возвращает значение false. Это означает, что объект NativeObject можно использовать повторно. Другими словами, можно создать экземпляр NativeProcess, вызвать метод start(), дождаться события exit, а затем вызвать метод start() еще раз. Можно использовать другой объект NativeProcessStartupInfo в качестве значения параметра info в следующем вызове метода start().

Класс NativeProcess и его возможности доступны только для программ AIR, установленных с помощью собственной программы установки. В ходе отладки можно передать аргумент -profile extendedDesktop в ADL, чтобы обеспечить возможность выполнения процессов NativeProcess. Проверьте свойство NativeProcess.isSupported, чтобы определить, поддерживается ли связь с собственными процессами.

Важные моменты с точки зрения безопасности

Встроенный API собственных процессов может запустить любой исполняемый файл в системе пользователя. Соблюдайте крайнюю осторожность при создании и выполнении команд. Если любая часть используемой команды исходит от внешнего источника, тщательно проанализируйте безопасность выполнения такой команды. Подобным образом приложение AIR должно проверять данные, передаваемые выполняемому процессу.

Однако проверка ввода может представлять определенную трудность. Чтобы избежать таких трудностей, лучше написать собственное приложение (например, EXE-файл в ОС Windows), со специальными API-интерфейсами. Эти API должны обрабатывать только те команды, которые необходимы именно для приложения AIR. Например, собственное приложение может принимать только ограниченный набор инструкций через стандартный поток ввода.

Среда выполнения AIR в ОС Windows не разрешает непосредственное выполнение файлов .bat. Файлы .bat системы Windows выполняются программой интерпретатора команд (cmd.exe). При вызове файла .bat это приложение интерпретирует аргументы, передаваемые команде, как дополнительные приложения, которые требуется запустить. Вредоносная вставка лишних символов в строку аргумента может привести к выполнению приложением cmd.exe вредоносного или небезопасного приложения. Например, без надлежащей проверки данных приложение AIR может вызвать myBat.bat myArguments c:/evil.exe. В результате этого приложение cmd.exe вместе с файлом .bat запустит приложение evil.exe.

Если вызвать метод start() вместе с файлом .bat, объект NativeProcess выдаст исключение. Свойство message объекта Error содержит строку «Error #3219: The NativeProcess could not be started» (Ошибка №3219. Не удалось запустить собственный процесс).

Параметры

Связанные элементы API

Сообщает о завершении работы собственного процесса. Свойство exitCode содержит значение, которое процесс возвращает операционной системе хоста при завершении работы. Если программа AIR завершает процесс с помощью метода exit() объекта NativeProcess, свойство exitCode получает значение NaN.

Сообщает о том, что объект NativeProcess закрыл свой поток ошибок.

Сообщает о том, что собственный процесс содержит данные, доступные для чтения, в стандартном потоке ошибок (stderror). Объект NativeProcess отправляет это событие, когда переполняется стандартный поток ошибок дочернего процесса или когда заполняется внутренний буфер, используемый для связи между процессами. Не создавайте код, зависимый от размера такого внутреннего буфера, так как он неодинаковый в разных версиях и операционных системах.

Сообщает о том, что не удалось прочитать данные из стандартного потока ошибок (stderror). Объект NativeProcess может отправлять это событие, когда среда выполнения не может прочитать данные из стандартного канала ошибок собственного процесса.

Сообщает о том, что объект NativeProcess закрыл свой поток ввода с помощью метода closeInput(). Объект NativeProcess не отправляет это событие, когда собственный процесс закрывает поток ввода самостоятельно.

Сообщает о том, что запись в стандартный поток ввода (stdin) не удалась. Объект NativeProcess отправляет это событие, когда метод closeInput() выполняется с ошибкой или когда среда выполнения не может записать данные в стандартный поток ввода собственного процесса.

Сообщает о том, что объект NativeProcess записал данные в поток ввода для дочернего процесса. Объект NativeProcess отправляет это событие, когда в поток записываются данные. Это событие не указывает на то, удалось ли дочернему процессу прочитать эти данные.

Сообщает о том, что объект NativeProcess закрыл свой поток вывода.

Сообщает о том, что у собственного процесса есть доступные для чтения данные в потоке вывода. Объект NativeProcess отправляет это событие, когда переполняется стандартный поток вывода дочернего процесса или когда заполняется внутренний буфер, используемый для связи между процессами. Не создавайте код, зависимый от размера такого внутреннего буфера, так как он неодинаковый в разных версиях и операционных системах.

Сообщает о том, что чтение из потока stdout завершилось ошибкой. Объект NativeProcess может отправлять это событие, когда среда выполнения не может прочитать данные из стандартного канала вывода собственного процесса.

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)