rev 48074 : 8189102: All tools should support -?, -h and --help
Reviewed-by: kvn, jjg, weijun, alanb, rfield, ksrini

   1 /*
   2  * Copyright (c) 2011, 2017, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.
   8  *
   9  * This code is distributed in the hope that it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12  * version 2 for more details (a copy is included in the LICENSE file that
  13  * accompanied this code).
  14  *
  15  * You should have received a copy of the GNU General Public License version
  16  * 2 along with this work; if not, write to the Free Software Foundation,
  17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  18  *
  19  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  20  * or visit www.oracle.com if you need additional information or have any
  21  * questions.
  22  */
  23 
  24 import static jdk.testlibrary.Asserts.*;
  25 
  26 import java.io.File;
  27 import java.io.IOException;
  28 import java.nio.file.Files;
  29 import java.nio.file.Path;
  30 import java.nio.file.Paths;
  31 import java.util.List;
  32 
  33 import jdk.testlibrary.JcmdBase;
  34 import jdk.testlibrary.OutputAnalyzer;
  35 import jdk.testlibrary.Utils;
  36 
  37 /*
  38  * @test
  39  * @bug 7104647
  40  * @summary Unit test for jcmd utility. Tests jcmd options which do not send
  41  * requests to a specific JVM process.
  42  *
  43  * @library /lib/testlibrary
  44  *
  45  * @build jdk.testlibrary.*
  46  * @run main TestJcmdDefaults
  47  */
  48 public class TestJcmdDefaults {
  49 
  50     private static final String TEST_SRC = System.getProperty("test.src").trim();
  51     private static final String[] VM_ARGS = new String[] { "-XX:+UsePerfData" };
  52     private static final String JCMD_LIST_REGEX = "(?s)^\\d+\\s*.*";
  53 
  54     public static void main(String[] args) throws Exception {

  55         testJcmdUsage("-h");
  56         testJcmdUsage("-help");
  57         testJcmdDefaults();
  58         testJcmdDefaults("-l");
  59     }
  60 
  61     /**

  62      * jcmd -J-XX:+UsePerfData -h
  63      * jcmd -J-XX:+UsePerfData -help
  64      */
  65     private static void testJcmdUsage(String... jcmdArgs) throws Exception {
  66         OutputAnalyzer output = JcmdBase.jcmdNoPid(VM_ARGS, jcmdArgs);
  67 
  68         assertNotEquals(output.getExitValue(), 0);
  69         verifyOutputAgainstFile(output);
  70     }
  71 
  72     /**
  73      * jcmd -J-XX:+UsePerfData
  74      * jcmd -J-XX:+UsePerfData -l
  75      */
  76     private static void testJcmdDefaults(String... jcmdArgs) throws Exception {
  77         OutputAnalyzer output = JcmdBase.jcmdNoPid(VM_ARGS, jcmdArgs);
  78 
  79         output.shouldHaveExitValue(0);
  80         output.shouldContain("sun.tools.jcmd.JCmd");
  81         matchListedProcesses(output);
  82     }
  83 
  84     /**
  85      * Verifies the listed processes match a certain pattern.
  86      *
  87      * The output should look like:
  88      * 12246 sun.tools.jcmd.JCmd
  89      * 24428 com.sun.javatest.regtest.MainWrapper /tmp/jtreg/jtreg-workdir/classes/sun/tools/jcmd/TestJcmdDefaults.jta
  90      *
  91      * @param output The generated output from the jcmd.
  92      * @throws Exception
  93      */
  94     private static void matchListedProcesses(OutputAnalyzer output) throws Exception {
  95         int matchedCount = output.shouldMatchByLine(JCMD_LIST_REGEX);
  96         assertGreaterThan(matchedCount , 0,
  97                 "Found no lines matching pattern: " + JCMD_LIST_REGEX);
  98     }
  99 
 100     private static void verifyOutputAgainstFile(OutputAnalyzer output) throws IOException {
 101         Path path = Paths.get(TEST_SRC, "usage.out");
 102         List<String> fileOutput = Files.readAllLines(path);
 103         List<String> outputAsLines = output.asLines();
 104         assertTrue(outputAsLines.containsAll(fileOutput),
 105                 "The ouput should contain all content of " + path.toAbsolutePath());
 106     }
 107 
 108 }
--- EOF ---