CompoundElement, which accepts the member elements
to be integrated into the built structure. Builders are usually passed as
an argument to Consumer handlers, such as in ClassFile#build(ClassDesc, Consumer). The handlers should deliver elements
to a builder similar to how a CompoundElement traverses its member
elements.
The basic way a builder accepts elements is through with, which
supports call chaining. Concrete subtypes of builders usually define extra
methods to define elements directly to the builder, such as ClassBuilder#withFlags(int) or CodeBuilder#aload(int).
Whether a member element can appear multiple times in a compound structure
affects the behavior of the element in ClassFileBuilders. If an
element can appear at most once but multiple instances are supplied to a
ClassFileBuilder, the last supplied instance appears on the built
structure. If an element appears exactly once but no instance is supplied,
an unspecified default value element may be used in that structure.
Due to restrictions of the class file format, certain member elements
that can be modeled by the API cannot be represented in the built structure
under specific circumstances. Passing such elements to the builder causes
IllegalArgumentException. Some ClassFile.s control
whether such elements should be altered or dropped to produce valid class files.
CompoundElement, ClassFileTransform
| Modifier and Type | Method and Description |
|---|---|
| public default void | accept(E
the member element e)Implements java. Integrates the member element into the structure being built. |
| public ConstantPoolBuilder | Returns: the constant pool builder associated with this builderReturns the constant pool builder associated with this builder. |
| public default B | Returns: this builderthe structure to transform model, ClassFileTransform<?, E, B> the transform to apply transform)Applies a transform to a compound structure, directing results to this builder. |
| public B | Returns: this builderthe member element e)Integrates the member element into the structure being built. |
| accept | back to summary |
|---|---|
| public default void accept(E e) Implements java. Integrates the member element into the structure being built.
| |
| constantPool | back to summary |
|---|---|
| public ConstantPoolBuilder constantPool() Returns the constant pool builder associated with this builder.
| |
| transform | back to summary |
|---|---|
| public default B transform(CompoundElement<E> model, ClassFileTransform<?, E, B> transform) Applies a transform to a compound structure, directing results to this builder. The transform will receive each element of the compound structure, as well as this builder for building the structure. The transform is free to preserve, remove, or replace elements as it sees fit. A builder can run multiple transforms against different compound structures, integrating member elements of different origins. API Note Many subinterfaces have methods like
| |
| with | back to summary |
|---|---|
| public B with(E e) Integrates the member element into the structure being built.
| |