1 /*

     2  * Copyright (c) 2015, 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 package com.oracle.java.testlibrary.dcmd;

    25 

    26 import com.oracle.java.testlibrary.OutputAnalyzer;

    27 

    28 /**

    29  * Abstract base class for Diagnostic Command executors

    30  */

    31 public abstract class CommandExecutor {

    32 

    33     /**

    34      * Execute a diagnostic command

    35      *

    36      * @param cmd The diagnostic command to execute

    37      * @return an {@link jdk.testlibrary.OutputAnalyzer} encapsulating the output of the command

    38      * @throws CommandExecutorException if there is an exception on the "calling side" while trying to execute the

    39      *          Diagnostic Command. Exceptions thrown on the remote side are available as textual representations in

    40      *          stderr, regardless of the specific executor used.

    41      */

    42     public final OutputAnalyzer execute(String cmd) throws CommandExecutorException {

    43         System.out.printf("Running DCMD '%s' through '%s'%n", cmd, this.getClass().getSimpleName());

    44         OutputAnalyzer oa = executeImpl(cmd);

    45 

    46         System.out.println("---------------- stdout ----------------");

    47         System.out.println(oa.getStdout());

    48         System.out.println("---------------- stderr ----------------");

    49         System.out.println(oa.getStderr());

    50         System.out.println("----------------------------------------");

    51         System.out.println();

    52 

    53         return oa;

    54     }

    55 

    56     protected abstract OutputAnalyzer executeImpl(String cmd) throws CommandExecutorException;

    57 }