/** * Get the string array value of an entry given its key. An empty array will * be returned if no such entry exists. * * @param key entry key * @return string array entry values */ public final String[] getStringArray(String key) { String[] values = getStringArrayOrNull(key); return values == null ? EMPTY_ARRAY : values; }
/** * Get the string array value of an entry given its key or default values if * no such entry exists. * * @param key entry key * @param defaultValues default values * @return string array entry values */ public final String[] getStringArrayOrDefault(String key, String... defaultValues) { String[] values = getStringArrayOrNull(key); return values == null ? defaultValues : values; }
/** * Get the <code>java.util.Map</code> value of an entry given its key or * <code>null</code> if no such entry exists. * * @param key entry key * @return Map entry value */ public final Map<String, String> getMapOrNull(String key) { String[] values = getStringArrayOrNull(key); return values == null ? null : toMap(values); }
/** * Get the <code>java.util.Map</code> value of an entry given its key. * {@link Collections#emptyMap()} will be returned if no such entry exists. * * @param key entry key * @return Map entry value */ public final Map<String, String> getMap(String key) { String[] values = getStringArrayOrNull(key); return values == null ? Collections.<String, String> emptyMap() : toMap(values); }
/** * Get the <code>java.util.Map</code> value of an entry given its key or a * default value if no such entry exists. * * @param key entry key * @param defaultValue default value * @return Map entry value */ public final Map<String, String> getMapOrDefault(String key, Map<String, String> defaultValue) { String[] values = getStringArrayOrNull(key); return values == null ? defaultValue : toMap(values); }
/** * Get the string array value of an entry given its key or fail with an * exception if it does not. * * @param key entry key * @return string array entry value * @throws MultiMapException if no such entry exists */ public final String[] getStringArrayOrFail(String key) { String[] values = getStringArrayOrNull(key); if (values == null) { throw new MultiMapException("Missing value for attribute '" + key + "'."); } return values; }