/* * Copyright (c) 2001, 2002, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation.  Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */package com.sun.tools.example.debug.tty; import java.util.*;import java.text.MessageFormat;/** * Internationalization (i18n) convenience methods for jdb. * * All program output should flow through these methods, and this is * the only class that should be printing directly or otherwise * accessing System.[out,err]. * * @bug 4348376 * @author Tim Bell */public class MessageOutput {    /**     * The resource bundle containing localizable message content.     * This is loaded by TTY.main() at start-up     */    static ResourceBundle textResources;     /** Our message formatter.  Allocated once, used many times */    private static MessageFormat messageFormat;     /**     * Fatal shutdown notification.  This is sent to System.err     * instead of System.out     */    static void fatalError(String messageKey) {        System.err.println();        System.err.println(format("Fatal error"));        System.err.println(format(messageKey));        Env.shutdown();    }     /**     * "Format" a string by doing a simple key lookup.     */    static String format(String key) {        return (textResources.getString(key));    }     /**     * Fetch and format a message with one string argument.     * This is the most common usage.     */    static String format(String key, String argument) {        return format(key, new Object [] {argument});    }     /**     * Fetch a string by key lookup and format in the arguments.     */    static synchronized String format(String key, Object [] arguments) {        if (messageFormat == null) {            messageFormat = new MessageFormat (textResources.getString(key));        } else {            messageFormat.applyPattern (textResources.getString(key));        }        return (messageFormat.format (arguments));    }     /**     * Print directly to System.out.     * Every rule has a few exceptions.     * The exceptions to "must use the MessageOutput formatters" are:     *     VMConnection.dumpStream()     *     TTY.monitorCommand()     *     TTY.TTY() (for the '!!' command only)     *     Commands.java (multiple locations)     * These are the only sites that should be calling this     * method.     */    static void printDirectln(String line) {        System.out.println(line);    }    static void printDirect(String line) {        System.out.print(line);    }    static void printDirect(char c) {        System.out.print(c);    }     /**     * Print a newline.     * Use this instead of '\n'     */    static void println() {        System.out.println();    }     /**     * Format and print a simple string.     */    static void print(String key) {        System.out.print(format(key));    }    /**     * Format and print a simple string.     */    static void println(String key) {        System.out.println(format(key));    }      /**     * Fetch, format and print a message with one string argument.     * This is the most common usage.     */    static void print(String key, String argument) {        System.out.print(format(key, argument));    }    static void println(String key, String argument) {        System.out.println(format(key, argument));    }     /**     * Fetch, format and print a message with an arbitrary     * number of message arguments.     */    static void println(String key, Object [] arguments) {        System.out.println(format(key, arguments));    }     /**     * Print a newline, followed by the string.     */    static void lnprint(String key) {        System.out.println();        System.out.print(textResources.getString(key));    }     static void lnprint(String key, String argument) {        System.out.println();        System.out.print(format(key, argument));    }     static void lnprint(String key, Object [] arguments) {        System.out.println();        System.out.print(format(key, arguments));    }     /**     * Print an exception message with a stack trace.     */    static void printException(String key, Exception e) {        if (key != null) {            try {                println(key);            } catch (MissingResourceException mex) {                printDirectln(key);            }        }        System.out.flush();        e.printStackTrace();    }     static void printPrompt() {        ThreadInfo threadInfo = ThreadInfo.getCurrentThreadInfo();        if (threadInfo == null) {            System.out.print                (MessageOutput.format("jdb prompt with no current thread"));        } else {            System.out.print                (MessageOutput.format("jdb prompt thread name and current stack frame",                                      new Object [] {                                          threadInfo.getThread().name(),                                          new Integer (threadInfo.getCurrentFrameIndex() + 1)}));        }        System.out.flush();    }}