001// *************************************************************************************************************************** 002// * Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file * 003// * distributed with this work for additional information regarding copyright ownership. The ASF licenses this file * 004// * to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance * 005// * with the License. You may obtain a copy of the License at * 006// * * 007// * http://www.apache.org/licenses/LICENSE-2.0 * 008// * * 009// * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an * 010// * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the * 011// * specific language governing permissions and limitations under the License. * 012// *************************************************************************************************************************** 013package org.apache.juneau; 014 015import static org.apache.juneau.BeanTraverseContext.*; 016 017import java.util.*; 018 019import org.apache.juneau.http.*; 020 021/** 022 * Builder class for building instances of bean traversals. 023 */ 024public class BeanTraverseBuilder extends BeanContextBuilder { 025 026 /** 027 * Constructor, default settings. 028 */ 029 public BeanTraverseBuilder() { 030 super(); 031 } 032 033 /** 034 * Constructor. 035 * 036 * @param ps The initial configuration settings for this builder. 037 */ 038 public BeanTraverseBuilder(PropertyStore ps) { 039 super(ps); 040 } 041 042 043 //----------------------------------------------------------------------------------------------------------------- 044 // Properties 045 //----------------------------------------------------------------------------------------------------------------- 046 047 /** 048 * Configuration property: Automatically detect POJO recursions. 049 * 050 * <p> 051 * Specifies that recursions should be checked for during traversal. 052 * 053 * <h5 class='section'>Notes:</h5> 054 * <ul class='spaced-list'> 055 * <li> 056 * Checking for recursion can cause a small performance penalty. 057 * </ul> 058 * 059 * <h5 class='section'>See Also:</h5> 060 * <ul> 061 * <li class='jf'>{@link BeanTraverseContext#BEANTRAVERSE_detectRecursions} 062 * </ul> 063 * 064 * @param value 065 * The new value for this property. 066 * <br>The default is <jk>false</jk>. 067 * @return This object (for method chaining). 068 */ 069 public BeanTraverseBuilder detectRecursions(boolean value) { 070 return set(BEANTRAVERSE_detectRecursions, value); 071 } 072 073 /** 074 * Configuration property: Automatically detect POJO recursions. 075 * 076 * <p> 077 * Shortcut for calling <code>detectRecursions(<jk>true</jk>)</code>. 078 * 079 * <h5 class='section'>See Also:</h5> 080 * <ul> 081 * <li class='jf'>{@link BeanTraverseContext#BEANTRAVERSE_detectRecursions} 082 * </ul> 083 * 084 * @return This object (for method chaining). 085 */ 086 public BeanTraverseBuilder detectRecursions() { 087 return set(BEANTRAVERSE_detectRecursions, true); 088 } 089 090 /** 091 * Configuration property: Ignore recursion errors. 092 * 093 * <p> 094 * If <jk>true</jk>, when we encounter the same object when traversing a tree, we set the value to <jk>null</jk>. 095 * Otherwise, an exception is thrown. 096 * 097 * <h5 class='section'>Notes:</h5> 098 * <ul class='spaced-list'> 099 * <li> 100 * Checking for recursion can cause a small performance penalty. 101 * </ul> 102 * 103 * <h5 class='section'>See Also:</h5> 104 * <ul> 105 * <li class='jf'>{@link BeanTraverseContext#BEANTRAVERSE_ignoreRecursions} 106 * </ul> 107 * 108 * @param value 109 * The new value for this property. 110 * <br>The default is <jk>false</jk>. 111 * @return This object (for method chaining). 112 */ 113 public BeanTraverseBuilder ignoreRecursions(boolean value) { 114 return set(BEANTRAVERSE_ignoreRecursions, value); 115 } 116 117 /** 118 * Configuration property: Ignore recursion errors. 119 * 120 * <p> 121 * Shortcut for calling <code>ignoreRecursions(<jk>true</jk>)</code>. 122 * 123 * <h5 class='section'>See Also:</h5> 124 * <ul> 125 * <li class='jf'>{@link BeanTraverseContext#BEANTRAVERSE_ignoreRecursions} 126 * </ul> 127 * 128 * @return This object (for method chaining). 129 */ 130 public BeanTraverseBuilder ignoreRecursions() { 131 return set(BEANTRAVERSE_ignoreRecursions, true); 132 } 133 134 /** 135 * Configuration property: Initial depth. 136 * 137 * <p> 138 * The initial indentation level at the root. 139 * 140 * <h5 class='section'>See Also:</h5> 141 * <ul> 142 * <li class='jf'>{@link BeanTraverseContext#BEANTRAVERSE_initialDepth} 143 * </ul> 144 * 145 * @param value 146 * The new value for this property. 147 * <br>The default is <code>0</code>. 148 * @return This object (for method chaining). 149 */ 150 public BeanTraverseBuilder initialDepth(int value) { 151 return set(BEANTRAVERSE_initialDepth, value); 152 } 153 154 /** 155 * Configuration property: Max traversal depth. 156 * 157 * <p> 158 * Abort traversal if specified depth is reached in the POJO tree. 159 * <br>If this depth is exceeded, an exception is thrown. 160 * <br>This prevents stack overflows from occurring when trying to traverse models with recursive references. 161 * 162 * <h5 class='section'>See Also:</h5> 163 * <ul> 164 * <li class='jf'>{@link BeanTraverseContext#BEANTRAVERSE_maxDepth} 165 * </ul> 166 * 167 * @param value 168 * The new value for this property. 169 * <br>The default is <code>100</code>. 170 * @return This object (for method chaining). 171 */ 172 public BeanTraverseBuilder maxDepth(int value) { 173 return set(BEANTRAVERSE_maxDepth, value); 174 } 175 176 177 @Override /* BeanContextBuilder */ 178 public BeanTraverseBuilder beanClassVisibility(Visibility value) { 179 super.beanClassVisibility(value); 180 return this; 181 } 182 183 @Override /* BeanContextBuilder */ 184 public BeanTraverseBuilder beanConstructorVisibility(Visibility value) { 185 super.beanConstructorVisibility(value); 186 return this; 187 } 188 189 @Override /* BeanContextBuilder */ 190 public BeanTraverseBuilder beanDictionary(boolean append, Object...values) { 191 super.beanDictionary(append, values); 192 return this; 193 } 194 195 @Override /* BeanContextBuilder */ 196 public BeanTraverseBuilder beanDictionary(Class<?>...values) { 197 super.beanDictionary(values); 198 return this; 199 } 200 201 @Override /* BeanContextBuilder */ 202 public BeanTraverseBuilder beanDictionary(Object...values) { 203 super.beanDictionary(values); 204 return this; 205 } 206 207 @Override /* BeanContextBuilder */ 208 public BeanTraverseBuilder beanDictionaryRemove(Object...values) { 209 super.beanDictionaryRemove(values); 210 return this; 211 } 212 213 @Override /* BeanContextBuilder */ 214 public BeanTraverseBuilder beanFieldVisibility(Visibility value) { 215 super.beanFieldVisibility(value); 216 return this; 217 } 218 219 @Override /* BeanContextBuilder */ 220 public BeanTraverseBuilder beanFilters(boolean append, Object...values) { 221 super.beanFilters(append, values); 222 return this; 223 } 224 225 @Override /* BeanContextBuilder */ 226 public BeanTraverseBuilder beanFilters(Class<?>...values) { 227 super.beanFilters(values); 228 return this; 229 } 230 231 @Override /* BeanContextBuilder */ 232 public BeanTraverseBuilder beanFilters(Object...values) { 233 super.beanFilters(values); 234 return this; 235 } 236 237 @Override /* BeanContextBuilder */ 238 public BeanTraverseBuilder beanFiltersRemove(Object...values) { 239 super.beanFiltersRemove(values); 240 return this; 241 } 242 243 @Override /* BeanContextBuilder */ 244 public BeanTraverseBuilder beanMapPutReturnsOldValue(boolean value) { 245 super.beanMapPutReturnsOldValue(value); 246 return this; 247 } 248 249 @Override /* BeanContextBuilder */ 250 public BeanTraverseBuilder beanMapPutReturnsOldValue() { 251 super.beanMapPutReturnsOldValue(); 252 return this; 253 } 254 255 @Override /* BeanContextBuilder */ 256 public BeanTraverseBuilder beanMethodVisibility(Visibility value) { 257 super.beanMethodVisibility(value); 258 return this; 259 } 260 261 @Override /* BeanContextBuilder */ 262 public BeanTraverseBuilder beansRequireDefaultConstructor(boolean value) { 263 super.beansRequireDefaultConstructor(value); 264 return this; 265 } 266 267 @Override /* BeanContextBuilder */ 268 public BeanTraverseBuilder beansRequireDefaultConstructor() { 269 super.beansRequireDefaultConstructor(); 270 return this; 271 } 272 273 @Override /* BeanContextBuilder */ 274 public BeanTraverseBuilder beansRequireSerializable(boolean value) { 275 super.beansRequireSerializable(value); 276 return this; 277 } 278 279 @Override /* BeanContextBuilder */ 280 public BeanTraverseBuilder beansRequireSerializable() { 281 super.beansRequireSerializable(); 282 return this; 283 } 284 285 @Override /* BeanContextBuilder */ 286 public BeanTraverseBuilder beansRequireSettersForGetters(boolean value) { 287 super.beansRequireSettersForGetters(value); 288 return this; 289 } 290 291 @Override /* BeanContextBuilder */ 292 public BeanTraverseBuilder beansRequireSettersForGetters() { 293 super.beansRequireSettersForGetters(); 294 return this; 295 } 296 297 @Override /* BeanContextBuilder */ 298 public BeanTraverseBuilder beansRequireSomeProperties(boolean value) { 299 super.beansRequireSomeProperties(value); 300 return this; 301 } 302 303 @Override /* BeanContextBuilder */ 304 public BeanTraverseBuilder beanTypePropertyName(String value) { 305 super.beanTypePropertyName(value); 306 return this; 307 } 308 309 @Override /* BeanContextBuilder */ 310 public BeanTraverseBuilder debug() { 311 super.debug(); 312 return this; 313 } 314 315 @Override /* BeanContextBuilder */ 316 public <T> BeanTraverseBuilder example(Class<T> c, T o) { 317 super.example(c, o); 318 return this; 319 } 320 321 @Override /* BeanContextBuilder */ 322 public BeanTraverseBuilder ignoreInvocationExceptionsOnGetters(boolean value) { 323 super.ignoreInvocationExceptionsOnGetters(value); 324 return this; 325 } 326 327 @Override /* BeanContextBuilder */ 328 public BeanTraverseBuilder ignoreInvocationExceptionsOnGetters() { 329 super.ignoreInvocationExceptionsOnGetters(); 330 return this; 331 } 332 333 @Override /* BeanContextBuilder */ 334 public BeanTraverseBuilder ignoreInvocationExceptionsOnSetters(boolean value) { 335 super.ignoreInvocationExceptionsOnSetters(value); 336 return this; 337 } 338 339 @Override /* BeanContextBuilder */ 340 public BeanTraverseBuilder ignoreInvocationExceptionsOnSetters() { 341 super.ignoreInvocationExceptionsOnSetters(); 342 return this; 343 } 344 345 @Override /* BeanContextBuilder */ 346 public BeanTraverseBuilder ignorePropertiesWithoutSetters(boolean value) { 347 super.ignorePropertiesWithoutSetters(value); 348 return this; 349 } 350 351 @Override /* BeanContextBuilder */ 352 public BeanTraverseBuilder ignoreUnknownBeanProperties(boolean value) { 353 super.ignoreUnknownBeanProperties(value); 354 return this; 355 } 356 357 @Override /* BeanContextBuilder */ 358 public BeanTraverseBuilder ignoreUnknownBeanProperties() { 359 super.ignoreUnknownBeanProperties(); 360 return this; 361 } 362 363 @Override /* BeanContextBuilder */ 364 public BeanTraverseBuilder ignoreUnknownNullBeanProperties(boolean value) { 365 super.ignoreUnknownNullBeanProperties(value); 366 return this; 367 } 368 369 @Override /* BeanContextBuilder */ 370 public <T> BeanTraverseBuilder implClass(Class<T> interfaceClass, Class<? extends T> implClass) { 371 super.implClass(interfaceClass, implClass); 372 return this; 373 } 374 375 @Override /* BeanContextBuilder */ 376 public BeanTraverseBuilder implClasses(Map<String,Class<?>> values) { 377 super.implClasses(values); 378 return this; 379 } 380 381 @Override /* BeanContextBuilder */ 382 public BeanTraverseBuilder locale(Locale value) { 383 super.locale(value); 384 return this; 385 } 386 387 @Override /* BeanContextBuilder */ 388 public BeanTraverseBuilder mediaType(MediaType value) { 389 super.mediaType(value); 390 return this; 391 } 392 393 @Override /* BeanContextBuilder */ 394 public BeanTraverseBuilder notBeanClasses(boolean append, Object...values) { 395 super.notBeanClasses(append, values); 396 return this; 397 } 398 399 @Override /* BeanContextBuilder */ 400 public BeanTraverseBuilder notBeanClasses(Class<?>...values) { 401 super.notBeanClasses(values); 402 return this; 403 } 404 405 @Override /* BeanContextBuilder */ 406 public BeanTraverseBuilder notBeanClasses(Object...values) { 407 super.notBeanClasses(values); 408 return this; 409 } 410 411 @Override /* BeanContextBuilder */ 412 public BeanTraverseBuilder notBeanClassesRemove(Object...values) { 413 super.notBeanClassesRemove(values); 414 return this; 415 } 416 417 @Override /* BeanContextBuilder */ 418 public BeanTraverseBuilder notBeanPackages(boolean append, Object...values) { 419 super.notBeanPackages(append, values); 420 return this; 421 } 422 423 @Override /* BeanContextBuilder */ 424 public BeanTraverseBuilder notBeanPackages(Object...values) { 425 super.notBeanPackages(values); 426 return this; 427 } 428 429 @Override /* BeanContextBuilder */ 430 public BeanTraverseBuilder notBeanPackages(String...values) { 431 super.notBeanPackages(values); 432 return this; 433 } 434 435 @Override /* BeanContextBuilder */ 436 public BeanTraverseBuilder notBeanPackagesRemove(Object...values) { 437 super.notBeanPackagesRemove(values); 438 return this; 439 } 440 441 @Override /* BeanContextBuilder */ 442 public BeanTraverseBuilder pojoSwaps(boolean append, Object...values) { 443 super.pojoSwaps(append, values); 444 return this; 445 } 446 447 @Override /* BeanContextBuilder */ 448 public BeanTraverseBuilder pojoSwaps(Class<?>...values) { 449 super.pojoSwaps(values); 450 return this; 451 } 452 453 @Override /* BeanContextBuilder */ 454 public BeanTraverseBuilder pojoSwaps(Object...values) { 455 super.pojoSwaps(values); 456 return this; 457 } 458 459 @Override /* BeanContextBuilder */ 460 public BeanTraverseBuilder pojoSwapsRemove(Object...values) { 461 super.pojoSwapsRemove(values); 462 return this; 463 } 464 465 @Override /* BeanContextBuilder */ 466 public BeanTraverseBuilder sortProperties(boolean value) { 467 super.sortProperties(value); 468 return this; 469 } 470 471 @Override /* BeanContextBuilder */ 472 public BeanTraverseBuilder sortProperties() { 473 super.sortProperties(); 474 return this; 475 } 476 477 @Override /* BeanContextBuilder */ 478 public BeanTraverseBuilder timeZone(TimeZone value) { 479 super.timeZone(value); 480 return this; 481 } 482 483 @Override /* BeanContextBuilder */ 484 public BeanTraverseBuilder useEnumNames() { 485 super.useEnumNames(); 486 return this; 487 } 488 489 @Override /* BeanContextBuilder */ 490 public BeanTraverseBuilder useInterfaceProxies(boolean value) { 491 super.useInterfaceProxies(value); 492 return this; 493 } 494 495 @Override /* BeanContextBuilder */ 496 public BeanTraverseBuilder useJavaBeanIntrospector(boolean value) { 497 super.useJavaBeanIntrospector(value); 498 return this; 499 } 500 501 @Override /* BeanContextBuilder */ 502 public BeanTraverseBuilder useJavaBeanIntrospector() { 503 super.useJavaBeanIntrospector(); 504 return this; 505 } 506 507 @Override /* ContextBuilder */ 508 public BeanTraverseBuilder set(String name, Object value) { 509 super.set(name, value); 510 return this; 511 } 512 513 @Override /* ContextBuilder */ 514 public BeanTraverseBuilder set(boolean append, String name, Object value) { 515 super.set(append, name, value); 516 return this; 517 } 518 519 @Override /* ContextBuilder */ 520 public BeanTraverseBuilder set(Map<String,Object> properties) { 521 super.set(properties); 522 return this; 523 } 524 525 @Override /* ContextBuilder */ 526 public BeanTraverseBuilder add(Map<String,Object> properties) { 527 super.add(properties); 528 return this; 529 } 530 531 @Override /* ContextBuilder */ 532 public BeanTraverseBuilder addTo(String name, Object value) { 533 super.addTo(name, value); 534 return this; 535 } 536 537 @Override /* ContextBuilder */ 538 public BeanTraverseBuilder addTo(String name, String key, Object value) { 539 super.addTo(name, key, value); 540 return this; 541 } 542 543 @Override /* ContextBuilder */ 544 public BeanTraverseBuilder removeFrom(String name, Object value) { 545 super.removeFrom(name, value); 546 return this; 547 } 548 549 @Override /* ContextBuilder */ 550 public BeanTraverseBuilder apply(PropertyStore copyFrom) { 551 super.apply(copyFrom); 552 return this; 553 } 554 555 @Override /* Context */ 556 public BeanTraverseContext build() { 557 return null; 558 } 559}