View Javadoc

1   /*
2    *   Copyright (C) Christian Schulte, 2005-206
3    *   All rights reserved.
4    *
5    *   Redistribution and use in source and binary forms, with or without
6    *   modification, are permitted provided that the following conditions
7    *   are met:
8    *
9    *     o Redistributions of source code must retain the above copyright
10   *       notice, this list of conditions and the following disclaimer.
11   *
12   *     o Redistributions in binary form must reproduce the above copyright
13   *       notice, this list of conditions and the following disclaimer in
14   *       the documentation and/or other materials provided with the
15   *       distribution.
16   *
17   *   THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
18   *   INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
19   *   AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
20   *   THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT,
21   *   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22   *   NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23   *   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24   *   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25   *   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26   *   THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27   *
28   *   $JOMC: Messages.java 3881 2011-10-24 01:00:55Z schulte2005 $
29   *
30   */
31  package org.jomc.mojo;
32  
33  import java.text.MessageFormat;
34  import java.util.MissingResourceException;
35  import java.util.ResourceBundle;
36  
37  /**
38   * Utilities for accessing messages.
39   *
40   * @author <a href="mailto:schulte2005@users.sourceforge.net">Christian Schulte</a>
41   * @version $JOMC: Messages.java 3881 2011-10-24 01:00:55Z schulte2005 $
42   * @since 1.2
43   */
44  abstract class Messages
45  {
46  
47      /** Constant for the name of the resource bundle backing the tasks. */
48      private static final String RESOURCE_BUNDLE_NAME =
49          Messages.class.getPackage().getName().replace( '.', '/' ) + "/Messages";
50  
51      /** Creates a new {@code Messages} instance. */
52      Messages()
53      {
54          super();
55      }
56  
57      /**
58       * Gets a message for a given key from the resource bundle backing the tasks formatted using the given arguments.
59       *
60       * @param key The key of the string to get.
61       * @param arguments The arguments to format the string with.
62       *
63       * @return The string matching {@code key} formatted using {@code arguments}.
64       *
65       * @throws NullPointerException if {@code key} is {@code null}.
66       */
67      static String getMessage( final String key, final Object... arguments )
68      {
69          if ( key == null )
70          {
71              throw new NullPointerException( "key" );
72          }
73  
74          try
75          {
76              return MessageFormat.format( ResourceBundle.getBundle( RESOURCE_BUNDLE_NAME ).getString( key ), arguments );
77          }
78          catch ( final MissingResourceException e )
79          {
80              throw new AssertionError( e );
81          }
82          catch ( final ClassCastException e )
83          {
84              throw new AssertionError( e );
85          }
86          catch ( final IllegalArgumentException e )
87          {
88              throw new AssertionError( e );
89          }
90      }
91  
92      /**
93       * Gets the message of a given {@code Throwable} recursively.
94       *
95       * @param t The {@code Throwable} to get the message of or {@code null}.
96       *
97       * @return The message of {@code t} or {@code null}.
98       */
99      static String getMessage( final Throwable t )
100     {
101         return t != null ? t.getMessage() != null ? t.getMessage() : getMessage( t.getCause() ) : null;
102     }
103 
104 }