C#的Process類調用第三方插件實現PDF文件轉SWF文件

     在項目開發過程當中，有時會須要用到調用第三方程序實現本系統的某一些功能，例如本文中須要使用到的swftools插件，那麼如何在程序中使用這個插件，而且該插件是如何將PDF文件轉化爲SWF文件的呢？接下來就會作一個簡單的介紹。

    在.NET平臺中，對C#提供了一個操做對本地和遠程的訪問進程,使可以啓動和中止系統進程。這個類就是System.Diagnostics.Process，咱們首先來了解一下該類。

一.解析System.Diagnostics.Process類

      在C#中使用Process類能夠提供對本地和遠程的訪問進程,使可以啓動和中止系統進程，而且該類能夠對系統進程進行管理。該類中的一些經常使用方法：Start() ，Kill()，　　　　WaitForExit()等方法；StartInfo，FileName，CreateNoWindow等屬性。

    1.Start()方法：啓動（或重用）此 Process 組件的 StartInfo 屬性指定的進程資源，並將其與該組件關聯。若是啓動了進程資源，則爲 true；若是沒有啓動新的進程資源（例如，若是重用了現有進程），則爲 false。

     具體介紹一下該方法的實現代碼：

        /// <devdoc>
        ///    <para> 
        ///    <see cref='System.Diagnostics.Process'/>若是過程資源被重用而不是啓動，重用的進程與此相關聯<see cref ='System.Diagnostics.Process'/>零件。
       ///    </para>        
       /// </devdoc>

        [ResourceExposure(ResourceScope.None)]
        [ResourceConsumption(ResourceScope.Machine, ResourceScope.Machine)] 
        public bool Start() {
            Close(); 
            ProcessStartInfo startInfo = StartInfo; 
            if (startInfo.FileName.Length == 0)
                throw new InvalidOperationException(SR.GetString(SR.FileNameMissing)); 

            if (startInfo.UseShellExecute) {
#if !FEATURE_PAL
                return StartWithShellExecuteEx(startInfo); 
#else
                throw new InvalidOperationException(SR.GetString(SR.net_perm_invalid_val, "StartInfo.UseShellExecute", true)); 
#endif // !FEATURE_PAL 
            } else {
                return StartWithCreateProcess(startInfo); 
            }
        }

     2.Kill()方法：當即中止關聯的進程。Kill 強制終止進程，Kill 方法將異步執行。 在調用 Kill 方法後，請調用 WaitForExit 方法等待進程退出，或者檢查 HasExited 屬性以肯定進程是否已經退出。

     具體介紹一下該方法的實現代碼：

  [ResourceExposure(ResourceScope.Machine)] 
        [ResourceConsumption(ResourceScope.Machine)]
        public void Kill() { 
            SafeProcessHandle handle = null;
            try {
                handle = GetProcessHandle(NativeMethods.PROCESS_TERMINATE);
                if (!NativeMethods.TerminateProcess(handle, -1)) 
                    throw new Win32Exception();
            } 
            finally { 
                ReleaseProcessHandle(handle);
            } 
        }

 SafeProcessHandle GetProcessHandle(int access) {
            return GetProcessHandle(access, true); 
        }

        /// <devdoc>
        /// 獲取進程的短時間句柄，具備給定的訪問權限。
         ///若是句柄存儲在當前進程對象中，則使用它。
         ///注意，咱們存儲在當前進程對象中的句柄將具備咱們須要的全部訪問權限。
        /// </devdoc> 
        /// <internalonly/> 
        [ResourceExposure(ResourceScope.None)]
        [ResourceConsumption(ResourceScope.Machine, ResourceScope.Machine)] 
        SafeProcessHandle GetProcessHandle(int access, bool throwIfExited) {
            Debug.WriteLineIf(processTracing.TraceVerbose, "GetProcessHandle(access = 0x" + access.ToString("X8", CultureInfo.InvariantCulture) + ", throwIfExited = " + throwIfExited + ")");
#if DEBUG
            if (processTracing.TraceVerbose) { 
                StackFrame calledFrom = new StackTrace(true).GetFrame(0);
                Debug.WriteLine("   called from " + calledFrom.GetFileName() + ", line " + calledFrom.GetFileLineNumber()); 
            } 
#endif
            if (haveProcessHandle) { 
                if (throwIfExited) {
                    //由於hasProcessHandle是true，咱們知道咱們有進程句柄

                     //打開時至少要有SYNCHRONIZE訪問，因此咱們能夠等待它
                     // zero timeout以查看進程是否已退出。

                    ProcessWaitHandle waitHandle = null;
                    try { 
                        waitHandle = new ProcessWaitHandle(m_processHandle); 
                        if (waitHandle.WaitOne(0, false)) {
                            if (haveProcessId) 
                                throw new InvalidOperationException(SR.GetString(SR.ProcessHasExited, processId.ToString(CultureInfo.CurrentCulture)));
                            else
                                throw new InvalidOperationException(SR.GetString(SR.ProcessHasExitedNoId));
                        } 
                    }
                    finally { 
                        if( waitHandle != null) { 
                            waitHandle.Close();
                        } 
                    }
                }
                return m_processHandle;
            } 
            else {
                EnsureState(State.HaveId | State.IsLocal); 
                SafeProcessHandle handle = SafeProcessHandle.InvalidHandle; 
#if !FEATURE_PAL
                handle = ProcessManager.OpenProcess(processId, access, throwIfExited); 
#else
                IntPtr pseudohandle = NativeMethods.GetCurrentProcess();
                // Get a real handle
                if (!NativeMethods.DuplicateHandle (new HandleRef(this, pseudohandle), 
                                                    new HandleRef(this, pseudohandle),
                                                    new HandleRef(this, pseudohandle), 
                                                    out handle, 
                                                    0,
                                                    false, 
                                                    NativeMethods.DUPLICATE_SAME_ACCESS |
                                                    NativeMethods.DUPLICATE_CLOSE_SOURCE)) {
                    throw new Win32Exception();
                } 
#endif // !FEATURE_PAL
                if (throwIfExited && (access & NativeMethods.PROCESS_QUERY_INFORMATION) != 0) { 
                    if (NativeMethods.GetExitCodeProcess(handle, out exitCode) && exitCode != NativeMethods.STILL_ACTIVE) { 
                        throw new InvalidOperationException(SR.GetString(SR.ProcessHasExited, processId.ToString(CultureInfo.CurrentCulture)));
                    } 
                }
                return handle;
            }
 
        }

     3.WaitForExit()方法：指示<see cref ='System.Diagnostics.Process'/>組件等待指定的毫秒數，以使相關聯的進程退出。

        具體介紹一下該方法的實現代碼：

 public bool WaitForExit(int milliseconds) { 
            SafeProcessHandle handle = null; 
         bool exited;
            ProcessWaitHandle processWaitHandle = null; 
            try {
                handle = GetProcessHandle(NativeMethods.SYNCHRONIZE, false);
                if (handle.IsInvalid) {
                    exited = true; 
                }
                else { 
                    processWaitHandle = new ProcessWaitHandle(handle); 
                    if( processWaitHandle.WaitOne(milliseconds, false)) {
                        exited = true; 
                        signaled = true;
                    }
                    else {
                        exited = false; 
                        signaled = false;
                    } 
                } 
            }
            finally { 
                if( processWaitHandle != null) {
                    processWaitHandle.Close();
                }
 
                // If we have a hard timeout, we cannot wait for the streams
                if( output != null && milliseconds == -1) { 
                    output.WaitUtilEOF(); 
                }
 
                if( error != null && milliseconds == -1) {
                    error.WaitUtilEOF();
                }
 
                ReleaseProcessHandle(handle);
 
            } 

            if (exited && watchForExit) { 
                RaiseOnExited();
            }
            
            return exited; 
        }

 internal ProcessWaitHandle( SafeProcessHandle processHandle): base() {
            SafeWaitHandle waitHandle = null; 
            bool succeeded = NativeMethods.DuplicateHandle(
                new HandleRef(this, NativeMethods.GetCurrentProcess()), 
                processHandle, 
                new HandleRef(this, NativeMethods.GetCurrentProcess()),
                out waitHandle, 
                0,
                false,
                NativeMethods.DUPLICATE_SAME_ACCESS);
 
            if (!succeeded) {
                Marshal.ThrowExceptionForHR(Marshal.GetHRForLastWin32Error()); 
            } 

            this.SafeWaitHandle = waitHandle; 
        }

     4.StartInfo屬性：獲取或設置要傳遞給 Process 的 Start 方法的屬性。StartInfo 表示用於啓動進程的一組參數。 調用 Start 時，StartInfo 用於指定要啓動的進程。 惟一必須設置的 StartInfo 成員是 FileName 屬性。

     具體介紹一下該方法的實現代碼：

 [Browsable(false), DesignerSerializationVisibility(DesignerSerializationVisibility.Content), MonitoringDescription(SR.ProcessStartInfo)] 
        public ProcessStartInfo StartInfo {
            get { 
                if (startInfo == null) { 
                    startInfo = new ProcessStartInfo(this);
                } 
                return startInfo;
            }
            [ResourceExposure(ResourceScope.Machine)]
            set { 
                if (value == null) {
                    throw new ArgumentNullException("value"); 
                } 
                startInfo = value;
            } 
        }

     5.CreateNoWindow屬性：獲取或設置指示是否在新窗口中啓動該進程的值。

        具體介紹一下該方法的實現代碼：

 [
        DefaultValue(false),
        MonitoringDescription(SR.ProcessCreateNoWindow),
        NotifyParentProperty(true) 
        ]
        public bool CreateNoWindow { 
            get { return createNoWindow; } 
            set { createNoWindow = value; }
        } 

    以上簡單介紹了該類的三種經常使用方法和兩種經常使用屬性，在實際的開發項目中無須對每一個屬性方法和屬性的底層實現作全面的瞭解，但建議在學習該類的時候，適當的瞭解一下某一些類的方法實現，有助於咱們很好的掌握該類。

