http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/b5c66cf1/content/site/apidocs/src-html/org/apache/juneau/ObjectMap.html ---------------------------------------------------------------------- diff --git a/content/site/apidocs/src-html/org/apache/juneau/ObjectMap.html b/content/site/apidocs/src-html/org/apache/juneau/ObjectMap.html index ec0c1f0..bc1daba 100644 --- a/content/site/apidocs/src-html/org/apache/juneau/ObjectMap.html +++ b/content/site/apidocs/src-html/org/apache/juneau/ObjectMap.html @@ -631,759 +631,771 @@ <span class="sourceLineNo">623</span><a name="line.623"></a> <span class="sourceLineNo">624</span> /**<a name="line.624"></a> <span class="sourceLineNo">625</span> * Specialized method that calls {@link #getString(String)} and splits the results as a simple comma-delimited list.<a name="line.625"></a> -<span class="sourceLineNo">626</span> *<a name="line.626"></a> -<span class="sourceLineNo">627</span> * @param key the key.<a name="line.627"></a> -<span class="sourceLineNo">628</span> * @return<a name="line.628"></a> -<span class="sourceLineNo">629</span> * A list of tokens, trimmed of whitespace.<a name="line.629"></a> -<span class="sourceLineNo">630</span> * An empty list if entry not found.<a name="line.630"></a> -<span class="sourceLineNo">631</span> * Never <jk>null</jk>.<a name="line.631"></a> -<span class="sourceLineNo">632</span> */<a name="line.632"></a> -<span class="sourceLineNo">633</span> public String[] getStringArray(String key) {<a name="line.633"></a> -<span class="sourceLineNo">634</span> String s = get(String.class, key);<a name="line.634"></a> -<span class="sourceLineNo">635</span> return (s == null ? new String[0] : split(s));<a name="line.635"></a> -<span class="sourceLineNo">636</span> }<a name="line.636"></a> -<span class="sourceLineNo">637</span><a name="line.637"></a> -<span class="sourceLineNo">638</span> /**<a name="line.638"></a> -<span class="sourceLineNo">639</span> * Same as {@link #getStringArray(String)} but returns a default value if the value cannot be found.<a name="line.639"></a> -<span class="sourceLineNo">640</span> *<a name="line.640"></a> -<span class="sourceLineNo">641</span> * @param key The map key.<a name="line.641"></a> -<span class="sourceLineNo">642</span> * @param def The default value if value is not found.<a name="line.642"></a> -<span class="sourceLineNo">643</span> * @return The value converted to a string array.<a name="line.643"></a> -<span class="sourceLineNo">644</span> */<a name="line.644"></a> -<span class="sourceLineNo">645</span> public String[] getStringArray(String key, String[] def) {<a name="line.645"></a> -<span class="sourceLineNo">646</span> String s = get(String.class, key);<a name="line.646"></a> -<span class="sourceLineNo">647</span> String[] r = (s == null ? new String[0] : split(s));<a name="line.647"></a> -<span class="sourceLineNo">648</span> return (r.length == 0 ? def : r);<a name="line.648"></a> -<span class="sourceLineNo">649</span> }<a name="line.649"></a> -<span class="sourceLineNo">650</span><a name="line.650"></a> -<span class="sourceLineNo">651</span> /**<a name="line.651"></a> -<span class="sourceLineNo">652</span> * Returns the specified entry value converted to a {@link String}.<a name="line.652"></a> -<span class="sourceLineNo">653</span> *<a name="line.653"></a> -<span class="sourceLineNo">654</span> * <p><a name="line.654"></a> -<span class="sourceLineNo">655</span> * Shortcut for <code>get(String.<jk>class</jk>, key, defVal)</code>.<a name="line.655"></a> -<span class="sourceLineNo">656</span> *<a name="line.656"></a> -<span class="sourceLineNo">657</span> * @param key The key.<a name="line.657"></a> -<span class="sourceLineNo">658</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.658"></a> -<span class="sourceLineNo">659</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.659"></a> -<span class="sourceLineNo">660</span> */<a name="line.660"></a> -<span class="sourceLineNo">661</span> public String getString(String key, String defVal) {<a name="line.661"></a> -<span class="sourceLineNo">662</span> return get(String.class, key, defVal);<a name="line.662"></a> -<span class="sourceLineNo">663</span> }<a name="line.663"></a> -<span class="sourceLineNo">664</span><a name="line.664"></a> -<span class="sourceLineNo">665</span> /**<a name="line.665"></a> -<span class="sourceLineNo">666</span> * Returns the specified entry value converted to an {@link Integer}.<a name="line.666"></a> -<span class="sourceLineNo">667</span> *<a name="line.667"></a> -<span class="sourceLineNo">668</span> * <p><a name="line.668"></a> -<span class="sourceLineNo">669</span> * Shortcut for <code>get(Integer.<jk>class</jk>, key)</code>.<a name="line.669"></a> -<span class="sourceLineNo">670</span> *<a name="line.670"></a> -<span class="sourceLineNo">671</span> * @param key The key.<a name="line.671"></a> -<span class="sourceLineNo">672</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.672"></a> -<span class="sourceLineNo">673</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.673"></a> -<span class="sourceLineNo">674</span> */<a name="line.674"></a> -<span class="sourceLineNo">675</span> public Integer getInt(String key) {<a name="line.675"></a> -<span class="sourceLineNo">676</span> return get(Integer.class, key);<a name="line.676"></a> -<span class="sourceLineNo">677</span> }<a name="line.677"></a> -<span class="sourceLineNo">678</span><a name="line.678"></a> -<span class="sourceLineNo">679</span> /**<a name="line.679"></a> -<span class="sourceLineNo">680</span> * Returns the specified entry value converted to an {@link Integer}.<a name="line.680"></a> -<span class="sourceLineNo">681</span> *<a name="line.681"></a> -<span class="sourceLineNo">682</span> * <p><a name="line.682"></a> -<span class="sourceLineNo">683</span> * Shortcut for <code>get(Integer.<jk>class</jk>, key, defVal)</code>.<a name="line.683"></a> -<span class="sourceLineNo">684</span> *<a name="line.684"></a> -<span class="sourceLineNo">685</span> * @param key The key.<a name="line.685"></a> -<span class="sourceLineNo">686</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.686"></a> -<span class="sourceLineNo">687</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.687"></a> -<span class="sourceLineNo">688</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.688"></a> -<span class="sourceLineNo">689</span> */<a name="line.689"></a> -<span class="sourceLineNo">690</span> public Integer getInt(String key, Integer defVal) {<a name="line.690"></a> -<span class="sourceLineNo">691</span> return get(Integer.class, key, defVal);<a name="line.691"></a> -<span class="sourceLineNo">692</span> }<a name="line.692"></a> -<span class="sourceLineNo">693</span><a name="line.693"></a> -<span class="sourceLineNo">694</span> /**<a name="line.694"></a> -<span class="sourceLineNo">695</span> * Returns the specified entry value converted to a {@link Long}.<a name="line.695"></a> +<span class="sourceLineNo">626</span> * <a name="line.626"></a> +<span class="sourceLineNo">627</span> * <p><a name="line.627"></a> +<span class="sourceLineNo">628</span> * If the value is already a collection, the individual entries are converted to strings using {@link #toString()}.<a name="line.628"></a> +<span class="sourceLineNo">629</span> *<a name="line.629"></a> +<span class="sourceLineNo">630</span> * @param key the key.<a name="line.630"></a> +<span class="sourceLineNo">631</span> * @return<a name="line.631"></a> +<span class="sourceLineNo">632</span> * A list of tokens, trimmed of whitespace.<a name="line.632"></a> +<span class="sourceLineNo">633</span> * An empty list if entry not found.<a name="line.633"></a> +<span class="sourceLineNo">634</span> * Never <jk>null</jk>.<a name="line.634"></a> +<span class="sourceLineNo">635</span> */<a name="line.635"></a> +<span class="sourceLineNo">636</span> public String[] getStringArray(String key) {<a name="line.636"></a> +<span class="sourceLineNo">637</span> Object s = get(Object.class, key);<a name="line.637"></a> +<span class="sourceLineNo">638</span> if (s == null)<a name="line.638"></a> +<span class="sourceLineNo">639</span> return new String[0];<a name="line.639"></a> +<span class="sourceLineNo">640</span> if (s instanceof Collection) <a name="line.640"></a> +<span class="sourceLineNo">641</span> return ArrayUtils.toStringArray((Collection<?>)s);<a name="line.641"></a> +<span class="sourceLineNo">642</span> String[] r = split(StringUtils.toString(s));<a name="line.642"></a> +<span class="sourceLineNo">643</span> return r;<a name="line.643"></a> +<span class="sourceLineNo">644</span> }<a name="line.644"></a> +<span class="sourceLineNo">645</span><a name="line.645"></a> +<span class="sourceLineNo">646</span> /**<a name="line.646"></a> +<span class="sourceLineNo">647</span> * Same as {@link #getStringArray(String)} but returns a default value if the value cannot be found.<a name="line.647"></a> +<span class="sourceLineNo">648</span> *<a name="line.648"></a> +<span class="sourceLineNo">649</span> * @param key The map key.<a name="line.649"></a> +<span class="sourceLineNo">650</span> * @param def The default value if value is not found.<a name="line.650"></a> +<span class="sourceLineNo">651</span> * @return The value converted to a string array.<a name="line.651"></a> +<span class="sourceLineNo">652</span> */<a name="line.652"></a> +<span class="sourceLineNo">653</span> public String[] getStringArray(String key, String[] def) {<a name="line.653"></a> +<span class="sourceLineNo">654</span> Object s = get(Object.class, key);<a name="line.654"></a> +<span class="sourceLineNo">655</span> if (s == null)<a name="line.655"></a> +<span class="sourceLineNo">656</span> return def;<a name="line.656"></a> +<span class="sourceLineNo">657</span> if (s instanceof Collection) <a name="line.657"></a> +<span class="sourceLineNo">658</span> return ArrayUtils.toStringArray((Collection<?>)s);<a name="line.658"></a> +<span class="sourceLineNo">659</span> String[] r = split(StringUtils.toString(s));<a name="line.659"></a> +<span class="sourceLineNo">660</span> return (r.length == 0 ? def : r);<a name="line.660"></a> +<span class="sourceLineNo">661</span> }<a name="line.661"></a> +<span class="sourceLineNo">662</span><a name="line.662"></a> +<span class="sourceLineNo">663</span> /**<a name="line.663"></a> +<span class="sourceLineNo">664</span> * Returns the specified entry value converted to a {@link String}.<a name="line.664"></a> +<span class="sourceLineNo">665</span> *<a name="line.665"></a> +<span class="sourceLineNo">666</span> * <p><a name="line.666"></a> +<span class="sourceLineNo">667</span> * Shortcut for <code>get(String.<jk>class</jk>, key, defVal)</code>.<a name="line.667"></a> +<span class="sourceLineNo">668</span> *<a name="line.668"></a> +<span class="sourceLineNo">669</span> * @param key The key.<a name="line.669"></a> +<span class="sourceLineNo">670</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.670"></a> +<span class="sourceLineNo">671</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.671"></a> +<span class="sourceLineNo">672</span> */<a name="line.672"></a> +<span class="sourceLineNo">673</span> public String getString(String key, String defVal) {<a name="line.673"></a> +<span class="sourceLineNo">674</span> return get(String.class, key, defVal);<a name="line.674"></a> +<span class="sourceLineNo">675</span> }<a name="line.675"></a> +<span class="sourceLineNo">676</span><a name="line.676"></a> +<span class="sourceLineNo">677</span> /**<a name="line.677"></a> +<span class="sourceLineNo">678</span> * Returns the specified entry value converted to an {@link Integer}.<a name="line.678"></a> +<span class="sourceLineNo">679</span> *<a name="line.679"></a> +<span class="sourceLineNo">680</span> * <p><a name="line.680"></a> +<span class="sourceLineNo">681</span> * Shortcut for <code>get(Integer.<jk>class</jk>, key)</code>.<a name="line.681"></a> +<span class="sourceLineNo">682</span> *<a name="line.682"></a> +<span class="sourceLineNo">683</span> * @param key The key.<a name="line.683"></a> +<span class="sourceLineNo">684</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.684"></a> +<span class="sourceLineNo">685</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.685"></a> +<span class="sourceLineNo">686</span> */<a name="line.686"></a> +<span class="sourceLineNo">687</span> public Integer getInt(String key) {<a name="line.687"></a> +<span class="sourceLineNo">688</span> return get(Integer.class, key);<a name="line.688"></a> +<span class="sourceLineNo">689</span> }<a name="line.689"></a> +<span class="sourceLineNo">690</span><a name="line.690"></a> +<span class="sourceLineNo">691</span> /**<a name="line.691"></a> +<span class="sourceLineNo">692</span> * Returns the specified entry value converted to an {@link Integer}.<a name="line.692"></a> +<span class="sourceLineNo">693</span> *<a name="line.693"></a> +<span class="sourceLineNo">694</span> * <p><a name="line.694"></a> +<span class="sourceLineNo">695</span> * Shortcut for <code>get(Integer.<jk>class</jk>, key, defVal)</code>.<a name="line.695"></a> <span class="sourceLineNo">696</span> *<a name="line.696"></a> -<span class="sourceLineNo">697</span> * <p><a name="line.697"></a> -<span class="sourceLineNo">698</span> * Shortcut for <code>get(Long.<jk>class</jk>, key)</code>.<a name="line.698"></a> -<span class="sourceLineNo">699</span> *<a name="line.699"></a> -<span class="sourceLineNo">700</span> * @param key The key.<a name="line.700"></a> -<span class="sourceLineNo">701</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.701"></a> -<span class="sourceLineNo">702</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.702"></a> -<span class="sourceLineNo">703</span> */<a name="line.703"></a> -<span class="sourceLineNo">704</span> public Long getLong(String key) {<a name="line.704"></a> -<span class="sourceLineNo">705</span> return get(Long.class, key);<a name="line.705"></a> -<span class="sourceLineNo">706</span> }<a name="line.706"></a> -<span class="sourceLineNo">707</span><a name="line.707"></a> -<span class="sourceLineNo">708</span> /**<a name="line.708"></a> -<span class="sourceLineNo">709</span> * Returns the specified entry value converted to a {@link Long}.<a name="line.709"></a> -<span class="sourceLineNo">710</span> *<a name="line.710"></a> -<span class="sourceLineNo">711</span> * <p><a name="line.711"></a> -<span class="sourceLineNo">712</span> * Shortcut for <code>get(Long.<jk>class</jk>, key, defVal)</code>.<a name="line.712"></a> -<span class="sourceLineNo">713</span> *<a name="line.713"></a> -<span class="sourceLineNo">714</span> * @param key The key.<a name="line.714"></a> -<span class="sourceLineNo">715</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.715"></a> -<span class="sourceLineNo">716</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.716"></a> -<span class="sourceLineNo">717</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.717"></a> -<span class="sourceLineNo">718</span> */<a name="line.718"></a> -<span class="sourceLineNo">719</span> public Long getLong(String key, Long defVal) {<a name="line.719"></a> -<span class="sourceLineNo">720</span> return get(Long.class, key, defVal);<a name="line.720"></a> -<span class="sourceLineNo">721</span> }<a name="line.721"></a> -<span class="sourceLineNo">722</span><a name="line.722"></a> -<span class="sourceLineNo">723</span> /**<a name="line.723"></a> -<span class="sourceLineNo">724</span> * Returns the specified entry value converted to a {@link Boolean}.<a name="line.724"></a> +<span class="sourceLineNo">697</span> * @param key The key.<a name="line.697"></a> +<span class="sourceLineNo">698</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.698"></a> +<span class="sourceLineNo">699</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.699"></a> +<span class="sourceLineNo">700</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.700"></a> +<span class="sourceLineNo">701</span> */<a name="line.701"></a> +<span class="sourceLineNo">702</span> public Integer getInt(String key, Integer defVal) {<a name="line.702"></a> +<span class="sourceLineNo">703</span> return get(Integer.class, key, defVal);<a name="line.703"></a> +<span class="sourceLineNo">704</span> }<a name="line.704"></a> +<span class="sourceLineNo">705</span><a name="line.705"></a> +<span class="sourceLineNo">706</span> /**<a name="line.706"></a> +<span class="sourceLineNo">707</span> * Returns the specified entry value converted to a {@link Long}.<a name="line.707"></a> +<span class="sourceLineNo">708</span> *<a name="line.708"></a> +<span class="sourceLineNo">709</span> * <p><a name="line.709"></a> +<span class="sourceLineNo">710</span> * Shortcut for <code>get(Long.<jk>class</jk>, key)</code>.<a name="line.710"></a> +<span class="sourceLineNo">711</span> *<a name="line.711"></a> +<span class="sourceLineNo">712</span> * @param key The key.<a name="line.712"></a> +<span class="sourceLineNo">713</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.713"></a> +<span class="sourceLineNo">714</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.714"></a> +<span class="sourceLineNo">715</span> */<a name="line.715"></a> +<span class="sourceLineNo">716</span> public Long getLong(String key) {<a name="line.716"></a> +<span class="sourceLineNo">717</span> return get(Long.class, key);<a name="line.717"></a> +<span class="sourceLineNo">718</span> }<a name="line.718"></a> +<span class="sourceLineNo">719</span><a name="line.719"></a> +<span class="sourceLineNo">720</span> /**<a name="line.720"></a> +<span class="sourceLineNo">721</span> * Returns the specified entry value converted to a {@link Long}.<a name="line.721"></a> +<span class="sourceLineNo">722</span> *<a name="line.722"></a> +<span class="sourceLineNo">723</span> * <p><a name="line.723"></a> +<span class="sourceLineNo">724</span> * Shortcut for <code>get(Long.<jk>class</jk>, key, defVal)</code>.<a name="line.724"></a> <span class="sourceLineNo">725</span> *<a name="line.725"></a> -<span class="sourceLineNo">726</span> * <p><a name="line.726"></a> -<span class="sourceLineNo">727</span> * Shortcut for <code>get(Boolean.<jk>class</jk>, key)</code>.<a name="line.727"></a> -<span class="sourceLineNo">728</span> *<a name="line.728"></a> -<span class="sourceLineNo">729</span> * @param key The key.<a name="line.729"></a> -<span class="sourceLineNo">730</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.730"></a> -<span class="sourceLineNo">731</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.731"></a> -<span class="sourceLineNo">732</span> */<a name="line.732"></a> -<span class="sourceLineNo">733</span> public Boolean getBoolean(String key) {<a name="line.733"></a> -<span class="sourceLineNo">734</span> return get(Boolean.class, key);<a name="line.734"></a> -<span class="sourceLineNo">735</span> }<a name="line.735"></a> -<span class="sourceLineNo">736</span><a name="line.736"></a> -<span class="sourceLineNo">737</span> /**<a name="line.737"></a> -<span class="sourceLineNo">738</span> * Returns the specified entry value converted to a {@link Boolean}.<a name="line.738"></a> -<span class="sourceLineNo">739</span> *<a name="line.739"></a> -<span class="sourceLineNo">740</span> * <p><a name="line.740"></a> -<span class="sourceLineNo">741</span> * Shortcut for <code>get(Boolean.<jk>class</jk>, key, defVal)</code>.<a name="line.741"></a> -<span class="sourceLineNo">742</span> *<a name="line.742"></a> -<span class="sourceLineNo">743</span> * @param key The key.<a name="line.743"></a> -<span class="sourceLineNo">744</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.744"></a> -<span class="sourceLineNo">745</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.745"></a> -<span class="sourceLineNo">746</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.746"></a> -<span class="sourceLineNo">747</span> */<a name="line.747"></a> -<span class="sourceLineNo">748</span> public Boolean getBoolean(String key, Boolean defVal) {<a name="line.748"></a> -<span class="sourceLineNo">749</span> return get(Boolean.class, key, defVal);<a name="line.749"></a> -<span class="sourceLineNo">750</span> }<a name="line.750"></a> -<span class="sourceLineNo">751</span><a name="line.751"></a> -<span class="sourceLineNo">752</span> /**<a name="line.752"></a> -<span class="sourceLineNo">753</span> * Returns the specified entry value converted to a {@link Map}.<a name="line.753"></a> +<span class="sourceLineNo">726</span> * @param key The key.<a name="line.726"></a> +<span class="sourceLineNo">727</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.727"></a> +<span class="sourceLineNo">728</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.728"></a> +<span class="sourceLineNo">729</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.729"></a> +<span class="sourceLineNo">730</span> */<a name="line.730"></a> +<span class="sourceLineNo">731</span> public Long getLong(String key, Long defVal) {<a name="line.731"></a> +<span class="sourceLineNo">732</span> return get(Long.class, key, defVal);<a name="line.732"></a> +<span class="sourceLineNo">733</span> }<a name="line.733"></a> +<span class="sourceLineNo">734</span><a name="line.734"></a> +<span class="sourceLineNo">735</span> /**<a name="line.735"></a> +<span class="sourceLineNo">736</span> * Returns the specified entry value converted to a {@link Boolean}.<a name="line.736"></a> +<span class="sourceLineNo">737</span> *<a name="line.737"></a> +<span class="sourceLineNo">738</span> * <p><a name="line.738"></a> +<span class="sourceLineNo">739</span> * Shortcut for <code>get(Boolean.<jk>class</jk>, key)</code>.<a name="line.739"></a> +<span class="sourceLineNo">740</span> *<a name="line.740"></a> +<span class="sourceLineNo">741</span> * @param key The key.<a name="line.741"></a> +<span class="sourceLineNo">742</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.742"></a> +<span class="sourceLineNo">743</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.743"></a> +<span class="sourceLineNo">744</span> */<a name="line.744"></a> +<span class="sourceLineNo">745</span> public Boolean getBoolean(String key) {<a name="line.745"></a> +<span class="sourceLineNo">746</span> return get(Boolean.class, key);<a name="line.746"></a> +<span class="sourceLineNo">747</span> }<a name="line.747"></a> +<span class="sourceLineNo">748</span><a name="line.748"></a> +<span class="sourceLineNo">749</span> /**<a name="line.749"></a> +<span class="sourceLineNo">750</span> * Returns the specified entry value converted to a {@link Boolean}.<a name="line.750"></a> +<span class="sourceLineNo">751</span> *<a name="line.751"></a> +<span class="sourceLineNo">752</span> * <p><a name="line.752"></a> +<span class="sourceLineNo">753</span> * Shortcut for <code>get(Boolean.<jk>class</jk>, key, defVal)</code>.<a name="line.753"></a> <span class="sourceLineNo">754</span> *<a name="line.754"></a> -<span class="sourceLineNo">755</span> * <p><a name="line.755"></a> -<span class="sourceLineNo">756</span> * Shortcut for <code>get(Map.<jk>class</jk>, key)</code>.<a name="line.756"></a> -<span class="sourceLineNo">757</span> *<a name="line.757"></a> -<span class="sourceLineNo">758</span> * @param key The key.<a name="line.758"></a> -<span class="sourceLineNo">759</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.759"></a> -<span class="sourceLineNo">760</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.760"></a> -<span class="sourceLineNo">761</span> */<a name="line.761"></a> -<span class="sourceLineNo">762</span> public Map<?,?> getMap(String key) {<a name="line.762"></a> -<span class="sourceLineNo">763</span> return get(Map.class, key);<a name="line.763"></a> -<span class="sourceLineNo">764</span> }<a name="line.764"></a> -<span class="sourceLineNo">765</span><a name="line.765"></a> -<span class="sourceLineNo">766</span> /**<a name="line.766"></a> -<span class="sourceLineNo">767</span> * Returns the specified entry value converted to a {@link Map}.<a name="line.767"></a> -<span class="sourceLineNo">768</span> *<a name="line.768"></a> -<span class="sourceLineNo">769</span> * <p><a name="line.769"></a> -<span class="sourceLineNo">770</span> * Shortcut for <code>get(Map.<jk>class</jk>, key, defVal)</code>.<a name="line.770"></a> -<span class="sourceLineNo">771</span> *<a name="line.771"></a> -<span class="sourceLineNo">772</span> * @param key The key.<a name="line.772"></a> -<span class="sourceLineNo">773</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.773"></a> -<span class="sourceLineNo">774</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.774"></a> -<span class="sourceLineNo">775</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.775"></a> -<span class="sourceLineNo">776</span> */<a name="line.776"></a> -<span class="sourceLineNo">777</span> public Map<?,?> getMap(String key, Map<?,?> defVal) {<a name="line.777"></a> -<span class="sourceLineNo">778</span> return get(Map.class, key, defVal);<a name="line.778"></a> -<span class="sourceLineNo">779</span> }<a name="line.779"></a> -<span class="sourceLineNo">780</span><a name="line.780"></a> -<span class="sourceLineNo">781</span> /**<a name="line.781"></a> -<span class="sourceLineNo">782</span> * Returns the specified entry value converted to a {@link List}.<a name="line.782"></a> +<span class="sourceLineNo">755</span> * @param key The key.<a name="line.755"></a> +<span class="sourceLineNo">756</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.756"></a> +<span class="sourceLineNo">757</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.757"></a> +<span class="sourceLineNo">758</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.758"></a> +<span class="sourceLineNo">759</span> */<a name="line.759"></a> +<span class="sourceLineNo">760</span> public Boolean getBoolean(String key, Boolean defVal) {<a name="line.760"></a> +<span class="sourceLineNo">761</span> return get(Boolean.class, key, defVal);<a name="line.761"></a> +<span class="sourceLineNo">762</span> }<a name="line.762"></a> +<span class="sourceLineNo">763</span><a name="line.763"></a> +<span class="sourceLineNo">764</span> /**<a name="line.764"></a> +<span class="sourceLineNo">765</span> * Returns the specified entry value converted to a {@link Map}.<a name="line.765"></a> +<span class="sourceLineNo">766</span> *<a name="line.766"></a> +<span class="sourceLineNo">767</span> * <p><a name="line.767"></a> +<span class="sourceLineNo">768</span> * Shortcut for <code>get(Map.<jk>class</jk>, key)</code>.<a name="line.768"></a> +<span class="sourceLineNo">769</span> *<a name="line.769"></a> +<span class="sourceLineNo">770</span> * @param key The key.<a name="line.770"></a> +<span class="sourceLineNo">771</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.771"></a> +<span class="sourceLineNo">772</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.772"></a> +<span class="sourceLineNo">773</span> */<a name="line.773"></a> +<span class="sourceLineNo">774</span> public Map<?,?> getMap(String key) {<a name="line.774"></a> +<span class="sourceLineNo">775</span> return get(Map.class, key);<a name="line.775"></a> +<span class="sourceLineNo">776</span> }<a name="line.776"></a> +<span class="sourceLineNo">777</span><a name="line.777"></a> +<span class="sourceLineNo">778</span> /**<a name="line.778"></a> +<span class="sourceLineNo">779</span> * Returns the specified entry value converted to a {@link Map}.<a name="line.779"></a> +<span class="sourceLineNo">780</span> *<a name="line.780"></a> +<span class="sourceLineNo">781</span> * <p><a name="line.781"></a> +<span class="sourceLineNo">782</span> * Shortcut for <code>get(Map.<jk>class</jk>, key, defVal)</code>.<a name="line.782"></a> <span class="sourceLineNo">783</span> *<a name="line.783"></a> -<span class="sourceLineNo">784</span> * <p><a name="line.784"></a> -<span class="sourceLineNo">785</span> * Shortcut for <code>get(List.<jk>class</jk>, key)</code>.<a name="line.785"></a> -<span class="sourceLineNo">786</span> *<a name="line.786"></a> -<span class="sourceLineNo">787</span> * @param key The key.<a name="line.787"></a> -<span class="sourceLineNo">788</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.788"></a> -<span class="sourceLineNo">789</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.789"></a> -<span class="sourceLineNo">790</span> */<a name="line.790"></a> -<span class="sourceLineNo">791</span> public List<?> getList(String key) {<a name="line.791"></a> -<span class="sourceLineNo">792</span> return get(List.class, key);<a name="line.792"></a> -<span class="sourceLineNo">793</span> }<a name="line.793"></a> -<span class="sourceLineNo">794</span><a name="line.794"></a> -<span class="sourceLineNo">795</span> /**<a name="line.795"></a> -<span class="sourceLineNo">796</span> * Returns the specified entry value converted to a {@link List}.<a name="line.796"></a> -<span class="sourceLineNo">797</span> *<a name="line.797"></a> -<span class="sourceLineNo">798</span> * <p><a name="line.798"></a> -<span class="sourceLineNo">799</span> * Shortcut for <code>get(List.<jk>class</jk>, key, defVal)</code>.<a name="line.799"></a> -<span class="sourceLineNo">800</span> *<a name="line.800"></a> -<span class="sourceLineNo">801</span> * @param key The key.<a name="line.801"></a> -<span class="sourceLineNo">802</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.802"></a> -<span class="sourceLineNo">803</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.803"></a> -<span class="sourceLineNo">804</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.804"></a> -<span class="sourceLineNo">805</span> */<a name="line.805"></a> -<span class="sourceLineNo">806</span> public List<?> getList(String key, List<?> defVal) {<a name="line.806"></a> -<span class="sourceLineNo">807</span> return get(List.class, key, defVal);<a name="line.807"></a> -<span class="sourceLineNo">808</span> }<a name="line.808"></a> -<span class="sourceLineNo">809</span><a name="line.809"></a> -<span class="sourceLineNo">810</span> /**<a name="line.810"></a> -<span class="sourceLineNo">811</span> * Returns the specified entry value converted to a {@link Map}.<a name="line.811"></a> +<span class="sourceLineNo">784</span> * @param key The key.<a name="line.784"></a> +<span class="sourceLineNo">785</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.785"></a> +<span class="sourceLineNo">786</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.786"></a> +<span class="sourceLineNo">787</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.787"></a> +<span class="sourceLineNo">788</span> */<a name="line.788"></a> +<span class="sourceLineNo">789</span> public Map<?,?> getMap(String key, Map<?,?> defVal) {<a name="line.789"></a> +<span class="sourceLineNo">790</span> return get(Map.class, key, defVal);<a name="line.790"></a> +<span class="sourceLineNo">791</span> }<a name="line.791"></a> +<span class="sourceLineNo">792</span><a name="line.792"></a> +<span class="sourceLineNo">793</span> /**<a name="line.793"></a> +<span class="sourceLineNo">794</span> * Returns the specified entry value converted to a {@link List}.<a name="line.794"></a> +<span class="sourceLineNo">795</span> *<a name="line.795"></a> +<span class="sourceLineNo">796</span> * <p><a name="line.796"></a> +<span class="sourceLineNo">797</span> * Shortcut for <code>get(List.<jk>class</jk>, key)</code>.<a name="line.797"></a> +<span class="sourceLineNo">798</span> *<a name="line.798"></a> +<span class="sourceLineNo">799</span> * @param key The key.<a name="line.799"></a> +<span class="sourceLineNo">800</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.800"></a> +<span class="sourceLineNo">801</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.801"></a> +<span class="sourceLineNo">802</span> */<a name="line.802"></a> +<span class="sourceLineNo">803</span> public List<?> getList(String key) {<a name="line.803"></a> +<span class="sourceLineNo">804</span> return get(List.class, key);<a name="line.804"></a> +<span class="sourceLineNo">805</span> }<a name="line.805"></a> +<span class="sourceLineNo">806</span><a name="line.806"></a> +<span class="sourceLineNo">807</span> /**<a name="line.807"></a> +<span class="sourceLineNo">808</span> * Returns the specified entry value converted to a {@link List}.<a name="line.808"></a> +<span class="sourceLineNo">809</span> *<a name="line.809"></a> +<span class="sourceLineNo">810</span> * <p><a name="line.810"></a> +<span class="sourceLineNo">811</span> * Shortcut for <code>get(List.<jk>class</jk>, key, defVal)</code>.<a name="line.811"></a> <span class="sourceLineNo">812</span> *<a name="line.812"></a> -<span class="sourceLineNo">813</span> * <p><a name="line.813"></a> -<span class="sourceLineNo">814</span> * Shortcut for <code>get(ObjectMap.<jk>class</jk>, key)</code>.<a name="line.814"></a> -<span class="sourceLineNo">815</span> *<a name="line.815"></a> -<span class="sourceLineNo">816</span> * @param key The key.<a name="line.816"></a> -<span class="sourceLineNo">817</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.817"></a> -<span class="sourceLineNo">818</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.818"></a> -<span class="sourceLineNo">819</span> */<a name="line.819"></a> -<span class="sourceLineNo">820</span> public ObjectMap getObjectMap(String key) {<a name="line.820"></a> -<span class="sourceLineNo">821</span> return get(ObjectMap.class, key);<a name="line.821"></a> -<span class="sourceLineNo">822</span> }<a name="line.822"></a> -<span class="sourceLineNo">823</span><a name="line.823"></a> -<span class="sourceLineNo">824</span> /**<a name="line.824"></a> -<span class="sourceLineNo">825</span> * Returns the specified entry value converted to a {@link ObjectMap}.<a name="line.825"></a> -<span class="sourceLineNo">826</span> *<a name="line.826"></a> -<span class="sourceLineNo">827</span> * <p><a name="line.827"></a> -<span class="sourceLineNo">828</span> * Shortcut for <code>get(ObjectMap.<jk>class</jk>, key, defVal)</code>.<a name="line.828"></a> -<span class="sourceLineNo">829</span> *<a name="line.829"></a> -<span class="sourceLineNo">830</span> * @param key The key.<a name="line.830"></a> -<span class="sourceLineNo">831</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.831"></a> -<span class="sourceLineNo">832</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.832"></a> -<span class="sourceLineNo">833</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.833"></a> -<span class="sourceLineNo">834</span> */<a name="line.834"></a> -<span class="sourceLineNo">835</span> public ObjectMap getObjectMap(String key, ObjectMap defVal) {<a name="line.835"></a> -<span class="sourceLineNo">836</span> return get(ObjectMap.class, key, defVal);<a name="line.836"></a> -<span class="sourceLineNo">837</span> }<a name="line.837"></a> -<span class="sourceLineNo">838</span><a name="line.838"></a> -<span class="sourceLineNo">839</span> /**<a name="line.839"></a> -<span class="sourceLineNo">840</span> * Returns the specified entry value converted to a {@link ObjectList}.<a name="line.840"></a> +<span class="sourceLineNo">813</span> * @param key The key.<a name="line.813"></a> +<span class="sourceLineNo">814</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.814"></a> +<span class="sourceLineNo">815</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.815"></a> +<span class="sourceLineNo">816</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.816"></a> +<span class="sourceLineNo">817</span> */<a name="line.817"></a> +<span class="sourceLineNo">818</span> public List<?> getList(String key, List<?> defVal) {<a name="line.818"></a> +<span class="sourceLineNo">819</span> return get(List.class, key, defVal);<a name="line.819"></a> +<span class="sourceLineNo">820</span> }<a name="line.820"></a> +<span class="sourceLineNo">821</span><a name="line.821"></a> +<span class="sourceLineNo">822</span> /**<a name="line.822"></a> +<span class="sourceLineNo">823</span> * Returns the specified entry value converted to a {@link Map}.<a name="line.823"></a> +<span class="sourceLineNo">824</span> *<a name="line.824"></a> +<span class="sourceLineNo">825</span> * <p><a name="line.825"></a> +<span class="sourceLineNo">826</span> * Shortcut for <code>get(ObjectMap.<jk>class</jk>, key)</code>.<a name="line.826"></a> +<span class="sourceLineNo">827</span> *<a name="line.827"></a> +<span class="sourceLineNo">828</span> * @param key The key.<a name="line.828"></a> +<span class="sourceLineNo">829</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.829"></a> +<span class="sourceLineNo">830</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.830"></a> +<span class="sourceLineNo">831</span> */<a name="line.831"></a> +<span class="sourceLineNo">832</span> public ObjectMap getObjectMap(String key) {<a name="line.832"></a> +<span class="sourceLineNo">833</span> return get(ObjectMap.class, key);<a name="line.833"></a> +<span class="sourceLineNo">834</span> }<a name="line.834"></a> +<span class="sourceLineNo">835</span><a name="line.835"></a> +<span class="sourceLineNo">836</span> /**<a name="line.836"></a> +<span class="sourceLineNo">837</span> * Returns the specified entry value converted to a {@link ObjectMap}.<a name="line.837"></a> +<span class="sourceLineNo">838</span> *<a name="line.838"></a> +<span class="sourceLineNo">839</span> * <p><a name="line.839"></a> +<span class="sourceLineNo">840</span> * Shortcut for <code>get(ObjectMap.<jk>class</jk>, key, defVal)</code>.<a name="line.840"></a> <span class="sourceLineNo">841</span> *<a name="line.841"></a> -<span class="sourceLineNo">842</span> * <p><a name="line.842"></a> -<span class="sourceLineNo">843</span> * Shortcut for <code>get(ObjectList.<jk>class</jk>, key)</code>.<a name="line.843"></a> -<span class="sourceLineNo">844</span> *<a name="line.844"></a> -<span class="sourceLineNo">845</span> * @param key The key.<a name="line.845"></a> -<span class="sourceLineNo">846</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.846"></a> -<span class="sourceLineNo">847</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.847"></a> -<span class="sourceLineNo">848</span> */<a name="line.848"></a> -<span class="sourceLineNo">849</span> public ObjectList getObjectList(String key) {<a name="line.849"></a> -<span class="sourceLineNo">850</span> return get(ObjectList.class, key);<a name="line.850"></a> -<span class="sourceLineNo">851</span> }<a name="line.851"></a> -<span class="sourceLineNo">852</span><a name="line.852"></a> -<span class="sourceLineNo">853</span> /**<a name="line.853"></a> -<span class="sourceLineNo">854</span> * Returns the specified entry value converted to a {@link ObjectList}.<a name="line.854"></a> -<span class="sourceLineNo">855</span> *<a name="line.855"></a> -<span class="sourceLineNo">856</span> * <p><a name="line.856"></a> -<span class="sourceLineNo">857</span> * Shortcut for <code>get(ObjectList.<jk>class</jk>, key, defVal)</code>.<a name="line.857"></a> -<span class="sourceLineNo">858</span> *<a name="line.858"></a> -<span class="sourceLineNo">859</span> * @param key The key.<a name="line.859"></a> -<span class="sourceLineNo">860</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.860"></a> -<span class="sourceLineNo">861</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.861"></a> -<span class="sourceLineNo">862</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.862"></a> -<span class="sourceLineNo">863</span> */<a name="line.863"></a> -<span class="sourceLineNo">864</span> public ObjectList getObjectList(String key, ObjectList defVal) {<a name="line.864"></a> -<span class="sourceLineNo">865</span> return get(ObjectList.class, key, defVal);<a name="line.865"></a> -<span class="sourceLineNo">866</span> }<a name="line.866"></a> -<span class="sourceLineNo">867</span><a name="line.867"></a> -<span class="sourceLineNo">868</span> /**<a name="line.868"></a> -<span class="sourceLineNo">869</span> * Returns the first entry that exists converted to a {@link String}.<a name="line.869"></a> +<span class="sourceLineNo">842</span> * @param key The key.<a name="line.842"></a> +<span class="sourceLineNo">843</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.843"></a> +<span class="sourceLineNo">844</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.844"></a> +<span class="sourceLineNo">845</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.845"></a> +<span class="sourceLineNo">846</span> */<a name="line.846"></a> +<span class="sourceLineNo">847</span> public ObjectMap getObjectMap(String key, ObjectMap defVal) {<a name="line.847"></a> +<span class="sourceLineNo">848</span> return get(ObjectMap.class, key, defVal);<a name="line.848"></a> +<span class="sourceLineNo">849</span> }<a name="line.849"></a> +<span class="sourceLineNo">850</span><a name="line.850"></a> +<span class="sourceLineNo">851</span> /**<a name="line.851"></a> +<span class="sourceLineNo">852</span> * Returns the specified entry value converted to a {@link ObjectList}.<a name="line.852"></a> +<span class="sourceLineNo">853</span> *<a name="line.853"></a> +<span class="sourceLineNo">854</span> * <p><a name="line.854"></a> +<span class="sourceLineNo">855</span> * Shortcut for <code>get(ObjectList.<jk>class</jk>, key)</code>.<a name="line.855"></a> +<span class="sourceLineNo">856</span> *<a name="line.856"></a> +<span class="sourceLineNo">857</span> * @param key The key.<a name="line.857"></a> +<span class="sourceLineNo">858</span> * @return The converted value, or <jk>null</jk> if the map contains no mapping for this key.<a name="line.858"></a> +<span class="sourceLineNo">859</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.859"></a> +<span class="sourceLineNo">860</span> */<a name="line.860"></a> +<span class="sourceLineNo">861</span> public ObjectList getObjectList(String key) {<a name="line.861"></a> +<span class="sourceLineNo">862</span> return get(ObjectList.class, key);<a name="line.862"></a> +<span class="sourceLineNo">863</span> }<a name="line.863"></a> +<span class="sourceLineNo">864</span><a name="line.864"></a> +<span class="sourceLineNo">865</span> /**<a name="line.865"></a> +<span class="sourceLineNo">866</span> * Returns the specified entry value converted to a {@link ObjectList}.<a name="line.866"></a> +<span class="sourceLineNo">867</span> *<a name="line.867"></a> +<span class="sourceLineNo">868</span> * <p><a name="line.868"></a> +<span class="sourceLineNo">869</span> * Shortcut for <code>get(ObjectList.<jk>class</jk>, key, defVal)</code>.<a name="line.869"></a> <span class="sourceLineNo">870</span> *<a name="line.870"></a> -<span class="sourceLineNo">871</span> * <p><a name="line.871"></a> -<span class="sourceLineNo">872</span> * Shortcut for <code>find(String.<jk>class</jk>, keys)</code>.<a name="line.872"></a> -<span class="sourceLineNo">873</span> *<a name="line.873"></a> -<span class="sourceLineNo">874</span> * @param keys The list of keys to look for.<a name="line.874"></a> -<span class="sourceLineNo">875</span> * @return<a name="line.875"></a> -<span class="sourceLineNo">876</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.876"></a> -<span class="sourceLineNo">877</span> * contains no mapping for any of the keys.<a name="line.877"></a> -<span class="sourceLineNo">878</span> */<a name="line.878"></a> -<span class="sourceLineNo">879</span> public String findString(String... keys) {<a name="line.879"></a> -<span class="sourceLineNo">880</span> return find(String.class, keys);<a name="line.880"></a> -<span class="sourceLineNo">881</span> }<a name="line.881"></a> -<span class="sourceLineNo">882</span><a name="line.882"></a> -<span class="sourceLineNo">883</span> /**<a name="line.883"></a> -<span class="sourceLineNo">884</span> * Returns the first entry that exists converted to an {@link Integer}.<a name="line.884"></a> +<span class="sourceLineNo">871</span> * @param key The key.<a name="line.871"></a> +<span class="sourceLineNo">872</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.872"></a> +<span class="sourceLineNo">873</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.873"></a> +<span class="sourceLineNo">874</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.874"></a> +<span class="sourceLineNo">875</span> */<a name="line.875"></a> +<span class="sourceLineNo">876</span> public ObjectList getObjectList(String key, ObjectList defVal) {<a name="line.876"></a> +<span class="sourceLineNo">877</span> return get(ObjectList.class, key, defVal);<a name="line.877"></a> +<span class="sourceLineNo">878</span> }<a name="line.878"></a> +<span class="sourceLineNo">879</span><a name="line.879"></a> +<span class="sourceLineNo">880</span> /**<a name="line.880"></a> +<span class="sourceLineNo">881</span> * Returns the first entry that exists converted to a {@link String}.<a name="line.881"></a> +<span class="sourceLineNo">882</span> *<a name="line.882"></a> +<span class="sourceLineNo">883</span> * <p><a name="line.883"></a> +<span class="sourceLineNo">884</span> * Shortcut for <code>find(String.<jk>class</jk>, keys)</code>.<a name="line.884"></a> <span class="sourceLineNo">885</span> *<a name="line.885"></a> -<span class="sourceLineNo">886</span> * <p><a name="line.886"></a> -<span class="sourceLineNo">887</span> * Shortcut for <code>find(Integer.<jk>class</jk>, keys)</code>.<a name="line.887"></a> -<span class="sourceLineNo">888</span> *<a name="line.888"></a> -<span class="sourceLineNo">889</span> * @param keys The list of keys to look for.<a name="line.889"></a> -<span class="sourceLineNo">890</span> * @return<a name="line.890"></a> -<span class="sourceLineNo">891</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.891"></a> -<span class="sourceLineNo">892</span> * contains no mapping for any of the keys.<a name="line.892"></a> -<span class="sourceLineNo">893</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.893"></a> -<span class="sourceLineNo">894</span> */<a name="line.894"></a> -<span class="sourceLineNo">895</span> public Integer findInt(String... keys) {<a name="line.895"></a> -<span class="sourceLineNo">896</span> return find(Integer.class, keys);<a name="line.896"></a> -<span class="sourceLineNo">897</span> }<a name="line.897"></a> -<span class="sourceLineNo">898</span><a name="line.898"></a> -<span class="sourceLineNo">899</span> /**<a name="line.899"></a> -<span class="sourceLineNo">900</span> * Returns the first entry that exists converted to a {@link Long}.<a name="line.900"></a> -<span class="sourceLineNo">901</span> *<a name="line.901"></a> -<span class="sourceLineNo">902</span> * <p><a name="line.902"></a> -<span class="sourceLineNo">903</span> * Shortcut for <code>find(Long.<jk>class</jk>, keys)</code>.<a name="line.903"></a> -<span class="sourceLineNo">904</span> *<a name="line.904"></a> -<span class="sourceLineNo">905</span> * @param keys The list of keys to look for.<a name="line.905"></a> -<span class="sourceLineNo">906</span> * @return<a name="line.906"></a> -<span class="sourceLineNo">907</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.907"></a> -<span class="sourceLineNo">908</span> * contains no mapping for any of the keys.<a name="line.908"></a> -<span class="sourceLineNo">909</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.909"></a> -<span class="sourceLineNo">910</span> */<a name="line.910"></a> -<span class="sourceLineNo">911</span> public Long findLong(String... keys) {<a name="line.911"></a> -<span class="sourceLineNo">912</span> return find(Long.class, keys);<a name="line.912"></a> -<span class="sourceLineNo">913</span> }<a name="line.913"></a> -<span class="sourceLineNo">914</span><a name="line.914"></a> -<span class="sourceLineNo">915</span> /**<a name="line.915"></a> -<span class="sourceLineNo">916</span> * Returns the first entry that exists converted to a {@link Boolean}.<a name="line.916"></a> -<span class="sourceLineNo">917</span> *<a name="line.917"></a> -<span class="sourceLineNo">918</span> * <p><a name="line.918"></a> -<span class="sourceLineNo">919</span> * Shortcut for <code>find(Boolean.<jk>class</jk>, keys)</code>.<a name="line.919"></a> -<span class="sourceLineNo">920</span> *<a name="line.920"></a> -<span class="sourceLineNo">921</span> * @param keys The list of keys to look for.<a name="line.921"></a> -<span class="sourceLineNo">922</span> * @return<a name="line.922"></a> -<span class="sourceLineNo">923</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.923"></a> -<span class="sourceLineNo">924</span> * contains no mapping for any of the keys.<a name="line.924"></a> -<span class="sourceLineNo">925</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.925"></a> -<span class="sourceLineNo">926</span> */<a name="line.926"></a> -<span class="sourceLineNo">927</span> public Boolean findBoolean(String... keys) {<a name="line.927"></a> -<span class="sourceLineNo">928</span> return find(Boolean.class, keys);<a name="line.928"></a> -<span class="sourceLineNo">929</span> }<a name="line.929"></a> -<span class="sourceLineNo">930</span><a name="line.930"></a> -<span class="sourceLineNo">931</span> /**<a name="line.931"></a> -<span class="sourceLineNo">932</span> * Returns the first entry that exists converted to a {@link Map}.<a name="line.932"></a> -<span class="sourceLineNo">933</span> *<a name="line.933"></a> -<span class="sourceLineNo">934</span> * <p><a name="line.934"></a> -<span class="sourceLineNo">935</span> * Shortcut for <code>find(Map.<jk>class</jk>, keys)</code>.<a name="line.935"></a> -<span class="sourceLineNo">936</span> *<a name="line.936"></a> -<span class="sourceLineNo">937</span> * @param keys The list of keys to look for.<a name="line.937"></a> -<span class="sourceLineNo">938</span> * @return<a name="line.938"></a> -<span class="sourceLineNo">939</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.939"></a> -<span class="sourceLineNo">940</span> * contains no mapping for any of the keys.<a name="line.940"></a> -<span class="sourceLineNo">941</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.941"></a> -<span class="sourceLineNo">942</span> */<a name="line.942"></a> -<span class="sourceLineNo">943</span> public Map<?,?> findMap(String... keys) {<a name="line.943"></a> -<span class="sourceLineNo">944</span> return find(Map.class, keys);<a name="line.944"></a> -<span class="sourceLineNo">945</span> }<a name="line.945"></a> -<span class="sourceLineNo">946</span><a name="line.946"></a> -<span class="sourceLineNo">947</span> /**<a name="line.947"></a> -<span class="sourceLineNo">948</span> * Returns the first entry that exists converted to a {@link List}.<a name="line.948"></a> -<span class="sourceLineNo">949</span> *<a name="line.949"></a> -<span class="sourceLineNo">950</span> * <p><a name="line.950"></a> -<span class="sourceLineNo">951</span> * Shortcut for <code>find(List.<jk>class</jk>, keys)</code>.<a name="line.951"></a> -<span class="sourceLineNo">952</span> *<a name="line.952"></a> -<span class="sourceLineNo">953</span> * @param keys The list of keys to look for.<a name="line.953"></a> -<span class="sourceLineNo">954</span> * @return<a name="line.954"></a> -<span class="sourceLineNo">955</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.955"></a> -<span class="sourceLineNo">956</span> * contains no mapping for any of the keys.<a name="line.956"></a> -<span class="sourceLineNo">957</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.957"></a> -<span class="sourceLineNo">958</span> */<a name="line.958"></a> -<span class="sourceLineNo">959</span> public List<?> findList(String... keys) {<a name="line.959"></a> -<span class="sourceLineNo">960</span> return find(List.class, keys);<a name="line.960"></a> -<span class="sourceLineNo">961</span> }<a name="line.961"></a> -<span class="sourceLineNo">962</span><a name="line.962"></a> -<span class="sourceLineNo">963</span> /**<a name="line.963"></a> -<span class="sourceLineNo">964</span> * Returns the first entry that exists converted to a {@link ObjectMap}.<a name="line.964"></a> -<span class="sourceLineNo">965</span> *<a name="line.965"></a> -<span class="sourceLineNo">966</span> * <p><a name="line.966"></a> -<span class="sourceLineNo">967</span> * Shortcut for <code>find(ObjectMap.<jk>class</jk>, keys)</code>.<a name="line.967"></a> -<span class="sourceLineNo">968</span> *<a name="line.968"></a> -<span class="sourceLineNo">969</span> * @param keys The list of keys to look for.<a name="line.969"></a> -<span class="sourceLineNo">970</span> * @return<a name="line.970"></a> -<span class="sourceLineNo">971</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.971"></a> -<span class="sourceLineNo">972</span> * contains no mapping for any of the keys.<a name="line.972"></a> -<span class="sourceLineNo">973</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.973"></a> -<span class="sourceLineNo">974</span> */<a name="line.974"></a> -<span class="sourceLineNo">975</span> public ObjectMap findObjectMap(String... keys) {<a name="line.975"></a> -<span class="sourceLineNo">976</span> return find(ObjectMap.class, keys);<a name="line.976"></a> -<span class="sourceLineNo">977</span> }<a name="line.977"></a> -<span class="sourceLineNo">978</span><a name="line.978"></a> -<span class="sourceLineNo">979</span> /**<a name="line.979"></a> -<span class="sourceLineNo">980</span> * Returns the first entry that exists converted to a {@link ObjectList}.<a name="line.980"></a> -<span class="sourceLineNo">981</span> *<a name="line.981"></a> -<span class="sourceLineNo">982</span> * <p><a name="line.982"></a> -<span class="sourceLineNo">983</span> * Shortcut for <code>find(ObjectList.<jk>class</jk>, keys)</code>.<a name="line.983"></a> -<span class="sourceLineNo">984</span> *<a name="line.984"></a> -<span class="sourceLineNo">985</span> * @param keys The list of keys to look for.<a name="line.985"></a> -<span class="sourceLineNo">986</span> * @return<a name="line.986"></a> -<span class="sourceLineNo">987</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.987"></a> -<span class="sourceLineNo">988</span> * contains no mapping for any of the keys.<a name="line.988"></a> -<span class="sourceLineNo">989</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.989"></a> -<span class="sourceLineNo">990</span> */<a name="line.990"></a> -<span class="sourceLineNo">991</span> public ObjectList findObjectList(String... keys) {<a name="line.991"></a> -<span class="sourceLineNo">992</span> return find(ObjectList.class, keys);<a name="line.992"></a> -<span class="sourceLineNo">993</span> }<a name="line.993"></a> -<span class="sourceLineNo">994</span><a name="line.994"></a> -<span class="sourceLineNo">995</span> /**<a name="line.995"></a> -<span class="sourceLineNo">996</span> * Returns the first key in the map.<a name="line.996"></a> -<span class="sourceLineNo">997</span> *<a name="line.997"></a> -<span class="sourceLineNo">998</span> * @return The first key in the map, or <jk>null</jk> if the map is empty.<a name="line.998"></a> -<span class="sourceLineNo">999</span> */<a name="line.999"></a> -<span class="sourceLineNo">1000</span> public String getFirstKey() {<a name="line.1000"></a> -<span class="sourceLineNo">1001</span> return isEmpty() ? null : keySet().iterator().next();<a name="line.1001"></a> -<span class="sourceLineNo">1002</span> }<a name="line.1002"></a> -<span class="sourceLineNo">1003</span><a name="line.1003"></a> -<span class="sourceLineNo">1004</span> /**<a name="line.1004"></a> -<span class="sourceLineNo">1005</span> * Returns the class type of the object at the specified index.<a name="line.1005"></a> -<span class="sourceLineNo">1006</span> *<a name="line.1006"></a> -<span class="sourceLineNo">1007</span> * @param key The key into this map.<a name="line.1007"></a> -<span class="sourceLineNo">1008</span> * @return<a name="line.1008"></a> -<span class="sourceLineNo">1009</span> * The data type of the object at the specified key, or <jk>null</jk> if the value is null or does not exist.<a name="line.1009"></a> -<span class="sourceLineNo">1010</span> */<a name="line.1010"></a> -<span class="sourceLineNo">1011</span> public ClassMeta<?> getClassMeta(String key) {<a name="line.1011"></a> -<span class="sourceLineNo">1012</span> return session.getClassMetaForObject(get(key));<a name="line.1012"></a> -<span class="sourceLineNo">1013</span> }<a name="line.1013"></a> -<span class="sourceLineNo">1014</span><a name="line.1014"></a> -<span class="sourceLineNo">1015</span> /**<a name="line.1015"></a> -<span class="sourceLineNo">1016</span> * Equivalent to calling <code>get(class,key,def)</code> followed by <code>remove(key);</code><a name="line.1016"></a> -<span class="sourceLineNo">1017</span> *<a name="line.1017"></a> -<span class="sourceLineNo">1018</span> * @param <T> The class type.<a name="line.1018"></a> -<span class="sourceLineNo">1019</span> * @param type The class type.<a name="line.1019"></a> -<span class="sourceLineNo">1020</span> * @param key The key.<a name="line.1020"></a> -<span class="sourceLineNo">1021</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.1021"></a> -<span class="sourceLineNo">1022</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.1022"></a> -<span class="sourceLineNo">1023</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.1023"></a> -<span class="sourceLineNo">1024</span> */<a name="line.1024"></a> -<span class="sourceLineNo">1025</span> public <T> T remove(Class<T> type, String key, T defVal) {<a name="line.1025"></a> -<span class="sourceLineNo">1026</span> T t = get(type, key, defVal);<a name="line.1026"></a> -<span class="sourceLineNo">1027</span> remove(key);<a name="line.1027"></a> -<span class="sourceLineNo">1028</span> return t;<a name="line.1028"></a> -<span class="sourceLineNo">1029</span> }<a name="line.1029"></a> -<span class="sourceLineNo">1030</span><a name="line.1030"></a> -<span class="sourceLineNo">1031</span><a name="line.1031"></a> -<span class="sourceLineNo">1032</span> /**<a name="line.1032"></a> -<span class="sourceLineNo">1033</span> * Convenience method for removing several keys at once.<a name="line.1033"></a> -<span class="sourceLineNo">1034</span> *<a name="line.1034"></a> -<span class="sourceLineNo">1035</span> * @param keys The list of keys to remove.<a name="line.1035"></a> +<span class="sourceLineNo">886</span> * @param keys The list of keys to look for.<a name="line.886"></a> +<span class="sourceLineNo">887</span> * @return<a name="line.887"></a> +<span class="sourceLineNo">888</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.888"></a> +<span class="sourceLineNo">889</span> * contains no mapping for any of the keys.<a name="line.889"></a> +<span class="sourceLineNo">890</span> */<a name="line.890"></a> +<span class="sourceLineNo">891</span> public String findString(String... keys) {<a name="line.891"></a> +<span class="sourceLineNo">892</span> return find(String.class, keys);<a name="line.892"></a> +<span class="sourceLineNo">893</span> }<a name="line.893"></a> +<span class="sourceLineNo">894</span><a name="line.894"></a> +<span class="sourceLineNo">895</span> /**<a name="line.895"></a> +<span class="sourceLineNo">896</span> * Returns the first entry that exists converted to an {@link Integer}.<a name="line.896"></a> +<span class="sourceLineNo">897</span> *<a name="line.897"></a> +<span class="sourceLineNo">898</span> * <p><a name="line.898"></a> +<span class="sourceLineNo">899</span> * Shortcut for <code>find(Integer.<jk>class</jk>, keys)</code>.<a name="line.899"></a> +<span class="sourceLineNo">900</span> *<a name="line.900"></a> +<span class="sourceLineNo">901</span> * @param keys The list of keys to look for.<a name="line.901"></a> +<span class="sourceLineNo">902</span> * @return<a name="line.902"></a> +<span class="sourceLineNo">903</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.903"></a> +<span class="sourceLineNo">904</span> * contains no mapping for any of the keys.<a name="line.904"></a> +<span class="sourceLineNo">905</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.905"></a> +<span class="sourceLineNo">906</span> */<a name="line.906"></a> +<span class="sourceLineNo">907</span> public Integer findInt(String... keys) {<a name="line.907"></a> +<span class="sourceLineNo">908</span> return find(Integer.class, keys);<a name="line.908"></a> +<span class="sourceLineNo">909</span> }<a name="line.909"></a> +<span class="sourceLineNo">910</span><a name="line.910"></a> +<span class="sourceLineNo">911</span> /**<a name="line.911"></a> +<span class="sourceLineNo">912</span> * Returns the first entry that exists converted to a {@link Long}.<a name="line.912"></a> +<span class="sourceLineNo">913</span> *<a name="line.913"></a> +<span class="sourceLineNo">914</span> * <p><a name="line.914"></a> +<span class="sourceLineNo">915</span> * Shortcut for <code>find(Long.<jk>class</jk>, keys)</code>.<a name="line.915"></a> +<span class="sourceLineNo">916</span> *<a name="line.916"></a> +<span class="sourceLineNo">917</span> * @param keys The list of keys to look for.<a name="line.917"></a> +<span class="sourceLineNo">918</span> * @return<a name="line.918"></a> +<span class="sourceLineNo">919</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.919"></a> +<span class="sourceLineNo">920</span> * contains no mapping for any of the keys.<a name="line.920"></a> +<span class="sourceLineNo">921</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.921"></a> +<span class="sourceLineNo">922</span> */<a name="line.922"></a> +<span class="sourceLineNo">923</span> public Long findLong(String... keys) {<a name="line.923"></a> +<span class="sourceLineNo">924</span> return find(Long.class, keys);<a name="line.924"></a> +<span class="sourceLineNo">925</span> }<a name="line.925"></a> +<span class="sourceLineNo">926</span><a name="line.926"></a> +<span class="sourceLineNo">927</span> /**<a name="line.927"></a> +<span class="sourceLineNo">928</span> * Returns the first entry that exists converted to a {@link Boolean}.<a name="line.928"></a> +<span class="sourceLineNo">929</span> *<a name="line.929"></a> +<span class="sourceLineNo">930</span> * <p><a name="line.930"></a> +<span class="sourceLineNo">931</span> * Shortcut for <code>find(Boolean.<jk>class</jk>, keys)</code>.<a name="line.931"></a> +<span class="sourceLineNo">932</span> *<a name="line.932"></a> +<span class="sourceLineNo">933</span> * @param keys The list of keys to look for.<a name="line.933"></a> +<span class="sourceLineNo">934</span> * @return<a name="line.934"></a> +<span class="sourceLineNo">935</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.935"></a> +<span class="sourceLineNo">936</span> * contains no mapping for any of the keys.<a name="line.936"></a> +<span class="sourceLineNo">937</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.937"></a> +<span class="sourceLineNo">938</span> */<a name="line.938"></a> +<span class="sourceLineNo">939</span> public Boolean findBoolean(String... keys) {<a name="line.939"></a> +<span class="sourceLineNo">940</span> return find(Boolean.class, keys);<a name="line.940"></a> +<span class="sourceLineNo">941</span> }<a name="line.941"></a> +<span class="sourceLineNo">942</span><a name="line.942"></a> +<span class="sourceLineNo">943</span> /**<a name="line.943"></a> +<span class="sourceLineNo">944</span> * Returns the first entry that exists converted to a {@link Map}.<a name="line.944"></a> +<span class="sourceLineNo">945</span> *<a name="line.945"></a> +<span class="sourceLineNo">946</span> * <p><a name="line.946"></a> +<span class="sourceLineNo">947</span> * Shortcut for <code>find(Map.<jk>class</jk>, keys)</code>.<a name="line.947"></a> +<span class="sourceLineNo">948</span> *<a name="line.948"></a> +<span class="sourceLineNo">949</span> * @param keys The list of keys to look for.<a name="line.949"></a> +<span class="sourceLineNo">950</span> * @return<a name="line.950"></a> +<span class="sourceLineNo">951</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.951"></a> +<span class="sourceLineNo">952</span> * contains no mapping for any of the keys.<a name="line.952"></a> +<span class="sourceLineNo">953</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.953"></a> +<span class="sourceLineNo">954</span> */<a name="line.954"></a> +<span class="sourceLineNo">955</span> public Map<?,?> findMap(String... keys) {<a name="line.955"></a> +<span class="sourceLineNo">956</span> return find(Map.class, keys);<a name="line.956"></a> +<span class="sourceLineNo">957</span> }<a name="line.957"></a> +<span class="sourceLineNo">958</span><a name="line.958"></a> +<span class="sourceLineNo">959</span> /**<a name="line.959"></a> +<span class="sourceLineNo">960</span> * Returns the first entry that exists converted to a {@link List}.<a name="line.960"></a> +<span class="sourceLineNo">961</span> *<a name="line.961"></a> +<span class="sourceLineNo">962</span> * <p><a name="line.962"></a> +<span class="sourceLineNo">963</span> * Shortcut for <code>find(List.<jk>class</jk>, keys)</code>.<a name="line.963"></a> +<span class="sourceLineNo">964</span> *<a name="line.964"></a> +<span class="sourceLineNo">965</span> * @param keys The list of keys to look for.<a name="line.965"></a> +<span class="sourceLineNo">966</span> * @return<a name="line.966"></a> +<span class="sourceLineNo">967</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.967"></a> +<span class="sourceLineNo">968</span> * contains no mapping for any of the keys.<a name="line.968"></a> +<span class="sourceLineNo">969</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.969"></a> +<span class="sourceLineNo">970</span> */<a name="line.970"></a> +<span class="sourceLineNo">971</span> public List<?> findList(String... keys) {<a name="line.971"></a> +<span class="sourceLineNo">972</span> return find(List.class, keys);<a name="line.972"></a> +<span class="sourceLineNo">973</span> }<a name="line.973"></a> +<span class="sourceLineNo">974</span><a name="line.974"></a> +<span class="sourceLineNo">975</span> /**<a name="line.975"></a> +<span class="sourceLineNo">976</span> * Returns the first entry that exists converted to a {@link ObjectMap}.<a name="line.976"></a> +<span class="sourceLineNo">977</span> *<a name="line.977"></a> +<span class="sourceLineNo">978</span> * <p><a name="line.978"></a> +<span class="sourceLineNo">979</span> * Shortcut for <code>find(ObjectMap.<jk>class</jk>, keys)</code>.<a name="line.979"></a> +<span class="sourceLineNo">980</span> *<a name="line.980"></a> +<span class="sourceLineNo">981</span> * @param keys The list of keys to look for.<a name="line.981"></a> +<span class="sourceLineNo">982</span> * @return<a name="line.982"></a> +<span class="sourceLineNo">983</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.983"></a> +<span class="sourceLineNo">984</span> * contains no mapping for any of the keys.<a name="line.984"></a> +<span class="sourceLineNo">985</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.985"></a> +<span class="sourceLineNo">986</span> */<a name="line.986"></a> +<span class="sourceLineNo">987</span> public ObjectMap findObjectMap(String... keys) {<a name="line.987"></a> +<span class="sourceLineNo">988</span> return find(ObjectMap.class, keys);<a name="line.988"></a> +<span class="sourceLineNo">989</span> }<a name="line.989"></a> +<span class="sourceLineNo">990</span><a name="line.990"></a> +<span class="sourceLineNo">991</span> /**<a name="line.991"></a> +<span class="sourceLineNo">992</span> * Returns the first entry that exists converted to a {@link ObjectList}.<a name="line.992"></a> +<span class="sourceLineNo">993</span> *<a name="line.993"></a> +<span class="sourceLineNo">994</span> * <p><a name="line.994"></a> +<span class="sourceLineNo">995</span> * Shortcut for <code>find(ObjectList.<jk>class</jk>, keys)</code>.<a name="line.995"></a> +<span class="sourceLineNo">996</span> *<a name="line.996"></a> +<span class="sourceLineNo">997</span> * @param keys The list of keys to look for.<a name="line.997"></a> +<span class="sourceLineNo">998</span> * @return<a name="line.998"></a> +<span class="sourceLineNo">999</span> * The converted value of the first key in the list that has an entry in this map, or <jk>null</jk> if the map<a name="line.999"></a> +<span class="sourceLineNo">1000</span> * contains no mapping for any of the keys.<a name="line.1000"></a> +<span class="sourceLineNo">1001</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.1001"></a> +<span class="sourceLineNo">1002</span> */<a name="line.1002"></a> +<span class="sourceLineNo">1003</span> public ObjectList findObjectList(String... keys) {<a name="line.1003"></a> +<span class="sourceLineNo">1004</span> return find(ObjectList.class, keys);<a name="line.1004"></a> +<span class="sourceLineNo">1005</span> }<a name="line.1005"></a> +<span class="sourceLineNo">1006</span><a name="line.1006"></a> +<span class="sourceLineNo">1007</span> /**<a name="line.1007"></a> +<span class="sourceLineNo">1008</span> * Returns the first key in the map.<a name="line.1008"></a> +<span class="sourceLineNo">1009</span> *<a name="line.1009"></a> +<span class="sourceLineNo">1010</span> * @return The first key in the map, or <jk>null</jk> if the map is empty.<a name="line.1010"></a> +<span class="sourceLineNo">1011</span> */<a name="line.1011"></a> +<span class="sourceLineNo">1012</span> public String getFirstKey() {<a name="line.1012"></a> +<span class="sourceLineNo">1013</span> return isEmpty() ? null : keySet().iterator().next();<a name="line.1013"></a> +<span class="sourceLineNo">1014</span> }<a name="line.1014"></a> +<span class="sourceLineNo">1015</span><a name="line.1015"></a> +<span class="sourceLineNo">1016</span> /**<a name="line.1016"></a> +<span class="sourceLineNo">1017</span> * Returns the class type of the object at the specified index.<a name="line.1017"></a> +<span class="sourceLineNo">1018</span> *<a name="line.1018"></a> +<span class="sourceLineNo">1019</span> * @param key The key into this map.<a name="line.1019"></a> +<span class="sourceLineNo">1020</span> * @return<a name="line.1020"></a> +<span class="sourceLineNo">1021</span> * The data type of the object at the specified key, or <jk>null</jk> if the value is null or does not exist.<a name="line.1021"></a> +<span class="sourceLineNo">1022</span> */<a name="line.1022"></a> +<span class="sourceLineNo">1023</span> public ClassMeta<?> getClassMeta(String key) {<a name="line.1023"></a> +<span class="sourceLineNo">1024</span> return session.getClassMetaForObject(get(key));<a name="line.1024"></a> +<span class="sourceLineNo">1025</span> }<a name="line.1025"></a> +<span class="sourceLineNo">1026</span><a name="line.1026"></a> +<span class="sourceLineNo">1027</span> /**<a name="line.1027"></a> +<span class="sourceLineNo">1028</span> * Equivalent to calling <code>get(class,key,def)</code> followed by <code>remove(key);</code><a name="line.1028"></a> +<span class="sourceLineNo">1029</span> *<a name="line.1029"></a> +<span class="sourceLineNo">1030</span> * @param <T> The class type.<a name="line.1030"></a> +<span class="sourceLineNo">1031</span> * @param type The class type.<a name="line.1031"></a> +<span class="sourceLineNo">1032</span> * @param key The key.<a name="line.1032"></a> +<span class="sourceLineNo">1033</span> * @param defVal The default value if the map doesn't contain the specified mapping.<a name="line.1033"></a> +<span class="sourceLineNo">1034</span> * @return The converted value, or the default value if the map contains no mapping for this key.<a name="line.1034"></a> +<span class="sourceLineNo">1035</span> * @throws InvalidDataConversionException If value cannot be converted.<a name="line.1035"></a> <span class="sourceLineNo">1036</span> */<a name="line.1036"></a> -<span class="sourceLineNo">1037</span> public void removeAll(Collection<String> keys) {<a name="line.1037"></a> -<span class="sourceLineNo">1038</span> for (String k : keys)<a name="line.1038"></a> -<span class="sourceLineNo">1039</span> remove(k);<a name="line.1039"></a> -<span class="sourceLineNo">1040</span> }<a name="line.1040"></a> -<span class="sourceLineNo">1041</span><a name="line.1041"></a> -<span class="sourceLineNo">1042</span> /**<a name="line.1042"></a> -<span class="sourceLineNo">1043</span> * Convenience method for removing several keys at once.<a name="line.1043"></a> -<span class="sourceLineNo">1044</span> *<a name="line.1044"></a> -<span class="sourceLineNo">1045</span> * @param keys The list of keys to remove.<a name="line.1045"></a> -<span class="sourceLineNo">1046</span> */<a name="line.1046"></a> -<span class="sourceLineNo">1047</span> public void removeAll(String... keys) {<a name="line.1047"></a> -<span class="sourceLineNo">1048</span> for (String k : keys)<a name="line.1048"></a> -<span class="sourceLineNo">1049</span> remove(k);<a name="line.1049"></a> -<span class="sourceLineNo">1050</span> }<a name="line.1050"></a> -<span class="sourceLineNo">1051</span><a name="line.1051"></a> -<span class="sourceLineNo">1052</span> @Override /* Map */<a name="line.1052"></a> -<span class="sourceLineNo">1053</span> public boolean containsKey(Object key) {<a name="line.1053"></a> -<span class="sourceLineNo">1054</span> if (super.containsKey(key))<a name="line.1054"></a> -<span class="sourceLineNo">1055</span> return true;<a name="line.1055"></a> -<span class="sourceLineNo">1056</span> if (inner != null)<a name="line.1056"></a> -<span class="sourceLineNo">1057</span> return inner.containsKey(key);<a name="line.1057"></a> -<span class="sourceLineNo">1058</span> return false;<a name="line.1058"></a> -<span class="sourceLineNo">1059</span> }<a name="line.1059"></a> -<span class="sourceLineNo">1060</span><a name="line.1060"></a> -<span class="sourceLineNo">1061</span> /**<a name="line.1061"></a> -<span class="sourceLineNo">1062</span> * Returns <jk>true</jk> if this map contains the specified key, ignoring the inner map if it exists.<a name="line.1062"></a> -<span class="sourceLineNo">1063</span> *<a name="line.1063"></a> -<span class="sourceLineNo">1064</span> * @param key The key to look up.<a name="line.1064"></a> -<span class="sourceLineNo">1065</span> * @return <jk>true</jk> if this map contains the specified key.<a name="line.1065"></a> -<span class="sourceLineNo">1066</span> */<a name="line.1066"></a> -<span class="sourceLineNo">1067</span> public boolean containsOuterKey(Object key) {<a name="line.1067"></a> -<span class="sourceLineNo">1068</span> return super.containsKey(key);<a name="line.1068"></a> -<span class="sourceLineNo">1069</span> }<a name="line.1069"></a> -<span class="sourceLineNo">1070</span><a name="line.1070"></a> -<span class="sourceLineNo">1071</span> /**<a name="line.1071"></a> -<span class="sourceLineNo">1072</span> * Returns a copy of this <code>ObjectMap</code> with only the specified keys.<a name="line.1072"></a> -<span class="sourceLineNo">1073</span> *<a name="line.1073"></a> -<span class="sourceLineNo">1074</span> * @param keys The keys of the entries to copy.<a name="line.1074"></a> -<span class="sourceLineNo">1075</span> * @return A new map with just the keys and values from this map.<a name="line.1075"></a> -<span class="sourceLineNo">1076</span> */<a name="line.1076"></a> -<span class="sourceLineNo">1077</span> public ObjectMap include(String...keys) {<a name="line.1077"></a> -<span class="sourceLineNo">1078</span> ObjectMap m2 = new ObjectMap();<a name="line.1078"></a> -<span class="sourceLineNo">1079</span> for (Map.Entry<String,Object> e : this.entrySet())<a name="line.1079"></a> -<span class="sourceLineNo">1080</span> for (String k : keys)<a name="line.1080"></a> -<span class="sourceLineNo">1081</span> if (k.equals(e.getKey()))<a name="line.1081"></a> -<span class="sourceLineNo">1082</span> m2.put(k, e.getValue());<a name="line.1082"></a> -<span class="sourceLineNo">1083</span> return m2;<a name="line.1083"></a> -<span class="sourceLineNo">1084</span> }<a name="line.1084"></a> -<span class="sourceLineNo">1085</span><a name="line.1085"></a> -<span class="sourceLineNo">1086</span> /**<a name="line.1086"></a> -<span class="sourceLineNo">1087</span> * Returns a copy of this <code>ObjectMap</code> without the specified keys.<a name="line.1087"></a> -<span class="sourceLineNo">1088</span> *<a name="line.1088"></a> -<span class="sourceLineNo">1089</span> * @param keys The keys of the entries not to copy.<a name="line.1089"></a> -<span class="sourceLineNo">1090</span> * @return A new map without the keys and values from this map.<a name="line.1090"></a> -<span class="sourceLineNo">1091</span> */<a name="line.1091"></a> -<span class="sourceLineNo">1092</span> public ObjectMap exclude(String...keys) {<a name="line.1092"></a> -<span class="sourceLineNo">1093</span> ObjectMap m2 = new ObjectMap();<a name="line.1093"></a> -<span class="sourceLineNo">1094</span> for (Map.Entry<String,Object> e : this.entrySet()) {<a name="line.1094"></a> -<span class="sourceLineNo">1095</span> boolean exclude = false;<a name="line.1095"></a> -<span class="sourceLineNo">1096</span> for (String k : keys)<a name="line.1096"></a> -<span class="sourceLineNo">1097</span> if (k.equals(e.getKey()))<a name="line.1097"></a> -<span class="sourceLineNo">1098</span> exclude = true;<a name="line.1098"></a> -<span class="sourceLineNo">1099</span> if (! exclude)<a name="line.1099"></a> -<span class="sourceLineNo">1100</span> m2.put(e.getKey(), e.getValue());<a name="line.1100"></a> -<span class="sourceLineNo">1101</span> }<a name="line.1101"></a> -<span class="sourceLineNo">1102</span> return m2;<a name="line.1102"></a> -<span class="sourceLineNo">1103</span> }<a name="line.1103"></a> -<span class="sourceLineNo">1104</span><a name="line.1104"></a> -<span class="sourceLineNo">1105</span> /**<a name="line.1105"></a> -<span class="sourceLineNo">1106</span> * Sets a value in this map if the entry does not exist or the value is <jk>null</jk>.<a name="line.1106"></a> -<span class="sourceLineNo">1107</span> *<a name="line.1107"></a> -<span class="sourceLineNo">1108</span> * @param key The map key.<a name="line.1108"></a> -<span class="sourceLineNo">1109</span> * @param val The value to set if the current value does not exist or is <jk>null</jk>.<a name="line.1109"></a> -<span class="sourceLineNo">1110</span> * @return This object (for method chaining).<a name="line.1110"></a> -<span class="sourceLineNo">1111</span> */<a name="line.1111"></a> -<span class="sourceLineNo">1112</span> public ObjectMap putIfNull(String key, Object val) {<a name="line.1112"></a> -<span class="sourceLineNo">1113</span> Object o = get(key);<a name="line.1113"></a> -<span class="sourceLineNo">1114</span> if (o == null)<a name="line.1114"></a> -<span class="sourceLineNo">1115</span> put(key, val);<a name="line.1115"></a> -<span class="sourceLineNo">1116</span> return this;<a name="line.1116"></a> -<span class="sourceLineNo">1117</span> }<a name="line.1117"></a> -<span class="sourceLineNo">1118</span><a name="line.1118"></a> -<span class="sourceLineNo">1119</span> /**<a name="line.1119"></a> -<span class="sourceLineNo">1120</span> * Sets a value in this map if the entry does not exist or the value is <jk>null</jk> or an empty string.<a name="line.1120"></a> -<span class="sourceLineNo">1121</span> *<a name="line.1121"></a>
<TRUNCATED>
