B
- the type of the Builder itselfT
- the type being built by the build()
method of this builder.R
- the actual subtype of ILightRequest
in use by this implementation.@NotThreadSafe public abstract static class AbstractStoredRequest.AbstractBuilder<B extends AbstractStoredRequest.AbstractBuilder<B,T,R>,T extends AbstractStoredRequest<R>,R extends Serializable> extends Object
AbstractStoredRequest
subtypes.
Effective Java, 2nd Ed. : Item 2: Builder Pattern.
This Builder is not thread-safe but is thread-compliant, it is supposed to be used by only one thread.
See Self-bounding generics:
http://www.artima.com/weblogs/viewpost.jsp?thread=136394
http://www.artima.com/forums/flat.jsp?forum=106&thread=136394
http://en.wikipedia.org/wiki/Covariance_and_contravariance
Modifier | Constructor and Description |
---|---|
protected |
AbstractBuilder() |
protected |
AbstractBuilder(AbstractStoredRequest.AbstractBuilder<?,?,R> copy) |
protected |
AbstractBuilder(AbstractStoredRequest<R> copy) |
Modifier and Type | Method and Description |
---|---|
T |
build()
Builds a new
T instance based on this Builder instance (Builder pattern for AbstractStoredRequest ). |
protected abstract T |
newInstance()
Method to be implemented by subtypes to create the right type
T of instances. |
B |
remoteIpAddress(String remoteIpAddress) |
B |
request(R request) |
protected abstract void |
validate()
Validates the state of this Builder before allowing to create new instances of the built type
T . |
protected AbstractBuilder()
protected AbstractBuilder(@Nonnull AbstractStoredRequest<R> copy)
protected AbstractBuilder(@Nonnull AbstractStoredRequest.AbstractBuilder<?,?,R> copy)
protected abstract void validate() throws IllegalArgumentException
T
.IllegalArgumentException
- if the builder is not in a legal state allowing to proceed with the creation
of a T
instance.@Nonnull public final T build()
T
instance based on this Builder instance (Builder pattern for AbstractStoredRequest
).
The validate()
is always called before creating a new instance through a call to the newInstance()
method.
T
instance based on this Builder instance.Copyright © 2020. All Rights Reserved.