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.parser; 014 015import static org.apache.juneau.parser.ReaderParser.*; 016 017import java.lang.reflect.*; 018import java.nio.charset.*; 019import java.util.*; 020 021import org.apache.juneau.*; 022import org.apache.juneau.http.*; 023import org.apache.juneau.reflect.*; 024import org.apache.juneau.svl.*; 025 026/** 027 * Base builder class for building instances of reader-based parsers. 028 */ 029public abstract class ReaderParserBuilder extends ParserBuilder { 030 031 /** 032 * Constructor, default settings. 033 */ 034 public ReaderParserBuilder() { 035 super(); 036 } 037 038 /** 039 * Constructor. 040 * 041 * @param ps The initial configuration settings for this builder. 042 */ 043 public ReaderParserBuilder(PropertyStore ps) { 044 super(ps); 045 } 046 047 //----------------------------------------------------------------------------------------------------------------- 048 // Properties 049 //----------------------------------------------------------------------------------------------------------------- 050 051 /** 052 * Configuration property: File charset. 053 * 054 * <p> 055 * The character set to use for reading <c>Files</c> from the file system. 056 * 057 * <ul class='seealso'> 058 * <li class='jf'>{@link ReaderParser#RPARSER_fileCharset} 059 * </ul> 060 * 061 * @param value 062 * The new value for this property. 063 * <br>The default value is <js>"DEFAULT"</js> which causes the system default to be used. 064 * @return This object (for method chaining). 065 */ 066 public ReaderParserBuilder fileCharset(Charset value) { 067 return set(RPARSER_fileCharset, value); 068 } 069 070 /** 071 * Configuration property: Input stream charset. 072 * 073 * <p> 074 * The character set to use for converting <c>InputStreams</c> and byte arrays to readers. 075 * 076 * <ul class='seealso'> 077 * <li class='jf'>{@link ReaderParser#RPARSER_streamCharset} 078 * </ul> 079 * 080 * @param value 081 * The new value for this property. 082 * <br>The default value is <js>"UTF-8"</js>. 083 * @return This object (for method chaining). 084 */ 085 public ReaderParserBuilder streamCharset(Charset value) { 086 return set(RPARSER_streamCharset, value); 087 } 088 089 @Override /* ParserBuilder */ 090 public ReaderParserBuilder autoCloseStreams(boolean value) { 091 super.autoCloseStreams(value); 092 return this; 093 } 094 095 @Override /* ParserBuilder */ 096 public ReaderParserBuilder autoCloseStreams() { 097 super.autoCloseStreams(); 098 return this; 099 } 100 101 @Override /* ParserBuilder */ 102 public ReaderParserBuilder debugOutputLines(int value) { 103 super.debugOutputLines(value); 104 return this; 105 } 106 107 @Override /* ParserBuilder */ 108 public ReaderParserBuilder listener(Class<? extends ParserListener> value) { 109 super.listener(value); 110 return this; 111 } 112 113 @Override /* ParserBuilder */ 114 public ReaderParserBuilder strict(boolean value) { 115 super.strict(value); 116 return this; 117 } 118 119 @Override /* ParserBuilder */ 120 public ReaderParserBuilder strict() { 121 super.strict(); 122 return this; 123 } 124 125 @Override /* ParserBuilder */ 126 public ReaderParserBuilder trimStrings(boolean value) { 127 super.trimStrings(value); 128 return this; 129 } 130 131 @Override /* ParserBuilder */ 132 public ReaderParserBuilder trimStrings() { 133 super.trimStrings(); 134 return this; 135 } 136 137 @Override /* ParserBuilder */ 138 public ReaderParserBuilder unbuffered(boolean value) { 139 super.unbuffered(value); 140 return this; 141 } 142 143 @Override /* ParserBuilder */ 144 public ReaderParserBuilder unbuffered() { 145 super.unbuffered(); 146 return this; 147 } 148 149 @Override /* BeanContextBuilder */ 150 public ReaderParserBuilder beanClassVisibility(Visibility value) { 151 super.beanClassVisibility(value); 152 return this; 153 } 154 155 @Override /* BeanContextBuilder */ 156 public ReaderParserBuilder beanConstructorVisibility(Visibility value) { 157 super.beanConstructorVisibility(value); 158 return this; 159 } 160 161 @Override /* BeanContextBuilder */ 162 public ReaderParserBuilder beanDictionary(Class<?>...values) { 163 super.beanDictionary(values); 164 return this; 165 } 166 167 @Override /* BeanContextBuilder */ 168 public ReaderParserBuilder beanDictionary(Object...values) { 169 super.beanDictionary(values); 170 return this; 171 } 172 173 @Override /* BeanContextBuilder */ 174 public ReaderParserBuilder beanDictionaryReplace(Class<?>...values) { 175 super.beanDictionaryReplace(values); 176 return this; 177 } 178 179 @Override /* BeanContextBuilder */ 180 public ReaderParserBuilder beanDictionaryReplace(Object...values) { 181 super.beanDictionaryReplace(values); 182 return this; 183 } 184 185 @Override /* BeanContextBuilder */ 186 public ReaderParserBuilder beanDictionaryRemove(Class<?>...values) { 187 super.beanDictionaryRemove(values); 188 return this; 189 } 190 191 @Override /* BeanContextBuilder */ 192 public ReaderParserBuilder beanDictionaryRemove(Object...values) { 193 super.beanDictionaryRemove(values); 194 return this; 195 } 196 197 @Override /* BeanContextBuilder */ 198 public ReaderParserBuilder beanFieldVisibility(Visibility value) { 199 super.beanFieldVisibility(value); 200 return this; 201 } 202 203 @Override /* BeanContextBuilder */ 204 public ReaderParserBuilder beanFilters(Class<?>...values) { 205 super.beanFilters(values); 206 return this; 207 } 208 209 @Override /* BeanContextBuilder */ 210 public ReaderParserBuilder beanFilters(Object...values) { 211 super.beanFilters(values); 212 return this; 213 } 214 215 @Override /* BeanContextBuilder */ 216 public ReaderParserBuilder beanFiltersReplace(Class<?>...values) { 217 super.beanFiltersReplace(values); 218 return this; 219 } 220 221 @Override /* BeanContextBuilder */ 222 public ReaderParserBuilder beanFiltersReplace(Object...values) { 223 super.beanFiltersReplace(values); 224 return this; 225 } 226 227 @Override /* BeanContextBuilder */ 228 public ReaderParserBuilder beanFiltersRemove(Class<?>...values) { 229 super.beanFiltersRemove(values); 230 return this; 231 } 232 233 @Override /* BeanContextBuilder */ 234 public ReaderParserBuilder beanFiltersRemove(Object...values) { 235 super.beanFiltersRemove(values); 236 return this; 237 } 238 239 @Override /* BeanContextBuilder */ 240 public ReaderParserBuilder beanMapPutReturnsOldValue(boolean value) { 241 super.beanMapPutReturnsOldValue(value); 242 return this; 243 } 244 245 @Override /* BeanContextBuilder */ 246 public ReaderParserBuilder beanMapPutReturnsOldValue() { 247 super.beanMapPutReturnsOldValue(); 248 return this; 249 } 250 251 @Override /* BeanContextBuilder */ 252 public ReaderParserBuilder beanMethodVisibility(Visibility value) { 253 super.beanMethodVisibility(value); 254 return this; 255 } 256 257 @Override /* BeanContextBuilder */ 258 public ReaderParserBuilder beansRequireDefaultConstructor(boolean value) { 259 super.beansRequireDefaultConstructor(value); 260 return this; 261 } 262 263 @Override /* BeanContextBuilder */ 264 public ReaderParserBuilder beansRequireDefaultConstructor() { 265 super.beansRequireDefaultConstructor(); 266 return this; 267 } 268 269 @Override /* BeanContextBuilder */ 270 public ReaderParserBuilder beansRequireSerializable(boolean value) { 271 super.beansRequireSerializable(value); 272 return this; 273 } 274 275 @Override /* BeanContextBuilder */ 276 public ReaderParserBuilder beansRequireSerializable() { 277 super.beansRequireSerializable(); 278 return this; 279 } 280 281 @Override /* BeanContextBuilder */ 282 public ReaderParserBuilder beansRequireSettersForGetters(boolean value) { 283 super.beansRequireSettersForGetters(value); 284 return this; 285 } 286 287 @Override /* BeanContextBuilder */ 288 public ReaderParserBuilder beansRequireSettersForGetters() { 289 super.beansRequireSettersForGetters(); 290 return this; 291 } 292 293 @Override /* BeanContextBuilder */ 294 public ReaderParserBuilder beansRequireSomeProperties(boolean value) { 295 super.beansRequireSomeProperties(value); 296 return this; 297 } 298 299 @Override /* BeanContextBuilder */ 300 public ReaderParserBuilder beanTypePropertyName(String value) { 301 super.beanTypePropertyName(value); 302 return this; 303 } 304 305 @Override /* BeanContextBuilder */ 306 public ReaderParserBuilder debug() { 307 super.debug(); 308 return this; 309 } 310 311 @Override /* BeanContextBuilder */ 312 public <T> ReaderParserBuilder example(Class<T> c, T o) { 313 super.example(c, o); 314 return this; 315 } 316 317 @Override /* BeanContextBuilder */ 318 public <T> ReaderParserBuilder exampleJson(Class<T> c, String value) { 319 super.exampleJson(c, value); 320 return this; 321 } 322 323 @Override /* BeanContextBuilder */ 324 public ReaderParserBuilder ignoreInvocationExceptionsOnGetters(boolean value) { 325 super.ignoreInvocationExceptionsOnGetters(value); 326 return this; 327 } 328 329 @Override /* BeanContextBuilder */ 330 public ReaderParserBuilder ignoreInvocationExceptionsOnGetters() { 331 super.ignoreInvocationExceptionsOnGetters(); 332 return this; 333 } 334 335 @Override /* BeanContextBuilder */ 336 public ReaderParserBuilder ignoreInvocationExceptionsOnSetters(boolean value) { 337 super.ignoreInvocationExceptionsOnSetters(value); 338 return this; 339 } 340 341 @Override /* BeanContextBuilder */ 342 public ReaderParserBuilder ignoreInvocationExceptionsOnSetters() { 343 super.ignoreInvocationExceptionsOnSetters(); 344 return this; 345 } 346 347 @Override /* BeanContextBuilder */ 348 public ReaderParserBuilder ignorePropertiesWithoutSetters(boolean value) { 349 super.ignorePropertiesWithoutSetters(value); 350 return this; 351 } 352 353 @Override /* BeanContextBuilder */ 354 public ReaderParserBuilder ignoreUnknownBeanProperties(boolean value) { 355 super.ignoreUnknownBeanProperties(value); 356 return this; 357 } 358 359 @Override /* BeanContextBuilder */ 360 public ReaderParserBuilder ignoreUnknownBeanProperties() { 361 super.ignoreUnknownBeanProperties(); 362 return this; 363 } 364 365 @Override /* BeanContextBuilder */ 366 public ReaderParserBuilder ignoreUnknownNullBeanProperties(boolean value) { 367 super.ignoreUnknownNullBeanProperties(value); 368 return this; 369 } 370 371 @Override /* BeanContextBuilder */ 372 public ReaderParserBuilder implClass(Class<?> interfaceClass, Class<?> implClass) { 373 super.implClass(interfaceClass, implClass); 374 return this; 375 } 376 377 @Override /* BeanContextBuilder */ 378 public ReaderParserBuilder implClasses(Map<String,Class<?>> values) { 379 super.implClasses(values); 380 return this; 381 } 382 383 @Override /* BeanContextBuilder */ 384 public ReaderParserBuilder locale(Locale value) { 385 super.locale(value); 386 return this; 387 } 388 389 @Override /* BeanContextBuilder */ 390 public ReaderParserBuilder mediaType(MediaType value) { 391 super.mediaType(value); 392 return this; 393 } 394 395 @Override /* BeanContextBuilder */ 396 public ReaderParserBuilder notBeanClasses(Class<?>...values) { 397 super.notBeanClasses(values); 398 return this; 399 } 400 401 @Override /* BeanContextBuilder */ 402 public ReaderParserBuilder notBeanClasses(Object...values) { 403 super.notBeanClasses(values); 404 return this; 405 } 406 407 @Override /* BeanContextBuilder */ 408 public ReaderParserBuilder notBeanClassesReplace(Class<?>...values) { 409 super.notBeanClassesReplace(values); 410 return this; 411 } 412 413 @Override /* BeanContextBuilder */ 414 public ReaderParserBuilder notBeanClassesReplace(Object...values) { 415 super.notBeanClassesReplace(values); 416 return this; 417 } 418 419 @Override /* BeanContextBuilder */ 420 public ReaderParserBuilder notBeanClassesRemove(Class<?>...values) { 421 super.notBeanClassesRemove(values); 422 return this; 423 } 424 425 @Override /* BeanContextBuilder */ 426 public ReaderParserBuilder notBeanClassesRemove(Object...values) { 427 super.notBeanClassesRemove(values); 428 return this; 429 } 430 431 @Override /* BeanContextBuilder */ 432 public ReaderParserBuilder notBeanPackages(Object...values) { 433 super.notBeanPackages(values); 434 return this; 435 } 436 437 @Override /* BeanContextBuilder */ 438 public ReaderParserBuilder notBeanPackages(String...values) { 439 super.notBeanPackages(values); 440 return this; 441 } 442 443 @Override /* BeanContextBuilder */ 444 public ReaderParserBuilder notBeanPackagesReplace(String...values) { 445 super.notBeanPackagesReplace(values); 446 return this; 447 } 448 449 @Override /* BeanContextBuilder */ 450 public ReaderParserBuilder notBeanPackagesReplace(Object...values) { 451 super.notBeanPackagesReplace(values); 452 return this; 453 } 454 455 @Override /* BeanContextBuilder */ 456 public ReaderParserBuilder notBeanPackagesRemove(String...values) { 457 super.notBeanPackagesRemove(values); 458 return this; 459 } 460 461 @Override /* BeanContextBuilder */ 462 public ReaderParserBuilder notBeanPackagesRemove(Object...values) { 463 super.notBeanPackagesRemove(values); 464 return this; 465 } 466 467 @Override /* BeanContextBuilder */ 468 public ReaderParserBuilder pojoSwaps(Class<?>...values) { 469 super.pojoSwaps(values); 470 return this; 471 } 472 473 @Override /* BeanContextBuilder */ 474 public ReaderParserBuilder pojoSwaps(Object...values) { 475 super.pojoSwaps(values); 476 return this; 477 } 478 479 @Override /* BeanContextBuilder */ 480 public ReaderParserBuilder pojoSwapsReplace(Class<?>...values) { 481 super.pojoSwapsReplace(values); 482 return this; 483 } 484 485 @Override /* BeanContextBuilder */ 486 public ReaderParserBuilder pojoSwapsReplace(Object...values) { 487 super.pojoSwapsReplace(values); 488 return this; 489 } 490 491 @Override /* BeanContextBuilder */ 492 public ReaderParserBuilder pojoSwapsRemove(Class<?>...values) { 493 super.pojoSwapsRemove(values); 494 return this; 495 } 496 497 @Override /* BeanContextBuilder */ 498 public ReaderParserBuilder pojoSwapsRemove(Object...values) { 499 super.pojoSwapsRemove(values); 500 return this; 501 } 502 503 @Override /* BeanContextBuilder */ 504 public ReaderParserBuilder sortProperties(boolean value) { 505 super.sortProperties(value); 506 return this; 507 } 508 509 @Override /* BeanContextBuilder */ 510 public ReaderParserBuilder sortProperties() { 511 super.sortProperties(); 512 return this; 513 } 514 515 @Override /* BeanContextBuilder */ 516 public ReaderParserBuilder timeZone(TimeZone value) { 517 super.timeZone(value); 518 return this; 519 } 520 521 @Override /* BeanContextBuilder */ 522 public ReaderParserBuilder useEnumNames(boolean value) { 523 super.useEnumNames(value); 524 return this; 525 } 526 527 @Override /* BeanContextBuilder */ 528 public ReaderParserBuilder useEnumNames() { 529 super.useEnumNames(); 530 return this; 531 } 532 533 @Override /* BeanContextBuilder */ 534 public ReaderParserBuilder useInterfaceProxies(boolean value) { 535 super.useInterfaceProxies(value); 536 return this; 537 } 538 539 @Override /* BeanContextBuilder */ 540 public ReaderParserBuilder useJavaBeanIntrospector(boolean value) { 541 super.useJavaBeanIntrospector(value); 542 return this; 543 } 544 545 @Override /* BeanContextBuilder */ 546 public ReaderParserBuilder useJavaBeanIntrospector() { 547 super.useJavaBeanIntrospector(); 548 return this; 549 } 550 551 @Override /* ContextBuilder */ 552 public ReaderParserBuilder set(String name, Object value) { 553 super.set(name, value); 554 return this; 555 } 556 557 @Override /* ContextBuilder */ 558 public ReaderParserBuilder set(Map<String,Object> properties) { 559 super.set(properties); 560 return this; 561 } 562 563 @Override /* ContextBuilder */ 564 public ReaderParserBuilder add(Map<String,Object> properties) { 565 super.add(properties); 566 return this; 567 } 568 569 @Override /* ContextBuilder */ 570 public ReaderParserBuilder addTo(String name, Object value) { 571 super.addTo(name, value); 572 return this; 573 } 574 575 @Override /* ContextBuilder */ 576 public ReaderParserBuilder addTo(String name, String key, Object value) { 577 super.addTo(name, key, value); 578 return this; 579 } 580 581 @Override /* ContextBuilder */ 582 public ReaderParserBuilder removeFrom(String name, Object value) { 583 super.removeFrom(name, value); 584 return this; 585 } 586 587 @Override /* ContextBuilder */ 588 public ReaderParserBuilder apply(PropertyStore copyFrom) { 589 super.apply(copyFrom); 590 return this; 591 } 592 593 @Override /* ContextBuilder */ 594 public ReaderParserBuilder applyAnnotations(AnnotationList al, VarResolverSession vrs) { 595 super.applyAnnotations(al, vrs); 596 return this; 597 } 598 599 @Override /* ContextBuilder */ 600 public ReaderParserBuilder applyAnnotations(Class<?> fromClass) { 601 super.applyAnnotations(fromClass); 602 return this; 603 } 604 605 @Override /* ContextBuilder */ 606 public ReaderParserBuilder applyAnnotations(Method fromMethod) { 607 super.applyAnnotations(fromMethod); 608 return this; 609 } 610}