600849155 / command4j

java调用命令的工具，命令行运行管理器，命令执行、停止、查询功能的工具

command4j java命令执行管理器

作用

调用系统的一些可执行软件，比如 linux 的 shell 脚本，windows 的 bat、exe可执行文件

为什么要创建此项目

当我们需要用 java 调用本地程序时，使用 Runtime.getRuntime().exec(cmd)固然可以，但需要注意需要此方法返回的 process 中获取 inputStream、errorStream，需要使用两个线程从中读取内容， 如果忽略这个问题，会导致所执行的本地程序阻塞， 看起来就是不报错停在那里了,原因是java中会为所执行的命令开辟一个缓冲区，用于存放命令所产生的输出，包括标准输出， 和错误输出，如果被调用的程序产生的输出较多，而且也不从缓冲中读走，那么时间长了就会导致被调用的程序阻塞。 所以本项目就是为了解决此问题，而且不需要手动对 inputStream、errorStream 的流进行处理，使用commandManager.exec("一个命令")即可， commandManager 会自动帮你处理 inputStream、errorStream 的流,从而避免被调用的程序阻塞。

使用方法

引入依赖

<dependency>
  <groupId>com.github.jazzhow</groupId>
  <artifactId>command4j</artifactId>
  <version>2.0.0-RELEASE</version>
</dependency>

@Test
void test1() throws IOException, InterruptedException, ProcessExistException {
    //可执行的linux程序，或windows程序，cmd1 与 cmd2执行的内容可以相同可以不同。
    String cmd1 = "D:/software/ffmpeg/bin/ffmpeg -i rtsp://184.72.239.149/vod/mp4://BigBuckBunny_175k.mov -f flv -r 25 -g 25 -s 640x360 -an rtmp://localhost/live/test -vcodec copy  -f flv -an rtmp://localhost/live/test123HD";
    String cmd2 = "D:/software/ffmpeg/bin/ffmpeg -i rtsp://184.72.239.149/vod/mp4://BigBuckBunny_175k.mov -f flv -r 25 -g 25 -s 640x360 -an rtmp://localhost/live/test -vcodec copy  -f flv -an rtmp://localhost/live/test123HD";
    CommandManager commandManager = new CommandManager();
    //第一个参数是这个启动进程的标识,在同一个CommandManager对象中唯一，它的意义是方便通过这个标识关闭这个启动的进程，
    //如果在同一个CommandManager对象中启动两个相同标识进程，那么会抛出一个ProcessExistException异常。
    commandManager.exec("process1", cmd1);
    CommandProcess process2 = commandManager.exec("process2", cmd2);
    //获取commandManager中的所有的CommandProcess
    Collection<CommandProcess> allProcess = commandManager.getAllProcess();
    System.out.println(allProcess.size());
    //process2的进程状态
    System.out.println(process2.getProcess().isAlive());
    //process2的执行命令
    System.out.println(process2.getCommand());
    //process2的执行时间
    System.out.println(process2.getExecTime());
    //process2的执行标识
    System.out.println(process2.getProcessId());
    TimeUnit.SECONDS.sleep(1);
    //关闭process1
    commandManager.destroy("process1");
    //关闭process2
    commandManager.destroy(process2.getProcessId());
    //关闭一个不存在的标识
    CommandProcess huhuhah = commandManager.destroy("呼呼哈哈");
    System.out.println("destroy传入commandManager中不存在的标识返回： " + huhuhah);
    if (!process2.getProcess().isAlive()){
           //process2的执行命令后系统的显示
           process2.getResponse().forEach(System.out::println);
       }
}

如何让被调用的程序输出或关闭输出

本项目使用 slf4j 控制被调用的程序的输出，指定 jazzhow.command4j 的日志级别即可，level=debug 可以看到被调用的程序的输出的输出， level=info 只输出关键信息，等于其他请自行脑补。

说明

一个 CommandManager 对象可以管理多个运行的的本地程序，包括启动多个本地程序，关闭通过它启动的程序， 在程序退出时会自动关闭所有通过他运行的程序。

• 创建一个命令管理对象： CommandManager commandManager = new CommandManager();

• 运行本地程序： commandManager.exec("进程标识", "启动命令"); //返回一个 java.lang.Process对象。

• 结束通过 commandManager 启动的本地程序：

commandManager.destroy("进程标识"); 
//返回一个 java.lang.Process对象。
//commandManager如果进程标识存在于commandManager中，返回null

• 获取通过 commandManager 启动的程序：commandManager.getAllProcess(); //返回Collection<CommandProcess>

• 停止通过 commandManager 所启动的所有程序：commandManager.destroyAll(); //返回Collection<CommandProcess>,被关闭的CommandProcess的集合

注意

• 当 java 程序结束时，commandManager 所管理的本地进程会被关闭，如果想java退出也不关闭被调用的本地程序， 请使用 java 的原生方式 Runtime.getRuntime().exec(cmd)
• linux 下如果要结束本 java 程序，kill java 程序是可以的，但是不要用 kill -9 结束，否则 commandManager 所管理的本地进程将 无法被 commandManager 自动关闭。