Package org.apache.james.mime4j.stream
Interface FieldBuilder
-
- All Known Implementing Classes:
DefaultFieldBuilder
public interface FieldBuilder
Field builders are intended to construct
RawField
instances from multiple lines contained inByteArrayBuffer
s.Field builders are stateful and modal as they have to store intermediate results between method invocations and also rely on a particular sequence of method invocations (the mode of operation).
Consumers are expected to interact with field builder in the following way:
- Invoke
reset()
method in order to reset builder's internal state and make it ready to start the process of building a newRawField
. - Invoke
append(ByteArrayBuffer)
method one or multiple times in order to build an internal representation of a MIME field from individual lines of text. - Optionally
getRaw()
method can be invoked in order to get combined content of all lines processed so far. Please note builder implementations can returnnull
if they do not retain original raw content. - Invoke
build()
method in order to generate aRawField
instance based on the internal state of the builder.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
append(ByteArrayBuffer line)
Updates builder's internal state by adding a new line of text.RawField
build()
Builds an instance ofRawField
based on the internal state.ByteArrayBuffer
getRaw()
Returns combined content of all lines processed so far ornull
if the builder does not retain original raw content.void
reset()
Resets the internal state of the builder making it ready to process new input.
-
-
-
Method Detail
-
reset
void reset()
Resets the internal state of the builder making it ready to process new input.
-
append
void append(ByteArrayBuffer line) throws MimeException
Updates builder's internal state by adding a new line of text.- Throws:
MimeException
-
build
RawField build() throws MimeException
Builds an instance ofRawField
based on the internal state.- Throws:
MimeException
-
getRaw
ByteArrayBuffer getRaw()
Returns combined content of all lines processed so far ornull
if the builder does not retain original raw content.
-
-