1f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 2f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Licensed to the Apache Software Foundation (ASF) under one or more 3f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * contributor license agreements. See the NOTICE file distributed with 4f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * this work for additional information regarding copyright ownership. 5f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * The ASF licenses this file to You under the Apache License, Version 2.0 6f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * (the "License"); you may not use this file except in compliance with 7f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the License. You may obtain a copy of the License at 8f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 9f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 10f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 11f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 12f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 13f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * See the License for the specific language governing permissions and 15f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * limitations under the License. 16f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 17f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 18f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpackage java.lang; 19f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport java.io.InputStream; 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport java.io.OutputStream; 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/** 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Represents an external process. Enables writing to, reading from, destroying, 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * and waiting for the external process, as well as querying its exit value. 263819a76e7c1f49253f0e077bd497f149340c02b8Jesse Wilson * 27f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @see Runtime#exec 28f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @see ProcessBuilder#start() 29f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 30f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpublic abstract class Process { 31f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 32f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 33f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Terminates this process and closes any associated streams. 34f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 35f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project abstract public void destroy(); 36f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 37f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 38f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Returns the exit value of the native process represented by this object. 39f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * It is available only when the native process has terminated. 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 41f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return the exit value of this process. 42f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @throws IllegalThreadStateException 43f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * if this process has not terminated. 44f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 45f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project abstract public int exitValue(); 46f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 48f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Returns an input stream that is connected to the error stream 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <em>(stderr)</em> of the native process represented by this object. 50f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return the input stream to read from the error stream associated with 52f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the native process. 53f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 54f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project abstract public InputStream getErrorStream(); 55f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 56f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 57f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Returns an input stream that is connected to the standard output stream 58f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <em>(stdout)</em> of the native process represented by this object. 59f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 60f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return the input stream to read from the output stream associated with 61f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the native process. 62f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 63f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project abstract public InputStream getInputStream(); 64f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 65f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 66f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Returns an output stream that is connected to the standard input stream 67f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <em>(stdin)</em> of the native process represented by this object. 68f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 69f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return the output stream to write to the input stream associated with 70f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the native process. 71f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 72f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project abstract public OutputStream getOutputStream(); 73f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 74f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 75f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Causes the calling thread to wait for the native process associated with 76f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * this object to finish executing. 77f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 78f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return the exit value of the native process being waited on. 79f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @throws InterruptedException 80f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * if the calling thread is interrupted. 81f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 82f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project abstract public int waitFor() throws InterruptedException; 83f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} 84