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}