Package org.apache.juneau.parser

Class ParserSet.Builder

java.lang.Object
org.apache.juneau.BeanBuilder<ParserSet>
org.apache.juneau.parser.ParserSet.Builder
Enclosing class:
ParserSet
public static class ParserSet.Builder extends BeanBuilder<ParserSet>
Builder class.

  • Constructor Details

    • Builder

      protected Builder(BeanStore beanStore)
      Create an empty parser group builder.
      Parameters:
      beanStore - The bean store to use for creating beans.

    • Builder

      protected Builder(ParserSet copyFrom)
      Clone an existing parser group.
      Parameters:
      copyFrom - The parser group that we're copying settings and parsers from.

    • Builder

      protected Builder(ParserSet.Builder copyFrom)
      Clone an existing parser group builder.

      Parser builders will be cloned during this process.

      Parameters:
      copyFrom - The parser group that we're copying settings and parsers from.

  • Method Details

    • buildDefault

      protected ParserSet buildDefault()
      Description copied from class: BeanBuilder
      Creates the bean when the bean type is null or is the default value.
      Overrides:
      buildDefault in class BeanBuilder<ParserSet>
      Returns:
      A new bean.

    • copy

      public ParserSet.Builder copy()
      Makes a copy of this builder.
      Returns:
      A new copy of this builder.

    • beanContext

      public ParserSet.Builder beanContext(BeanContext.Builder value)
      Associates an existing bean context builder with all parser builders in this group.
      Parameters:
      value - The bean contest builder to associate.
      Returns:
      This object.

    • beanContext

      public final ParserSet.Builder beanContext(Consumer<BeanContext.Builder> operation)
      Applies an operation to the bean context builder.
      Parameters:
      operation - The operation to apply.
      Returns:
      This object.

    • add

      public ParserSet.Builder add(Class<?>... values)
      Adds the specified parsers to this group.

      Entries are added in-order to the beginning of the list in the group.

      The ParserSet.NoInherit class can be used to clear out the existing list of parsers before adding the new entries.

      Example:

      ParserSet.Builder builder = ParserSet.create(); // Create an empty builder. builder.add(FooParser.class); // Now contains: [FooParser] builder.add(BarParser.class, BazParser.class); // Now contains: [BarParser,BazParser,FooParser] builder.add(NoInherit.class, QuxParser.class); // Now contains: [QuxParser]

      Parameters:
      values - The parsers to add to this group.
      Returns:
      This object.
      Throws:
      IllegalArgumentException - If one or more values do not extend from Parser.

    • set

      public ParserSet.Builder set(Class<?>... values)
      Sets the specified parsers for this group.

      Existing values are overwritten.

      The ParserSet.Inherit class can be used to insert existing entries in this group into the position specified.

      Example:

      ParserSet.Builder builder = ParserSet.create(); // Create an empty builder. builder.set(FooParser.class); // Now contains: [FooParser] builder.set(BarParser.class, BazParser.class); // Now contains: [BarParser,BazParser] builder.set(Inherit.class, QuxParser.class); // Now contains: [BarParser,BazParser,QuxParser]

      Parameters:
      values - The parsers to set in this group.
      Returns:
      This object.
      Throws:
      IllegalArgumentException - If one or more values do not extend from Parser or named "Inherit".

    • add

      public ParserSet.Builder add(Parser... s)
      Registers the specified parsers with this group.

      When passing in pre-instantiated parsers to this group, applying properties and transforms to the group do not affect them.

      Parameters:
      s - The parsers to append to this group.
      Returns:
      This object.

    • clear

      public ParserSet.Builder clear()
      Clears out any existing parsers in this group.
      Returns:
      This object.

    • canApply

      public boolean canApply(AnnotationWorkList work)
      Returns true if at least one of the specified annotations can be applied to at least one parser builder in this group.
      Parameters:
      work - The work to check.
      Returns:
      true if at least one of the specified annotations can be applied to at least one parser builder in this group.

    • apply

      public ParserSet.Builder apply(AnnotationWorkList work)
      Applies the specified annotations to all applicable parser builders in this group.
      Parameters:
      work - The annotations to apply.
      Returns:
      This object.

    • forEach

      public ParserSet.Builder forEach(Consumer<Parser.Builder> action)
      Performs an action on all parser builders in this group.
      Parameters:
      action - The action to perform.
      Returns:
      This object.

    • forEachRP

      public ParserSet.Builder forEachRP(Consumer<ReaderParser.Builder> action)
      Performs an action on all writer parser builders in this group.
      Parameters:
      action - The action to perform.
      Returns:
      This object.

    • forEachISP

      public ParserSet.Builder forEachISP(Consumer<InputStreamParser.Builder> action)
      Performs an action on all output stream parser builders in this group.
      Parameters:
      action - The action to perform.
      Returns:
      This object.

    • forEach

      public <B extends Parser.Builder> ParserSet.Builder forEach(Class<B> type, Consumer<B> action)
      Performs an action on all parser builders of the specified type in this group.
      Type Parameters:
      B - The parser builder type.
      Parameters:
      type - The parser builder type.
      action - The action to perform.
      Returns:
      This object.

    • inner

      public List<Object> inner()
      Returns direct access to the Parser and Parser.Builder objects in this builder.

      Provided to allow for any extraneous modifications to the list not accomplishable via other methods on this builder such as re-ordering/adding/removing entries.

      Note that it is up to the user to ensure that the list only contains Parser and Parser.Builder objects.

      Returns:
      The inner list of entries in this builder.

    • impl

      public ParserSet.Builder impl(Object value)
      Description copied from class: BeanBuilder
      Overrides the bean returned by the BeanBuilder.build() method.

      Use this method if you want this builder to return an already-instantiated bean.

      Overrides:
      impl in class BeanBuilder<ParserSet>
      Parameters:
      value - The setting value.
      Returns:
      This object.

    • type

      public ParserSet.Builder type(Class<?> value)
      Description copied from class: BeanBuilder
      Overrides the bean type produced by the BeanBuilder.build() method.

      Use this method if you want to instantiated a bean subclass.

      Overrides:
      type in class BeanBuilder<ParserSet>
      Parameters:
      value - The setting value.
      Returns:
      This object.

    • toString

      public String toString()
      Overrides:
      toString in class Object