Clase Java.lang.ProcessBuilder en Java

Esta clase se utiliza para crear procesos del sistema operativo. Cada instancia de ProcessBuilder administra una colección de atributos de proceso. El método start() crea una nueva instancia de Process con esos atributos. El método start() se puede invocar repetidamente desde la misma instancia para crear nuevos subprocesos con atributos idénticos o relacionados. 

  • ProcessBuilder se puede utilizar para ayudar a crear un proceso de sistema operativo.
  • Antes de JDK 5.0, la única forma de crear un proceso y ejecutarlo era usar el método Runtime.exec().
  • Extiende la clase Object.
  • Esta clase no está sincronizada.

Constructor: 

  • ProcessBuilder (comando List): construye un generador de procesos con el programa y los argumentos del sistema operativo especificados. 
     
  • ProcessBuilder(String… comando): Construye un generador de procesos con el programa y los argumentos del sistema operativo especificados.

Métodos:  

1. List command(): este método devuelve el programa y los argumentos del sistema operativo del generador de procesos. 

Syntax: public List command().
Returns: this process builder's program and its arguments.
Exceptions: NullPointerException - if the argument is null.

Java

// Java code illustrating command() method
import java.io.*;
import java.lang.*;
import java.util.*;
class ProcessBuilderDemo {
    public static void main(String[] arg) throws IOException
    {
        // creating list of process
        List<String> list = new ArrayList<String>();
        list.add("notepad.exe");
 
        // create the process
        ProcessBuilder build = new ProcessBuilder(list);
 
        // checking the command i list
        System.out.println("command: " + build.command());
    }
}
Producción

command: [notepad.exe]

2. Comando ProcessBuilder (comando List): este método establece el programa y los argumentos del sistema operativo del generador de procesos. 

Syntax: public ProcessBuilder command(List command).
Returns: NA.
Exception: NullPointerException - if the argument is null.

Java

// Java code illustrating ProcessBuilder
// command(List<String> command)
import java.io.*;
import java.lang.*;
import java.util.*;
class ProcessBuilderDemo {
    public static void main(String[] arg) throws IOException
    {
        // creating list of process
        List<String> list = new ArrayList<String>();
        list.add("notepad.exe");
        list.add("xyz.txt");
 
        // create the process
        ProcessBuilder build = new ProcessBuilder(list);
 
        // checking the command in list
        System.out.println("command: " + build.command());
    }
}
Producción

command: [notepad.exe, xyz.txt]

3. Directorio de ProcessBuilder (directorio de archivos): este método establece el directorio de trabajo del generador de procesos. Los subprocesos iniciados posteriormente por el método start() del objeto lo usarán como su directorio de trabajo. El argumento puede ser nulo, lo que significa utilizar el directorio de trabajo del proceso Java actual, generalmente el directorio nombrado por la propiedad del sistema user.dir, como el directorio de trabajo del proceso secundario. 

Syntax: public ProcessBuilder directory(File directory).
Returns: this process builder.
Exception: NA.

Java

// Java code illustrating directory() method
import java.io.*;
import java.lang.*;
import java.util.*;
class ProcessBuilderDemo {
    public static void main(String[] arg) throws IOException
    {
        // creating list of process
        List<String> list = new ArrayList<String>();
        list.add("notepad.exe");
        list.add("abc.txt");
 
        // creating the process
        ProcessBuilder build = new ProcessBuilder(list);
 
        // setting the directory
        build.directory(new File("src"));
 
        // checking the directory, on which currently
        // working on
        System.out.println("directory: "
                           + build.directory());
    }
}
Producción

directory: src

4. Entorno de mapa(): este método devuelve una vista de mapa de strings del entorno del generador de procesos. Cada vez que se crea un generador de procesos, el entorno se inicializa en una copia del entorno de proceso actual. Los subprocesos iniciados posteriormente por el método start() del objeto utilizarán este mapa como su entorno. 

Syntax: public Map environment()
Returns: this process builder's environment
Exception: SecurityException - if a security manager exists 
and its checkPermission method doesn't allow access to the process environment.

Java

