NativeProcess  - AS3

Çalışan yerel işlemlerin geçerli profilde desteklenip desteklenmediğini belirtir. Bu özellik yalnızca extendedDesktop profilinde çalışırken true değerini döndürür. Ek olarak, NativeProcess.isSupported AIR dosyası olarak yüklenmiş uygulamalar için her zaman false değerine sahiptir. NativeProcess sınıfını kullanmak için ADT -target native bayrağını kullanarak bir AIR uygulamasını paketlemeniz gerekir.

Bu yerel işlemin o anda çalışıp çalışmadığını belirtir. start() yöntemini çağırdıysanız ve NativeProcess nesnesi henüz bir exit olayı göndermediyse işlem çalışır. NativeProcess örneği, temel işletim sistemindeki tek bir işleme karşılık gelir. Temel işletim sistemi işlemi çalıştırıldığı sürece (yerel işlem başlatılırken ve işlem işletim sistemine bir çıkış konu döndürünceye kadar) bu özellik true olarak kalır.

Bu yerel işlemden standart hata çıktısına erişim sağlar. Bu geçitte veriler kullanılabilir oldukça, NativeProcess nesnesi bir ProgressEvent nesnesi gönderir. Herhangi bir veri bulunmadığında bu akıştan veri okumaya çalışırsanız, NativeProcess nesnesi bir EOFError istisnası atar.

Veriler, alt işlemin çıktı akışı olsa da, geçerli işlemin perspektifinden girdi olarak değerlendirildiğinden tür IDataInput olur.

İlgili API Öğeleri

Bu yerel işlemin standart girdisine erişim sağlar. Bu işleme veri göndermek için bu geçidi kullanın. input özelliğine her veri yazıldığında, bu veriler mümkün olduğunca kısa sürede yerel işlemin girdi geçidine yazılır.

Veriler, alt işlemin girdi akışı olsa da, geçerli işlemin perspektifinden çıktı olarak değerlendirildiğinden, tür IDataOutput olur.

İlgili API Öğeleri

Bu yerel işlemin standart çıktı geçidine erişim sağlar. Yerel işlemin standart çıktısından verileri okumak için bu geçidi kullanın. Bu geçitte veri olmadığında, NativeProcess nesnesi bir ProgressEvent öğesi gönderir. Herhangi bir veri bulunmadığında bu akıştan veri okumaya çalışırsanız, NativeProcess nesnesi bir EOFError atar.

Veriler, alt işlemin çıktı akışı olsa da, geçerli işlemin perspektifinden girdi olarak değerlendirildiğinden tür IDataInput olur.

İlgili API Öğeleri

Başlatılmamış NativeProcess nesnesi oluşturur. İşlemi başlatmak için start() yöntemini çağırın.

İlgili API Öğeleri

Bu işlemde girdi akışını kapatır. Bazı komut satırı uygulamaları, bazı işlemleri başlatmak için girdi akışı kapatılıncaya kadar bekler. Akış kapandıktan sonra, işlem çıkış yapıp yeniden başlatılıncaya kadar akış yeniden açılamaz.

Yerel işlemden çıkmayı dener.

Parametreler

Belirtilen başlangıç bilgileri tarafından tanımlanan yerel işlemi başlatır. İşlem başlatıldıktan sonra, tüm girdi ve çıktı akışları açılır. İşletim sistemine belirtilen işlemi başlatma isteği yapıldıktan hemen sonra bu yöntem döndürülür. İşlem o anda çalışıyorsa, NativeProcess nesnesi bir IllegalOperationError istisnası atar. NativeProcess nesnesinin running özelliği true değerini döndürürse, işlem çalıştırılır. İşletim sistemi işlemi başlatamazsa, bir Error atılır.

NativeProcess örneği, temel işletim sistemindeki tek bir işleme karşılık gelir. Aynı işletim sistemi işleminin birden çok örneğini art arda çalıştırmak isterseniz, her alt işlem için bir NativeProcess örneği oluşturabilirsiniz.

NativeProcess nesnesinin running özelliği false değerini her döndürdüğünde bu yöntemi çağırabilirsiniz. Bu, NativeProcess nesnesinin yeniden kullanılabildiği anlamına gelir. Başka bir deyişle, bir NativeProcess örneği oluşturabilir, start() yöntemini çağırabilir, exit olayını bekleyebilir ve ardından tekrar start() yöntemini çağırabilirsiniz. start() yöntemine yapılan sonraki çağrıda info parametre değeri olarak farklı bir NativeProcessStartupInfo nesnesi kullanabilirsiniz.

NativeProcess sınıfı ve bu sınıfın yetenekleri yalnızca yerel yükleyici ile yüklenmiş AIR uygulamaları tarafından kullanılabilir. NativeProcess işlevselliğini etkinleştirmek için hata ayıklama sırasında -profile extendedDesktop argümanını ADL'ye iletebilirsiniz. Yerel işlem iletişiminin desteklenip desteklenmediğini belirlemek için NativeProcess.isSupported özelliğini kontrol edin.

