content/site/apidocs-7.1.0/src-html/org/apache/juneau/BeanPropertyMeta.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html lang="en"> <head> <title>Source code</title> <link rel="stylesheet" type="text/css" href="../../../../javadoc.css" title="Style"> </head> <body> <div class="sourceContainer"> <pre>001// ***************************************************************************************************************************<a name="line.1"></a> 002// * Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file *<a name="line.2"></a> 003// * distributed with this work for additional information regarding copyright ownership. The ASF licenses this file *<a name="line.3"></a> 004// * to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance *<a name="line.4"></a> 005// * with the License. You may obtain a copy of the License at *<a name="line.5"></a> 006// * *<a name="line.6"></a> 007// * http://www.apache.org/licenses/LICENSE-2.0 *<a name="line.7"></a> 008// * *<a name="line.8"></a> 009// * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an *<a name="line.9"></a> 010// * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the *<a name="line.10"></a> 011// * specific language governing permissions and limitations under the License. *<a name="line.11"></a> 012// ***************************************************************************************************************************<a name="line.12"></a> 013package org.apache.juneau;<a name="line.13"></a> 014<a name="line.14"></a> 015import static org.apache.juneau.Visibility.*;<a name="line.15"></a> 016import static org.apache.juneau.internal.ArrayUtils.*;<a name="line.16"></a> 017import static org.apache.juneau.internal.ClassUtils.*;<a name="line.17"></a> 018import static org.apache.juneau.internal.CollectionUtils.*;<a name="line.18"></a> 019import static org.apache.juneau.internal.ReflectionUtils.*;<a name="line.19"></a> 020import static org.apache.juneau.internal.StringUtils.*;<a name="line.20"></a> 021<a name="line.21"></a> 022import java.lang.annotation.*;<a name="line.22"></a> 023import java.lang.reflect.*;<a name="line.23"></a> 024import java.net.*;<a name="line.24"></a> 025import java.net.URI;<a name="line.25"></a> 026import java.util.*;<a name="line.26"></a> 027<a name="line.27"></a> 028import org.apache.juneau.annotation.*;<a name="line.28"></a> 029import org.apache.juneau.internal.*;<a name="line.29"></a> 030import org.apache.juneau.parser.*;<a name="line.30"></a> 031import org.apache.juneau.serializer.*;<a name="line.31"></a> 032import org.apache.juneau.transform.*;<a name="line.32"></a> 033import org.apache.juneau.transforms.*;<a name="line.33"></a> 034import org.apache.juneau.utils.*;<a name="line.34"></a> 035<a name="line.35"></a> 036/**<a name="line.36"></a> 037 * Contains metadata about a bean property.<a name="line.37"></a> 038 * <a name="line.38"></a> 039 * <a name="line.39"></a> 040 * Contains information such as type of property (e.g. field/getter/setter), class type of property value, and whether<a name="line.40"></a> 041 * any transforms are associated with this property.<a name="line.41"></a> 042 * <a name="line.42"></a> 043 * <a name="line.43"></a> 044 * Developers will typically not need access to this class. The information provided by it is already exposed through<a name="line.44"></a> 045 * several methods on the {@link BeanMap} API.<a name="line.45"></a> 046 */<a name="line.46"></a> 047@SuppressWarnings({ "rawtypes", "unchecked" })<a name="line.47"></a> 048public final class BeanPropertyMeta {<a name="line.48"></a> 049<a name="line.49"></a> 050 final BeanMeta<?> beanMeta; // The bean that this property belongs to.<a name="line.50"></a> 051 private final BeanContext beanContext; // The context that created this meta.<a name="line.51"></a> 052<a name="line.52"></a> 053 private final String name; // The name of the property.<a name="line.53"></a> 054 private final Field field; // The bean property field (if it has one).<a name="line.54"></a> 055 private final Method getter, setter; // The bean property getter and setter.<a name="line.55"></a> 056 private final boolean isUri; // True if this is a URL/URI or annotated with @URI.<a name="line.56"></a> 057 private final boolean isDyna; // This is a dyna property (i.e. name="*")<a name="line.57"></a> 058<a name="line.58"></a> 059 private final ClassMeta<?><a name="line.59"></a> 060 rawTypeMeta, // The real class type of the bean property.<a name="line.60"></a> 061 typeMeta; // The transformed class type of the bean property.<a name="line.61"></a> 062<a name="line.62"></a> 063 private final String[] properties; // The value of the @BeanProperty(properties) annotation.<a name="line.63"></a> 064 private final PojoSwap swap; // PojoSwap defined only via @BeanProperty annotation.<a name="line.64"></a> 065<a name="line.65"></a> 066 private final MetadataMap extMeta; // Extended metadata<a name="line.66"></a> 067 private final BeanRegistry beanRegistry;<a name="line.67"></a> 068<a name="line.68"></a> 069 private final Object overrideValue; // The bean property value (if it's an overridden delegate).<a name="line.69"></a> 070 private final BeanPropertyMeta delegateFor; // The bean property that this meta is a delegate for.<a name="line.70"></a> 071 private final boolean canRead, canWrite;<a name="line.71"></a> 072 <a name="line.72"></a> 073 /**<a name="line.73"></a> 074 * Creates a builder for {@link #BeanPropertyMeta} objects.<a name="line.74"></a> 075 * <a name="line.75"></a> 076 * @param beanMeta The metadata on the bean<a name="line.76"></a> 077 * @param name The bean property name.<a name="line.77"></a> 078 * @return A new builder.<a name="line.78"></a> 079 */<a name="line.79"></a> 080 public static Builder builder(BeanMeta<?> beanMeta, String name) {<a name="line.80"></a> 081 return new Builder(beanMeta, name);<a name="line.81"></a> 082 }<a name="line.82"></a> 083 <a name="line.83"></a> 084 /**<a name="line.84"></a> 085 * BeanPropertyMeta builder class.<a name="line.85"></a> 086 */<a name="line.86"></a> 087 public static final class Builder {<a name="line.87"></a> 088 BeanMeta<?> beanMeta;<a name="line.88"></a> 089 BeanContext beanContext;<a name="line.89"></a> 090 String name;<a name="line.90"></a> 091 Field field;<a name="line.91"></a> 092 Method getter, setter;<a name="line.92"></a> 093 boolean isConstructorArg, isUri, isDyna;<a name="line.93"></a> 094 ClassMeta<?> rawTypeMeta, typeMeta;<a name="line.94"></a> 095 String[] properties;<a name="line.95"></a> 096 PojoSwap swap;<a name="line.96"></a> 097 BeanRegistry beanRegistry;<a name="line.97"></a> 098 Object overrideValue;<a name="line.98"></a> 099 BeanPropertyMeta delegateFor;<a name="line.99"></a> 100 MetadataMap extMeta = new MetadataMap();<a name="line.100"></a> 101 boolean canRead, canWrite;<a name="line.101"></a> 102<a name="line.102"></a> 103 Builder(BeanMeta<?> beanMeta, String name) {<a name="line.103"></a> 104 this.beanMeta = beanMeta;<a name="line.104"></a> 105 this.beanContext = beanMeta.ctx;<a name="line.105"></a> 106 this.name = name;<a name="line.106"></a> 107 }<a name="line.107"></a> 108 <a name="line.108"></a> 109 /**<a name="line.109"></a> 110 * Sets the raw metadata type for this bean property.<a name="line.110"></a> 111 * <a name="line.111"></a> 112 * @param rawMetaType The raw metadata type for this bean property.<a name="line.112"></a> 113 * @return This object (for method chaining().<a name="line.113"></a> 114 */<a name="line.114"></a> 115 public Builder rawMetaType(ClassMeta<?> rawMetaType) {<a name="line.115"></a> 116 this.rawTypeMeta = rawMetaType;<a name="line.116"></a> 117 this.typeMeta = rawTypeMeta;<a name="line.117"></a> 118 return this;<a name="line.118"></a> 119 }<a name="line.119"></a> 120<a name="line.120"></a> 121 /**<a name="line.121"></a> 122 * Sets the bean registry to use with this bean property.<a name="line.122"></a> 123 * <a name="line.123"></a> 124 * @param beanRegistry The bean registry to use with this bean property.<a name="line.124"></a> 125 * @return This object (for method chaining().<a name="line.125"></a> 126 */<a name="line.126"></a> 127 public Builder beanRegistry(BeanRegistry beanRegistry) {<a name="line.127"></a> 128 this.beanRegistry = beanRegistry;<a name="line.128"></a> 129 return this;<a name="line.129"></a> 130 }<a name="line.130"></a> 131<a name="line.131"></a> 132 /**<a name="line.132"></a> 133 * Sets the overridden value of this bean property.<a name="line.133"></a> 134 * <a name="line.134"></a> 135 * @param overrideValue The overridden value of this bean property.<a name="line.135"></a> 136 * @return This object (for method chaining().<a name="line.136"></a> 137 */<a name="line.137"></a> 138 public Builder overrideValue(Object overrideValue) {<a name="line.138"></a> 139 this.overrideValue = overrideValue;<a name="line.139"></a> 140 return this;<a name="line.140"></a> 141 }<a name="line.141"></a> 142<a name="line.142"></a> 143 /**<a name="line.143"></a> 144 * Sets the original bean property that this one is overriding.<a name="line.144"></a> 145 * <a name="line.145"></a> 146 * @param delegateFor The original bean property that this one is overriding.<a name="line.146"></a> 147 * @return This object (for method chaining().<a name="line.147"></a> 148 */<a name="line.148"></a> 149 public Builder delegateFor(BeanPropertyMeta delegateFor) {<a name="line.149"></a> 150 this.delegateFor = delegateFor;<a name="line.150"></a> 151 return this;<a name="line.151"></a> 152 }<a name="line.152"></a> 153 <a name="line.153"></a> 154 Builder canRead() {<a name="line.154"></a> 155 this.canRead = true;<a name="line.155"></a> 156 return this;<a name="line.156"></a> 157 }<a name="line.157"></a> 158<a name="line.158"></a> 159 Builder canWrite() {<a name="line.159"></a> 160 this.canWrite = true;<a name="line.160"></a> 161 return this;<a name="line.161"></a> 162 }<a name="line.162"></a> 163<a name="line.163"></a> 164 boolean validate(BeanContext f, BeanRegistry parentBeanRegistry, Map<Class<?>,Class<?>[]> typeVarImpls) throws Exception {<a name="line.164"></a> 165<a name="line.165"></a> 166 List<Class<?>> bdClasses = new ArrayList<>();<a name="line.166"></a> 167<a name="line.167"></a> 168 if (field == null && getter == null && setter == null)<a name="line.168"></a> 169 return false;<a name="line.169"></a> 170<a name="line.170"></a> 171 if (field == null && setter == null && f.beansRequireSettersForGetters && ! isConstructorArg)<a name="line.171"></a> 172 return false;<a name="line.172"></a> 173 <a name="line.173"></a> 174 canRead |= (field != null || getter != null);<a name="line.174"></a> 175 canWrite |= (field != null || setter != null);<a name="line.175"></a> 176<a name="line.176"></a> 177 if (field != null) {<a name="line.177"></a> 178 BeanProperty p = field.getAnnotation(BeanProperty.class);<a name="line.178"></a> 179 rawTypeMeta = f.resolveClassMeta(p, field.getGenericType(), typeVarImpls);<a name="line.179"></a> 180 isUri |= (rawTypeMeta.isUri() || field.isAnnotationPresent(org.apache.juneau.annotation.URI.class));<a name="line.180"></a> 181 if (p != null) {<a name="line.181"></a> 182 if (! p.properties().isEmpty())<a name="line.182"></a> 183 properties = split(p.properties());<a name="line.183"></a> 184 bdClasses.addAll(Arrays.asList(p.beanDictionary()));<a name="line.184"></a> 185 }<a name="line.185"></a> 186 Swap s = field.getAnnotation(Swap.class);<a name="line.186"></a> 187 if (s != null) {<a name="line.187"></a> 188 swap = getPropertyPojoSwap(s);<a name="line.188"></a> 189 }<a name="line.189"></a> 190 }<a name="line.190"></a> 191<a name="line.191"></a> 192 if (getter != null) {<a name="line.192"></a> 193 BeanProperty p = getMethodAnnotation(BeanProperty.class, getter);<a name="line.193"></a> 194 if (rawTypeMeta == null)<a name="line.194"></a> 195 rawTypeMeta = f.resolveClassMeta(p, getter.getGenericReturnType(), typeVarImpls);<a name="line.195"></a> 196 isUri |= (rawTypeMeta.isUri() || getter.isAnnotationPresent(org.apache.juneau.annotation.URI.class));<a name="line.196"></a> 197 if (p != null) {<a name="line.197"></a> 198 if (properties != null && ! p.properties().isEmpty())<a name="line.198"></a> 199 properties = split(p.properties());<a name="line.199"></a> 200 bdClasses.addAll(Arrays.asList(p.beanDictionary()));<a name="line.200"></a> 201 }<a name="line.201"></a> 202 Swap s = getter.getAnnotation(Swap.class);<a name="line.202"></a> 203 if (s != null && swap == null) {<a name="line.203"></a> 204 swap = getPropertyPojoSwap(s);<a name="line.204"></a> 205 }<a name="line.205"></a> 206 }<a name="line.206"></a> 207<a name="line.207"></a> 208 if (setter != null) {<a name="line.208"></a> 209 BeanProperty p = getMethodAnnotation(BeanProperty.class, setter);<a name="line.209"></a> 210 if (rawTypeMeta == null)<a name="line.210"></a> 211 rawTypeMeta = f.resolveClassMeta(p, setter.getGenericParameterTypes()[0], typeVarImpls);<a name="line.211"></a> 212 isUri |= (rawTypeMeta.isUri() || setter.isAnnotationPresent(org.apache.juneau.annotation.URI.class));<a name="line.212"></a> 213 if (p != null) {<a name="line.213"></a> 214 if (swap == null)<a name="line.214"></a> 215 swap = getPropertyPojoSwap(p);<a name="line.215"></a> 216 if (properties != null && ! p.properties().isEmpty())<a name="line.216"></a> 217 properties = split(p.properties());<a name="line.217"></a> 218 bdClasses.addAll(Arrays.asList(p.beanDictionary()));<a name="line.218"></a> 219 }<a name="line.219"></a> 220 Swap s = setter.getAnnotation(Swap.class);<a name="line.220"></a> 221 if (s != null && swap == null) {<a name="line.221"></a> 222 swap = getPropertyPojoSwap(s);<a name="line.222"></a> 223 }<a name="line.223"></a> 224 }<a name="line.224"></a> 225<a name="line.225"></a> 226 if (rawTypeMeta == null)<a name="line.226"></a> 227 return false;<a name="line.227"></a> 228<a name="line.228"></a> 229 this.beanRegistry = new BeanRegistry(beanContext, parentBeanRegistry, bdClasses.toArray(new Class<?>[0]));<a name="line.229"></a> 230<a name="line.230"></a> 231 isDyna = "*".equals(name);<a name="line.231"></a> 232<a name="line.232"></a> 233 // Do some annotation validation.<a name="line.233"></a> 234 Class<?> c = rawTypeMeta.getInnerClass();<a name="line.234"></a> 235 if (getter != null) {<a name="line.235"></a> 236 if (isDyna) {<a name="line.236"></a> 237 if (! isParentClass(Map.class, c))<a name="line.237"></a> 238 return false;<a name="line.238"></a> 239 } else {<a name="line.239"></a> 240 if (! isParentClass(getter.getReturnType(), c))<a name="line.240"></a> 241 return false;<a name="line.241"></a> 242 }<a name="line.242"></a> 243 }<a name="line.243"></a> 244 if (setter != null) {<a name="line.244"></a> 245 Class<?>[] pt = setter.getParameterTypes();<a name="line.245"></a> 246 if (pt.length != (isDyna ? 2 : 1))<a name="line.246"></a> 247 return false;<a name="line.247"></a> 248 if (isDyna) {<a name="line.248"></a> 249 if (! pt[0].equals(String.class))<a name="line.249"></a> 250 return false;<a name="line.250"></a> 251 } else {<a name="line.251"></a> 252 if (! isParentClass(pt[0], c))<a name="line.252"></a> 253 return false;<a name="line.253"></a> 254 }<a name="line.254"></a> 255 }<a name="line.255"></a> 256 if (field != null) {<a name="line.256"></a> 257 if (isDyna) {<a name="line.257"></a> 258 if (! isParentClass(Map.class, field.getType()))<a name="line.258"></a> 259 return false;<a name="line.259"></a> 260 } else {<a name="line.260"></a> 261 if (! isParentClass(field.getType(), c))<a name="line.261"></a> 262 return false;<a name="line.262"></a> 263 }<a name="line.263"></a> 264 }<a name="line.264"></a> 265<a name="line.265"></a> 266 if (isDyna)<a name="line.266"></a> 267 rawTypeMeta = rawTypeMeta.getValueType();<a name="line.267"></a> 268 if (rawTypeMeta == null)<a name="line.268"></a> 269 return false;<a name="line.269"></a> 270<a name="line.270"></a> 271 if (typeMeta == null)<a name="line.271"></a> 272 typeMeta = (swap != null ? beanContext.getClassMeta(swap.getSwapClass()) : rawTypeMeta == null ? beanContext.object() : rawTypeMeta);<a name="line.272"></a> 273 if (typeMeta == null)<a name="line.273"></a> 274 typeMeta = rawTypeMeta;<a name="line.274"></a> 275<a name="line.275"></a> 276 return true;<a name="line.276"></a> 277 }<a name="line.277"></a> 278<a name="line.278"></a> 279 /**<a name="line.279"></a> 280 * @return A new BeanPropertyMeta object using this builder.<a name="line.280"></a> 281 */<a name="line.281"></a> 282 public BeanPropertyMeta build() {<a name="line.282"></a> 283 return new BeanPropertyMeta(this);<a name="line.283"></a> 284 }<a name="line.284"></a> 285<a name="line.285"></a> 286 private PojoSwap getPropertyPojoSwap(BeanProperty p) throws Exception {<a name="line.286"></a> 287 if (! p.format().isEmpty())<a name="line.287"></a> 288 return beanContext.newInstance(PojoSwap.class, StringFormatSwap.class, false, p.format());<a name="line.288"></a> 289 return null;<a name="line.289"></a> 290 }<a name="line.290"></a> 291<a name="line.291"></a> 292 private PojoSwap getPropertyPojoSwap(Swap s) throws Exception {<a name="line.292"></a> 293 Class<?> c = s.value();<a name="line.293"></a> 294 if (c == Null.class)<a name="line.294"></a> 295 c = s.impl();<a name="line.295"></a> 296 if (c == Null.class)<a name="line.296"></a> 297 return null;<a name="line.297"></a> 298 if (isParentClass(PojoSwap.class, c)) {<a name="line.298"></a> 299 PojoSwap ps = beanContext.newInstance(PojoSwap.class, c);<a name="line.299"></a> 300 if (ps.forMediaTypes() != null)<a name="line.300"></a> 301 throw new RuntimeException("TODO - Media types on swaps not yet supported on bean properties.");<a name="line.301"></a> 302 if (ps.withTemplate() != null)<a name="line.302"></a> 303 throw new RuntimeException("TODO - Templates on swaps not yet supported on bean properties.");<a name="line.303"></a> 304 return ps;<a name="line.304"></a> 305 }<a name="line.305"></a> 306 if (isParentClass(Surrogate.class, c))<a name="line.306"></a> 307 throw new RuntimeException("TODO - Surrogate swaps not yet supported on bean properties.");<a name="line.307"></a> 308 throw new FormattedRuntimeException("Invalid class used in @Swap annotation. Must be a subclass of PojoSwap or Surrogate.", c);<a name="line.308"></a> 309 }<a name="line.309"></a> 310<a name="line.310"></a> 311 BeanPropertyMeta.Builder setGetter(Method getter) {<a name="line.311"></a> 312 setAccessible(getter);<a name="line.312"></a> 313 this.getter = getter;<a name="line.313"></a> 314 return this;<a name="line.314"></a> 315 }<a name="line.315"></a> 316<a name="line.316"></a> 317 BeanPropertyMeta.Builder setSetter(Method setter) {<a name="line.317"></a> 318 setAccessible(setter);<a name="line.318"></a> 319 this.setter = setter;<a name="line.319"></a> 320 return this;<a name="line.320"></a> 321 }<a name="line.321"></a> 322<a name="line.322"></a> 323 BeanPropertyMeta.Builder setField(Field field) {<a name="line.323"></a> 324 setAccessible(field);<a name="line.324"></a> 325 this.field = field;<a name="line.325"></a> 326 return this;<a name="line.326"></a> 327 }<a name="line.327"></a> 328<a name="line.328"></a> 329 BeanPropertyMeta.Builder setAsConstructorArg() {<a name="line.329"></a> 330 this.isConstructorArg = true;<a name="line.330"></a> 331 return this;<a name="line.331"></a> 332 }<a name="line.332"></a> 333<a name="line.333"></a> 334 }<a name="line.334"></a> 335<a name="line.335"></a> 336 /**<a name="line.336"></a> 337 * Creates a new BeanPropertyMeta using the contents of the specified builder.<a name="line.337"></a> 338 * <a name="line.338"></a> 339 * @param b The builder to copy fields from.<a name="line.339"></a> 340 */<a name="line.340"></a> 341 protected BeanPropertyMeta(BeanPropertyMeta.Builder b) {<a name="line.341"></a> 342 this.field = b.field;<a name="line.342"></a> 343 this.getter = b.getter;<a name="line.343"></a> 344 this.setter = b.setter;<a name="line.344"></a> 345 this.isUri = b.isUri;<a name="line.345"></a> 346 this.beanMeta = b.beanMeta;<a name="line.346"></a> 347 this.beanContext = b.beanContext;<a name="line.347"></a> 348 this.name = b.name;<a name="line.348"></a> 349 this.rawTypeMeta = b.rawTypeMeta;<a name="line.349"></a> 350 this.typeMeta = b.typeMeta;<a name="line.350"></a> 351 this.properties = b.properties;<a name="line.351"></a> 352 this.swap = b.swap;<a name="line.352"></a> 353 this.beanRegistry = b.beanRegistry;<a name="line.353"></a> 354 this.overrideValue = b.overrideValue;<a name="line.354"></a> 355 this.delegateFor = b.delegateFor;<a name="line.355"></a> 356 this.extMeta = b.extMeta;<a name="line.356"></a> 357 this.isDyna = b.isDyna;<a name="line.357"></a> 358 this.canRead = b.canRead;<a name="line.358"></a> 359 this.canWrite = b.canWrite;<a name="line.359"></a> 360 }<a name="line.360"></a> 361<a name="line.361"></a> 362 /**<a name="line.362"></a> 363 * Returns the name of this bean property.<a name="line.363"></a> 364 * <a name="line.364"></a> 365 * @return The name of the bean property.<a name="line.365"></a> 366 */<a name="line.366"></a> 367 public String getName() {<a name="line.367"></a> 368 return name;<a name="line.368"></a> 369 }<a name="line.369"></a> 370<a name="line.370"></a> 371 /**<a name="line.371"></a> 372 * Returns the bean meta that this property belongs to.<a name="line.372"></a> 373 * <a name="line.373"></a> 374 * @return The bean meta that this property belongs to.<a name="line.374"></a> 375 */<a name="line.375"></a> 376 @BeanIgnore<a name="line.376"></a> 377 public BeanMeta<?> getBeanMeta() {<a name="line.377"></a> 378 return beanMeta;<a name="line.378"></a> 379 }<a name="line.379"></a> 380<a name="line.380"></a> 381 /**<a name="line.381"></a> 382 * Returns the getter method for this property.<a name="line.382"></a> 383 * <a name="line.383"></a> 384 * @return The getter method for this bean property, or <jk>null</jk> if there is no getter method.<a name="line.384"></a> 385 */<a name="line.385"></a> 386 public Method getGetter() {<a name="line.386"></a> 387 return getter;<a name="line.387"></a> 388 }<a name="line.388"></a> 389<a name="line.389"></a> 390 /**<a name="line.390"></a> 391 * Returns the setter method for this property.<a name="line.391"></a> 392 * <a name="line.392"></a> 393 * @return The setter method for this bean property, or <jk>null</jk> if there is no setter method.<a name="line.393"></a> 394 */<a name="line.394"></a> 395 public Method getSetter() {<a name="line.395"></a> 396 return setter;<a name="line.396"></a> 397 }<a name="line.397"></a> 398<a name="line.398"></a> 399 /**<a name="line.399"></a> 400 * Returns the field for this property.<a name="line.400"></a> 401 * <a name="line.401"></a> 402 * @return The field for this bean property, or <jk>null</jk> if there is no field associated with this bean property.<a name="line.402"></a> 403 */<a name="line.403"></a> 404 public Field getField() {<a name="line.404"></a> 405 return field;<a name="line.405"></a> 406 }<a name="line.406"></a> 407<a name="line.407"></a> 408 /**<a name="line.408"></a> 409 * Returns the {@link ClassMeta} of the class of this property.<a name="line.409"></a> 410 * <a name="line.410"></a> 411 * <a name="line.411"></a> 412 * If this property or the property type class has a {@link PojoSwap} associated with it, this method returns the<a name="line.412"></a> 413 * transformed class meta.<a name="line.413"></a> 414 * This matches the class type that is used by the {@link #get(BeanMap,String)} and<a name="line.414"></a> 415 * {@link #set(BeanMap,String,Object)} methods.<a name="line.415"></a> 416 * <a name="line.416"></a> 417 * @return The {@link ClassMeta} of the class of this property.<a name="line.417"></a> 418 */<a name="line.418"></a> 419 public ClassMeta<?> getClassMeta() {<a name="line.419"></a> 420 return typeMeta;<a name="line.420"></a> 421 }<a name="line.421"></a> 422<a name="line.422"></a> 423 /**<a name="line.423"></a> 424 * Returns the bean dictionary in use for this bean property.<a name="line.424"></a> 425 * <a name="line.425"></a> 426 * <a name="line.426"></a> 427 * The order of lookup for the dictionary is as follows:<a name="line.427"></a> 428 * <ol><a name="line.428"></a> 429 * <li>Dictionary defined via {@link BeanProperty#beanDictionary() @BeanProperty.beanDictionary()}.<a name="line.429"></a> 430 * <li>Dictionary defined via {@link BeanContext#BEAN_beanDictionary} context property.<a name="line.430"></a> 431 * </ol><a name="line.431"></a> 432 * <a name="line.432"></a> 433 * @return The bean dictionary in use for this bean property. Never <jk>null</jk>.<a name="line.433"></a> 434 */<a name="line.434"></a> 435 public BeanRegistry getBeanRegistry() {<a name="line.435"></a> 436 return beanRegistry;<a name="line.436"></a> 437 }<a name="line.437"></a> 438<a name="line.438"></a> 439 /**<a name="line.439"></a> 440 * Returns <jk>true</jk> if this bean property is a URI.<a name="line.440"></a> 441 * <a name="line.441"></a> 442 * <a name="line.442"></a> 443 * A bean property can be considered a URI if any of the following are true:<a name="line.443"></a> 444 * <ul><a name="line.444"></a> 445 * <li>Property class type is {@link URL} or {@link URI}.<a name="line.445"></a> 446 * <li>Property class type is annotated with {@link org.apache.juneau.annotation.URI @URI}.<a name="line.446"></a> 447 * <li>Property getter, setter, or field is annotated with {@link org.apache.juneau.annotation.URI @URI}.<a name="line.447"></a> 448 * </ul><a name="line.448"></a> 449 * <a name="line.449"></a> 450 * @return <jk>true</jk> if this bean property is a URI.<a name="line.450"></a> 451 */<a name="line.451"></a> 452 public boolean isUri() {<a name="line.452"></a> 453 return isUri;<a name="line.453"></a> 454 }<a name="line.454"></a> 455<a name="line.455"></a> 456 /**<a name="line.456"></a> 457 * Returns <jk>true</jk> if this bean property is named <js>"*"</js>.<a name="line.457"></a> 458 * <a name="line.458"></a> 459 * @return <jk>true</jk> if this bean property is named <js>"*"</js>.<a name="line.459"></a> 460 */<a name="line.460"></a> 461 public boolean isDyna() {<a name="line.461"></a> 462 return isDyna;<a name="line.462"></a> 463 }<a name="line.463"></a> 464<a name="line.464"></a> 465 /**<a name="line.465"></a> 466 * Returns the override list of properties defined through a {@link BeanProperty#properties() @BeanProperty.properties()} annotation<a name="line.466"></a> 467 * on this property.<a name="line.467"></a> 468 * <a name="line.468"></a> 469 * @return The list of override properties, or <jk>null</jk> if annotation not specified.<a name="line.469"></a> 470 */<a name="line.470"></a> 471 public String[] getProperties() {<a name="line.471"></a> 472 return properties;<a name="line.472"></a> 473 }<a name="line.473"></a> 474<a name="line.474"></a> 475 /**<a name="line.475"></a> 476 * Returns the language-specified extended metadata on this bean property.<a name="line.476"></a> 477 * <a name="line.477"></a> 478 * @param c The name of the metadata class to create.<a name="line.478"></a> 479 * @return Extended metadata on this bean property. Never <jk>null</jk>.<a name="line.479"></a> 480 */<a name="line.480"></a> 481 public <M extends BeanPropertyMetaExtended> M getExtendedMeta(Class<M> c) {<a name="line.481"></a> 482 if (delegateFor != null)<a name="line.482"></a> 483 return delegateFor.getExtendedMeta(c);<a name="line.483"></a> 484 return extMeta.get(c, this);<a name="line.484"></a> 485 }<a name="line.485"></a> 486<a name="line.486"></a> 487 /**<a name="line.487"></a> 488 * Equivalent to calling {@link BeanMap#get(Object)}, but is faster since it avoids looking up the property meta.<a name="line.488"></a> 489 * <a name="line.489"></a> 490 * @param m The bean map to get the transformed value from.<a name="line.490"></a> 491 * @param pName The property name.<a name="line.491"></a> 492 * @return The property value.<a name="line.492"></a> 493 */<a name="line.493"></a> 494 public Object get(BeanMap<?> m, String pName) {<a name="line.494"></a> 495 try {<a name="line.495"></a> 496 if (overrideValue != null)<a name="line.496"></a> 497 return overrideValue;<a name="line.497"></a> 498<a name="line.498"></a> 499 // Read-only beans have their properties stored in a cache until getBean() is called.<a name="line.499"></a> 500 Object bean = m.bean;<a name="line.500"></a> 501 if (bean == null)<a name="line.501"></a> 502 return m.propertyCache.get(name);<a name="line.502"></a> 503<a name="line.503"></a> 504 return toSerializedForm(m.getBeanSession(), getRaw(m, pName));<a name="line.504"></a> 505<a name="line.505"></a> 506 } catch (Throwable e) {<a name="line.506"></a> 507 if (beanContext.ignoreInvocationExceptionsOnGetters) {<a name="line.507"></a> 508 if (rawTypeMeta.isPrimitive())<a name="line.508"></a> 509 return rawTypeMeta.getPrimitiveDefault();<a name="line.509"></a> 510 return null;<a name="line.510"></a> 511 }<a name="line.511"></a> 512 throw new BeanRuntimeException(beanMeta.c, "Exception occurred while getting property ''{0}''", name).initCause(e);<a name="line.512"></a> 513 }<a name="line.513"></a> 514 }<a name="line.514"></a> 515<a name="line.515"></a> 516 /**<a name="line.516"></a> 517 * Equivalent to calling {@link BeanMap#getRaw(Object)}, but is faster since it avoids looking up the property meta.<a name="line.517"></a> 518 * <a name="line.518"></a> 519 * @param m The bean map to get the transformed value from.<a name="line.519"></a> 520 * @param pName The property name.<a name="line.520"></a> 521 * @return The raw property value.<a name="line.521"></a> 522 */<a name="line.522"></a> 523 public Object getRaw(BeanMap<?> m, String pName) {<a name="line.523"></a> 524 try {<a name="line.524"></a> 525 // Read-only beans have their properties stored in a cache until getBean() is called.<a name="line.525"></a> 526 Object bean = m.bean;<a name="line.526"></a> 527 if (bean == null)<a name="line.527"></a> 528 return m.propertyCache.get(name);<a name="line.528"></a> 529<a name="line.529"></a> 530 return invokeGetter(bean, pName);<a name="line.530"></a> 531<a name="line.531"></a> 532 } catch (Throwable e) {<a name="line.532"></a> 533 if (beanContext.ignoreInvocationExceptionsOnGetters) {<a name="line.533"></a> 534 if (rawTypeMeta.isPrimitive())<a name="line.534"></a> 535 return rawTypeMeta.getPrimitiveDefault();<a name="line.535"></a> 536 return null;<a name="line.536"></a> 537 }<a name="line.537"></a> 538 throw new BeanRuntimeException(beanMeta.c, "Exception occurred while getting property ''{0}''", name).initCause(e);<a name="line.538"></a> 539 }<a name="line.539"></a> 540 }<a name="line.540"></a> 541<a name="line.541"></a> 542 /**<a name="line.542"></a> 543 * Converts a raw bean property value to serialized form.<a name="line.543"></a> 544 * Applies transforms and child property filters.<a name="line.544"></a> 545 */<a name="line.545"></a> 546 final Object toSerializedForm(BeanSession session, Object o) {<a name="line.546"></a> 547 try {<a name="line.547"></a> 548 o = transform(session, o);<a name="line.548"></a> 549 if (o == null)<a name="line.549"></a> 550 return null;<a name="line.550"></a> 551 if (properties != null) {<a name="line.551"></a> 552 if (rawTypeMeta.isArray()) {<a name="line.552"></a> 553 Object[] a = (Object[])o;<a name="line.553"></a> 554 List l = new DelegateList(rawTypeMeta);<a name="line.554"></a> 555 ClassMeta childType = rawTypeMeta.getElementType();<a name="line.555"></a> 556 for (Object c : a)<a name="line.556"></a> 557 l.add(applyChildPropertiesFilter(session, childType, c));<a name="line.557"></a> 558 return l;<a name="line.558"></a> 559 } else if (rawTypeMeta.isCollection()) {<a name="line.559"></a> 560 Collection c = (Collection)o;<a name="line.560"></a> 561 List l = new ArrayList(c.size());<a name="line.561"></a> 562 ClassMeta childType = rawTypeMeta.getElementType();<a name="line.562"></a> 563 for (Object cc : c)<a name="line.563"></a> 564 l.add(applyChildPropertiesFilter(session, childType, cc));<a name="line.564"></a> 565 return l;<a name="line.565"></a> 566 } else {<a name="line.566"></a> 567 return applyChildPropertiesFilter(session, rawTypeMeta, o);<a name="line.567"></a> 568 }<a name="line.568"></a> 569 }<a name="line.569"></a> 570 return o;<a name="line.570"></a> 571 } catch (SerializeException e) {<a name="line.571"></a> 572 throw new BeanRuntimeException(e);<a name="line.572"></a> 573 }<a name="line.573"></a> 574 }<a name="line.574"></a> 575<a name="line.575"></a> 576 /**<a name="line.576"></a> 577 * Equivalent to calling {@link BeanMap#put(String, Object)}, but is faster since it avoids looking up the property<a name="line.577"></a> 578 * meta.<a name="line.578"></a> 579 * <a name="line.579"></a> 580 * @param m The bean map to set the property value on.<a name="line.580"></a> 581 * @param pName The property name.<a name="line.581"></a> 582 * @param value The value to set.<a name="line.582"></a> 583 * @return The previous property value.<a name="line.583"></a> 584 * @throws BeanRuntimeException If property could not be set.<a name="line.584"></a> 585 */<a name="line.585"></a> 586 public Object set(BeanMap<?> m, String pName, Object value) throws BeanRuntimeException {<a name="line.586"></a> 587 try {<a name="line.587"></a> 588<a name="line.588"></a> 589 BeanSession session = m.getBeanSession();<a name="line.589"></a> 590<a name="line.590"></a> 591 // Convert to raw form.<a name="line.591"></a> 592 value = unswap(session, value);<a name="line.592"></a> 593<a name="line.593"></a> 594 if (m.bean == null) {<a name="line.594"></a> 595<a name="line.595"></a> 596 // Read-only beans get their properties stored in a cache.<a name="line.596"></a> 597 if (m.propertyCache != null)<a name="line.597"></a> 598 return m.propertyCache.put(name, value);<a name="line.598"></a> 599<a name="line.599"></a> 600 throw new BeanRuntimeException("Non-existent bean instance on bean.");<a name="line.600"></a> 601 }<a name="line.601"></a> 602<a name="line.602"></a> 603 boolean isMap = rawTypeMeta.isMap();<a name="line.603"></a> 604 boolean isCollection = rawTypeMeta.isCollection();<a name="line.604"></a> 605<a name="line.605"></a> 606 if ((! isDyna) && field == null && setter == null && ! (isMap || isCollection)) {<a name="line.606"></a> 607 if ((value == null && beanContext.ignoreUnknownNullBeanProperties) || beanContext.ignorePropertiesWithoutSetters)<a name="line.607"></a> 608 return null;<a name="line.608"></a> 609 throw new BeanRuntimeException(beanMeta.c, "Setter or public field not defined on property ''{0}''", name);<a name="line.609"></a> 610 }<a name="line.610"></a> 611<a name="line.611"></a> 612 Object bean = m.getBean(true); // Don't use getBean() because it triggers array creation!<a name="line.612"></a> 613<a name="line.613"></a> 614 try {<a name="line.614"></a> 615<a name="line.615"></a> 616 Object r = beanContext.beanMapPutReturnsOldValue || isMap || isCollection ? get(m, pName) : null;<a name="line.616"></a> 617 Class<?> propertyClass = rawTypeMeta.getInnerClass();<a name="line.617"></a> 618<a name="line.618"></a> 619 if (value == null && (isMap || isCollection)) {<a name="line.619"></a> 620 invokeSetter(bean, pName, null);<a name="line.620"></a> 621 return r;<a name="line.621"></a> 622 }<a name="line.622"></a> 623<a name="line.623"></a> 624 if (isMap) {<a name="line.624"></a> 625<a name="line.625"></a> 626 if (! (value instanceof Map)) {<a name="line.626"></a> 627 if (value instanceof CharSequence)<a name="line.627"></a> 628 value = new ObjectMap((CharSequence)value).setBeanSession(session);<a name="line.628"></a> 629 else<a name="line.629"></a> 630 throw new BeanRuntimeException(beanMeta.c, "Cannot set property ''{0}'' of type ''{1}'' to object of type ''{2}''", name, propertyClass.getName(), findClassName(value));<a name="line.630"></a> 631 }<a name="line.631"></a> 632<a name="line.632"></a> 633 Map valueMap = (Map)value;<a name="line.633"></a> 634 Map propMap = (Map)r;<a name="line.634"></a> 635 ClassMeta<?> valueType = rawTypeMeta.getValueType();<a name="line.635"></a> 636<a name="line.636"></a> 637 // If the property type is abstract, then we either need to reuse the existing<a name="line.637"></a> 638 // map (if it's not null), or try to assign the value directly.<a name="line.638"></a> 639 if (! rawTypeMeta.canCreateNewInstance()) {<a name="line.639"></a> 640 if (propMap == null) {<a name="line.640"></a> 641 if (setter == null && field == null)<a name="line.641"></a> 642 throw new BeanRuntimeException(beanMeta.c, "Cannot set property ''{0}'' of type ''{1}'' to object of type ''{2}'' because no setter or public field is defined, and the current value is null", name, propertyClass.getName(), findClassName(value));<a name="line.642"></a> 643<a name="line.643"></a> 644 if (propertyClass.isInstance(valueMap)) {<a name="line.644"></a> 645 if (! valueType.isObject()) {<a name="line.645"></a> 646 for (Map.Entry e : (Set<Map.Entry>)valueMap.entrySet()) {<a name="line.646"></a> 647 Object v = e.getValue();<a name="line.647"></a> 648 if (v != null && ! valueType.getInnerClass().isInstance(v))<a name="line.648"></a> 649 throw new BeanRuntimeException(beanMeta.c, "Cannot set property ''{0}'' of type ''{1}'' to object of type ''{2}'' because the value types in the assigned map do not match the specified ''elementClass'' attribute on the property, and the property value is currently null", name, propertyClass.getName(), findClassName(value));<a name="line.649"></a> 650 }<a name="line.650"></a> 651 }<a name="line.651"></a> 652 invokeSetter(bean, pName, valueMap);<a name="line.652"></a> 653 return r;<a name="line.653"></a> 654 }<a name="line.654"></a> 655 throw new BeanRuntimeException(beanMeta.c, "Cannot set property ''{0}'' of type ''{2}'' to object of type ''{2}'' because the assigned map cannot be converted to the specified type because the property type is abstract, and the property value is currently null", name, propertyClass.getName(), findClassName(value));<a name="line.655"></a> 656 }<a name="line.656"></a> 657 } else {<a name="line.657"></a> 658 if (propMap == null) {<a name="line.658"></a> 659 propMap = beanContext.newInstance(Map.class, propertyClass);<a name="line.659"></a> 660 } else {<a name="line.660"></a> 661 propMap.clear();<a name="line.661"></a> 662 }<a name="line.662"></a> 663 }<a name="line.663"></a> 664<a name="line.664"></a> 665 // Set the values.<a name="line.665"></a> 666 for (Map.Entry e : (Set<Map.Entry>)valueMap.entrySet()) {<a name="line.666"></a> 667 Object k = e.getKey();<a name="line.667"></a> 668 Object v = e.getValue();<a name="line.668"></a> 669 if (! valueType.isObject())<a name="line.669"></a> 670 v = session.convertToType(v, valueType);<a name="line.670"></a> 671 propMap.put(k, v);<a name="line.671"></a> 672 }<a name="line.672"></a> 673 if (setter != null || field != null)<a name="line.673"></a> 674 invokeSetter(bean, pName, propMap);<a name="line.674"></a> 675<a name="line.675"></a> 676 } else if (isCollection) {<a name="line.676"></a> 677<a name="line.677"></a> 678 if (! (value instanceof Collection)) {<a name="line.678"></a> 679 if (value instanceof CharSequence)<a name="line.679"></a> 680 value = new ObjectList((CharSequence)value).setBeanSession(session);<a name="line.680"></a> 681 else<a name="line.681"></a> 682 throw new BeanRuntimeException(beanMeta.c, "Cannot set property ''{0}'' of type ''{1}'' to object of type ''{2}''", name, propertyClass.getName(), findClassName(value));<a name="line.682"></a> 683 }<a name="line.683"></a> 684<a name="line.684"></a> 685 Collection valueList = (Collection)value;<a name="line.685"></a> 686 Collection propList = (Collection)r;<a name="line.686"></a> 687 ClassMeta elementType = rawTypeMeta.getElementType();<a name="line.687"></a> 688<a name="line.688"></a> 689 // If the property type is abstract, then we either need to reuse the existing<a name="line.689"></a> 690 // collection (if it's not null), or try to assign the value directly.<a name="line.690"></a> 691 if (! rawTypeMeta.canCreateNewInstance()) {<a name="line.691"></a> 692 if (propList == null) {<a name="line.692"></a> 693 if (setter == null && field == null)<a name="line.693"></a> 694 throw new BeanRuntimeException(beanMeta.c, "Cannot set property ''{0}'' of type ''{1}'' to object of type ''{2}'' because no setter or public field is defined, and the current value is null", name, propertyClass.getName(), findClassName(value));<a name="line.694"></a> 695<a name="line.695"></a> 696 if (propertyClass.isInstance(valueList)) {<a name="line.696"></a> 697 if (! elementType.isObject()) {<a name="line.697"></a> 698 List l = new ObjectList(valueList);<a name="line.698"></a> 699 for (ListIterator<Object> i = l.listIterator(); i.hasNext(); ) {<a name="line.699"></a> 700 Object v = i.next();<a name="line.700"></a> 701 if (v != null && (! elementType.getInnerClass().isInstance(v))) {<a name="line.701"></a> 702 i.set(session.convertToType(v, elementType));<a name="line.702"></a> 703 }<a name="line.703"></a> 704 }<a name="line.704"></a> 705 valueList = l;<a name="line.705"></a> 706 }<a name="line.706"></a> 707 invokeSetter(bean, pName, valueList);<a name="line.707"></a> 708 return r;<a name="line.708"></a> 709 }<a name="line.709"></a> 710 throw new BeanRuntimeException(beanMeta.c, "Cannot set property ''{0}'' of type ''{1}'' to object of type ''{2}'' because the assigned map cannot be converted to the specified type because the property type is abstract, and the property value is currently null", name, propertyClass.getName(), findClassName(value));<a name="line.710"></a> 711 }<a name="line.711"></a> 712 propList.clear();<a name="line.712"></a> 713 } else {<a name="line.713"></a> 714 if (propList == null) {<a name="line.714"></a> 715 propList = beanContext.newInstance(Collection.class, propertyClass);<a name="line.715"></a> 716 invokeSetter(bean, pName, propList);<a name="line.716"></a> 717 } else {<a name="line.717"></a> 718 propList.clear();<a name="line.718"></a> 719 }<a name="line.719"></a> 720 }<a name="line.720"></a> 721<a name="line.721"></a> 722 // Set the values.<a name="line.722"></a> 723 for (Object v : valueList) {<a name="line.723"></a> 724 if (! elementType.isObject())<a name="line.724"></a> 725 v = session.convertToType(v, elementType);<a name="line.725"></a> 726 propList.add(v);<a name="line.726"></a> 727 }<a name="line.727"></a> 728<a name="line.728"></a> 729 } else {<a name="line.729"></a> 730 if (swap != null && value != null && isParentClass(swap.getSwapClass(), value.getClass())) {<a name="line.730"></a> 731 value = swap.unswap(session, value, rawTypeMeta);<a name="line.731"></a> 732 } else {<a name="line.732"></a> 733 value = session.convertToType(value, rawTypeMeta);<a name="line.733"></a> 734 }<a name="line.734"></a> 735 invokeSetter(bean, pName, value);<a name="line.735"></a> 736 }<a name="line.736"></a> 737<a name="line.737"></a> 738 return r;<a name="line.738"></a> 739<a name="line.739"></a> 740 } catch (BeanRuntimeException e) {<a name="line.740"></a> 741 throw e;<a name="line.741"></a> 742 } catch (Exception e) {<a name="line.742"></a> 743 e.printStackTrace();<a name="line.743"></a> 744 if (beanContext.ignoreInvocationExceptionsOnSetters) {<a name="line.744"></a> 745 if (rawTypeMeta.isPrimitive())<a name="line.745"></a> 746 return rawTypeMeta.getPrimitiveDefault();<a name="line.746"></a> 747 return null;<a name="line.747"></a> 748 }<a name="line.748"></a> 749 throw new BeanRuntimeException(beanMeta.c, "Error occurred trying to set property ''{0}''", name).initCause(e);<a name="line.749"></a> 750 }<a name="line.750"></a> 751 } catch (ParseException e) {<a name="line.751"></a> 752 throw new BeanRuntimeException(e);<a name="line.752"></a> 753 }<a name="line.753"></a> 754 }<a name="line.754"></a> 755<a name="line.755"></a> 756 private Object invokeGetter(Object bean, String pName) throws IllegalArgumentException, IllegalAccessException, InvocationTargetException {<a name="line.756"></a> 757 if (isDyna) {<a name="line.757"></a> 758 Map m = null;<a name="line.758"></a> 759 if (getter != null)<a name="line.759"></a> 760 m = (Map)getter.invoke(bean);<a name="line.760"></a> 761 else if (field != null)<a name="line.761"></a> 762 m = (Map)field.get(bean);<a name="line.762"></a> 763 else<a name="line.763"></a> 764 throw new BeanRuntimeException(beanMeta.c, "Getter or public field not defined on property ''{0}''", name);<a name="line.764"></a> 765 return (m == null ? null : m.get(pName));<a name="line.765"></a> 766 }<a name="line.766"></a> 767 if (getter != null)<a name="line.767"></a> 768 return getter.invoke(bean);<a name="line.768"></a> 769 if (field != null)<a name="line.769"></a> 770 return field.get(bean);<a name="line.770"></a> 771 throw new BeanRuntimeException(beanMeta.c, "Getter or public field not defined on property ''{0}''", name);<a name="line.771"></a> 772 }<a name="line.772"></a> 773<a name="line.773"></a> 774 private Object invokeSetter(Object bean, String pName, Object val) throws IllegalArgumentException, IllegalAccessException, InvocationTargetException {<a name="line.774"></a> 775 if (isDyna) {<a name="line.775"></a> 776 if (setter != null)<a name="line.776"></a> 777 return setter.invoke(bean, pName, val);<a name="line.777"></a> 778 Map m = null;<a name="line.778"></a> 779 if (field != null)<a name="line.779"></a> 780 m = (Map<String,Object>)field.get(bean);<a name="line.780"></a> 781 else if (getter != null)<a name="line.781"></a> 782 m = (Map<String,Object>)getter.invoke(bean);<a name="line.782"></a> 783 else<a name="line.783"></a> 784 throw new BeanRuntimeException(beanMeta.c, "Cannot set property ''{0}'' of type ''{1}'' to object of type ''{2}'' because no setter is defined on this property, and the existing property value is null", name, this.getClassMeta().getInnerClass().getName(), findClassName(val));<a name="line.784"></a> 785 return (m == null ? null : m.put(pName, val));<a name="line.785"></a> 786 }<a name="line.786"></a> 787 if (setter != null)<a name="line.787"></a> 788 return setter.invoke(bean, val);<a name="line.788"></a> 789 if (field != null) {<a name="line.789"></a> 790 field.set(bean, val);<a name="line.790"></a> 791 return null;<a name="line.791"></a> 792 }<a name="line.792"></a> 793 throw new BeanRuntimeException(beanMeta.c, "Cannot set property ''{0}'' of type ''{1}'' to object of type ''{2}'' because no setter is defined on this property, and the existing property value is null", name, this.getClassMeta().getInnerClass().getName(), findClassName(val));<a name="line.793"></a> 794 }<a name="line.794"></a> 795<a name="line.795"></a> 796 /**<a name="line.796"></a> 797 * Returns the {@link Map} object returned by the DynaBean getter.<a name="line.797"></a> 798 * <a name="line.798"></a> 799 * <a name="line.799"></a> 800 * The DynaBean property is the property whose name is <js>"*"</js> and returns a map of "extra" properties on the<a name="line.800"></a> 801 * bean.<a name="line.801"></a> 802 * <a name="line.802"></a> 803 * @param bean The bean.<a name="line.803"></a> 804 * @return<a name="line.804"></a> 805 * The map returned by the getter, or an empty map if the getter returned <jk>null</jk> or this isn't a DynaBean<a name="line.805"></a> 806 * property.<a name="line.806"></a> 807 * @throws IllegalArgumentException Thrown by method invocation.<a name="line.807"></a> 808 * @throws IllegalAccessException Thrown by method invocation.<a name="line.808"></a> 809 * @throws InvocationTargetException Thrown by method invocation.<a name="line.809"></a> 810 */<a name="line.810"></a> 811 public Map<String,Object> getDynaMap(Object bean) throws IllegalArgumentException, IllegalAccessException, InvocationTargetException {<a name="line.811"></a> 812 if (isDyna) {<a name="line.812"></a> 813 if (getter != null)<a name="line.813"></a> 814 return (Map)getter.invoke(bean);<a name="line.814"></a> 815 if (field != null)<a name="line.815"></a> 816 return (Map)field.get(bean);<a name="line.816"></a> 817 throw new BeanRuntimeException(beanMeta.c, "Getter or public field not defined on property ''{0}''", name);<a name="line.817"></a> 818 }<a name="line.818"></a> 819 return Collections.EMPTY_MAP;<a name="line.819"></a> 820 }<a name="line.820"></a> 821<a name="line.821"></a> 822 /**<a name="line.822"></a> 823 * Sets an array field on this bean.<a name="line.823"></a> 824 * <a name="line.824"></a> 825 * <a name="line.825"></a> 826 * Works on both <code>Object</code> and primitive arrays.<a name="line.826"></a> 827 * <a name="line.827"></a> 828 * @param bean The bean of the field.<a name="line.828"></a> 829 * @param l The collection to use to set the array field.<a name="line.829"></a> 830 * @throws IllegalArgumentException Thrown by method invocation.<a name="line.830"></a> 831 * @throws IllegalAccessException Thrown by method invocation.<a name="line.831"></a> 832 * @throws InvocationTargetException Thrown by method invocation.<a name="line.832"></a> 833 */<a name="line.833"></a> 834 protected void setArray(Object bean, List l) throws IllegalArgumentException, IllegalAccessException, InvocationTargetException {<a name="line.834"></a> 835 Object array = toArray(l, this.rawTypeMeta.getElementType().getInnerClass());<a name="line.835"></a> 836 invokeSetter(bean, name, array);<a name="line.836"></a> 837 }<a name="line.837"></a> 838<a name="line.838"></a> 839 /**<a name="line.839"></a> 840 * Adds a value to a {@link Collection} or array property.<a name="line.840"></a> 841 * <a name="line.841"></a> 842 * <a name="line.842"></a> 843 * Note that adding values to an array property is inefficient for large arrays since it must copy the array into a<a name="line.843"></a> 844 * larger array on each operation.<a name="line.844"></a> 845 * <a name="line.845"></a> 846 * @param m The bean of the field being set.<a name="line.846"></a> 847 * @param pName The property name.<a name="line.847"></a> 848 * @param value The value to add to the field.<a name="line.848"></a> 849 * @throws BeanRuntimeException If field is not a collection or array.<a name="line.849"></a> 850 */<a name="line.850"></a> 851 public void add(BeanMap<?> m, String pName, Object value) throws BeanRuntimeException {<a name="line.851"></a> 852<a name="line.852"></a> 853 // Read-only beans get their properties stored in a cache.<a name="line.853"></a> 854 if (m.bean == null) {<a name="line.854"></a> 855 if (! m.propertyCache.containsKey(name))<a name="line.855"></a> 856 m.propertyCache.put(name, new ObjectList(m.getBeanSession()));<a name="line.856"></a> 857 ((ObjectList)m.propertyCache.get(name)).add(value);<a name="line.857"></a> 858 return;<a name="line.858"></a> 859 }<a name="line.859"></a> 860<a name="line.860"></a> 861 BeanSession session = m.getBeanSession();<a name="line.861"></a> 862<a name="line.862"></a> 863 boolean isCollection = rawTypeMeta.isCollection();<a name="line.863"></a> 864 boolean isArray = rawTypeMeta.isArray();<a name="line.864"></a> 865<a name="line.865"></a> 866 if (! (isCollection || isArray))<a name="line.866"></a> 867 throw new BeanRuntimeException(beanMeta.c, "Attempt to add element to property ''{0}'' which is not a collection or array", name);<a name="line.867"></a> 868<a name="line.868"></a> 869 Object bean = m.getBean(true);<a name="line.869"></a> 870<a name="line.870"></a> 871 ClassMeta<?> elementType = rawTypeMeta.getElementType();<a name="line.871"></a> 872<a name="line.872"></a> 873 try {<a name="line.873"></a> 874 Object v = session.convertToType(value, elementType);<a name="line.874"></a> 875<a name="line.875"></a> 876 if (isCollection) {<a name="line.876"></a> 877 Collection c = (Collection)invokeGetter(bean, pName);<a name="line.877"></a> 878<a name="line.878"></a> 879 if (c != null) {<a name="line.879"></a> 880 c.add(v);<a name="line.880"></a> 881 return;<a name="line.881"></a> 882 }<a name="line.882"></a> 883<a name="line.883"></a> 884 if (rawTypeMeta.canCreateNewInstance())<a name="line.884"></a> 885 c = (Collection)rawTypeMeta.newInstance();<a name="line.885"></a> 886 else<a name="line.886"></a> 887 c = new ObjectList(session);<a name="line.887"></a> 888<a name="line.888"></a> 889 c.add(v);<a name="line.889"></a> 890<a name="line.890"></a> 891 invokeSetter(bean, pName, c);<a name="line.891"></a> 892<a name="line.892"></a> 893 } else /* isArray() */ {<a name="line.893"></a> 894<a name="line.894"></a> 895 if (m.arrayPropertyCache == null)<a name="line.895"></a> 896 m.arrayPropertyCache = new TreeMap<>();<a name="line.896"></a> 897<a name="line.897"></a> 898 List l = m.arrayPropertyCache.get(name);<a name="line.898"></a> 899 if (l == null) {<a name="line.899"></a> 900 l = new LinkedList(); // ArrayLists and LinkLists appear to perform equally.<a name="line.900"></a> 901 m.arrayPropertyCache.put(name, l);<a name="line.901"></a> 902<a name="line.902"></a> 903 // Copy any existing array values into the temporary list.<a name="line.903"></a> 904 Object oldArray = invokeGetter(bean, pName);<a name="line.904"></a> 905 copyToList(oldArray, l);<a name="line.905"></a> 906 }<a name="line.906"></a> 907<a name="line.907"></a> 908 // Add new entry to our array.<a name="line.908"></a> 909 l.add(v);<a name="line.909"></a> 910 }<a name="line.910"></a> 911<a name="line.911"></a> 912 } catch (BeanRuntimeException e) {<a name="line.912"></a> 913 throw e;<a name="line.913"></a> 914 } catch (Exception e) {<a name="line.914"></a> 915 throw new BeanRuntimeException(e);<a name="line.915"></a> 916 }<a name="line.916"></a> 917 }<a name="line.917"></a> 918<a name="line.918"></a> 919 /**<a name="line.919"></a> 920 * Adds a value to a {@link Map} or bean property.<a name="line.920"></a> 921 * <a name="line.921"></a> 922 * @param m The bean of the field being set.<a name="line.922"></a> 923 * @param pName The property name.<a name="line.923"></a> 924 * @param key The key to add to the field.<a name="line.924"></a> 925 * @param value The value to add to the field.<a name="line.925"></a> 926 * @throws BeanRuntimeException If field is not a map or array.<a name="line.926"></a> 927 */<a name="line.927"></a> 928 public void add(BeanMap<?> m, String pName, String key, Object value) throws BeanRuntimeException {<a name="line.928"></a> 929<a name="line.929"></a> 930 // Read-only beans get their properties stored in a cache.<a name="line.930"></a> 931 if (m.bean == null) {<a name="line.931"></a> 932 if (! m.propertyCache.containsKey(name))<a name="line.932"></a> 933 m.propertyCache.put(name, new ObjectMap(m.getBeanSession()));<a name="line.933"></a> 934 ((ObjectMap)m.propertyCache.get(name)).append(key.toString(), value);<a name="line.934"></a> 935 return;<a name="line.935"></a> 936 }<a name="line.936"></a> 937<a name="line.937"></a> 938 BeanSession session = m.getBeanSession();<a name="line.938"></a> 939<a name="line.939"></a> 940 boolean isMap = rawTypeMeta.isMap();<a name="line.940"></a> 941 boolean isBean = rawTypeMeta.isBean();<a name="line.941"></a> 942<a name="line.942"></a> 943 if (! (isBean || isMap))<a name="line.943"></a> 944 throw new BeanRuntimeException(beanMeta.c, "Attempt to add key/value to property ''{0}'' which is not a map or bean", name);<a name="line.944"></a> 945<a name="line.945"></a> 946 Object bean = m.getBean(true);<a name="line.946"></a> 947<a name="line.947"></a> 948 ClassMeta<?> elementType = rawTypeMeta.getElementType();<a name="line.948"></a> 949<a name="line.949"></a> 950 try {<a name="line.950"></a> 951 Object v = session.convertToType(value, elementType);<a name="line.951"></a> 952<a name="line.952"></a> 953 if (isMap) {<a name="line.953"></a> 954 Map map = (Map)invokeGetter(bean, pName);<a name="line.954"></a> 955<a name="line.955"></a> 956 if (map != null) {<a name="line.956"></a> 957 map.put(key, v);<a name="line.957"></a> 958 return;<a name="line.958"></a> 959 }<a name="line.959"></a> 960<a name="line.960"></a> 961 if (rawTypeMeta.canCreateNewInstance())<a name="line.961"></a> 962 map = (Map)rawTypeMeta.newInstance();<a name="line.962"></a> 963 else<a name="line.963"></a> 964 map = new ObjectMap(session);<a name="line.964"></a> 965<a name="line.965"></a> 966 map.put(key, v);<a name="line.966"></a> 967<a name="line.967"></a> 968 invokeSetter(bean, pName, map);<a name="line.968"></a> 969<a name="line.969"></a> 970 } else /* isBean() */ {<a name="line.970"></a> 971<a name="line.971"></a> 972 Object b = invokeGetter(bean, pName);<a name="line.972"></a> 973<a name="line.973"></a> 974 if (b != null) {<a name="line.974"></a> 975 BeanMap bm = session.toBeanMap(b);<a name="line.975"></a> 976 bm.put(key, v);<a name="line.976"></a> 977 return;<a name="line.977"></a> 978 }<a name="line.978"></a> 979<a name="line.979"></a> 980 if (rawTypeMeta.canCreateNewInstance(m.getBean(false))) {<a name="line.980"></a> 981 b = rawTypeMeta.newInstance();<a name="line.981"></a> 982 BeanMap bm = session.toBeanMap(b);<a name="line.982"></a> 983 bm.put(key, v);<a name="line.983"></a> 984 }<a name="line.984"></a> 985<a name="line.985"></a> 986 invokeSetter(bean, pName, b);<a name="line.986"></a> 987 }<a name="line.987"></a> 988<a name="line.988"></a> 989 } catch (BeanRuntimeException e) {<a name="line.989"></a> 990 throw e;<a name="line.990"></a> 991 } catch (Exception e) {<a name="line.991"></a> 992 throw new BeanRuntimeException(e);<a name="line.992"></a> 993 }<a name="line.993"></a> 994 }<a name="line.994"></a> 995<a name="line.995"></a> 996 /**<a name="line.996"></a> 997 * Returns all instances of the specified annotation in the hierarchy of this bean property.<a name="line.997"></a> 998 * <a name="line.998"></a> 999 * <a name="line.999"></a> 1000 * Searches through the class hierarchy (e.g. superclasses, interfaces, packages) for all instances of the<a name="line.1000"></a> 1001 * specified annotation.<a name="line.1001"></a> 1002 * <a name="line.1002"></a> 1003 * @param a The class to find annotations for.<a name="line.1003"></a> 1004 * @return A list of annotations ordered in child-to-parent order. Never <jk>null</jk>.<a name="line.1004"></a> 1005 */<a name="line.1005"></a> 1006 public <A extends Annotation> List<A> findAnnotations(Class<A> a) {<a name="line.1006"></a> 1007 List<A> l = new LinkedList<>();<a name="line.1007"></a> 1008 if (field != null) {<a name="line.1008"></a> 1009 addIfNotNull(l, field.getAnnotation(a));<a name="line.1009"></a> 1010 appendAnnotations(a, field.getType(), l);<a name="line.1010"></a> 1011 }<a name="line.1011"></a> 1012 if (getter != null) {<a name="line.1012"></a> 1013 addIfNotNull(l, getMethodAnnotation(a, getter));<a name="line.1013"></a> 1014 appendAnnotations(a, getter.getReturnType(), l);<a name="line.1014"></a> 1015 }<a name="line.1015"></a> 1016 if (setter != null) {<a name="line.1016"></a> 1017 addIfNotNull(l, getMethodAnnotation(a, setter));<a name="line.1017"></a> 1018 appendAnnotations(a, setter.getReturnType(), l);<a name="line.1018"></a> 1019 }<a name="line.1019"></a> 1020<a name="line.1020"></a> 1021 appendAnnotations(a, this.getBeanMeta().getClassMeta().getInnerClass(), l);<a name="line.1021"></a> 1022 return l;<a name="line.1022"></a> 1023 }<a name="line.1023"></a> 1024<a name="line.1024"></a> 1025 /**<a name="line.1025"></a> 1026 * Returns the specified annotation on the field or methods that define this property.<a name="line.1026"></a> 1027 * <a name="line.1027"></a> 1028 * <a name="line.1028"></a> 1029 * This method will search up the parent class/interface hierarchy chain to search for the annotation on<a name="line.1029"></a> 1030 * overridden getters and setters.<a name="line.1030"></a> 1031 * <a name="line.1031"></a> 1032 * @param a The annotation to search for.<a name="line.1032"></a> 1033 * @return The annotation, or <jk>null</jk> if it wasn't found.<a name="line.1033"></a> 1034 */<a name="line.1034"></a> 1035 public <A extends Annotation> A getAnnotation(Class<A> a) {<a name="line.1035"></a> 1036 A t = null;<a name="line.1036"></a> 1037 if (field != null)<a name="line.1037"></a> 1038 t = field.getAnnotation(a);<a name="line.1038"></a> 1039 if (t == null && getter != null)<a name="line.1039"></a> 1040 t = getMethodAnnotation(a, getter);<a name="line.1040"></a> 1041 if (t == null && setter != null)<a name="line.1041"></a> 1042 t = getMethodAnnotation(a, setter);<a name="line.1042"></a> 1043 return t;<a name="line.1043"></a> 1044 }<a name="line.1044"></a> 1045<a name="line.1045"></a> 1046 private Object transform(BeanSession session, Object o) throws SerializeException {<a name="line.1046"></a> 1047 try {<a name="line.1047"></a> 1048 // First use swap defined via @BeanProperty.<a name="line.1048"></a> 1049 if (swap != null)<a name="line.1049"></a> 1050 return swap.swap(session, o);<a name="line.1050"></a> 1051 if (o == null)<a name="line.1051"></a> 1052 return null;<a name="line.1052"></a> 1053 // Otherwise, look it up via bean context.<a name="line.1053"></a> 1054 if (rawTypeMeta.hasChildPojoSwaps()) {<a name="line.1054"></a> 1055 PojoSwap f = rawTypeMeta.getChildPojoSwapForSwap(o.getClass());<a name="line.1055"></a> 1056 if (f != null)<a name="line.1056"></a> 1057 return f.swap(session, o);<a name="line.1057"></a> 1058 }<a name="line.1058"></a> 1059 return o;<a name="line.1059"></a> 1060 } catch (SerializeException e) {<a name="line.1060"></a> 1061 throw e;<a name="line.1061"></a> 1062 } catch (Exception e) {<a name="line.1062"></a> 1063 throw new SerializeException(e);<a name="line.1063"></a> 1064 }<a name="line.1064"></a> 1065 }<a name="line.1065"></a> 1066<a name="line.1066"></a> 1067 private Object unswap(BeanSession session, Object o) throws ParseException {<a name="line.1067"></a> 1068 try {<a name="line.1068"></a> 1069 if (swap != null)<a name="line.1069"></a> 1070 return swap.unswap(session, o, rawTypeMeta);<a name="line.1070"></a> 1071 if (o == null)<a name="line.1071"></a> 1072 return null;<a name="line.1072"></a> 1073 if (rawTypeMeta.hasChildPojoSwaps()) {<a name="line.1073"></a> 1074 PojoSwap f = rawTypeMeta.getChildPojoSwapForUnswap(o.getClass());<a name="line.1074"></a> 1075 if (f != null)<a name="line.1075"></a> 1076 return f.unswap(session, o, rawTypeMeta);<a name="line.1076"></a> 1077 }<a name="line.1077"></a> 1078 return o;<a name="line.1078"></a> 1079 } catch (ParseException e) {<a name="line.1079"></a> 1080 throw e;<a name="line.1080"></a> 1081 } catch (Exception e) {<a name="line.1081"></a> 1082 throw new ParseException(e);<a name="line.1082"></a> 1083 }<a name="line.1083"></a> 1084 }<a name="line.1084"></a> 1085<a name="line.1085"></a> 1086 private Object applyChildPropertiesFilter(BeanSession session, ClassMeta cm, Object o) {<a name="line.1086"></a> 1087 if (o == null)<a name="line.1087"></a> 1088 return null;<a name="line.1088"></a> 1089 if (cm.isBean())<a name="line.1089"></a> 1090 return new BeanMap(session, o, new BeanMetaFiltered(cm.getBeanMeta(), properties));<a name="line.1090"></a> 1091 if (cm.isMap())<a name="line.1091"></a> 1092 return new FilteredMap(cm, (Map)o, properties);<a name="line.1092"></a> 1093 if (cm.isObject()) {<a name="line.1093"></a> 1094 if (o instanceof Map)<a name="line.1094"></a> 1095 return new FilteredMap(cm, (Map)o, properties);<a name="line.1095"></a> 1096 BeanMeta bm = beanContext.getBeanMeta(o.getClass());<a name="line.1096"></a> 1097 if (bm != null)<a name="line.1097"></a> 1098 return new BeanMap(session, o, new BeanMetaFiltered(cm.getBeanMeta(), properties));<a name="line.1098"></a> 1099 }<a name="line.1099"></a> 1100 return o;<a name="line.1100"></a> 1101 }<a name="line.1101"></a> 1102<a name="line.1102"></a> 1103 private static String findClassName(Object o) {<a name="line.1103"></a> 1104 if (o == null)<a name="line.1104"></a> 1105 return null;<a name="line.1105"></a> 1106 if (o instanceof Class)<a name="line.1106"></a> 1107 return ((Class<?>)o).getName();<a name="line.1107"></a> 1108 return o.getClass().getName();<a name="line.1108"></a> 1109 }<a name="line.1109"></a> 1110<a name="line.1110"></a> 1111 @Override /* Object */<a name="line.1111"></a> 1112 public String toString() {<a name="line.1112"></a> 1113 return name + ": " + this.rawTypeMeta.getInnerClass().getName() + ", field=["+field+"], getter=["+getter+"], setter=["+setter+"]";<a name="line.1113"></a> 1114 }<a name="line.1114"></a> 1115<a name="line.1115"></a> 1116 /**<a name="line.1116"></a> 1117 * Returns <jk>true</jk> if this property can be read.<a name="line.1117"></a> 1118 * <a name="line.1118"></a> 1119 * @return <jk>true</jk> if this property can be read.<a name="line.1119"></a> 1120 */<a name="line.1120"></a> 1121 public boolean canRead() {<a name="line.1121"></a> 1122 return canRead;<a name="line.1122"></a> 1123 }<a name="line.1123"></a> 1124<a name="line.1124"></a> 1125 /**<a name="line.1125"></a> 1126 * Returns <jk>true</jk> if this property can be written.<a name="line.1126"></a> 1127 * <a name="line.1127"></a> 1128 * @return <jk>true</jk> if this property can be written.<a name="line.1128"></a> 1129 */<a name="line.1129"></a> 1130 public boolean canWrite() {<a name="line.1130"></a> 1131 return canWrite;<a name="line.1131"></a> 1132 }<a name="line.1132"></a> 1133}<a name="line.1133"></a> </pre> </div> </body> </html>

content/site/apidocs-7.1.0/src-html/org/apache/juneau/BeanPropertyMeta.html (1,145 lines of code) (raw):