win-exec

License	The Apache Software License, Version 2.0
GroupId	io.webfolder
ArtifactId	win-exec
Last Version	1.0.0
Release Date	Jan 10, 2020
Type	jar
Description	win-exec win-exec
Project URL	https://github.com/webfolderio/win-exec
Source Code Management	https://github.com/webfolderio/win-exec.git

Download win-exec

Filename	Size
win-exec-1.0.0.pom
win-exec-1.0.0.jar	238 KB
win-exec-1.0.0-sources.jar	749 bytes
win-exec-1.0.0-javadoc.jar	24 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.webfolder/win-exec/ -->
<dependency>
    <groupId>io.webfolder</groupId>
    <artifactId>win-exec</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.webfolder/win-exec/
implementation 'io.webfolder:win-exec:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.webfolder/win-exec/
implementation ("io.webfolder:win-exec:1.0.0")

Apache Buildr

'io.webfolder:win-exec:jar:1.0.0'

Apache Ivy

<dependency org="io.webfolder" name="win-exec" rev="1.0.0">
  <artifact name="win-exec" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.webfolder', module='win-exec', version='1.0.0')
)

Scala SBT

libraryDependencies += "io.webfolder" % "win-exec" % "1.0.0"

Leiningen

[io.webfolder/win-exec "1.0.0"]

Dependencies

test (4)

Group / Artifact	Type	Version
org.zeroturnaround : zt-zip	jar	1.13
org.zeroturnaround : zt-exec	jar	1.11
org.slf4j : slf4j-simple	jar	1.7.30
commons-io : commons-io	jar	2.6

Project Modules

There are no modules declared in this project.

wf-exec

Process executor for Java which use Win32 Job Objects on Windows platform. Unlike default process executor this library help you to kill child process when parent dies normally or abnormally (reaps all zombie/defunct process).

Supported Java Versions

Oracle & OpenJDK Java 8, 11.

Both the JRE and the JDK are suitable for use with this library.

How it is tested

wf-exec is regularly tested on appveyor (Windows)

Integration with Maven

The project artifacts are available in Maven Central Repository.

To use the official release of wf-exec, please use the following snippet in your pom.xml file.

Add the following to your POM's <dependencies> tag:

<dependency>
    <groupId>io.webfolder</groupId>
    <artifactId>wf-exec</artifactId>
    <version>1.0.4</version>
</dependency>

Download

wf-exec-1.0.4.jar - 163 KB

Example

public class Example {

  private static final boolean WINDOWS  = getProperty("os.name")
                                              .toLowerCase(ENGLISH)
                                              .startsWith("windows");

  public static void main(String[] args) throws IOException {
    // load jni library
    WindowsJniLoader.loadJni();
    
    SubprocessFactory factory = WINDOWS ? WindowsSubprocessFactory.INSTANCE :
                                          JavaSubprocessFactory.INSTANCE;

    SubprocessBuilder builder = new SubprocessBuilder(factory);

    builder.setWorkingDirectory(new File("."));

    builder.setArgv("java.exe", "-version");

    StringBuilder buffer = new StringBuilder();

    Subprocess process = builder.start();
    try (Scanner scanner = new Scanner(process.getErrorStream())) {
      while (scanner.hasNext()) {
        String line = scanner.nextLine().trim();
        if (line.isEmpty()) {
          continue;
        }
        buffer.append(line).append("\r\n");
      }
    }

    // terminate the process
    process.destroy();

    while (process.finished()) {
      // wait until process finished
    }

    // close the native resources
    process.close();

    System.out.println(buffer.toString());
  }
}

License

Licensed under the Apache License.

Note: The included code from bazel is licensed under Apache.

Versions

Version
1.0.0 Jan 10, 2020