// Java code illustrating environment() method
import java.io.*;
import java.util.*;
class ProcessBuilderDemo {
    public static void main(String[] arg) throws IOException
    {
        // creating the process
        ProcessBuilder pb = new ProcessBuilder();
 
        // map view of this process builder's environment
        Map<String, String> envMap = pb.environment();
 
        // checking map view of environment
        for (Map.Entry<String, String> entry :
             envMap.entrySet()) {
            // checking key and value separately
            System.out.println("Key = " + entry.getKey()
                               + ", Value = "
                               + entry.getValue());
        }
    }
}

Producción: 

Key = PATH, Value = /usr/bin:/bin:/usr/sbin:/sbin
Key = JAVA_MAIN_CLASS_14267, Value = ProcessBuilderDemo
Key = J2D_PIXMAPS, Value = shared
Key = SHELL, Value = /bin/bash
Key = JAVA_MAIN_CLASS_11858, Value = org.netbeans.Main
Key = USER, Value = abhishekverma
Key = TMPDIR, Value = /var/folders/9z/p63ysmfd797clc0468vvy4980000gn/T/
Key = SSH_AUTH_SOCK, Value = /private/tmp/com.apple.launchd.uWvCfYQWBP/Listeners
Key = XPC_FLAGS, Value = 0x0
Key = LD_LIBRARY_PATH, Value = /Library/Java/JavaVirtualMachines
/jdk1.8.0_121.jdk/Contents/Home/jre/lib/
amd64:/Library/Java/JavaVirtualMachines/jdk1.8.0_121.jdk
/Contents/Home/jre/lib/i386:
Key = __CF_USER_TEXT_ENCODING, Value = 0x1F5:0x0:0x0
Key = Apple_PubSub_Socket_Render, Value = /private/tmp/com.apple.launchd.weuNq4pAfF/Render
Key = LOGNAME, Value = abhishekverma
Key = LC_CTYPE, Value = UTF-8
Key = XPC_SERVICE_NAME, Value = 0
Key = PWD, Value = /
Key = SHLVL, Value = 1
Key = HOME, Value = /Users/abhishekverma
Key = _, Value = /Library/Java/JavaVirtualMachines/
jdk1.8.0_121.jdk/Contents/Home/bin/java

Comprender el resultado anterior: El resultado es la vista de mapa de la creación del subproceso. El resultado anterior varía de un usuario a otro y depende totalmente del sistema operativo y del usuario.

5. boolean redirectErrorStream(): este método indica si el generador de procesos combina el error estándar y la salida estándar. Si esta propiedad es verdadera, cualquier resultado de error generado por los subprocesos iniciados posteriormente por el método start() del objeto se combinará con el resultado estándar, de modo que ambos puedan leerse mediante el método Process.getInputStream(). Facilita la correlación de mensajes de error con la salida correspondiente. El valor inicial es falso. 

Syntax: public boolean redirectErrorStream().
Returns: this process builder's redirectErrorStream property.
Exception: NA.

Java

// Java code illustrating redirectErrorStream() method
import java.io.*;
import java.lang.*;
import java.util.*;
class ProcessBuilderDemo {
    public static void main(String[] arg) throws IOException
    {
 
        // creating list of commands
        List list = new ArrayList();
 
        list.add("notepad.exe");
        list.add("xyz.txt");
 
        // creating the process
        ProcessBuilder build = new ProcessBuilder(list);
 
        // checking if error stream is redirected
        System.out.println(build.redirectErrorStream());
    }
}

Producción: 

false

6. ProcessBuilder redirectErrorStream(boolean redirectErrorStream): este método establece la propiedad redirectErrorStream de este generador de procesos. Si esta propiedad es verdadera, cualquier resultado de error generado por los subprocesos iniciados posteriormente por el método start() de este objeto se fusionará con el resultado estándar para que ambos puedan leerse mediante el método Process.getInputStream(). Esto facilita la correlación de mensajes de error con la salida correspondiente. El valor inicial es falso. 

Syntax: public ProcessBuilder redirectErrorStream(boolean redirectErrorStream).
Returns: this process builder.
Exception: NA.

Java

// Java code illustrating redirectErrorStream(boolean
// redirectErrorStream) method
import java.io.*;
import java.lang.*;
import java.util.*;
class ProcessBuilderDemo {
    public static void main(String[] arg) throws IOException
    {
 
        // creating list of commands
        List list = new ArrayList();
 
        list.add("notepad.exe");
        list.add("xyz.txt");
 
        // creating the process
        ProcessBuilder build = new ProcessBuilder(list);
 
        // redirecting error stream
        build.redirectErrorStream(true);
 
        // checking if error stream is redirected
        System.out.println(build.redirectErrorStream());
    }
}

