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