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