NativeProcess  - AS3

実行中のネイティブプロセスが現在のプロファイルでサポートされているかどうかを示します。extendedDesktop プロファイルで実行している場合のみ、このプロパティは true を返します。また、AIR ファイルとしてインストールされているアプリケーションの場合、NativeProcess.isSupported は常に false です。NativeProcess を使用するには、ADT -target native フラグを使用して API アプリケーションをパッケージ化する必要があります。

このネイティブプロセスが現在実行中かどうかを示します。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 例外をスローします。NativeProcess オブジェクトの running プロパティが true を返す場合、プロセスは実行中です。オペレーティングシステムがプロセスを開始できない場合は、Error がスローされます。

基礎となるオペレーティングシステム上の単一プロセスに対応する NativeProcess インスタンスです。同じオペレーティングシステムプロセスの複数のインスタンスを同時に実行する場合は、子プロセスごとに NativeProcess インスタンスを作成します。

NativeProcess オブジェクトの running プロパティが false を返す場合は、常にこのメソッドを呼び出すことができます。つまり、NativeProcess オブジェクトは再利用できます。言い換えれば、NativeProcess インスタンスを作成して、start() メソッドを呼び出し、exit イベントを待ってから、start() を再度呼び出すことができます。後続の start() メソッドの呼び出しでは、異なる NativeProcessStartupInfo オブジェクトを info パラメーター値として使用します。

NativeProcess クラスとその機能は、ネイティブインストーラーを使用してインストールされた AIR アプリケーションでのみ使用できます。デバッグ時に、ADL に対して -profile extendedDesktop 引数を渡すことにより、NativeProcess の機能を有効にできます。ネイティブプロセスとの通信がサポートされているかどうかを確認するには、NativeProcess.isSupported プロパティを調べます。

セキュリティに関する重要な考慮事項：

ネイティブプロセス API は、ユーザーのシステム上で任意の実行可能ファイルを実行できます。コマンドの構築時および実行時には、十分に注意を払ってください。実行されるコマンドが一部でも外部ソースから発行されている場合には、そのコマンドを実行しても安全であるかどうかを慎重に検証してください。同様に、AIR アプリケーションは、実行中のプロセスに渡されるデータを検証する必要があります。

ただし、入力を検証することは難しい場合があります。このような問題を回避するには、特定の API を含むネイティブアプリケーション（Windows 上の EXE ファイルなど）を作成することが最適です。これらの API は、AIR アプリケーションによって明示的に要求される場合にのみこれらのコマンドを処理します。例えば、ネイティブアプリケーションは、標準入力ストリームを通じて、限定された命令セットのみを受け付ける場合があります。

Windows 上の AIR は、ユーザーが .bat ファイルを直接実行することを許可しません。Windows .bat ファイルは、コマンドインタープリターアプリケーション（cmd.exe）によって実行されます。.bat ファイルを呼び出すとき、このコマンドアプリケーションは、コマンドに渡される引数を、起動する追加のアプリケーションとして解釈することができます。引数のストリングに悪質な意図で不要な文字が挿入されている場合、有害または安全ではないアプリケーションを cmd.exe が実行するおそれがあります。例えば、妥当なデータ検証が行われない場合、AIR アプリケーションが myBat.bat myArguments c:/evil.exe を呼び出す可能性があります。このコマンドアプリケーションは、バッチファイルを実行するときに、一緒に evil.exe アプリケーションを起動することになります。

.bat ファイルで start() メソッドを呼び出すと、NativeProcess オブジェクトは例外をスローします。Error オブジェクトの message プロパティには、ストリング「Error #3219: The NativeProcess could not be started」が含まれます。

パラメーター

関連する API エレメント

ネイティブプロセスが存在していることを通知します。exitCode プロパティには、プロセスの終了時にプロセスからホストオペレーティングシステムに返される値が含まれています。AIR アプリケーションが NativeProcess オブジェクトの exit() メソッドを呼び出してプロセスを終了すると、exitCode プロパティは NaN に設定されます。

NativeProcess がエラーストリームを閉じたことを通知します。

ネイティブプロセスで読み取り可能なデータが標準エラー（stderror）ストリームにあることを通知します。NativeProcess オブジェクトは、子プロセスが標準エラーストリームをフラッシュしたとき、またはプロセス間通信で使用している内部バッファーが一杯になったときに、このイベントを送出します。この内部バッファーのサイズに依存するようなコードは書かないようにしてください。内部バッファーのサイズはオペレーティングシステムによって異なります。

標準エラー（stderror）ストリームからの読み取りが失敗したことを通知します。NativeProcess オブジェクトは、ランタイムがネイティブプロセスの標準エラーパイプからデータを読み取れない場合に、このイベントを送出することがあります。

NativeProcess オブジェクトが closeInput() メソッドを呼び出して、入力ストリームを閉じたことを通知します。実際のネイティブプロセスによって入力ストリームが閉じられた場合には、NativeProcess オブジェクトはこのイベントを送出しません。

標準入力（stdin）ストリームへの書き込みが失敗したことを通知します。NativeProcess オブジェクトは、closeInput() メソッドが失敗したとき、またはランタイムがネイティブプロセスの標準入力パイプにデータを書き込めない場合に、このイベントを送出します。

NativeProcess が、子プロセスに対する入力ストリームにデータを書き込んだことを通知します。NativeProcess オブジェクトは、データがストリームに書き込まれたときに、このイベントを送出します。このイベントは、子プロセスにデータが読み取られたかどうかを示すものではありません。

NativeProcess オブジェクトが出力ストリームを閉じたことを通知します。

ネイティブプロセスで読み取り可能なデータが出力ストリームにあることを通知します。NativeProcess オブジェクトは、子プロセスが stdout ストリームをフラッシュしたとき、またはプロセス間通信で使用している内部バッファーが一杯になったときに、このイベントを送出します。この内部バッファーのサイズに依存するようなコードは書かないようにしてください。内部バッファーのサイズはオペレーティングシステムによって異なります。

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)