1 /*
2 * Copyright (C) 2005 Christian Schulte <cs@schulte.it>
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 5135 2016-04-08 13:53:07Z schulte $
29 *
30 */
31 package org.jomc.ant;
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:cs@schulte.it">Christian Schulte</a>
41 * @version $JOMC: Messages.java 5135 2016-04-08 13:53:07Z schulte $
42 */
43 abstract class Messages
44 {
45
46 /**
47 * Constant for the name of the resource bundle backing the tasks.
48 */
49 private static final String RESOURCE_BUNDLE_NAME =
50 Messages.class.getPackage().getName().replace( '.', '/' ) + "/Messages";
51
52 /**
53 * Creates a new {@code Messages} instance.
54 */
55 Messages()
56 {
57 super();
58 }
59
60 /**
61 * Gets a message for a given key from the resource bundle backing the tasks formatted using the given arguments.
62 *
63 * @param key The key of the string to get.
64 * @param arguments The arguments to format the string with.
65 *
66 * @return The string matching {@code key} formatted using {@code arguments}.
67 *
68 * @throws NullPointerException if {@code key} is {@code null}.
69 */
70 static String getMessage( final String key, final Object... arguments )
71 {
72 if ( key == null )
73 {
74 throw new NullPointerException( "key" );
75 }
76
77 try
78 {
79 return MessageFormat.format( ResourceBundle.getBundle( RESOURCE_BUNDLE_NAME ).getString( key ), arguments );
80 }
81 catch ( final MissingResourceException e )
82 {
83 throw new AssertionError( e );
84 }
85 catch ( final ClassCastException e )
86 {
87 throw new AssertionError( e );
88 }
89 catch ( final IllegalArgumentException e )
90 {
91 throw new AssertionError( e );
92 }
93 }
94
95 /**
96 * Gets the message of a given {@code Throwable} recursively.
97 *
98 * @param t The {@code Throwable} to get the message of or {@code null}.
99 *
100 * @return The message of {@code t} or {@code null}.
101 */
102 static String getMessage( final Throwable t )
103 {
104 return t != null
105 ? t.getMessage() != null && t.getMessage().trim().length() > 0
106 ? t.getMessage()
107 : getMessage( t.getCause() )
108 : null;
109
110 }
111
112 }