http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/3fcb8e91/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 04cc4cc..24a0f4b 100644 --- a/content/site/apidocs/src-html/org/apache/juneau/ObjectMap.html +++ b/content/site/apidocs/src-html/org/apache/juneau/ObjectMap.html @@ -1077,276 +1077,248 @@ <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> * Converts this map into the class type specified by the <js>"_type"</js> entry value.<a name="line.1072"></a> +<span class="sourceLineNo">1072</span> * Converts this map into an object of the specified type.<a name="line.1072"></a> <span class="sourceLineNo">1073</span> * <p><a name="line.1073"></a> -<span class="sourceLineNo">1074</span> * TODO - Needs better description.<a name="line.1074"></a> -<span class="sourceLineNo">1075</span> *<a name="line.1075"></a> -<span class="sourceLineNo">1076</span> * @return This object map cast as another object.<a name="line.1076"></a> -<span class="sourceLineNo">1077</span> */<a name="line.1077"></a> -<span class="sourceLineNo">1078</span> public Object cast() {<a name="line.1078"></a> -<span class="sourceLineNo">1079</span> return cast(session.getBeanRegistry());<a name="line.1079"></a> -<span class="sourceLineNo">1080</span> }<a name="line.1080"></a> -<span class="sourceLineNo">1081</span><a name="line.1081"></a> -<span class="sourceLineNo">1082</span> /**<a name="line.1082"></a> -<span class="sourceLineNo">1083</span> * Same as {@link #cast()}, but first do a lookup for the name in the specified dictionary.<a name="line.1083"></a> -<span class="sourceLineNo">1084</span> *<a name="line.1084"></a> -<span class="sourceLineNo">1085</span> * @param beanRegistry<a name="line.1085"></a> -<span class="sourceLineNo">1086</span> * The class lexicon to resolve the name. Can be <jk>null</jk>.<a name="line.1086"></a> -<span class="sourceLineNo">1087</span> * @return The new Java object of type specified by the <js>"_type"</js> entry value, or this<a name="line.1087"></a> -<span class="sourceLineNo">1088</span> * same object if entry does not exist.<a name="line.1088"></a> -<span class="sourceLineNo">1089</span> */<a name="line.1089"></a> -<span class="sourceLineNo">1090</span> public Object cast(BeanRegistry beanRegistry) {<a name="line.1090"></a> -<span class="sourceLineNo">1091</span> String c = (String)get(session.getBeanTypePropertyName());<a name="line.1091"></a> -<span class="sourceLineNo">1092</span> if (c == null || beanRegistry == null)<a name="line.1092"></a> -<span class="sourceLineNo">1093</span> return this;<a name="line.1093"></a> -<span class="sourceLineNo">1094</span> ClassMeta<?> cm = beanRegistry.getClassMeta(c);<a name="line.1094"></a> -<span class="sourceLineNo">1095</span> if (cm == null)<a name="line.1095"></a> -<span class="sourceLineNo">1096</span> return this;<a name="line.1096"></a> -<span class="sourceLineNo">1097</span> return cast2(cm);<a name="line.1097"></a> -<span class="sourceLineNo">1098</span> }<a name="line.1098"></a> -<span class="sourceLineNo">1099</span><a name="line.1099"></a> -<span class="sourceLineNo">1100</span> /**<a name="line.1100"></a> -<span class="sourceLineNo">1101</span> * Converts this map into an object of the specified type.<a name="line.1101"></a> -<span class="sourceLineNo">1102</span> * <p><a name="line.1102"></a> -<span class="sourceLineNo">1103</span> * The rules are the same as those specified in {@link #cast()}.<a name="line.1103"></a> -<span class="sourceLineNo">1104</span> * <p><a name="line.1104"></a> -<span class="sourceLineNo">1105</span> * If this map contains a <js>"_type"</js> entry, it must be the same as or a subclass<a name="line.1105"></a> -<span class="sourceLineNo">1106</span> * of the <code>type</code>.<a name="line.1106"></a> -<span class="sourceLineNo">1107</span> *<a name="line.1107"></a> -<span class="sourceLineNo">1108</span> * @param <T> The class type to convert this map object to.<a name="line.1108"></a> -<span class="sourceLineNo">1109</span> * @param type The class type to convert this map object to.<a name="line.1109"></a> -<span class="sourceLineNo">1110</span> * @return The new object.<a name="line.1110"></a> -<span class="sourceLineNo">1111</span> * @throws ClassCastException If the <js>"_type"</js> entry is present and not assignable<a name="line.1111"></a> -<span class="sourceLineNo">1112</span> * from <code>type</code><a name="line.1112"></a> -<span class="sourceLineNo">1113</span> */<a name="line.1113"></a> -<span class="sourceLineNo">1114</span> @SuppressWarnings("unchecked")<a name="line.1114"></a> -<span class="sourceLineNo">1115</span> public <T> T cast(Class<T> type) {<a name="line.1115"></a> -<span class="sourceLineNo">1116</span> ClassMeta<?> c1 = session.getBeanRegistry().getClassMeta((String)get(session.getBeanTypePropertyName()));<a name="line.1116"></a> -<span class="sourceLineNo">1117</span> ClassMeta<?> c2 = session.getClassMeta(type);<a name="line.1117"></a> -<span class="sourceLineNo">1118</span> ClassMeta<?> c = narrowClassMeta(c1, c2);<a name="line.1118"></a> -<span class="sourceLineNo">1119</span> return (T)cast2(c);<a name="line.1119"></a> -<span class="sourceLineNo">1120</span> }<a name="line.1120"></a> -<span class="sourceLineNo">1121</span><a name="line.1121"></a> -<span class="sourceLineNo">1122</span> /**<a name="line.1122"></a> -<span class="sourceLineNo">1123</span> * Same as {@link #cast(Class)}, except allows you to specify a {@link ClassMeta} parameter.<a name="line.1123"></a> -<span class="sourceLineNo">1124</span> *<a name="line.1124"></a> -<span class="sourceLineNo">1125</span> * @param <T> The class type to convert this map object to.<a name="line.1125"></a> -<span class="sourceLineNo">1126</span> * @param cm The class type to convert this map object to.<a name="line.1126"></a> -<span class="sourceLineNo">1127</span> * @return The new object.<a name="line.1127"></a> -<span class="sourceLineNo">1128</span> * @throws ClassCastException If the <js>"_type"</js> entry is present and not assignable<a name="line.1128"></a> -<span class="sourceLineNo">1129</span> * from <code>type</code><a name="line.1129"></a> -<span class="sourceLineNo">1130</span> */<a name="line.1130"></a> -<span class="sourceLineNo">1131</span> @SuppressWarnings({"unchecked"})<a name="line.1131"></a> -<span class="sourceLineNo">1132</span> public <T> T cast(ClassMeta<T> cm) {<a name="line.1132"></a> -<span class="sourceLineNo">1133</span> ClassMeta<?> c1 = session.getBeanRegistry().getClassMeta((String)get(session.getBeanTypePropertyName()));<a name="line.1133"></a> -<span class="sourceLineNo">1134</span> ClassMeta<?> c = narrowClassMeta(c1, cm);<a name="line.1134"></a> -<span class="sourceLineNo">1135</span> return (T)cast2(c);<a name="line.1135"></a> -<span class="sourceLineNo">1136</span> }<a name="line.1136"></a> -<span class="sourceLineNo">1137</span><a name="line.1137"></a> -<span class="sourceLineNo">1138</span> /*<a name="line.1138"></a> -<span class="sourceLineNo">1139</span> * Combines the class specified by a "_type" attribute with the ClassMeta<a name="line.1139"></a> -<span class="sourceLineNo">1140</span> * passed in through the cast(ClassMeta) method.<a name="line.1140"></a> -<span class="sourceLineNo">1141</span> * The rule is that child classes superceed parent classes, and c2 superceeds c1<a name="line.1141"></a> -<span class="sourceLineNo">1142</span> * if one isn't the parent of another.<a name="line.1142"></a> -<span class="sourceLineNo">1143</span> */<a name="line.1143"></a> -<span class="sourceLineNo">1144</span> private ClassMeta<?> narrowClassMeta(ClassMeta<?> c1, ClassMeta<?> c2) {<a name="line.1144"></a> -<span class="sourceLineNo">1145</span> if (c1 == null)<a name="line.1145"></a> -<span class="sourceLineNo">1146</span> return c2;<a name="line.1146"></a> -<span class="sourceLineNo">1147</span> ClassMeta<?> c = getNarrowedClassMeta(c1, c2);<a name="line.1147"></a> -<span class="sourceLineNo">1148</span> if (c1.isMap()) {<a name="line.1148"></a> -<span class="sourceLineNo">1149</span> ClassMeta<?> k = getNarrowedClassMeta(c1.getKeyType(), c2.getKeyType());<a name="line.1149"></a> -<span class="sourceLineNo">1150</span> ClassMeta<?> v = getNarrowedClassMeta(c1.getValueType(), c2.getValueType());<a name="line.1150"></a> -<span class="sourceLineNo">1151</span> return session.getClassMeta(c.getInnerClass(), k, v);<a name="line.1151"></a> -<span class="sourceLineNo">1152</span> }<a name="line.1152"></a> -<span class="sourceLineNo">1153</span> if (c1.isCollection()) {<a name="line.1153"></a> -<span class="sourceLineNo">1154</span> ClassMeta<?> e = getNarrowedClassMeta(c1.getElementType(), c2.getElementType());<a name="line.1154"></a> -<span class="sourceLineNo">1155</span> return session.getClassMeta(c.getInnerClass(), e);<a name="line.1155"></a> -<span class="sourceLineNo">1156</span> }<a name="line.1156"></a> -<span class="sourceLineNo">1157</span> return c;<a name="line.1157"></a> -<span class="sourceLineNo">1158</span> }<a name="line.1158"></a> -<span class="sourceLineNo">1159</span><a name="line.1159"></a> -<span class="sourceLineNo">1160</span> /*<a name="line.1160"></a> -<span class="sourceLineNo">1161</span> * If c1 is a child of c2 or the same as c2, returns c1.<a name="line.1161"></a> -<span class="sourceLineNo">1162</span> * Otherwise, returns c2.<a name="line.1162"></a> -<span class="sourceLineNo">1163</span> */<a name="line.1163"></a> -<span class="sourceLineNo">1164</span> private static ClassMeta<?> getNarrowedClassMeta(ClassMeta<?> c1, ClassMeta<?> c2) {<a name="line.1164"></a> -<span class="sourceLineNo">1165</span> if (isParentClass(c2.getInnerClass(), c1.getInnerClass()))<a name="line.1165"></a> -<span class="sourceLineNo">1166</span> return c1;<a name="line.1166"></a> -<span class="sourceLineNo">1167</span> return c2;<a name="line.1167"></a> -<span class="sourceLineNo">1168</span> }<a name="line.1168"></a> -<span class="sourceLineNo">1169</span><a name="line.1169"></a> -<span class="sourceLineNo">1170</span> /*<a name="line.1170"></a> -<span class="sourceLineNo">1171</span> * Converts this map to the specified class type.<a name="line.1171"></a> -<span class="sourceLineNo">1172</span> */<a name="line.1172"></a> -<span class="sourceLineNo">1173</span> @SuppressWarnings({"unchecked","rawtypes"})<a name="line.1173"></a> -<span class="sourceLineNo">1174</span> private <T> T cast2(ClassMeta<T> cm) {<a name="line.1174"></a> -<span class="sourceLineNo">1175</span><a name="line.1175"></a> -<span class="sourceLineNo">1176</span> try {<a name="line.1176"></a> -<span class="sourceLineNo">1177</span> Object value = get("value");<a name="line.1177"></a> -<span class="sourceLineNo">1178</span><a name="line.1178"></a> -<span class="sourceLineNo">1179</span> if (cm.isMap()) {<a name="line.1179"></a> -<span class="sourceLineNo">1180</span> Map m2 = (cm.canCreateNewInstance() ? (Map)cm.newInstance() : new ObjectMap(session));<a name="line.1180"></a> -<span class="sourceLineNo">1181</span> ClassMeta<?> kType = cm.getKeyType(), vType = cm.getValueType();<a name="line.1181"></a> -<span class="sourceLineNo">1182</span> for (Map.Entry<String,Object> e : entrySet()) {<a name="line.1182"></a> -<span class="sourceLineNo">1183</span> Object k = e.getKey();<a name="line.1183"></a> -<span class="sourceLineNo">1184</span> Object v = e.getValue();<a name="line.1184"></a> -<span class="sourceLineNo">1185</span> if (! k.equals(session.getBeanTypePropertyName())) {<a name="line.1185"></a> -<span class="sourceLineNo">1186</span><a name="line.1186"></a> -<span class="sourceLineNo">1187</span> // Attempt to recursively cast child maps.<a name="line.1187"></a> -<span class="sourceLineNo">1188</span> if (v instanceof ObjectMap)<a name="line.1188"></a> -<span class="sourceLineNo">1189</span> v = ((ObjectMap)v).cast(session.getBeanRegistry());<a name="line.1189"></a> -<span class="sourceLineNo">1190</span><a name="line.1190"></a> -<span class="sourceLineNo">1191</span> k = (kType.isString() ? k : session.convertToType(k, kType));<a name="line.1191"></a> -<span class="sourceLineNo">1192</span> v = (vType.isObject() ? v : session.convertToType(v, vType));<a name="line.1192"></a> +<span class="sourceLineNo">1074</span> * If this map contains a <js>"_type"</js> entry, it must be the same as or a subclass<a name="line.1074"></a> +<span class="sourceLineNo">1075</span> * of the <code>type</code>.<a name="line.1075"></a> +<span class="sourceLineNo">1076</span> *<a name="line.1076"></a> +<span class="sourceLineNo">1077</span> * @param <T> The class type to convert this map object to.<a name="line.1077"></a> +<span class="sourceLineNo">1078</span> * @param type The class type to convert this map object to.<a name="line.1078"></a> +<span class="sourceLineNo">1079</span> * @return The new object.<a name="line.1079"></a> +<span class="sourceLineNo">1080</span> * @throws ClassCastException If the <js>"_type"</js> entry is present and not assignable<a name="line.1080"></a> +<span class="sourceLineNo">1081</span> * from <code>type</code><a name="line.1081"></a> +<span class="sourceLineNo">1082</span> */<a name="line.1082"></a> +<span class="sourceLineNo">1083</span> @SuppressWarnings("unchecked")<a name="line.1083"></a> +<span class="sourceLineNo">1084</span> public <T> T cast(Class<T> type) {<a name="line.1084"></a> +<span class="sourceLineNo">1085</span> ClassMeta<?> c2 = session.getClassMeta(type);<a name="line.1085"></a> +<span class="sourceLineNo">1086</span> String typePropertyName = session.getBeanTypePropertyName(c2);<a name="line.1086"></a> +<span class="sourceLineNo">1087</span> ClassMeta<?> c1 = session.getBeanRegistry().getClassMeta((String)get(typePropertyName));<a name="line.1087"></a> +<span class="sourceLineNo">1088</span> ClassMeta<?> c = c1 == null ? c2 : narrowClassMeta(c1, c2);<a name="line.1088"></a> +<span class="sourceLineNo">1089</span> if (c.isObject())<a name="line.1089"></a> +<span class="sourceLineNo">1090</span> return (T)this;<a name="line.1090"></a> +<span class="sourceLineNo">1091</span> return (T)cast2(c);<a name="line.1091"></a> +<span class="sourceLineNo">1092</span> }<a name="line.1092"></a> +<span class="sourceLineNo">1093</span><a name="line.1093"></a> +<span class="sourceLineNo">1094</span> /**<a name="line.1094"></a> +<span class="sourceLineNo">1095</span> * Same as {@link #cast(Class)}, except allows you to specify a {@link ClassMeta} parameter.<a name="line.1095"></a> +<span class="sourceLineNo">1096</span> *<a name="line.1096"></a> +<span class="sourceLineNo">1097</span> * @param <T> The class type to convert this map object to.<a name="line.1097"></a> +<span class="sourceLineNo">1098</span> * @param cm The class type to convert this map object to.<a name="line.1098"></a> +<span class="sourceLineNo">1099</span> * @return The new object.<a name="line.1099"></a> +<span class="sourceLineNo">1100</span> * @throws ClassCastException If the <js>"_type"</js> entry is present and not assignable<a name="line.1100"></a> +<span class="sourceLineNo">1101</span> * from <code>type</code><a name="line.1101"></a> +<span class="sourceLineNo">1102</span> */<a name="line.1102"></a> +<span class="sourceLineNo">1103</span> @SuppressWarnings({"unchecked"})<a name="line.1103"></a> +<span class="sourceLineNo">1104</span> public <T> T cast(ClassMeta<T> cm) {<a name="line.1104"></a> +<span class="sourceLineNo">1105</span> ClassMeta<?> c1 = session.getBeanRegistry().getClassMeta((String)get(session.getBeanTypePropertyName(cm)));<a name="line.1105"></a> +<span class="sourceLineNo">1106</span> ClassMeta<?> c = narrowClassMeta(c1, cm);<a name="line.1106"></a> +<span class="sourceLineNo">1107</span> return (T)cast2(c);<a name="line.1107"></a> +<span class="sourceLineNo">1108</span> }<a name="line.1108"></a> +<span class="sourceLineNo">1109</span><a name="line.1109"></a> +<span class="sourceLineNo">1110</span> /*<a name="line.1110"></a> +<span class="sourceLineNo">1111</span> * Combines the class specified by a "_type" attribute with the ClassMeta<a name="line.1111"></a> +<span class="sourceLineNo">1112</span> * passed in through the cast(ClassMeta) method.<a name="line.1112"></a> +<span class="sourceLineNo">1113</span> * The rule is that child classes superceed parent classes, and c2 superceeds c1<a name="line.1113"></a> +<span class="sourceLineNo">1114</span> * if one isn't the parent of another.<a name="line.1114"></a> +<span class="sourceLineNo">1115</span> */<a name="line.1115"></a> +<span class="sourceLineNo">1116</span> private ClassMeta<?> narrowClassMeta(ClassMeta<?> c1, ClassMeta<?> c2) {<a name="line.1116"></a> +<span class="sourceLineNo">1117</span> if (c1 == null)<a name="line.1117"></a> +<span class="sourceLineNo">1118</span> return c2;<a name="line.1118"></a> +<span class="sourceLineNo">1119</span> ClassMeta<?> c = getNarrowedClassMeta(c1, c2);<a name="line.1119"></a> +<span class="sourceLineNo">1120</span> if (c1.isMap()) {<a name="line.1120"></a> +<span class="sourceLineNo">1121</span> ClassMeta<?> k = getNarrowedClassMeta(c1.getKeyType(), c2.getKeyType());<a name="line.1121"></a> +<span class="sourceLineNo">1122</span> ClassMeta<?> v = getNarrowedClassMeta(c1.getValueType(), c2.getValueType());<a name="line.1122"></a> +<span class="sourceLineNo">1123</span> return session.getClassMeta(c.getInnerClass(), k, v);<a name="line.1123"></a> +<span class="sourceLineNo">1124</span> }<a name="line.1124"></a> +<span class="sourceLineNo">1125</span> if (c1.isCollection()) {<a name="line.1125"></a> +<span class="sourceLineNo">1126</span> ClassMeta<?> e = getNarrowedClassMeta(c1.getElementType(), c2.getElementType());<a name="line.1126"></a> +<span class="sourceLineNo">1127</span> return session.getClassMeta(c.getInnerClass(), e);<a name="line.1127"></a> +<span class="sourceLineNo">1128</span> }<a name="line.1128"></a> +<span class="sourceLineNo">1129</span> return c;<a name="line.1129"></a> +<span class="sourceLineNo">1130</span> }<a name="line.1130"></a> +<span class="sourceLineNo">1131</span><a name="line.1131"></a> +<span class="sourceLineNo">1132</span> /*<a name="line.1132"></a> +<span class="sourceLineNo">1133</span> * If c1 is a child of c2 or the same as c2, returns c1.<a name="line.1133"></a> +<span class="sourceLineNo">1134</span> * Otherwise, returns c2.<a name="line.1134"></a> +<span class="sourceLineNo">1135</span> */<a name="line.1135"></a> +<span class="sourceLineNo">1136</span> private static ClassMeta<?> getNarrowedClassMeta(ClassMeta<?> c1, ClassMeta<?> c2) {<a name="line.1136"></a> +<span class="sourceLineNo">1137</span> if (c2 == null || isParentClass(c2.getInnerClass(), c1.getInnerClass()))<a name="line.1137"></a> +<span class="sourceLineNo">1138</span> return c1;<a name="line.1138"></a> +<span class="sourceLineNo">1139</span> return c2;<a name="line.1139"></a> +<span class="sourceLineNo">1140</span> }<a name="line.1140"></a> +<span class="sourceLineNo">1141</span><a name="line.1141"></a> +<span class="sourceLineNo">1142</span> /*<a name="line.1142"></a> +<span class="sourceLineNo">1143</span> * Converts this map to the specified class type.<a name="line.1143"></a> +<span class="sourceLineNo">1144</span> */<a name="line.1144"></a> +<span class="sourceLineNo">1145</span> @SuppressWarnings({"unchecked","rawtypes"})<a name="line.1145"></a> +<span class="sourceLineNo">1146</span> private <T> T cast2(ClassMeta<T> cm) {<a name="line.1146"></a> +<span class="sourceLineNo">1147</span><a name="line.1147"></a> +<span class="sourceLineNo">1148</span> try {<a name="line.1148"></a> +<span class="sourceLineNo">1149</span> Object value = get("value");<a name="line.1149"></a> +<span class="sourceLineNo">1150</span><a name="line.1150"></a> +<span class="sourceLineNo">1151</span> if (cm.isMap()) {<a name="line.1151"></a> +<span class="sourceLineNo">1152</span> Map m2 = (cm.canCreateNewInstance() ? (Map)cm.newInstance() : new ObjectMap(session));<a name="line.1152"></a> +<span class="sourceLineNo">1153</span> ClassMeta<?> kType = cm.getKeyType(), vType = cm.getValueType();<a name="line.1153"></a> +<span class="sourceLineNo">1154</span> for (Map.Entry<String,Object> e : entrySet()) {<a name="line.1154"></a> +<span class="sourceLineNo">1155</span> Object k = e.getKey();<a name="line.1155"></a> +<span class="sourceLineNo">1156</span> Object v = e.getValue();<a name="line.1156"></a> +<span class="sourceLineNo">1157</span> if (! k.equals(session.getBeanTypePropertyName(cm))) {<a name="line.1157"></a> +<span class="sourceLineNo">1158</span><a name="line.1158"></a> +<span class="sourceLineNo">1159</span> // Attempt to recursively cast child maps.<a name="line.1159"></a> +<span class="sourceLineNo">1160</span> if (v instanceof ObjectMap)<a name="line.1160"></a> +<span class="sourceLineNo">1161</span> v = ((ObjectMap)v).cast(vType);<a name="line.1161"></a> +<span class="sourceLineNo">1162</span><a name="line.1162"></a> +<span class="sourceLineNo">1163</span> k = (kType.isString() ? k : session.convertToType(k, kType));<a name="line.1163"></a> +<span class="sourceLineNo">1164</span> v = (vType.isObject() ? v : session.convertToType(v, vType));<a name="line.1164"></a> +<span class="sourceLineNo">1165</span><a name="line.1165"></a> +<span class="sourceLineNo">1166</span> m2.put(k, v);<a name="line.1166"></a> +<span class="sourceLineNo">1167</span> }<a name="line.1167"></a> +<span class="sourceLineNo">1168</span> }<a name="line.1168"></a> +<span class="sourceLineNo">1169</span> return (T)m2;<a name="line.1169"></a> +<span class="sourceLineNo">1170</span><a name="line.1170"></a> +<span class="sourceLineNo">1171</span> } else if (cm.isBean()) {<a name="line.1171"></a> +<span class="sourceLineNo">1172</span> BeanMap<? extends T> bm = session.newBeanMap(cm.getInnerClass());<a name="line.1172"></a> +<span class="sourceLineNo">1173</span><a name="line.1173"></a> +<span class="sourceLineNo">1174</span> // Iterate through all the entries in the map and set the individual field values.<a name="line.1174"></a> +<span class="sourceLineNo">1175</span> for (Map.Entry<String,Object> e : entrySet()) {<a name="line.1175"></a> +<span class="sourceLineNo">1176</span> String k = e.getKey();<a name="line.1176"></a> +<span class="sourceLineNo">1177</span> Object v = e.getValue();<a name="line.1177"></a> +<span class="sourceLineNo">1178</span> if (! k.equals(session.getBeanTypePropertyName(cm))) {<a name="line.1178"></a> +<span class="sourceLineNo">1179</span><a name="line.1179"></a> +<span class="sourceLineNo">1180</span> // Attempt to recursively cast child maps.<a name="line.1180"></a> +<span class="sourceLineNo">1181</span> if (v instanceof ObjectMap)<a name="line.1181"></a> +<span class="sourceLineNo">1182</span> v = ((ObjectMap)v).cast(bm.getProperty(k).getMeta().getClassMeta());<a name="line.1182"></a> +<span class="sourceLineNo">1183</span><a name="line.1183"></a> +<span class="sourceLineNo">1184</span> bm.put(k, v);<a name="line.1184"></a> +<span class="sourceLineNo">1185</span> }<a name="line.1185"></a> +<span class="sourceLineNo">1186</span> }<a name="line.1186"></a> +<span class="sourceLineNo">1187</span><a name="line.1187"></a> +<span class="sourceLineNo">1188</span> return bm.getBean();<a name="line.1188"></a> +<span class="sourceLineNo">1189</span><a name="line.1189"></a> +<span class="sourceLineNo">1190</span> } else if (cm.isCollectionOrArray()) {<a name="line.1190"></a> +<span class="sourceLineNo">1191</span> List items = (List)get("items");<a name="line.1191"></a> +<span class="sourceLineNo">1192</span> return session.convertToType(items, cm);<a name="line.1192"></a> <span class="sourceLineNo">1193</span><a name="line.1193"></a> -<span class="sourceLineNo">1194</span> m2.put(k, v);<a name="line.1194"></a> -<span class="sourceLineNo">1195</span> }<a name="line.1195"></a> -<span class="sourceLineNo">1196</span> }<a name="line.1196"></a> -<span class="sourceLineNo">1197</span> return (T)m2;<a name="line.1197"></a> -<span class="sourceLineNo">1198</span><a name="line.1198"></a> -<span class="sourceLineNo">1199</span> } else if (cm.isBean()) {<a name="line.1199"></a> -<span class="sourceLineNo">1200</span> BeanMap<? extends T> bm = session.newBeanMap(cm.getInnerClass());<a name="line.1200"></a> +<span class="sourceLineNo">1194</span> } else if (value != null) {<a name="line.1194"></a> +<span class="sourceLineNo">1195</span> return session.convertToType(value, cm);<a name="line.1195"></a> +<span class="sourceLineNo">1196</span> }<a name="line.1196"></a> +<span class="sourceLineNo">1197</span><a name="line.1197"></a> +<span class="sourceLineNo">1198</span> } catch (Exception e) {<a name="line.1198"></a> +<span class="sourceLineNo">1199</span> throw new BeanRuntimeException(cm.innerClass, "Error occurred attempting to cast to an object of type ''{0}''", cm.innerClass.getName()).initCause(e);<a name="line.1199"></a> +<span class="sourceLineNo">1200</span> }<a name="line.1200"></a> <span class="sourceLineNo">1201</span><a name="line.1201"></a> -<span class="sourceLineNo">1202</span> // Iterate through all the entries in the map and set the individual field values.<a name="line.1202"></a> -<span class="sourceLineNo">1203</span> for (Map.Entry<String,Object> e : entrySet()) {<a name="line.1203"></a> -<span class="sourceLineNo">1204</span> String k = e.getKey();<a name="line.1204"></a> -<span class="sourceLineNo">1205</span> Object v = e.getValue();<a name="line.1205"></a> -<span class="sourceLineNo">1206</span> if (! k.equals(session.getBeanTypePropertyName())) {<a name="line.1206"></a> -<span class="sourceLineNo">1207</span><a name="line.1207"></a> -<span class="sourceLineNo">1208</span> // Attempt to recursively cast child maps.<a name="line.1208"></a> -<span class="sourceLineNo">1209</span> if (v instanceof ObjectMap)<a name="line.1209"></a> -<span class="sourceLineNo">1210</span> v = ((ObjectMap)v).cast(session.getBeanRegistry());<a name="line.1210"></a> -<span class="sourceLineNo">1211</span><a name="line.1211"></a> -<span class="sourceLineNo">1212</span> bm.put(k, v);<a name="line.1212"></a> -<span class="sourceLineNo">1213</span> }<a name="line.1213"></a> -<span class="sourceLineNo">1214</span> }<a name="line.1214"></a> -<span class="sourceLineNo">1215</span><a name="line.1215"></a> -<span class="sourceLineNo">1216</span> return bm.getBean();<a name="line.1216"></a> -<span class="sourceLineNo">1217</span><a name="line.1217"></a> -<span class="sourceLineNo">1218</span> } else if (cm.isCollectionOrArray()) {<a name="line.1218"></a> -<span class="sourceLineNo">1219</span> List items = (List)get("items");<a name="line.1219"></a> -<span class="sourceLineNo">1220</span> return session.convertToType(items, cm);<a name="line.1220"></a> +<span class="sourceLineNo">1202</span> throw new BeanRuntimeException(cm.innerClass, "Cannot convert to class type ''{0}''. Only beans and maps can be converted using this method.", cm.innerClass.getName());<a name="line.1202"></a> +<span class="sourceLineNo">1203</span> }<a name="line.1203"></a> +<span class="sourceLineNo">1204</span><a name="line.1204"></a> +<span class="sourceLineNo">1205</span> private PojoRest getPojoRest() {<a name="line.1205"></a> +<span class="sourceLineNo">1206</span> if (pojoRest == null)<a name="line.1206"></a> +<span class="sourceLineNo">1207</span> pojoRest = new PojoRest(this);<a name="line.1207"></a> +<span class="sourceLineNo">1208</span> return pojoRest;<a name="line.1208"></a> +<span class="sourceLineNo">1209</span> }<a name="line.1209"></a> +<span class="sourceLineNo">1210</span><a name="line.1210"></a> +<span class="sourceLineNo">1211</span> /**<a name="line.1211"></a> +<span class="sourceLineNo">1212</span> * Serialize this object into a string using the specified serializer.<a name="line.1212"></a> +<span class="sourceLineNo">1213</span> *<a name="line.1213"></a> +<span class="sourceLineNo">1214</span> * @param serializer The serializer to use to convert this object to a string.<a name="line.1214"></a> +<span class="sourceLineNo">1215</span> * @return This object serialized as a string.<a name="line.1215"></a> +<span class="sourceLineNo">1216</span> * @throws SerializeException If a problem occurred trying to convert the output.<a name="line.1216"></a> +<span class="sourceLineNo">1217</span> */<a name="line.1217"></a> +<span class="sourceLineNo">1218</span> public String toString(WriterSerializer serializer) throws SerializeException {<a name="line.1218"></a> +<span class="sourceLineNo">1219</span> return serializer.serialize(this);<a name="line.1219"></a> +<span class="sourceLineNo">1220</span> }<a name="line.1220"></a> <span class="sourceLineNo">1221</span><a name="line.1221"></a> -<span class="sourceLineNo">1222</span> } else if (value != null) {<a name="line.1222"></a> -<span class="sourceLineNo">1223</span> return session.convertToType(value, cm);<a name="line.1223"></a> -<span class="sourceLineNo">1224</span> }<a name="line.1224"></a> -<span class="sourceLineNo">1225</span><a name="line.1225"></a> -<span class="sourceLineNo">1226</span> } catch (Exception e) {<a name="line.1226"></a> -<span class="sourceLineNo">1227</span> throw new BeanRuntimeException(cm.innerClass, "Error occurred attempting to cast to an object of type ''{0}''", cm.innerClass.getName()).initCause(e);<a name="line.1227"></a> -<span class="sourceLineNo">1228</span> }<a name="line.1228"></a> -<span class="sourceLineNo">1229</span><a name="line.1229"></a> -<span class="sourceLineNo">1230</span> throw new BeanRuntimeException(cm.innerClass, "Cannot convert to class type ''{0}''. Only beans and maps can be converted using this method.", cm.innerClass.getName());<a name="line.1230"></a> -<span class="sourceLineNo">1231</span> }<a name="line.1231"></a> -<span class="sourceLineNo">1232</span><a name="line.1232"></a> -<span class="sourceLineNo">1233</span> private PojoRest getPojoRest() {<a name="line.1233"></a> -<span class="sourceLineNo">1234</span> if (pojoRest == null)<a name="line.1234"></a> -<span class="sourceLineNo">1235</span> pojoRest = new PojoRest(this);<a name="line.1235"></a> -<span class="sourceLineNo">1236</span> return pojoRest;<a name="line.1236"></a> -<span class="sourceLineNo">1237</span> }<a name="line.1237"></a> -<span class="sourceLineNo">1238</span><a name="line.1238"></a> -<span class="sourceLineNo">1239</span> /**<a name="line.1239"></a> -<span class="sourceLineNo">1240</span> * Serialize this object into a string using the specified serializer.<a name="line.1240"></a> -<span class="sourceLineNo">1241</span> *<a name="line.1241"></a> -<span class="sourceLineNo">1242</span> * @param serializer The serializer to use to convert this object to a string.<a name="line.1242"></a> -<span class="sourceLineNo">1243</span> * @return This object serialized as a string.<a name="line.1243"></a> -<span class="sourceLineNo">1244</span> * @throws SerializeException If a problem occurred trying to convert the output.<a name="line.1244"></a> -<span class="sourceLineNo">1245</span> */<a name="line.1245"></a> -<span class="sourceLineNo">1246</span> public String toString(WriterSerializer serializer) throws SerializeException {<a name="line.1246"></a> -<span class="sourceLineNo">1247</span> return serializer.serialize(this);<a name="line.1247"></a> -<span class="sourceLineNo">1248</span> }<a name="line.1248"></a> -<span class="sourceLineNo">1249</span><a name="line.1249"></a> -<span class="sourceLineNo">1250</span> /**<a name="line.1250"></a> -<span class="sourceLineNo">1251</span> * Serialize this object into a JSON string using the {@link JsonSerializer#DEFAULT} serializer.<a name="line.1251"></a> -<span class="sourceLineNo">1252</span> */<a name="line.1252"></a> -<span class="sourceLineNo">1253</span> @Override /* Object */<a name="line.1253"></a> -<span class="sourceLineNo">1254</span> public String toString() {<a name="line.1254"></a> -<span class="sourceLineNo">1255</span> try {<a name="line.1255"></a> -<span class="sourceLineNo">1256</span> return this.toString(JsonSerializer.DEFAULT_LAX);<a name="line.1256"></a> -<span class="sourceLineNo">1257</span> } catch (SerializeException e) {<a name="line.1257"></a> -<span class="sourceLineNo">1258</span> return e.getLocalizedMessage();<a name="line.1258"></a> -<span class="sourceLineNo">1259</span> }<a name="line.1259"></a> -<span class="sourceLineNo">1260</span> }<a name="line.1260"></a> -<span class="sourceLineNo">1261</span><a name="line.1261"></a> -<span class="sourceLineNo">1262</span> /**<a name="line.1262"></a> -<span class="sourceLineNo">1263</span> * Convenience method for serializing this map to the specified <code>Writer</code> using<a name="line.1263"></a> -<span class="sourceLineNo">1264</span> * the {@link JsonSerializer#DEFAULT} serializer.<a name="line.1264"></a> -<span class="sourceLineNo">1265</span> *<a name="line.1265"></a> -<span class="sourceLineNo">1266</span> * @param w The writer to serialize this object to.<a name="line.1266"></a> -<span class="sourceLineNo">1267</span> * @return This object (for method chaining).<a name="line.1267"></a> -<span class="sourceLineNo">1268</span> * @throws IOException If a problem occurred trying to write to the writer.<a name="line.1268"></a> -<span class="sourceLineNo">1269</span> * @throws SerializeException If a problem occurred trying to convert the output.<a name="line.1269"></a> -<span class="sourceLineNo">1270</span> */<a name="line.1270"></a> -<span class="sourceLineNo">1271</span> public ObjectMap serializeTo(Writer w) throws IOException, SerializeException {<a name="line.1271"></a> -<span class="sourceLineNo">1272</span> JsonSerializer.DEFAULT.serialize(this);<a name="line.1272"></a> -<span class="sourceLineNo">1273</span> return this;<a name="line.1273"></a> -<span class="sourceLineNo">1274</span> }<a name="line.1274"></a> -<span class="sourceLineNo">1275</span><a name="line.1275"></a> -<span class="sourceLineNo">1276</span> @Override /* Map */<a name="line.1276"></a> -<span class="sourceLineNo">1277</span> public Set<String> keySet() {<a name="line.1277"></a> -<span class="sourceLineNo">1278</span> if (inner == null)<a name="line.1278"></a> -<span class="sourceLineNo">1279</span> return super.keySet();<a name="line.1279"></a> -<span class="sourceLineNo">1280</span> LinkedHashSet<String> s = new LinkedHashSet<String>();<a name="line.1280"></a> -<span class="sourceLineNo">1281</span> s.addAll(inner.keySet());<a name="line.1281"></a> -<span class="sourceLineNo">1282</span> s.addAll(super.keySet());<a name="line.1282"></a> -<span class="sourceLineNo">1283</span> return s;<a name="line.1283"></a> -<span class="sourceLineNo">1284</span> }<a name="line.1284"></a> -<span class="sourceLineNo">1285</span><a name="line.1285"></a> -<span class="sourceLineNo">1286</span> @Override /* Map */<a name="line.1286"></a> -<span class="sourceLineNo">1287</span> public Set<Map.Entry<String,Object>> entrySet() {<a name="line.1287"></a> -<span class="sourceLineNo">1288</span> if (inner == null)<a name="line.1288"></a> -<span class="sourceLineNo">1289</span> return super.entrySet();<a name="line.1289"></a> -<span class="sourceLineNo">1290</span><a name="line.1290"></a> -<span class="sourceLineNo">1291</span> final Set<String> keySet = keySet();<a name="line.1291"></a> -<span class="sourceLineNo">1292</span> final Iterator<String> keys = keySet.iterator();<a name="line.1292"></a> -<span class="sourceLineNo">1293</span><a name="line.1293"></a> -<span class="sourceLineNo">1294</span> return new AbstractSet<Map.Entry<String,Object>>() {<a name="line.1294"></a> -<span class="sourceLineNo">1295</span><a name="line.1295"></a> -<span class="sourceLineNo">1296</span> @Override /* Iterable */<a name="line.1296"></a> -<span class="sourceLineNo">1297</span> public Iterator<Map.Entry<String,Object>> iterator() {<a name="line.1297"></a> -<span class="sourceLineNo">1298</span><a name="line.1298"></a> -<span class="sourceLineNo">1299</span> return new Iterator<Map.Entry<String,Object>>() {<a name="line.1299"></a> -<span class="sourceLineNo">1300</span><a name="line.1300"></a> -<span class="sourceLineNo">1301</span> @Override /* Iterator */<a name="line.1301"></a> -<span class="sourceLineNo">1302</span> public boolean hasNext() {<a name="line.1302"></a> -<span class="sourceLineNo">1303</span> return keys.hasNext();<a name="line.1303"></a> -<span class="sourceLineNo">1304</span> }<a name="line.1304"></a> -<span class="sourceLineNo">1305</span><a name="line.1305"></a> -<span class="sourceLineNo">1306</span> @Override /* Iterator */<a name="line.1306"></a> -<span class="sourceLineNo">1307</span> public Map.Entry<String,Object> next() {<a name="line.1307"></a> -<span class="sourceLineNo">1308</span> return new Map.Entry<String,Object>() {<a name="line.1308"></a> -<span class="sourceLineNo">1309</span> String key = keys.next();<a name="line.1309"></a> -<span class="sourceLineNo">1310</span><a name="line.1310"></a> -<span class="sourceLineNo">1311</span> @Override /* Map.Entry */<a name="line.1311"></a> -<span class="sourceLineNo">1312</span> public String getKey() {<a name="line.1312"></a> -<span class="sourceLineNo">1313</span> return key;<a name="line.1313"></a> -<span class="sourceLineNo">1314</span> }<a name="line.1314"></a> -<span class="sourceLineNo">1315</span><a name="line.1315"></a> -<span class="sourceLineNo">1316</span> @Override /* Map.Entry */<a name="line.1316"></a> -<span class="sourceLineNo">1317</span> public Object getValue() {<a name="line.1317"></a> -<span class="sourceLineNo">1318</span> return get(key);<a name="line.1318"></a> -<span class="sourceLineNo">1319</span> }<a name="line.1319"></a> -<span class="sourceLineNo">1320</span><a name="line.1320"></a> -<span class="sourceLineNo">1321</span> @Override /* Map.Entry */<a name="line.1321"></a> -<span class="sourceLineNo">1322</span> public Object setValue(Object object) {<a name="line.1322"></a> -<span class="sourceLineNo">1323</span> return put(key, object);<a name="line.1323"></a> -<span class="sourceLineNo">1324</span> }<a name="line.1324"></a> -<span class="sourceLineNo">1325</span> };<a name="line.1325"></a> -<span class="sourceLineNo">1326</span> }<a name="line.1326"></a> -<span class="sourceLineNo">1327</span><a name="line.1327"></a> -<span class="sourceLineNo">1328</span> @Override /* Iterator */<a name="line.1328"></a> -<span class="sourceLineNo">1329</span> public void remove() {<a name="line.1329"></a> -<span class="sourceLineNo">1330</span> throw new UnsupportedOperationException();<a name="line.1330"></a> -<span class="sourceLineNo">1331</span> }<a name="line.1331"></a> -<span class="sourceLineNo">1332</span> };<a name="line.1332"></a> -<span class="sourceLineNo">1333</span> }<a name="line.1333"></a> -<span class="sourceLineNo">1334</span><a name="line.1334"></a> -<span class="sourceLineNo">1335</span> @Override /* Set */<a name="line.1335"></a> -<span class="sourceLineNo">1336</span> public int size() {<a name="line.1336"></a> -<span class="sourceLineNo">1337</span> return keySet.size();<a name="line.1337"></a> -<span class="sourceLineNo">1338</span> }<a name="line.1338"></a> -<span class="sourceLineNo">1339</span> };<a name="line.1339"></a> -<span class="sourceLineNo">1340</span> }<a name="line.1340"></a> -<span class="sourceLineNo">1341</span>}<a name="line.1341"></a> +<span class="sourceLineNo">1222</span> /**<a name="line.1222"></a> +<span class="sourceLineNo">1223</span> * Serialize this object into a JSON string using the {@link JsonSerializer#DEFAULT} serializer.<a name="line.1223"></a> +<span class="sourceLineNo">1224</span> */<a name="line.1224"></a> +<span class="sourceLineNo">1225</span> @Override /* Object */<a name="line.1225"></a> +<span class="sourceLineNo">1226</span> public String toString() {<a name="line.1226"></a> +<span class="sourceLineNo">1227</span> try {<a name="line.1227"></a> +<span class="sourceLineNo">1228</span> return this.toString(JsonSerializer.DEFAULT_LAX);<a name="line.1228"></a> +<span class="sourceLineNo">1229</span> } catch (SerializeException e) {<a name="line.1229"></a> +<span class="sourceLineNo">1230</span> return e.getLocalizedMessage();<a name="line.1230"></a> +<span class="sourceLineNo">1231</span> }<a name="line.1231"></a> +<span class="sourceLineNo">1232</span> }<a name="line.1232"></a> +<span class="sourceLineNo">1233</span><a name="line.1233"></a> +<span class="sourceLineNo">1234</span> /**<a name="line.1234"></a> +<span class="sourceLineNo">1235</span> * Convenience method for serializing this map to the specified <code>Writer</code> using<a name="line.1235"></a> +<span class="sourceLineNo">1236</span> * the {@link JsonSerializer#DEFAULT} serializer.<a name="line.1236"></a> +<span class="sourceLineNo">1237</span> *<a name="line.1237"></a> +<span class="sourceLineNo">1238</span> * @param w The writer to serialize this object to.<a name="line.1238"></a> +<span class="sourceLineNo">1239</span> * @return This object (for method chaining).<a name="line.1239"></a> +<span class="sourceLineNo">1240</span> * @throws IOException If a problem occurred trying to write to the writer.<a name="line.1240"></a> +<span class="sourceLineNo">1241</span> * @throws SerializeException If a problem occurred trying to convert the output.<a name="line.1241"></a> +<span class="sourceLineNo">1242</span> */<a name="line.1242"></a> +<span class="sourceLineNo">1243</span> public ObjectMap serializeTo(Writer w) throws IOException, SerializeException {<a name="line.1243"></a> +<span class="sourceLineNo">1244</span> JsonSerializer.DEFAULT.serialize(this);<a name="line.1244"></a> +<span class="sourceLineNo">1245</span> return this;<a name="line.1245"></a> +<span class="sourceLineNo">1246</span> }<a name="line.1246"></a> +<span class="sourceLineNo">1247</span><a name="line.1247"></a> +<span class="sourceLineNo">1248</span> @Override /* Map */<a name="line.1248"></a> +<span class="sourceLineNo">1249</span> public Set<String> keySet() {<a name="line.1249"></a> +<span class="sourceLineNo">1250</span> if (inner == null)<a name="line.1250"></a> +<span class="sourceLineNo">1251</span> return super.keySet();<a name="line.1251"></a> +<span class="sourceLineNo">1252</span> LinkedHashSet<String> s = new LinkedHashSet<String>();<a name="line.1252"></a> +<span class="sourceLineNo">1253</span> s.addAll(inner.keySet());<a name="line.1253"></a> +<span class="sourceLineNo">1254</span> s.addAll(super.keySet());<a name="line.1254"></a> +<span class="sourceLineNo">1255</span> return s;<a name="line.1255"></a> +<span class="sourceLineNo">1256</span> }<a name="line.1256"></a> +<span class="sourceLineNo">1257</span><a name="line.1257"></a> +<span class="sourceLineNo">1258</span> @Override /* Map */<a name="line.1258"></a> +<span class="sourceLineNo">1259</span> public Set<Map.Entry<String,Object>> entrySet() {<a name="line.1259"></a> +<span class="sourceLineNo">1260</span> if (inner == null)<a name="line.1260"></a> +<span class="sourceLineNo">1261</span> return super.entrySet();<a name="line.1261"></a> +<span class="sourceLineNo">1262</span><a name="line.1262"></a> +<span class="sourceLineNo">1263</span> final Set<String> keySet = keySet();<a name="line.1263"></a> +<span class="sourceLineNo">1264</span> final Iterator<String> keys = keySet.iterator();<a name="line.1264"></a> +<span class="sourceLineNo">1265</span><a name="line.1265"></a> +<span class="sourceLineNo">1266</span> return new AbstractSet<Map.Entry<String,Object>>() {<a name="line.1266"></a> +<span class="sourceLineNo">1267</span><a name="line.1267"></a> +<span class="sourceLineNo">1268</span> @Override /* Iterable */<a name="line.1268"></a> +<span class="sourceLineNo">1269</span> public Iterator<Map.Entry<String,Object>> iterator() {<a name="line.1269"></a> +<span class="sourceLineNo">1270</span><a name="line.1270"></a> +<span class="sourceLineNo">1271</span> return new Iterator<Map.Entry<String,Object>>() {<a name="line.1271"></a> +<span class="sourceLineNo">1272</span><a name="line.1272"></a> +<span class="sourceLineNo">1273</span> @Override /* Iterator */<a name="line.1273"></a> +<span class="sourceLineNo">1274</span> public boolean hasNext() {<a name="line.1274"></a> +<span class="sourceLineNo">1275</span> return keys.hasNext();<a name="line.1275"></a> +<span class="sourceLineNo">1276</span> }<a name="line.1276"></a> +<span class="sourceLineNo">1277</span><a name="line.1277"></a> +<span class="sourceLineNo">1278</span> @Override /* Iterator */<a name="line.1278"></a> +<span class="sourceLineNo">1279</span> public Map.Entry<String,Object> next() {<a name="line.1279"></a> +<span class="sourceLineNo">1280</span> return new Map.Entry<String,Object>() {<a name="line.1280"></a> +<span class="sourceLineNo">1281</span> String key = keys.next();<a name="line.1281"></a> +<span class="sourceLineNo">1282</span><a name="line.1282"></a> +<span class="sourceLineNo">1283</span> @Override /* Map.Entry */<a name="line.1283"></a> +<span class="sourceLineNo">1284</span> public String getKey() {<a name="line.1284"></a> +<span class="sourceLineNo">1285</span> return key;<a name="line.1285"></a> +<span class="sourceLineNo">1286</span> }<a name="line.1286"></a> +<span class="sourceLineNo">1287</span><a name="line.1287"></a> +<span class="sourceLineNo">1288</span> @Override /* Map.Entry */<a name="line.1288"></a> +<span class="sourceLineNo">1289</span> public Object getValue() {<a name="line.1289"></a> +<span class="sourceLineNo">1290</span> return get(key);<a name="line.1290"></a> +<span class="sourceLineNo">1291</span> }<a name="line.1291"></a> +<span class="sourceLineNo">1292</span><a name="line.1292"></a> +<span class="sourceLineNo">1293</span> @Override /* Map.Entry */<a name="line.1293"></a> +<span class="sourceLineNo">1294</span> public Object setValue(Object object) {<a name="line.1294"></a> +<span class="sourceLineNo">1295</span> return put(key, object);<a name="line.1295"></a> +<span class="sourceLineNo">1296</span> }<a name="line.1296"></a> +<span class="sourceLineNo">1297</span> };<a name="line.1297"></a> +<span class="sourceLineNo">1298</span> }<a name="line.1298"></a> +<span class="sourceLineNo">1299</span><a name="line.1299"></a> +<span class="sourceLineNo">1300</span> @Override /* Iterator */<a name="line.1300"></a> +<span class="sourceLineNo">1301</span> public void remove() {<a name="line.1301"></a> +<span class="sourceLineNo">1302</span> throw new UnsupportedOperationException();<a name="line.1302"></a> +<span class="sourceLineNo">1303</span> }<a name="line.1303"></a> +<span class="sourceLineNo">1304</span> };<a name="line.1304"></a> +<span class="sourceLineNo">1305</span> }<a name="line.1305"></a> +<span class="sourceLineNo">1306</span><a name="line.1306"></a> +<span class="sourceLineNo">1307</span> @Override /* Set */<a name="line.1307"></a> +<span class="sourceLineNo">1308</span> public int size() {<a name="line.1308"></a> +<span class="sourceLineNo">1309</span> return keySet.size();<a name="line.1309"></a> +<span class="sourceLineNo">1310</span> }<a name="line.1310"></a> +<span class="sourceLineNo">1311</span> };<a name="line.1311"></a> +<span class="sourceLineNo">1312</span> }<a name="line.1312"></a> +<span class="sourceLineNo">1313</span>}<a name="line.1313"></a>
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/3fcb8e91/content/site/apidocs/src-html/org/apache/juneau/annotation/Bean.html ---------------------------------------------------------------------- diff --git a/content/site/apidocs/src-html/org/apache/juneau/annotation/Bean.html b/content/site/apidocs/src-html/org/apache/juneau/annotation/Bean.html index cac74e6..6c9aeed 100644 --- a/content/site/apidocs/src-html/org/apache/juneau/annotation/Bean.html +++ b/content/site/apidocs/src-html/org/apache/juneau/annotation/Bean.html @@ -92,158 +92,192 @@ <span class="sourceLineNo">084</span> * {<a name="line.84"></a> <span class="sourceLineNo">085</span> * x: [<a name="line.85"></a> <span class="sourceLineNo">086</span> * {_type:<js>'bar'</js>},<a name="line.86"></a> -<span class="sourceLineNo">087</span> * {_type>:<js>'baz'</js>}<a name="line.87"></a> +<span class="sourceLineNo">087</span> * {_type:<js>'baz'</js>}<a name="line.87"></a> <span class="sourceLineNo">088</span> * ]<a name="line.88"></a> <span class="sourceLineNo">089</span> * }<a name="line.89"></a> <span class="sourceLineNo">090</span> * </p><a name="line.90"></a> <span class="sourceLineNo">091</span> */<a name="line.91"></a> <span class="sourceLineNo">092</span> String typeName() default "";<a name="line.92"></a> <span class="sourceLineNo">093</span><a name="line.93"></a> -<span class="sourceLineNo">094</span> /**<a name="line.94"></a> -<span class="sourceLineNo">095</span> * The set and order of names of properties associated with a bean class.<a name="line.95"></a> -<span class="sourceLineNo">096</span> * <p><a name="line.96"></a> -<span class="sourceLineNo">097</span> * The order specified is the same order that the entries will be returned by the {@link BeanMap#entrySet()} and related methods.<a name="line.97"></a> -<span class="sourceLineNo">098</span> * <p><a name="line.98"></a> -<span class="sourceLineNo">099</span> * This annotation is an alternative to using the {@link BeanFilter} class with an implemented {@link BeanFilter#getProperties()} method.<a name="line.99"></a> -<span class="sourceLineNo">100</span> *<a name="line.100"></a> -<span class="sourceLineNo">101</span> * <h5 class='section'>Example:</h5><a name="line.101"></a> -<span class="sourceLineNo">102</span> * <p class='bcode'><a name="line.102"></a> -<span class="sourceLineNo">103</span> * <jc>// Address class with only street/city/state properties (in that order).</jc><a name="line.103"></a> -<span class="sourceLineNo">104</span> * <jc>// All other properties are ignored.</jc><a name="line.104"></a> -<span class="sourceLineNo">105</span> * <ja>@Bean</ja>(properties=<js>"street,city,state"</js>)<a name="line.105"></a> -<span class="sourceLineNo">106</span> * <jk>public class</jk> Address {<a name="line.106"></a> -<span class="sourceLineNo">107</span> * ...<a name="line.107"></a> -<span class="sourceLineNo">108</span> * </p><a name="line.108"></a> -<span class="sourceLineNo">109</span> */<a name="line.109"></a> -<span class="sourceLineNo">110</span> String properties() default "";<a name="line.110"></a> -<span class="sourceLineNo">111</span><a name="line.111"></a> -<span class="sourceLineNo">112</span> /**<a name="line.112"></a> -<span class="sourceLineNo">113</span> * Sort bean properties in alphabetical order.<a name="line.113"></a> -<span class="sourceLineNo">114</span> * <p><a name="line.114"></a> -<span class="sourceLineNo">115</span> * When <jk>true</jk>, all bean properties will be serialized and access in alphabetical order.<a name="line.115"></a> -<span class="sourceLineNo">116</span> * Otherwise, the natural order of the bean properties is used which is dependent on the<a name="line.116"></a> -<span class="sourceLineNo">117</span> * JVM vendor.<a name="line.117"></a> -<span class="sourceLineNo">118</span> * On IBM JVMs, the bean properties are ordered based on their ordering in the Java file.<a name="line.118"></a> -<span class="sourceLineNo">119</span> * On Oracle JVMs, the bean properties are not ordered (which follows the offical JVM specs).<a name="line.119"></a> -<span class="sourceLineNo">120</span> * <p><a name="line.120"></a> -<span class="sourceLineNo">121</span> * This property is disabled by default so that IBM JVM users don't have to use {@link Bean @Bean} annotations<a name="line.121"></a> -<span class="sourceLineNo">122</span> * to force bean properties to be in a particular order and can just alter the order of the fields/methods<a name="line.122"></a> -<span class="sourceLineNo">123</span> * in the Java file.<a name="line.123"></a> -<span class="sourceLineNo">124</span> * <p><a name="line.124"></a> -<span class="sourceLineNo">125</span> * This annotation is equivalent to using the {@link BeanContext#BEAN_sortProperties} property, but<a name="line.125"></a> -<span class="sourceLineNo">126</span> * applied to individual classes instead of globally at the serializer or parser level.<a name="line.126"></a> -<span class="sourceLineNo">127</span> */<a name="line.127"></a> -<span class="sourceLineNo">128</span> boolean sort() default false;<a name="line.128"></a> -<span class="sourceLineNo">129</span><a name="line.129"></a> -<span class="sourceLineNo">130</span> /**<a name="line.130"></a> -<span class="sourceLineNo">131</span> * Specifies a list of properties that should be excluded from {@link BeanMap#entrySet()}.<a name="line.131"></a> +<span class="sourceLineNo">094</span><a name="line.94"></a> +<span class="sourceLineNo">095</span> /**<a name="line.95"></a> +<span class="sourceLineNo">096</span> * The property name to use for representing the type name.<a name="line.96"></a> +<span class="sourceLineNo">097</span> * <p><a name="line.97"></a> +<span class="sourceLineNo">098</span> * This can be used to override the name used for the <js>"_type"</js> property designated above.<a name="line.98"></a> +<span class="sourceLineNo">099</span> * Typically, you'll define this on an interface class so that it can apply to all subclasses.<a name="line.99"></a> +<span class="sourceLineNo">100</span> * <p class='bcode'><a name="line.100"></a> +<span class="sourceLineNo">101</span> * <ja>@Bean</ja>(typePropertyName=<js>"mytype"</js>, beanDictionary={MyClass1.<jk>class</jk>,MyClass2.<jk>class</jk>})<a name="line.101"></a> +<span class="sourceLineNo">102</span> * <jk>public interface</jk> MyInterface {...}<a name="line.102"></a> +<span class="sourceLineNo">103</span> *<a name="line.103"></a> +<span class="sourceLineNo">104</span> * <ja>@Bean</ja>(typeName=<js>"C1"</js>)<a name="line.104"></a> +<span class="sourceLineNo">105</span> * <jk>public class</jk> MyClass1 <jk>implements</jk> MyInterface {...}<a name="line.105"></a> +<span class="sourceLineNo">106</span> *<a name="line.106"></a> +<span class="sourceLineNo">107</span> * <ja>@Bean</ja>(typeName=<js>"C2"</js>)<a name="line.107"></a> +<span class="sourceLineNo">108</span> * <jk>public class</jk> MyClass2 <jk>implements</jk> MyInterface {...}<a name="line.108"></a> +<span class="sourceLineNo">109</span> *<a name="line.109"></a> +<span class="sourceLineNo">110</span> * MyInterface[] x = <jk>new</jk> MyInterface[]{ <jk>new</jk> MyClass1(), <jk>new</jk> MyClass2() };<a name="line.110"></a> +<span class="sourceLineNo">111</span> *<a name="line.111"></a> +<span class="sourceLineNo">112</span> * <jc>// Produces "[{mytype:'C1',...},{mytype:'C2',...}]"</jc><a name="line.112"></a> +<span class="sourceLineNo">113</span> * String json = JsonSerializer.<jsf>DEFAULT_LAX</jsf>.serialize(x);<a name="line.113"></a> +<span class="sourceLineNo">114</span> * </p><a name="line.114"></a> +<span class="sourceLineNo">115</span> * <p><a name="line.115"></a> +<span class="sourceLineNo">116</span> * This is similar in concept to the {@link BeanContext#BEAN_beanTypePropertyName} setting except this annotation<a name="line.116"></a> +<span class="sourceLineNo">117</span> * applies only to the annotated class and subclasses whereas the bean context property applies globally on<a name="line.117"></a> +<span class="sourceLineNo">118</span> * serializers and parsers.<a name="line.118"></a> +<span class="sourceLineNo">119</span> * <p class='warning'><a name="line.119"></a> +<span class="sourceLineNo">120</span> * Be careful what value you specify for this. It should not interfere with bean property names or<a name="line.120"></a> +<span class="sourceLineNo">121</span> * common HTML attribute names.<a name="line.121"></a> +<span class="sourceLineNo">122</span> * </p<a name="line.122"></a> +<span class="sourceLineNo">123</span> * <p><a name="line.123"></a> +<span class="sourceLineNo">124</span> * The default value if not specified is <js>"_type"</js> unless overridden by the {@link BeanContext#BEAN_beanTypePropertyName} setting.<a name="line.124"></a> +<span class="sourceLineNo">125</span> */<a name="line.125"></a> +<span class="sourceLineNo">126</span> String typePropertyName() default "";<a name="line.126"></a> +<span class="sourceLineNo">127</span><a name="line.127"></a> +<span class="sourceLineNo">128</span> /**<a name="line.128"></a> +<span class="sourceLineNo">129</span> * The set and order of names of properties associated with a bean class.<a name="line.129"></a> +<span class="sourceLineNo">130</span> * <p><a name="line.130"></a> +<span class="sourceLineNo">131</span> * The order specified is the same order that the entries will be returned by the {@link BeanMap#entrySet()} and related methods.<a name="line.131"></a> <span class="sourceLineNo">132</span> * <p><a name="line.132"></a> -<span class="sourceLineNo">133</span> * This annotation is an alternative to using the {@link BeanFilter} class with an implemented {@link BeanFilter#getExcludeProperties()} method.<a name="line.133"></a> +<span class="sourceLineNo">133</span> * This annotation is an alternative to using the {@link BeanFilter} class with an implemented {@link BeanFilter#getProperties()} method.<a name="line.133"></a> <span class="sourceLineNo">134</span> *<a name="line.134"></a> <span class="sourceLineNo">135</span> * <h5 class='section'>Example:</h5><a name="line.135"></a> <span class="sourceLineNo">136</span> * <p class='bcode'><a name="line.136"></a> <span class="sourceLineNo">137</span> * <jc>// Address class with only street/city/state properties (in that order).</jc><a name="line.137"></a> <span class="sourceLineNo">138</span> * <jc>// All other properties are ignored.</jc><a name="line.138"></a> -<span class="sourceLineNo">139</span> * <ja>@Bean</ja>(excludeProperties=<js>"city,state"</js>})<a name="line.139"></a> +<span class="sourceLineNo">139</span> * <ja>@Bean</ja>(properties=<js>"street,city,state"</js>)<a name="line.139"></a> <span class="sourceLineNo">140</span> * <jk>public class</jk> Address {<a name="line.140"></a> <span class="sourceLineNo">141</span> * ...<a name="line.141"></a> <span class="sourceLineNo">142</span> * </p><a name="line.142"></a> <span class="sourceLineNo">143</span> */<a name="line.143"></a> -<span class="sourceLineNo">144</span> String excludeProperties() default "";<a name="line.144"></a> +<span class="sourceLineNo">144</span> String properties() default "";<a name="line.144"></a> <span class="sourceLineNo">145</span><a name="line.145"></a> <span class="sourceLineNo">146</span> /**<a name="line.146"></a> -<span class="sourceLineNo">147</span> * Associates a {@link PropertyNamer} with this bean to tailor the names of the bean properties.<a name="line.147"></a> +<span class="sourceLineNo">147</span> * Sort bean properties in alphabetical order.<a name="line.147"></a> <span class="sourceLineNo">148</span> * <p><a name="line.148"></a> -<span class="sourceLineNo">149</span> * Property namers are used to transform bean property names from standard form to some other form.<a name="line.149"></a> -<span class="sourceLineNo">150</span> * For example, the {@link PropertyNamerDashedLC} will convert property names to dashed-lowercase, and<a name="line.150"></a> -<span class="sourceLineNo">151</span> * these will be used as attribute names in JSON, and element names in XML.<a name="line.151"></a> -<span class="sourceLineNo">152</span> * <p><a name="line.152"></a> -<span class="sourceLineNo">153</span> * This annotation is an alternative to using the {@link BeanFilter} class with an implemented {@link BeanFilter#getPropertyNamer()} method.<a name="line.153"></a> -<span class="sourceLineNo">154</span> *<a name="line.154"></a> -<span class="sourceLineNo">155</span> * <h5 class='section'>Example:</h5><a name="line.155"></a> -<span class="sourceLineNo">156</span> * <p class='bcode'><a name="line.156"></a> -<span class="sourceLineNo">157</span> * <jc>// Define a class with dashed-lowercase property names.</jc><a name="line.157"></a> -<span class="sourceLineNo">158</span> * <ja>@Bean</ja>(propertyNamer=PropertyNamerDashedLC.<jk>class</jk>)<a name="line.158"></a> -<span class="sourceLineNo">159</span> * <jk>public class</jk> MyClass {<a name="line.159"></a> -<span class="sourceLineNo">160</span> * ...<a name="line.160"></a> -<span class="sourceLineNo">161</span> * }<a name="line.161"></a> -<span class="sourceLineNo">162</span> * </p><a name="line.162"></a> -<span class="sourceLineNo">163</span> */<a name="line.163"></a> -<span class="sourceLineNo">164</span> Class<? extends PropertyNamer> propertyNamer() default PropertyNamerDefault.class;<a name="line.164"></a> -<span class="sourceLineNo">165</span><a name="line.165"></a> -<span class="sourceLineNo">166</span> /**<a name="line.166"></a> -<span class="sourceLineNo">167</span> * Identifies a class to be used as the interface class for this and all subclasses.<a name="line.167"></a> -<span class="sourceLineNo">168</span> * <p><a name="line.168"></a> -<span class="sourceLineNo">169</span> * When specified, only the list of properties defined on the interface class will be used during serialization.<a name="line.169"></a> -<span class="sourceLineNo">170</span> * Additional properties on subclasses will be ignored.<a name="line.170"></a> -<span class="sourceLineNo">171</span> * <p class='bcode'><a name="line.171"></a> -<span class="sourceLineNo">172</span> * <jc>// Parent class</jc><a name="line.172"></a> -<span class="sourceLineNo">173</span> * <ja>@Bean</ja>(interfaceClass=A.<jk>class</jk>)<a name="line.173"></a> -<span class="sourceLineNo">174</span> * <jk>public abstract class</jk> A {<a name="line.174"></a> -<span class="sourceLineNo">175</span> * <jk>public</jk> String <jf>f0</jf> = <js>"f0"</js>;<a name="line.175"></a> -<span class="sourceLineNo">176</span> * }<a name="line.176"></a> -<span class="sourceLineNo">177</span> *<a name="line.177"></a> -<span class="sourceLineNo">178</span> * <jc>// Sub class</jc><a name="line.178"></a> -<span class="sourceLineNo">179</span> * <jk>public class</jk> A1 <jk>extends</jk> A {<a name="line.179"></a> -<span class="sourceLineNo">180</span> * <jk>public</jk> String <jf>f1</jf> = <js>"f1"</js>;<a name="line.180"></a> -<span class="sourceLineNo">181</span> * }<a name="line.181"></a> -<span class="sourceLineNo">182</span> *<a name="line.182"></a> -<span class="sourceLineNo">183</span> * JsonSerializer s = JsonSerializer.<jsf>DEFAULT_LAX</jsf>;<a name="line.183"></a> -<span class="sourceLineNo">184</span> * A1 a1 = <jk>new</jk> A1();<a name="line.184"></a> -<span class="sourceLineNo">185</span> * String r = s.serialize(a1);<a name="line.185"></a> -<span class="sourceLineNo">186</span> * <jsm>assertEquals</jsm>(<js>"{f0:'f0'}"</js>, r); // Note f1 is not serialized.<a name="line.186"></a> -<span class="sourceLineNo">187</span> * </p><a name="line.187"></a> -<span class="sourceLineNo">188</span> * <p><a name="line.188"></a> -<span class="sourceLineNo">189</span> * Note that this annotation can be used on the parent class so that it filters to all child classes,<a name="line.189"></a> -<span class="sourceLineNo">190</span> * or can be set individually on the child classes.<a name="line.190"></a> -<span class="sourceLineNo">191</span> * <p><a name="line.191"></a> -<span class="sourceLineNo">192</span> * This annotation is an alternative to using the {@link BeanFilter} class with an implemented {@link BeanFilter#getInterfaceClass()} method.<a name="line.192"></a> -<span class="sourceLineNo">193</span> */<a name="line.193"></a> -<span class="sourceLineNo">194</span> Class<?> interfaceClass() default Object.class;<a name="line.194"></a> -<span class="sourceLineNo">195</span><a name="line.195"></a> -<span class="sourceLineNo">196</span> /**<a name="line.196"></a> -<span class="sourceLineNo">197</span> * Identifies a stop class for the annotated class.<a name="line.197"></a> -<span class="sourceLineNo">198</span> * <p><a name="line.198"></a> -<span class="sourceLineNo">199</span> * Identical in purpose to the stop class specified by {@link Introspector#getBeanInfo(Class, Class)}.<a name="line.199"></a> -<span class="sourceLineNo">200</span> * Any properties in the stop class or in its baseclasses will be ignored during analysis.<a name="line.200"></a> -<span class="sourceLineNo">201</span> * <p><a name="line.201"></a> -<span class="sourceLineNo">202</span> * For example, in the following class hierarchy, instances of <code>C3</code> will include property <code>p3</code>, but<a name="line.202"></a> -<span class="sourceLineNo">203</span> * not <code>p1</code> or <code>p2</code>.<a name="line.203"></a> -<span class="sourceLineNo">204</span> * <p class='bcode'><a name="line.204"></a> -<span class="sourceLineNo">205</span> * <jk>public class</jk> C1 {<a name="line.205"></a> -<span class="sourceLineNo">206</span> * <jk>public int</jk> getP1();<a name="line.206"></a> -<span class="sourceLineNo">207</span> * }<a name="line.207"></a> -<span class="sourceLineNo">208</span> *<a name="line.208"></a> -<span class="sourceLineNo">209</span> * <jk>public class</jk> C2 <jk>extends</jk> C1 {<a name="line.209"></a> -<span class="sourceLineNo">210</span> * <jk>public int</jk> getP2();<a name="line.210"></a> -<span class="sourceLineNo">211</span> * }<a name="line.211"></a> -<span class="sourceLineNo">212</span> *<a name="line.212"></a> -<span class="sourceLineNo">213</span> * <ja>@Bean</ja>(stopClass=C2.<jk>class</jk>)<a name="line.213"></a> -<span class="sourceLineNo">214</span> * <jk>public class</jk> C3 <jk>extends</jk> C2 {<a name="line.214"></a> -<span class="sourceLineNo">215</span> * <jk>public int</jk> getP3();<a name="line.215"></a> -<span class="sourceLineNo">216</span> * }<a name="line.216"></a> -<span class="sourceLineNo">217</span> * </p><a name="line.217"></a> -<span class="sourceLineNo">218</span> */<a name="line.218"></a> -<span class="sourceLineNo">219</span> Class<?> stopClass() default Object.class;<a name="line.219"></a> -<span class="sourceLineNo">220</span><a name="line.220"></a> -<span class="sourceLineNo">221</span><a name="line.221"></a> -<span class="sourceLineNo">222</span> /**<a name="line.222"></a> -<span class="sourceLineNo">223</span> * The list of classes that make up the bean dictionary for all properties of this bean<a name="line.223"></a> -<span class="sourceLineNo">224</span> * or for subclasses of this bean.<a name="line.224"></a> +<span class="sourceLineNo">149</span> * When <jk>true</jk>, all bean properties will be serialized and access in alphabetical order.<a name="line.149"></a> +<span class="sourceLineNo">150</span> * Otherwise, the natural order of the bean properties is used which is dependent on the<a name="line.150"></a> +<span class="sourceLineNo">151</span> * JVM vendor.<a name="line.151"></a> +<span class="sourceLineNo">152</span> * On IBM JVMs, the bean properties are ordered based on their ordering in the Java file.<a name="line.152"></a> +<span class="sourceLineNo">153</span> * On Oracle JVMs, the bean properties are not ordered (which follows the offical JVM specs).<a name="line.153"></a> +<span class="sourceLineNo">154</span> * <p><a name="line.154"></a> +<span class="sourceLineNo">155</span> * This property is disabled by default so that IBM JVM users don't have to use {@link Bean @Bean} annotations<a name="line.155"></a> +<span class="sourceLineNo">156</span> * to force bean properties to be in a particular order and can just alter the order of the fields/methods<a name="line.156"></a> +<span class="sourceLineNo">157</span> * in the Java file.<a name="line.157"></a> +<span class="sourceLineNo">158</span> * <p><a name="line.158"></a> +<span class="sourceLineNo">159</span> * This annotation is equivalent to using the {@link BeanContext#BEAN_sortProperties} property, but<a name="line.159"></a> +<span class="sourceLineNo">160</span> * applied to individual classes instead of globally at the serializer or parser level.<a name="line.160"></a> +<span class="sourceLineNo">161</span> */<a name="line.161"></a> +<span class="sourceLineNo">162</span> boolean sort() default false;<a name="line.162"></a> +<span class="sourceLineNo">163</span><a name="line.163"></a> +<span class="sourceLineNo">164</span> /**<a name="line.164"></a> +<span class="sourceLineNo">165</span> * Specifies a list of properties that should be excluded from {@link BeanMap#entrySet()}.<a name="line.165"></a> +<span class="sourceLineNo">166</span> * <p><a name="line.166"></a> +<span class="sourceLineNo">167</span> * This annotation is an alternative to using the {@link BeanFilter} class with an implemented {@link BeanFilter#getExcludeProperties()} method.<a name="line.167"></a> +<span class="sourceLineNo">168</span> *<a name="line.168"></a> +<span class="sourceLineNo">169</span> * <h5 class='section'>Example:</h5><a name="line.169"></a> +<span class="sourceLineNo">170</span> * <p class='bcode'><a name="line.170"></a> +<span class="sourceLineNo">171</span> * <jc>// Address class with only street/city/state properties (in that order).</jc><a name="line.171"></a> +<span class="sourceLineNo">172</span> * <jc>// All other properties are ignored.</jc><a name="line.172"></a> +<span class="sourceLineNo">173</span> * <ja>@Bean</ja>(excludeProperties=<js>"city,state"</js>})<a name="line.173"></a> +<span class="sourceLineNo">174</span> * <jk>public class</jk> Address {<a name="line.174"></a> +<span class="sourceLineNo">175</span> * ...<a name="line.175"></a> +<span class="sourceLineNo">176</span> * </p><a name="line.176"></a> +<span class="sourceLineNo">177</span> */<a name="line.177"></a> +<span class="sourceLineNo">178</span> String excludeProperties() default "";<a name="line.178"></a> +<span class="sourceLineNo">179</span><a name="line.179"></a> +<span class="sourceLineNo">180</span> /**<a name="line.180"></a> +<span class="sourceLineNo">181</span> * Associates a {@link PropertyNamer} with this bean to tailor the names of the bean properties.<a name="line.181"></a> +<span class="sourceLineNo">182</span> * <p><a name="line.182"></a> +<span class="sourceLineNo">183</span> * Property namers are used to transform bean property names from standard form to some other form.<a name="line.183"></a> +<span class="sourceLineNo">184</span> * For example, the {@link PropertyNamerDashedLC} will convert property names to dashed-lowercase, and<a name="line.184"></a> +<span class="sourceLineNo">185</span> * these will be used as attribute names in JSON, and element names in XML.<a name="line.185"></a> +<span class="sourceLineNo">186</span> * <p><a name="line.186"></a> +<span class="sourceLineNo">187</span> * This annotation is an alternative to using the {@link BeanFilter} class with an implemented {@link BeanFilter#getPropertyNamer()} method.<a name="line.187"></a> +<span class="sourceLineNo">188</span> *<a name="line.188"></a> +<span class="sourceLineNo">189</span> * <h5 class='section'>Example:</h5><a name="line.189"></a> +<span class="sourceLineNo">190</span> * <p class='bcode'><a name="line.190"></a> +<span class="sourceLineNo">191</span> * <jc>// Define a class with dashed-lowercase property names.</jc><a name="line.191"></a> +<span class="sourceLineNo">192</span> * <ja>@Bean</ja>(propertyNamer=PropertyNamerDashedLC.<jk>class</jk>)<a name="line.192"></a> +<span class="sourceLineNo">193</span> * <jk>public class</jk> MyClass {<a name="line.193"></a> +<span class="sourceLineNo">194</span> * ...<a name="line.194"></a> +<span class="sourceLineNo">195</span> * }<a name="line.195"></a> +<span class="sourceLineNo">196</span> * </p><a name="line.196"></a> +<span class="sourceLineNo">197</span> */<a name="line.197"></a> +<span class="sourceLineNo">198</span> Class<? extends PropertyNamer> propertyNamer() default PropertyNamerDefault.class;<a name="line.198"></a> +<span class="sourceLineNo">199</span><a name="line.199"></a> +<span class="sourceLineNo">200</span> /**<a name="line.200"></a> +<span class="sourceLineNo">201</span> * Identifies a class to be used as the interface class for this and all subclasses.<a name="line.201"></a> +<span class="sourceLineNo">202</span> * <p><a name="line.202"></a> +<span class="sourceLineNo">203</span> * When specified, only the list of properties defined on the interface class will be used during serialization.<a name="line.203"></a> +<span class="sourceLineNo">204</span> * Additional properties on subclasses will be ignored.<a name="line.204"></a> +<span class="sourceLineNo">205</span> * <p class='bcode'><a name="line.205"></a> +<span class="sourceLineNo">206</span> * <jc>// Parent class</jc><a name="line.206"></a> +<span class="sourceLineNo">207</span> * <ja>@Bean</ja>(interfaceClass=A.<jk>class</jk>)<a name="line.207"></a> +<span class="sourceLineNo">208</span> * <jk>public abstract class</jk> A {<a name="line.208"></a> +<span class="sourceLineNo">209</span> * <jk>public</jk> String <jf>f0</jf> = <js>"f0"</js>;<a name="line.209"></a> +<span class="sourceLineNo">210</span> * }<a name="line.210"></a> +<span class="sourceLineNo">211</span> *<a name="line.211"></a> +<span class="sourceLineNo">212</span> * <jc>// Sub class</jc><a name="line.212"></a> +<span class="sourceLineNo">213</span> * <jk>public class</jk> A1 <jk>extends</jk> A {<a name="line.213"></a> +<span class="sourceLineNo">214</span> * <jk>public</jk> String <jf>f1</jf> = <js>"f1"</js>;<a name="line.214"></a> +<span class="sourceLineNo">215</span> * }<a name="line.215"></a> +<span class="sourceLineNo">216</span> *<a name="line.216"></a> +<span class="sourceLineNo">217</span> * JsonSerializer s = JsonSerializer.<jsf>DEFAULT_LAX</jsf>;<a name="line.217"></a> +<span class="sourceLineNo">218</span> * A1 a1 = <jk>new</jk> A1();<a name="line.218"></a> +<span class="sourceLineNo">219</span> * String r = s.serialize(a1);<a name="line.219"></a> +<span class="sourceLineNo">220</span> * <jsm>assertEquals</jsm>(<js>"{f0:'f0'}"</js>, r); // Note f1 is not serialized.<a name="line.220"></a> +<span class="sourceLineNo">221</span> * </p><a name="line.221"></a> +<span class="sourceLineNo">222</span> * <p><a name="line.222"></a> +<span class="sourceLineNo">223</span> * Note that this annotation can be used on the parent class so that it filters to all child classes,<a name="line.223"></a> +<span class="sourceLineNo">224</span> * or can be set individually on the child classes.<a name="line.224"></a> <span class="sourceLineNo">225</span> * <p><a name="line.225"></a> -<span class="sourceLineNo">226</span> * This is a shorthand for setting the {@link BeanProperty#beanDictionary()} on all properties of the bean.<a name="line.226"></a> -<span class="sourceLineNo">227</span> * <p><a name="line.227"></a> -<span class="sourceLineNo">228</span> * This list can consist of the following class types:<a name="line.228"></a> -<span class="sourceLineNo">229</span> * <ul><a name="line.229"></a> -<span class="sourceLineNo">230</span> * <li>Any bean class that specifies a value for {@link Bean#typeName() @Bean.name()};<a name="line.230"></a> -<span class="sourceLineNo">231</span> * <li>Any subclass of {@link BeanDictionaryList} that defines an entire set of mappings.<a name="line.231"></a> -<span class="sourceLineNo">232</span> * Note that the subclass MUST implement a no-arg constructor so that it can be instantiated.<a name="line.232"></a> -<span class="sourceLineNo">233</span> * <li>Any subclass of {@link BeanDictionaryMap} that defines an entire set of mappings.<a name="line.233"></a> -<span class="sourceLineNo">234</span> * Note that the subclass MUST implement a no-arg constructor so that it can be instantiated.<a name="line.234"></a> -<span class="sourceLineNo">235</span> * </ul><a name="line.235"></a> -<span class="sourceLineNo">236</span> */<a name="line.236"></a> -<span class="sourceLineNo">237</span> Class<?>[] beanDictionary() default {};<a name="line.237"></a> -<span class="sourceLineNo">238</span>}<a name="line.238"></a> +<span class="sourceLineNo">226</span> * This annotation is an alternative to using the {@link BeanFilter} class with an implemented {@link BeanFilter#getInterfaceClass()} method.<a name="line.226"></a> +<span class="sourceLineNo">227</span> */<a name="line.227"></a> +<span class="sourceLineNo">228</span> Class<?> interfaceClass() default Object.class;<a name="line.228"></a> +<span class="sourceLineNo">229</span><a name="line.229"></a> +<span class="sourceLineNo">230</span> /**<a name="line.230"></a> +<span class="sourceLineNo">231</span> * Identifies a stop class for the annotated class.<a name="line.231"></a> +<span class="sourceLineNo">232</span> * <p><a name="line.232"></a> +<span class="sourceLineNo">233</span> * Identical in purpose to the stop class specified by {@link Introspector#getBeanInfo(Class, Class)}.<a name="line.233"></a> +<span class="sourceLineNo">234</span> * Any properties in the stop class or in its baseclasses will be ignored during analysis.<a name="line.234"></a> +<span class="sourceLineNo">235</span> * <p><a name="line.235"></a> +<span class="sourceLineNo">236</span> * For example, in the following class hierarchy, instances of <code>C3</code> will include property <code>p3</code>, but<a name="line.236"></a> +<span class="sourceLineNo">237</span> * not <code>p1</code> or <code>p2</code>.<a name="line.237"></a> +<span class="sourceLineNo">238</span> * <p class='bcode'><a name="line.238"></a> +<span class="sourceLineNo">239</span> * <jk>public class</jk> C1 {<a name="line.239"></a> +<span class="sourceLineNo">240</span> * <jk>public int</jk> getP1();<a name="line.240"></a> +<span class="sourceLineNo">241</span> * }<a name="line.241"></a> +<span class="sourceLineNo">242</span> *<a name="line.242"></a> +<span class="sourceLineNo">243</span> * <jk>public class</jk> C2 <jk>extends</jk> C1 {<a name="line.243"></a> +<span class="sourceLineNo">244</span> * <jk>public int</jk> getP2();<a name="line.244"></a> +<span class="sourceLineNo">245</span> * }<a name="line.245"></a> +<span class="sourceLineNo">246</span> *<a name="line.246"></a> +<span class="sourceLineNo">247</span> * <ja>@Bean</ja>(stopClass=C2.<jk>class</jk>)<a name="line.247"></a> +<span class="sourceLineNo">248</span> * <jk>public class</jk> C3 <jk>extends</jk> C2 {<a name="line.248"></a> +<span class="sourceLineNo">249</span> * <jk>public int</jk> getP3();<a name="line.249"></a> +<span class="sourceLineNo">250</span> * }<a name="line.250"></a> +<span class="sourceLineNo">251</span> * </p><a name="line.251"></a> +<span class="sourceLineNo">252</span> */<a name="line.252"></a> +<span class="sourceLineNo">253</span> Class<?> stopClass() default Object.class;<a name="line.253"></a> +<span class="sourceLineNo">254</span><a name="line.254"></a> +<span class="sourceLineNo">255</span><a name="line.255"></a> +<span class="sourceLineNo">256</span> /**<a name="line.256"></a> +<span class="sourceLineNo">257</span> * The list of classes that make up the bean dictionary for all properties of this bean<a name="line.257"></a> +<span class="sourceLineNo">258</span> * or for subclasses of this bean.<a name="line.258"></a> +<span class="sourceLineNo">259</span> * <p><a name="line.259"></a> +<span class="sourceLineNo">260</span> * This is a shorthand for setting the {@link BeanProperty#beanDictionary()} on all properties of the bean.<a name="line.260"></a> +<span class="sourceLineNo">261</span> * <p><a name="line.261"></a> +<span class="sourceLineNo">262</span> * This list can consist of the following class types:<a name="line.262"></a> +<span class="sourceLineNo">263</span> * <ul><a name="line.263"></a> +<span class="sourceLineNo">264</span> * <li>Any bean class that specifies a value for {@link Bean#typeName() @Bean.name()};<a name="line.264"></a> +<span class="sourceLineNo">265</span> * <li>Any subclass of {@link BeanDictionaryList} that defines an entire set of mappings.<a name="line.265"></a> +<span class="sourceLineNo">266</span> * Note that the subclass MUST implement a no-arg constructor so that it can be instantiated.<a name="line.266"></a> +<span class="sourceLineNo">267</span> * <li>Any subclass of {@link BeanDictionaryMap} that defines an entire set of mappings.<a name="line.267"></a> +<span class="sourceLineNo">268</span> * Note that the subclass MUST implement a no-arg constructor so that it can be instantiated.<a name="line.268"></a> +<span class="sourceLineNo">269</span> * </ul><a name="line.269"></a> +<span class="sourceLineNo">270</span> */<a name="line.270"></a> +<span class="sourceLineNo">271</span> Class<?>[] beanDictionary() default {};<a name="line.271"></a> +<span class="sourceLineNo">272</span>}<a name="line.272"></a>