二.如何實現PDF文件轉化爲SWF文件

   在項目若是須要將PDF文件轉換爲SWF文件，能夠在項目中引入Swftools插件，該插件的主要功能：PDF到SWF轉換器。 每頁生成一幀。 使您可以在Flash Movie中擁有徹底格式化的文本，包括表格，公式，圖形等。 它基於Derek B. Noonburg的xpdf PDF解析器。

  簡單介紹一下該插件的經常使用參數：

　　-h , –help                      Print short help message and exit              打印幫助信息    

　　-V , –version                Print version info and exit                        打印版本號 

　　-o , –output file.swf         Direct output to file.swf. If file.swf contains ‘13568621′ (file13568630.swf), then each page指定輸出的swf文件名

　　-P , –password password       Use password for deciphering the pdf.指定打開pdf的密碼 

　　-z , –zlib                    Use Flash 6 (MX) zlib compression.使用Flash 6的zlib壓縮機制 

　　-i , –ignore                  Allows pdf2swf to change the draw order of the pdf. This may make the generated容許程序修改pdf的繪製順序，可能會致使結果與原來有差別 

    以上是幾種經常使用的參數，具體擦參數列表詳見：http://www.swftools.org/。

   對實現本次操做的類和插件作了一個簡單的介紹，接下來提供一個具體實現該功能的操做方法：

        /// <summary>
        /// PDF格式轉爲SWF
        /// </summary>
        /// <param name="pdfPathParameter">原視頻文件地址，如/a/b/c.pdf</param>
        /// <param name="swfPathParameter">生成後的FLV文件地址，如/a/b/c.swf</param>
        /// <param name="beginpage">轉換開始頁</param>
        /// <param name="endpage">轉換結束頁</param>
        /// <param name="photoQuality">照片質量</param>
        /// <returns></returns>
        public static bool PdfConversionSwf(string pdfPathParameter, string swfPathParameter, int beginpage, int endpage, int photoQuality)
        {
            if (string.IsNullOrEmpty(pdfPathParameter))
            {
                throw new ArgumentNullException(pdfPathParameter);
            }
            if (string.IsNullOrEmpty(swfPathParameter))
            {
                throw new ArgumentNullException(swfPathParameter);
            }
            if (endpage < beginpage)
            {
                throw new ArgumentException("起始頁數大於結束頁數");
            }
            if (photoQuality <= 0)
            {
                throw new ArgumentException("照片質量錯誤");
            }
            var exe = HttpContext.Current.Server.MapPath("~/tools/swftools-2013-04-09-1007.exe");
            var pdfPath = HttpContext.Current.Server.MapPath(pdfPathParameter);
            var swfPath = HttpContext.Current.Server.MapPath(swfPathParameter);
            Process p = null;
            try
            {
                if (!File.Exists(exe) || !File.Exists(pdfPath))
                {
                    return false;
                }
                if (File.Exists(swfPath))
                {
                    File.Delete(swfPath);
                }
                var sb = new StringBuilder();
                sb.Append(" \"" + pdfPath + "\"");
                sb.Append(" -o \"" + swfPath + "\"");
                sb.Append(" -s flashversion=9");
                sb.Append(" -s disablelinks");
                if (endpage > GetPageCount(pdfPath))
                {
                    endpage = GetPageCount(pdfPath);
                }
                sb.Append(" -p " + "\"" + beginpage + "" + "-" + endpage + "\"");
                //SWF中的圖片質量
                sb.Append(" -j " + photoQuality);
                var command = sb.ToString();
                //Process提供對本地和遠程的訪問進程,使可以啓動和中止系統進程。
                p = new Process
                {
                    StartInfo =
                    {
                        FileName = exe,
                        Arguments = command,
                        WorkingDirectory = HttpContext.Current.Server.MapPath("~/Bin/"),
                        UseShellExecute = false,
                        RedirectStandardError = true,
                        CreateNoWindow = false
                    }
                };
                //啓動線程
                p.Start();
                //開始異步讀取
                p.BeginErrorReadLine();
                //等待完成
                p.WaitForExit();
                //開始同步讀取
                //p.StandardError.ReadToEnd();               
                if (!File.Exists(swfPath))
                    return false;
                return true;
            }
            catch (IOException ioex)
            {
                throw new IOException(ioex.Message);
            }
            catch (Exception ex)
            {
                throw new Exception(ex.Message);
            }
            finally
            {
                if (p != null)
                {
                    //關閉進程
                    p.Close();
                    //釋放資源
                    p.Dispose();
                }
            }

        }

三.小結

   在本文中介紹了在C#中如何操做外部程序和線程的類System.Diagnostics.Process，並介紹了該類的一些經常使用方法的底層實現代碼，若是須要對該類進行詳細的瞭解，能夠根據MSDN和.NET底層源碼的相關注釋和文章進行細緻的學習。在介紹完實現操做的類的同時，也對Swftools插件作了一個說明，並列舉了相關的參數，若是在項目中有較高的要求，能夠根據官方提供的API文檔進行重構。

   在項目開發中，任何一個功能是沒法作法完成全部的功能，在編碼功能時，只能儘量的考慮到方法的通用性，在理解了某一個類和某一個插件的基本原理和使用方法後，能夠根據對應的API進行添加新功能。