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