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.json;
014
015import static org.apache.juneau.json.JsonParser.*;
016
017import java.lang.annotation.*;
018import java.lang.reflect.*;
019import java.nio.charset.*;
020import java.util.*;
021
022import org.apache.juneau.*;
023import org.apache.juneau.http.*;
024import org.apache.juneau.parser.*;
025import org.apache.juneau.reflect.*;
026import org.apache.juneau.svl.*;
027
028/**
029 * Builder class for building instances of JSON parsers.
030 */
031public class JsonParserBuilder extends ReaderParserBuilder {
032
033   /**
034    * Constructor, default settings.
035    */
036   public JsonParserBuilder() {
037      super();
038   }
039
040   /**
041    * Constructor.
042    *
043    * @param ps The initial configuration settings for this builder.
044    */
045   public JsonParserBuilder(PropertyStore ps) {
046      super(ps);
047   }
048
049   @Override /* ContextBuilder */
050   public JsonParser build() {
051      return build(JsonParser.class);
052   }
053
054   //-----------------------------------------------------------------------------------------------------------------
055   // Properties
056   //-----------------------------------------------------------------------------------------------------------------
057
058   /**
059    * Configuration property:  Validate end.
060    *
061    * <p>
062    * If <jk>true</jk>, after parsing a POJO from the input, verifies that the remaining input in
063    * the stream consists of only comments or whitespace.
064    *
065    * <ul class='seealso'>
066    *    <li class='jf'>{@link JsonParser#JSON_validateEnd}
067    * </ul>
068    *
069    * @param value
070    *    The new value for this property.
071    *    <br>The default value is <jk>false</jk>.
072    * @return This object (for method chaining).
073    */
074   public JsonParserBuilder validateEnd(boolean value) {
075      return set(JSON_validateEnd, value);
076   }
077
078   /**
079    * Configuration property:  Validate end.
080    *
081    * <p>
082    * Shortcut for calling <code>validateEnd(<jk>true</jk>)</code>.
083    *
084    * <ul class='seealso'>
085    *    <li class='jf'>{@link JsonParser#JSON_validateEnd}
086    * </ul>
087    *
088    * @return This object (for method chaining).
089    */
090   public JsonParserBuilder validateEnd() {
091      return set(JSON_validateEnd, true);
092   }
093
094   @Override /* ReaderParserBuilder */
095   public JsonParserBuilder fileCharset(Charset value) {
096      super.fileCharset(value);
097      return this;
098   }
099
100   @Override /* ReaderParserBuilder */
101   public JsonParserBuilder streamCharset(Charset value) {
102      super.streamCharset(value);
103      return this;
104   }
105
106   @Override /* ParserBuilder */
107   public JsonParserBuilder autoCloseStreams(boolean value) {
108      super.autoCloseStreams(value);
109      return this;
110   }
111
112   @Override /* ParserBuilder */
113   public JsonParserBuilder autoCloseStreams() {
114      super.autoCloseStreams();
115      return this;
116   }
117
118   @Override /* ParserBuilder */
119   public JsonParserBuilder debugOutputLines(int value) {
120      super.debugOutputLines(value);
121      return this;
122   }
123
124   @Override /* ParserBuilder */
125   public JsonParserBuilder listener(Class<? extends ParserListener> value) {
126      super.listener(value);
127      return this;
128   }
129
130   @Override /* ParserBuilder */
131   public JsonParserBuilder strict(boolean value) {
132      super.strict(value);
133      return this;
134   }
135
136   @Override /* ParserBuilder */
137   public JsonParserBuilder strict() {
138      super.strict();
139      return this;
140   }
141
142   @Override /* ParserBuilder */
143   public JsonParserBuilder trimStrings(boolean value) {
144      super.trimStrings(value);
145      return this;
146   }
147
148   @Override /* ParserBuilder */
149   public JsonParserBuilder trimStrings() {
150      super.trimStrings();
151      return this;
152   }
153
154   @Override /* ParserBuilder */
155   public JsonParserBuilder unbuffered(boolean value) {
156      super.unbuffered(value);
157      return this;
158   }
159
160   @Override /* ParserBuilder */
161   public JsonParserBuilder unbuffered() {
162      super.unbuffered();
163      return this;
164   }
165
166   @Override /* BeanContextBuilder */
167   public JsonParserBuilder annotations(Annotation...values) {
168      super.annotations(values);
169      return this;
170   }
171
172   @Override /* BeanContextBuilder */
173   public JsonParserBuilder beanClassVisibility(Visibility value) {
174      super.beanClassVisibility(value);
175      return this;
176   }
177
178   @Override /* BeanContextBuilder */
179   public JsonParserBuilder beanConstructorVisibility(Visibility value) {
180      super.beanConstructorVisibility(value);
181      return this;
182   }
183
184   @Override /* BeanContextBuilder */
185   @Deprecated
186   public JsonParserBuilder beanDictionary(Class<?>...values) {
187      super.beanDictionary(values);
188      return this;
189   }
190
191   @Override /* BeanContextBuilder */
192   @Deprecated
193   public JsonParserBuilder beanDictionary(Object...values) {
194      super.beanDictionary(values);
195      return this;
196   }
197
198   @Override /* BeanContextBuilder */
199   @Deprecated
200   public JsonParserBuilder beanDictionaryReplace(Class<?>...values) {
201      super.beanDictionaryReplace(values);
202      return this;
203   }
204
205   @Override /* BeanContextBuilder */
206   @Deprecated
207   public JsonParserBuilder beanDictionaryReplace(Object...values) {
208      super.beanDictionaryReplace(values);
209      return this;
210   }
211
212   @Override /* BeanContextBuilder */
213   @Deprecated
214   public JsonParserBuilder beanDictionaryRemove(Class<?>...values) {
215      super.beanDictionaryRemove(values);
216      return this;
217   }
218
219   @Override /* BeanContextBuilder */
220   @Deprecated
221   public JsonParserBuilder beanDictionaryRemove(Object...values) {
222      super.beanDictionaryRemove(values);
223      return this;
224   }
225
226   @Override /* BeanContextBuilder */
227   public JsonParserBuilder beanFieldVisibility(Visibility value) {
228      super.beanFieldVisibility(value);
229      return this;
230   }
231
232   @Override /* BeanContextBuilder */
233   public JsonParserBuilder beanFilters(Class<?>...values) {
234      super.beanFilters(values);
235      return this;
236   }
237
238   @Override /* BeanContextBuilder */
239   public JsonParserBuilder beanFilters(Object...values) {
240      super.beanFilters(values);
241      return this;
242   }
243
244   @Override /* BeanContextBuilder */
245   public JsonParserBuilder beanFiltersReplace(Class<?>...values) {
246      super.beanFiltersReplace(values);
247      return this;
248   }
249
250   @Override /* BeanContextBuilder */
251   public JsonParserBuilder beanFiltersReplace(Object...values) {
252      super.beanFiltersReplace(values);
253      return this;
254   }
255
256   @Override /* BeanContextBuilder */
257   public JsonParserBuilder beanFiltersRemove(Class<?>...values) {
258      super.beanFiltersRemove(values);
259      return this;
260   }
261
262   @Override /* BeanContextBuilder */
263   public JsonParserBuilder beanFiltersRemove(Object...values) {
264      super.beanFiltersRemove(values);
265      return this;
266   }
267
268   @Override /* BeanContextBuilder */
269   public JsonParserBuilder beanMapPutReturnsOldValue(boolean value) {
270      super.beanMapPutReturnsOldValue(value);
271      return this;
272   }
273
274   @Override /* BeanContextBuilder */
275   public JsonParserBuilder beanMapPutReturnsOldValue() {
276      super.beanMapPutReturnsOldValue();
277      return this;
278   }
279
280   @Override /* BeanContextBuilder */
281   public JsonParserBuilder beanMethodVisibility(Visibility value) {
282      super.beanMethodVisibility(value);
283      return this;
284   }
285
286   @Override /* BeanContextBuilder */
287   public JsonParserBuilder beansRequireDefaultConstructor(boolean value) {
288      super.beansRequireDefaultConstructor(value);
289      return this;
290   }
291
292   @Override /* BeanContextBuilder */
293   public JsonParserBuilder beansRequireDefaultConstructor() {
294      super.beansRequireDefaultConstructor();
295      return this;
296   }
297
298   @Override /* BeanContextBuilder */
299   public JsonParserBuilder beansRequireSerializable(boolean value) {
300      super.beansRequireSerializable(value);
301      return this;
302   }
303
304   @Override /* BeanContextBuilder */
305   public JsonParserBuilder beansRequireSerializable() {
306      super.beansRequireSerializable();
307      return this;
308   }
309
310   @Override /* BeanContextBuilder */
311   public JsonParserBuilder beansRequireSettersForGetters(boolean value) {
312      super.beansRequireSettersForGetters(value);
313      return this;
314   }
315
316   @Override /* BeanContextBuilder */
317   public JsonParserBuilder beansRequireSettersForGetters() {
318      super.beansRequireSettersForGetters();
319      return this;
320   }
321
322   @Override /* BeanContextBuilder */
323   public JsonParserBuilder beansRequireSomeProperties(boolean value) {
324      super.beansRequireSomeProperties(value);
325      return this;
326   }
327
328   @Override /* BeanContextBuilder */
329   public JsonParserBuilder beanTypePropertyName(String value) {
330      super.beanTypePropertyName(value);
331      return this;
332   }
333
334   @Override /* BeanContextBuilder */
335   public JsonParserBuilder bpi(Class<?> beanClass, String value) {
336      super.bpi(beanClass, value);
337      return this;
338   }
339
340   @Override /* BeanContextBuilder */
341   public JsonParserBuilder bpi(Map<String,String> values) {
342      super.bpi(values);
343      return this;
344   }
345
346   @Override /* BeanContextBuilder */
347   public JsonParserBuilder bpi(String beanClassName, String value) {
348      super.bpi(beanClassName, value);
349      return this;
350   }
351
352   @Override /* BeanContextBuilder */
353   public JsonParserBuilder bpx(Class<?> beanClass, String properties) {
354      super.bpx(beanClass, properties);
355      return this;
356   }
357
358   @Override /* BeanContextBuilder */
359   public JsonParserBuilder bpx(Map<String,String> values) {
360      super.bpx(values);
361      return this;
362   }
363
364   @Override /* BeanContextBuilder */
365   public JsonParserBuilder bpx(String beanClassName, String value) {
366      super.bpx(beanClassName, value);
367      return this;
368   }
369
370   @Override /* BeanContextBuilder */
371   public JsonParserBuilder bpro(Class<?> beanClass, String value) {
372      super.bpro(beanClass, value);
373      return this;
374   }
375
376   @Override /* BeanContextBuilder */
377   public JsonParserBuilder bpro(Map<String,String> values) {
378      super.bpro(values);
379      return this;
380   }
381
382   @Override /* BeanContextBuilder */
383   public JsonParserBuilder bpro(String beanClassName, String value) {
384      super.bpro(beanClassName, value);
385      return this;
386   }
387
388   @Override /* BeanContextBuilder */
389   public JsonParserBuilder bpwo(Class<?> beanClass, String properties) {
390      super.bpwo(beanClass, properties);
391      return this;
392   }
393
394   @Override /* BeanContextBuilder */
395   public JsonParserBuilder bpwo(Map<String,String> values) {
396      super.bpwo(values);
397      return this;
398   }
399
400   @Override /* BeanContextBuilder */
401   public JsonParserBuilder bpwo(String beanClassName, String value) {
402      super.bpwo(beanClassName, value);
403      return this;
404   }
405
406   @Override /* BeanContextBuilder */
407   public JsonParserBuilder debug() {
408      super.debug();
409      return this;
410   }
411
412   @Override /* BeanContextBuilder */
413   public JsonParserBuilder dictionary(Class<?>...values) {
414      super.dictionary(values);
415      return this;
416   }
417
418   @Override /* BeanContextBuilder */
419   public JsonParserBuilder dictionary(Object...values) {
420      super.dictionary(values);
421      return this;
422   }
423
424   @Override /* BeanContextBuilder */
425   public JsonParserBuilder dictionaryReplace(Class<?>...values) {
426      super.dictionaryReplace(values);
427      return this;
428   }
429
430   @Override /* BeanContextBuilder */
431   public JsonParserBuilder dictionaryReplace(Object...values) {
432      super.dictionaryReplace(values);
433      return this;
434   }
435
436   @Override /* BeanContextBuilder */
437   public JsonParserBuilder dictionaryRemove(Class<?>...values) {
438      super.dictionaryRemove(values);
439      return this;
440   }
441
442   @Override /* BeanContextBuilder */
443   public JsonParserBuilder dictionaryRemove(Object...values) {
444      super.dictionaryRemove(values);
445      return this;
446   }
447
448   @Override /* BeanContextBuilder */
449   public <T> JsonParserBuilder example(Class<T> c, T o) {
450      super.example(c, o);
451      return this;
452   }
453
454   @Override /* BeanContextBuilder */
455   public <T> JsonParserBuilder exampleJson(Class<T> c, String value) {
456      super.exampleJson(c, value);
457      return this;
458   }
459
460   @Override /* BeanContextBuilder */
461   public JsonParserBuilder ignoreInvocationExceptionsOnGetters(boolean value) {
462      super.ignoreInvocationExceptionsOnGetters(value);
463      return this;
464   }
465
466   @Override /* BeanContextBuilder */
467   public JsonParserBuilder ignoreInvocationExceptionsOnGetters() {
468      super.ignoreInvocationExceptionsOnGetters();
469      return this;
470   }
471
472   @Override /* BeanContextBuilder */
473   public JsonParserBuilder ignoreInvocationExceptionsOnSetters(boolean value) {
474      super.ignoreInvocationExceptionsOnSetters(value);
475      return this;
476   }
477
478   @Override /* BeanContextBuilder */
479   public JsonParserBuilder ignoreInvocationExceptionsOnSetters() {
480      super.ignoreInvocationExceptionsOnSetters();
481      return this;
482   }
483
484   @Override /* BeanContextBuilder */
485   public JsonParserBuilder ignorePropertiesWithoutSetters(boolean value) {
486      super.ignorePropertiesWithoutSetters(value);
487      return this;
488   }
489
490   @Override /* BeanContextBuilder */
491   public JsonParserBuilder ignoreUnknownBeanProperties(boolean value) {
492      super.ignoreUnknownBeanProperties(value);
493      return this;
494   }
495
496   @Override /* BeanContextBuilder */
497   public JsonParserBuilder ignoreUnknownBeanProperties() {
498      super.ignoreUnknownBeanProperties();
499      return this;
500   }
501
502   @Override /* BeanContextBuilder */
503   public JsonParserBuilder ignoreUnknownNullBeanProperties(boolean value) {
504      super.ignoreUnknownNullBeanProperties(value);
505      return this;
506   }
507
508   @Override /* BeanContextBuilder */
509   public JsonParserBuilder implClass(Class<?> interfaceClass, Class<?> implClass) {
510      super.implClass(interfaceClass, implClass);
511      return this;
512   }
513
514   @Override /* BeanContextBuilder */
515   public JsonParserBuilder implClasses(Map<String,Class<?>> values) {
516      super.implClasses(values);
517      return this;
518   }
519
520   @Override /* BeanContextBuilder */
521   public JsonParserBuilder locale(Locale value) {
522      super.locale(value);
523      return this;
524   }
525
526   @Override /* BeanContextBuilder */
527   public JsonParserBuilder mediaType(MediaType value) {
528      super.mediaType(value);
529      return this;
530   }
531
532   @Override /* BeanContextBuilder */
533   public JsonParserBuilder notBeanClasses(Class<?>...values) {
534      super.notBeanClasses(values);
535      return this;
536   }
537
538   @Override /* BeanContextBuilder */
539   public JsonParserBuilder notBeanClasses(Object...values) {
540      super.notBeanClasses(values);
541      return this;
542   }
543
544   @Override /* BeanContextBuilder */
545   public JsonParserBuilder notBeanClassesReplace(Class<?>...values) {
546      super.notBeanClassesReplace(values);
547      return this;
548   }
549
550   @Override /* BeanContextBuilder */
551   public JsonParserBuilder notBeanClassesReplace(Object...values) {
552      super.notBeanClassesReplace(values);
553      return this;
554   }
555
556   @Override /* BeanContextBuilder */
557   public JsonParserBuilder notBeanClassesRemove(Class<?>...values) {
558      super.notBeanClassesRemove(values);
559      return this;
560   }
561
562   @Override /* BeanContextBuilder */
563   public JsonParserBuilder notBeanClassesRemove(Object...values) {
564      super.notBeanClassesRemove(values);
565      return this;
566   }
567
568   @Override /* BeanContextBuilder */
569   public JsonParserBuilder notBeanPackages(Object...values) {
570      super.notBeanPackages(values);
571      return this;
572   }
573
574   @Override /* BeanContextBuilder */
575   public JsonParserBuilder notBeanPackages(String...values) {
576      super.notBeanPackages(values);
577      return this;
578   }
579
580   @Override /* BeanContextBuilder */
581   public JsonParserBuilder notBeanPackagesReplace(String...values) {
582      super.notBeanPackagesReplace(values);
583      return this;
584   }
585
586   @Override /* BeanContextBuilder */
587   public JsonParserBuilder notBeanPackagesReplace(Object...values) {
588      super.notBeanPackagesReplace(values);
589      return this;
590   }
591
592   @Override /* BeanContextBuilder */
593   public JsonParserBuilder notBeanPackagesRemove(String...values) {
594      super.notBeanPackagesRemove(values);
595      return this;
596   }
597
598   @Override /* BeanContextBuilder */
599   public JsonParserBuilder notBeanPackagesRemove(Object...values) {
600      super.notBeanPackagesRemove(values);
601      return this;
602   }
603
604   @Override /* BeanContextBuilder */
605   public JsonParserBuilder pojoSwaps(Class<?>...values) {
606      super.pojoSwaps(values);
607      return this;
608   }
609
610   @Override /* BeanContextBuilder */
611   public JsonParserBuilder pojoSwaps(Object...values) {
612      super.pojoSwaps(values);
613      return this;
614   }
615
616   @Override /* BeanContextBuilder */
617   public JsonParserBuilder pojoSwapsReplace(Class<?>...values) {
618      super.pojoSwapsReplace(values);
619      return this;
620   }
621
622   @Override /* BeanContextBuilder */
623   public JsonParserBuilder pojoSwapsReplace(Object...values) {
624      super.pojoSwapsReplace(values);
625      return this;
626   }
627
628   @Override /* BeanContextBuilder */
629   public JsonParserBuilder pojoSwapsRemove(Class<?>...values) {
630      super.pojoSwapsRemove(values);
631      return this;
632   }
633
634   @Override /* BeanContextBuilder */
635   public JsonParserBuilder pojoSwapsRemove(Object...values) {
636      super.pojoSwapsRemove(values);
637      return this;
638   }
639
640   @Override /* BeanContextBuilder */
641   public JsonParserBuilder sortProperties(boolean value) {
642      super.sortProperties(value);
643      return this;
644   }
645
646   @Override /* BeanContextBuilder */
647   public JsonParserBuilder sortProperties() {
648      super.sortProperties();
649      return this;
650   }
651
652   @Override /* BeanContextBuilder */
653   public JsonParserBuilder timeZone(TimeZone value) {
654      super.timeZone(value);
655      return this;
656   }
657
658   @Override /* BeanContextBuilder */
659   public JsonParserBuilder useEnumNames(boolean value) {
660      super.useEnumNames(value);
661      return this;
662   }
663
664   @Override /* BeanContextBuilder */
665   public JsonParserBuilder useEnumNames() {
666      super.useEnumNames();
667      return this;
668   }
669
670   @Override /* BeanContextBuilder */
671   public JsonParserBuilder useInterfaceProxies(boolean value) {
672      super.useInterfaceProxies(value);
673      return this;
674   }
675
676   @Override /* BeanContextBuilder */
677   public JsonParserBuilder useJavaBeanIntrospector(boolean value) {
678      super.useJavaBeanIntrospector(value);
679      return this;
680   }
681
682   @Override /* BeanContextBuilder */
683   public JsonParserBuilder useJavaBeanIntrospector() {
684      super.useJavaBeanIntrospector();
685      return this;
686   }
687
688   @Override /* ContextBuilder */
689   public JsonParserBuilder set(String name, Object value) {
690      super.set(name, value);
691      return this;
692   }
693
694   @Override /* ContextBuilder */
695   public JsonParserBuilder set(Map<String,Object> properties) {
696      super.set(properties);
697      return this;
698   }
699
700   @Override /* ContextBuilder */
701   public JsonParserBuilder add(Map<String,Object> properties) {
702      super.add(properties);
703      return this;
704   }
705
706   @Override /* ContextBuilder */
707   public JsonParserBuilder addTo(String name, Object value) {
708      super.addTo(name, value);
709      return this;
710   }
711
712   @Override /* ContextBuilder */
713   public JsonParserBuilder addTo(String name, String key, Object value) {
714      super.addTo(name, key, value);
715      return this;
716   }
717
718   @Override /* ContextBuilder */
719   public JsonParserBuilder removeFrom(String name, Object value) {
720      super.removeFrom(name, value);
721      return this;
722   }
723
724   @Override /* ContextBuilder */
725   public JsonParserBuilder apply(PropertyStore copyFrom) {
726      super.apply(copyFrom);
727      return this;
728   }
729
730   @Override /* ContextBuilder */
731   public JsonParserBuilder applyAnnotations(AnnotationList al, VarResolverSession vrs) {
732      super.applyAnnotations(al, vrs);
733      return this;
734   }
735
736   @Override /* ContextBuilder */
737   public JsonParserBuilder applyAnnotations(Class<?>...fromClasses) {
738      super.applyAnnotations(fromClasses);
739      return this;
740   }
741
742   @Override /* ContextBuilder */
743   public JsonParserBuilder applyAnnotations(Method...fromMethods) {
744      super.applyAnnotations(fromMethods);
745      return this;
746   }
747}