Producción: 

true

Process start(): este método inicia un nuevo proceso utilizando los atributos del generador de procesos. El nuevo proceso invocará el comando y los argumentos dados por comando(), en un directorio de trabajo dado por directorio(), con un entorno de proceso dado por medio ambiente(). Este método verifica que el comando sea un comando válido del sistema operativo. Los comandos que son válidos dependen del sistema, pero como mínimo el comando debe ser una lista no vacía de strings no nulas. Si hay un administrador de seguridad, se llama a su método checkExec con el primer componente de la array de comandos de este objeto como argumento. Puede resultar en que se lance una SecurityException. 

Syntax: public Process start().
Returns: a new Process object for managing the subprocess.
Exception: NullPointerException - If an element of the command list is null
IndexOutOfBoundsException - If the command is an empty list (has size 0).
SecurityException - If a security manager exists 
and its checkExec method doesn't allow creation of the subprocess.
IOException - If an I/O error occurs.

Java

// Java code illustrating start() method
import java.io.*;
import java.lang.*;
import java.util.*;
class ProcessBuilderDemo {
    public static void main(String[] arg) throws IOException
    {
        // creating list of commands
        List<String> commands = new ArrayList<String>();
        commands.add("ls"); // command
        commands.add("-l"); // command
        commands.add(
            "/Users/abhishekverma"); // command in Mac OS
 
        // creating the process
        ProcessBuilder pb = new ProcessBuilder(commands);
 
        // starting the process
        Process process = pb.start();
 
        // for reading the output from stream
        BufferedReader stdInput
            = new BufferedReader(new InputStreamReader(
                process.getInputStream()));
        String s = null;
        while ((s = stdInput.readLine()) != null) {
            System.out.println(s);
        }
    }
}

Producción: 

total 0
drwxr-xr-x  10 abhishekverma  staff   340 Jun 20 02:24 AndroidStudioProjects
drwx------@ 22 abhishekverma  staff   748 Jun 20 03:00 Desktop
drwx------@  7 abhishekverma  staff   238 Apr 29 22:03 Documents
drwx------+ 27 abhishekverma  staff   918 Jun 20 03:01 Downloads
drwx------@ 65 abhishekverma  staff  2210 Jun 18 20:48 Library
drwx------+  3 abhishekverma  staff   102 Mar 28 13:08 Movies
drwx------+  4 abhishekverma  staff   136 Apr  8 04:51 Music
drwxr-xr-x   4 abhishekverma  staff   136 Jun 19 15:01 NetBeansProjects
drwx------+  5 abhishekverma  staff   170 Apr 10 09:46 Pictures
drwxr-xr-x+  6 abhishekverma  staff   204 Jun 18 20:45 Public
-rw-r--r--   1 abhishekverma  staff     0 Apr 15 19:23 newreactjs.jsx

ProcessBuilder heritageIO(): establece el origen y el destino de la E/S estándar del subproceso para que sean los mismos que los del proceso Java actual. 

Syntax: public ProcessBuilder inheritIO().
Returns: this process builder.
Exception: NA.

Java

// Java code illustrating inheritIO() method
import java.io.*;
import java.lang.*;
import java.util.*;
class ProcessBuilderDemo {
    public static void main(String[] arg)
        throws IOException, InterruptedException
    {
        ProcessBuilder pb = new ProcessBuilder(
            "echo", "Hello GeeksforGeeks\n"
                        + "This is ProcessBuilder Example");
        pb.inheritIO();
        Process process = pb.start();
        process.waitFor();
    }
}

Producción: 

Hello GeeksforGeeks
This is ProcessBuilder Example

Este artículo es una contribución de Abhishek Verma . Si te gusta GeeksforGeeks y te gustaría contribuir, también puedes escribir un artículo usando write.geeksforgeeks.org o enviar tu artículo por correo a review-team@geeksforgeeks.org. Vea su artículo que aparece en la página principal de GeeksforGeeks y ayude a otros Geeks.
Escriba comentarios si encuentra algo incorrecto o si desea compartir más información sobre el tema tratado anteriormente.

Publicación traducida automáticamente

Artículo escrito por GeeksforGeeks-1 y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *