/* * Copyright (c) 1995, 2012, Oracle and/or its affiliates. All rights reserved. * ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. * * * * * * * * * * * * * * * * * * * * */ package java.lang; import java.io.*; import java.util.concurrent.TimeUnit; /** * * {@link ProcessBuilder#start()}ºÍ * {@link Runtime#exec(String[],String[],File) Runtime.exec}·½·¨ * ´´½¨Ò»¸ö±¾µØ½ø³Ì²¢·µ»Ø{@code Process}µÄÒ»¸öʵÀý£¬ * £¨¸ÃʵÀý£©ÓÃÓÚ¿ØÖƽø³Ì²¢»ñÈ¡ÆäÐÅÏ¢¡£ * {@code Process}ÀàÌṩµÄ·½·¨ÓÃÓÚ»ñÈ¡½ø³ÌµÄÊäÈëÁ÷£¬½ø³ÌµÄÊä³öÁ÷£¬ * µÈ´ý½ø³ÌÖ´ÐÐÍê±Ï£¬¼ì²é½ø³ÌµÄÖ´ÐÐ״̬£¬ÒÔ¼°Ïú»Ù£¨É±ËÀ£©½ø³Ì¡£ * *

Ôڹ̶¨µÄ±¾µØƽ̨ÉÏ£¬´´½¨½ø³ÌµÄ·½·¨¶ÔÌض¨½ø³ÌµÄÖ§³Ö¿ÉÄܲ»ºÃ£¬±ÈÈç±¾µØ´°¿Ú½ø³Ì£¬ÊØ»¤½ø³Ì£¬ * ΢ÈíWindowsÖеÄWin16/DOS½ø³Ì£¬»òÕßÊÇshell½Å±¾¡£ * *

ĬÈϵģ¬´´½¨µÄ×Ó½ø³ÌûÓÐ×Ô¼ºµÄÖն˻ò¿ØÖÆ̨¡£ÆäËùÓеıê×¼I/O£¨±ÈÈçstdin, stdout, stderr£© * ²Ù×÷½«»áÖض¨Ïòµ½Æ丸½ø³ÌÖУ¬¸¸½ø³ÌÖпÉÒÔͨ¹ýʹÓ÷½·¨ * {@link #getOutputStream()}, * {@link #getInputStream()}, ºÍ * {@link #getErrorStream()}À´»ñÈ¡µÄÁ÷À´·ÃÎÊ¡£ * * ¸¸½ø³ÌÒÀ¿¿ÕâЩÁ÷À´´Ó×Ó½ø³Ì»ñÈ¡ÊäÈëºÍÊä³ö¡£ * ÓÉÓÚһЩ±¾µØƽֻ̨ΪÊäÈëÊä³öÁ÷ÌṩÓÐÏ޵Ļº´æ´óС£¬ * ѸËÙÏò×Ó½ø³ÌдÊäÈëÁ÷»ò¶ÁÊä³öÁ÷µÄ´íÎó¿ÉÄÜ»áÒýÆð×Ó½ø³Ì×èÈû£¬ÉõÖÁÊÇËÀËø¡£ * *

ͬʱ£¬ * ×Ó½ø³ÌI/OÒ²¿ÉÒÔʹÓÃ{@link ProcessBuilder}ÀàµÄ·½·¨À´Öض¨Ïò¡£ * *

µ±²»¾ßÓÐ{@code Process}¶ÔÏóµÄÒýÓÃʱ£¬ * ×Ó½ø³Ì²»»á±»É±ËÀ£¬Ïà·´×Ó½ø³Ì»á¼ÌÐøÒì²½Ö´ÐС£ * *

½ø³ÌûÓбØÒªÒì²½ÔËÐС£ * * *

1.5°æ±¾ÖУ¬{@link ProcessBuilder#start()}ÊÇ´´½¨{@code Process}µÄÊ×Ñ¡·½Ê½¡£ * * @since JDK1.0 */ public abstract class Process { /** * »ñÈ¡×Ó½ø³ÌµÄÊä³öÁ÷£¬¸Ã×Ó½ø³ÌÁ¬½Ó±ê×¼ÊäÈ롣ͨ¹ý¹ÜµÀ´Ó½ø³ÌµÄ±ê×¼ÊäÈë»ñÈ¡±ê×¼Êä³öÊý¾Ý¡£ * *

Èç¹û×Ó½ø³ÌµÄ±ê×¼ÊäÈ뱻ʹÓÃ{@link ProcessBuilder#redirectInput(Redirect) * ProcessBuilder.redirectInput}Öض¨Ïò¹ý£¬ * ÄÇô¸Ã·½·¨½«·µ»ØnullÊä³öÁ÷¡£ * *

ʵÏÖ×¢ÒâÊÂÏ½«±»·µ»ØµÄÊä³öÁ÷½øÐлº´æ²¢²»ÊǺÃÖ÷Òâ¡£ * * @return Á¬½Óµ½×Ó½ø³Ì±ê×¼ÊäÈëµÄÊä³öÁ÷¡£ */ public abstract OutputStream getOutputStream(); /** * ·µ»ØÁ¬½Óµ½±ê×¼Êä³öµÄÊäÈëÁ÷¡£Í¨¹ý¹ÜµÀ´Ó½ø³ÌµÄ±ê×¼Êä³ö»ñÈ¡±ê×¼ÊäÈëÊý¾Ý¡£ * *

Èç¹û×Ó½ø³ÌµÄ±ê×¼Êä³ö±»Ê¹ÓÃ{@link ProcessBuilder#redirectOutput(Redirect) * ProcessBuilder.redirectOutput}Öض¨Ïò¹ý£¬ * ÄÇô¸Ã·½·¨½«·µ»ØnullÊäÈëÁ÷¡£ * * *

·ñÔò£¬Èç¹û×Ó½ø³ÌµÄ±ê×¼´íÎó±»Ê¹ÓÃ{@link ProcessBuilder#redirectErrorStream(boolean) * ProcessBuilder.redirectErrorStream}Öض¨Ïò£¬ * ÄÇô¸Ã·½·¨·µ»ØµÄÊäÈëÁ÷½«»á½ÓÊÕµ½×Ó½ø³ÌºÏ²¢ºóµÄ±ê×¼Êä³ö¼°±ê×¼´íÎó¡£ * *

ʵÏÖ×¢ÒâÊÂÏ½«·µ»ØµÄÊäÈëÁ÷½øÐлº´æÊÇÒ»¸öºÃÖ÷Òâ¡£ * * @return Á¬½Óµ½×Ó½ø³ÌÕý³£Êä³öµÄÊäÈëÁ÷¡£ */ public abstract InputStream getInputStream(); /** * ·µ»Ø×Ó½ø³ÌÖÐÁ¬½Óµ½´íÎóÊä³öµÄÊäÈëÁ÷¡£Í¨¹ý¹ÜµÀ´Ó½ø³ÌµÄ´íÎóÊä³ö»ñÈ¡Êý¾Ý¡£ *

Èç¹û×Ó½ø³ÌµÄ±ê×¼´íÎó±»Ê¹ÓÃ{@link ProcessBuilder#redirectError(Redirect) * ProcessBuilder.redirectError}»òÕß * {@link ProcessBuilder#redirectErrorStream(boolean) * ProcessBuilder.redirectErrorStream}½øÐÐÁËÖض¨Ïò£¬ * ÄÇô¸Ã·½·¨½«»á·µ»ØÒ»¸ö * *

ʵÏÖ×¢ÒâÊÂÏ½«·µ»ØµÄÊäÈëÁ÷½øÐлº´æÊÇÒ»¸öºÃÖ÷Òâ¡£ * * @return ×Ó½ø³ÌÖУ¬Á¬½Óµ½´íÎóÊä³öµÄÊäÈëÁ÷ */ public abstract InputStream getErrorStream(); /** * ʹµÃµ±Ç°µÄÏ̹߳ÒÆðµÈ´ý£¬ÈçÓÐÐèÒª£¬Ö±µ½{@code Process}¶ÔÏó´ú±íµÄ×Ó½ø³ÌÖÕÖ¹¡£ * Èç¹û{@code Process}¶ÔÏóÖÕÖ¹£¬¸Ã·½·¨Á¢¼´·µ»Ø¡£ * Èç¹û×Ó½ø³ÌδÖÕÖ¹£¬µ÷ÓÃÏ߳̽«»á±»×èÈû£¬Ö±µ½×Ó½ø³ÌÍ˳ö¡£ * * @return {@code Process}¶ÔÏó±íʾµÄ×Ó½ø³ÌµÄÍ˳öÖµ¡£ * °´ÕÕ¹ßÀý£¬{@code 0}Öµ±íʾÕý³£ÖÕÖ¹¡£ * @throws InterruptedException Èç¹ûµ±Ç°Ïß³ÌÔڵȴýµÄʱºò * ±»ÆäËûÏ̴߳ò¶Ï£¬ÄÇôµÈ´ýÖÕÖ¹£¬²¢ÇÒÅ׳ö{@link InterruptedException}¡£ */ public abstract int waitFor() throws InterruptedException; /** * ʹµÃµ±Ç°Ï̹߳ÒÆðµÈ´ý£¬ÈçÓÐÐèÒª£¬Ö±µ½{@code Process}¶ÔÏó´ú±íµÄ×Ó½ø³ÌÖÕÖ¹£¬ * »òÕß³¬¹ýÁËÖ¸¶¨µÄµÈ´ýʱ¼ä¡£ * *

Èç¹û×Ó½ø³ÌÒÑÖÕÖ¹£¬ÄÇô¸Ã·½·¨Á¢¿Ì·µ»Ø{@code true}Öµ¡£ * Èç¹û×Ó½ø³ÌûÓÐÖÕÖ¹ÇÒtimeoutֵСÓÚ»òµÈÓÚÉ趨ֵ£¬0Öµ£¬ÄÇô¸Ã·½·¨Á¢¼´·µ»Ø{@code false}Öµ¡£ *

¸Ã·½·¨µÄĬÈÏʵÏÖͨ¹ý¼ì²â{@code exitValue}À´ºËʵ½ø³ÌÊÇ·ñÖÕÖ¹¡£Ç¿ÁÒ½¨ÒéÔÚ¾ßÌå±àÂëµÄʱºò * ʹÓÃÒ»¸ö¸üÓÐЧµÄʵÏÖ½øÐÐÖØд¡£ * * * @param timeout ×î´óµÄµÈ´ýʱ¼ä * @param {@code timeout}²ÎÊýµÄʱ¼äµ¥Î» * @return Èç¹û×Ó½ø³ÌÒÑÍ˳ö·µ»Ø{@code true}£¬Èç¹ûµÈ´ýʱ¼äÔÚ×Ó½ø³ÌÍ˳öÇ°³¬Ê±Ôò·µ»Ø{@code false}¡£ * @throws InterruptedException Èç¹ûÔڵȴýµÄʱºòµ±Ç°Ï̱߳»´ò¶Ï¡£ * @throws NullPointerException Èç¹ûµ¥Î»ÊÇnull * @since 1.8 */ public boolean waitFor(long timeout, TimeUnit unit) throws InterruptedException { long startTime = System.nanoTime(); long rem = unit.toNanos(timeout); do { try { exitValue(); return true; } catch(IllegalThreadStateException ex) { if (rem > 0) Thread.sleep( Math.min(TimeUnit.NANOSECONDS.toMillis(rem) + 1, 100)); } rem = unit.toNanos(timeout) - (System.nanoTime() - startTime); } while (rem > 0); return false; } /** * ·µ»Ø×Ó½ø³ÌµÄÍ˳öÖµ * * @return ¸Ã½ø³ÌµÄÍ˳öÖµ¡£°´ÕÕ¹ßÀý£¬{@code 0}Öµ´ú±íÕý³£Í˳ö¡£ * @throws IllegalThreadStateException Èç¹û×Ó½ø³Ì»¹Ã»ÓÐÖÕÖ¹ */ public abstract int exitValue(); /** * ɱËÀ×Ó½ø³Ì¡£ÎÞÂÛ×Ó½ø³Ì±»Ç¿ÖÆÖÕÖ¹»òÕß¾ßÓÐʵÏÖÒÀÀµ¡£ */ public abstract void destroy(); /** * ɱËÀ×Ó½ø³Ì¡£¸Ã{@code Process}¶ÔÏó´ú±íµÄ×Ó½ø³Ì±»Ç¿ÖÆÖÕÖ¹¡£ * *

¸Ã·½·¨µÄĬÈÏʵÏÖµ÷ÓÃÁË{@link #destroy}·½·¨£¬¹Ê¿ÉÄÜÎÞ·¨Ç¿ÖÆÖÕÖ¹µ±Ç°½ø³Ì¡£ * ¾ßÌåµÄʵÏÖ´ëÊ©ÖУ¬Ç¿ÁÒ½¨ÒéʹÓÃÓÐЧµÄʵÏÖÀ´ÖØд¸Ã·½·¨¡£ * µ÷Óø÷½·¨À´Ç¿ÖÆÖÕÖ¹½ø³Ì£¨ÓÉ {@link ProcessBuilder#start}ºÍ * {@link Runtime#exec}»ñµÃµÄ¶ÔÏ󣩡£ * *

×¢Ò⣺×Ó½ø³Ì²»»áÁ¢¿ÌÖÕÖ¹¡£ * ±ÈÈ磺{@code isAlive()}¿ÉÄÜÔÚ{@code destroyForcibly()} * µ÷ÓúóµÄ¶Ìʱ¼äÄÚ·µ»Øtrue¡£ÈçÓÐÐèÒª£¬¸Ã·½·¨Ó¦ºÍ{@code waitFor()}·½·¨½áºÏʹÓᣠ* * @return ±»Ç¿ÖÆÖÕÖ¹µÄ {@code Process}¶ÔÏó´ú±íµÄ×Ó½ø³Ì¡£ * @since 1.8 */ public Process destroyForcibly() { destroy(); return this; } /** * ²âÊÔ¸Ã{@code Process}¶ÔÏó´ú±íµÄ×Ó½ø³ÌÊÇ·ñ´æ»î¡£ * * @return {@code true} Èç¹û¸Ã×Ó½ø³Ìδ±»ÖÕÖ¹¡£ * @since 1.8 */ public boolean isAlive() { try { exitValue(); return false; } catch(IllegalThreadStateException e) { return true; } } }