Önemli güvenlik önlemleri:

API'nin yerel işlemi, kullanıcının sistemindeki herhangi bir çalıştırılabilir programı çalıştırabilir. Komut oluştururken ve çalıştırırken çok dikkatli olun. Çalıştırılacak komutun herhangi bir kısmı harici bir kaynaktan geliyorsa, komutun çalıştırılmasının güvenli olduğunu dikkatle doğrulayın. Benzer şekilde, AIR uygulamanız çalışan bir işleme iletilen verileri doğrulamalıdır.

Ancak girdiyi doğrulamak zor olabilir. Bu tür zorlukları önlemek için belirli API'lere sahip yerel bir uygulama (Windows'ta bir EXE dosyası gibi) yazmak en iyi çözümdür. Bu API'ler yalnızca AIR uygulaması tarafından özellikle istenen komutları işlemelidir. Örneğin, yerel uygulama standart girdi akışı üzerinden yalnızca kısıtlı bir talimat grubunu kabul edebilir.

Windows'taki AIR, .bat dosyalarını doğrudan çalıştırmanıza olanak vermez. Windows .bat dosyaları, komut yorumlayıcı uygulaması (cmd.exe) tarafından çalıştırılır. Bir .bat dosyasını çağırdığınızda, bu komut uygulaması komuta iletilen argümanları başlatılacak ek uygulamalar olarak yorumlayabilir. Argüman dizesine zarar verebilecek bir ek karakterler kümesinin eklenmesi, cmd.exe'nin zararlı veya güvensiz bir uygulama çalıştırmasına neden olabilir. Örneğin, uygun veri doğrulaması olmadan, AIR uygulamanız myBat.bat myArguments c:/evil.exe dosyasını çağırabilir. Komut uygulaması toplu işleme dosyanızı çalıştırmanın yanı sıra evil.exe dosyasını açabilir.

start() yöntemini bir .bat dosyası ile çağırırsanız, NativeProcess nesnesi bir istisna atar. Error nesnesinin message özelliği "Hata #3219: NativeProcess başlatılamadı." dizesini içerir.

Parametreler

İlgili API Öğeleri

Yerel işlemin çıkış yaptığını belirtir. exitCode özelliği, işlemin çıkışta ana bilgisayar işletim sistemine döndürdüğü değeri içerir. AIR uygulaması, NativeProcess nesnesinin exit() yöntemini çağırarak işlemi sonlandırır; exitCode özelliği NaN olarak ayarlıdır.

NativeProcess öğesinin hata akışını kapattığını belirtir.

Yerel işlemin, standart hata (stderror) akışında okunabilecek veriler içerdiğini belirtir. NativeProcess nesnesi, alt işlem standart hata akışını temizlediğinde veya işlemler arasında iletişim kurmak için kullanılan dahili arabellek dolu olduğunda bu olayı gönderir. Bu dahili arabelleğin boyutuna bağlı olan kod yazmayın, bu sürümler ve işletim sistemleri arasında değişiklik gösterebilir.

Standart hata (stderror) akışından okumanın başarısız olduğunu belirtir. NativeProcess nesnesi çalışma zamanı yerel işleminin standart hata çubuğundan veri okuyamadığında bu olayı gönderebilir.

NativeProcess nesnesinin closeInput() yöntemini çağırarak girdi akışını kapattığını belirtir. NativeProcess nesnesi, gerçek yerel işlem girdi akışını kapattığında bu olayı göndermez.

Standart girdi (stdin) akışına yazmanın başarısız olduğunu belirtir. NativeProcess nesnesi, closeInput() yöntemi başarısız olduğunda veya çalışma zamanı yerel işlemin standart girdi geçidine yazamadığında bu olayı gönderir.

NativeProcess öğesinin alt işlem için girdi akışına verileri yazdığını belirtir. NativeProcess nesnesi, veriler akışa yazıldığında bu olayı gönderir. Bu olay, alt işlemin herhangi bir veriyi okuyup okumadığını belirtmez.

NativeProcess öğesinin çıktı akışını kapattığını belirtir.

Yerel işlemin, çıktı akışında okunabilecek veriler içerdiğini belirtir. NativeProcess nesnesi, alt işlem stdout akışını temizlediğinde veya işlemler arasında iletişim kurmak için kullanılan dahili arabellek dolu olduğunda bu olayı gönderir. Bu dahili arabelleğin boyutuna bağlı olan kod yazmayın, bu sürümler ve işletim sistemleri arasında değişiklik gösterebilir.

stdout akışından okumanın başarısız olduğunu belirtir. NativeProcess nesnesi çalışma zamanı yerel işleminin standart çıktı çubuğundan veri okuyamadığında bu olayı gönderebilir.

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)