Class ResourceRequest.Builder

java.lang.Object

com.thecsdev.common.resource.ResourceRequest.Builder

Enclosing class:

ResourceRequest

public static final class ResourceRequest.Builder
extends Object

A builder for creating instances of ResourceRequest.

Field Summary

Fields

Modifier and Type	Field	Description
protected byte[]	data
protected final Map<String, List<String>>	metadata
protected final URI	uri

Constructor Summary

Constructors

Constructor	Description
Builder(@NotNull URI uri)

Method Summary

Modifier and Type	Method	Description
final @NotNull ResourceRequest.Builder	add(@NotNull String metadataName, @NotNull String metadataValue)	Adds a metadata entry to this ResourceMessage.
final ResourceRequest.Builder	addAll(@NotNull String metadataName, @NotNull com.google.gson.JsonArray metadataValues)	Adds multiple metadata values for the specified metadata name from a JsonArray.
final ResourceRequest.Builder	addAll(@NotNull String metadataName, @NotNull Collection<String> metadataValues)	Adds multiple metadata values for the specified metadata name.
final @NotNull ResourceRequest	build()	Builds and returns a new ResourceRequest instance based on the current state of the builder.
final @NotNull URI	getUri()	Returns the URI this ResourceMessage.AbstractBuilder is for.
final @NotNull ResourceRequest.Builder	set(@NotNull String metadataName, @NotNull String metadataValue)	Sets a metadata entry for this ResourceMessage, replacing any existing values associated with the specified metadata name.
final ResourceRequest.Builder	setData(byte @NotNull [] data)	Sets the raw byte data for the resource response.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

uri

protected final URI uri

metadata

protected final Map<String, List<String>> metadata

data

protected byte[] data

Constructor Details

Builder

public Builder(@NotNull
 @NotNull URI uri)
        throws NullPointerException

Throws:

NullPointerException

Method Details

add

@NotNull
public final @NotNull ResourceRequest.Builder add(@NotNull
 @NotNull String metadataName,
 @NotNull
 @NotNull String metadataValue)
                                           throws NullPointerException,
IllegalStateException

Adds a metadata entry to this ResourceMessage.

Parameters:

metadataName - The name of the metadata entry.

metadataValue - The value of the metadata entry.

Returns:

The current ResourceMessage.AbstractBuilder instance for method chaining.

Throws:

NullPointerException - If any argument is null.

IllegalStateException - If this ResourceMessage.AbstractBuilder already built a ResourceMessage.

addAll

public final ResourceRequest.Builder addAll(@NotNull
 @NotNull String metadataName,
 @NotNull
 @NotNull Collection<String> metadataValues)
                                     throws NullPointerException,
IllegalStateException

Adds multiple metadata values for the specified metadata name.

Parameters:

metadataName - The name of the metadata entry.

metadataValues - A collection of metadata values to add.

Returns:

The current ResourceMessage.AbstractBuilder instance for method chaining.

Throws:

NullPointerException - If any argument is null.

IllegalStateException - If this ResourceMessage.AbstractBuilder already built a ResourceMessage.

addAll

public final ResourceRequest.Builder addAll(@NotNull
 @NotNull String metadataName,
 @NotNull
 @NotNull com.google.gson.JsonArray metadataValues)
                                     throws NullPointerException,
IllegalStateException

Adds multiple metadata values for the specified metadata name from a JsonArray.

Parameters:

metadataName - The name of the metadata entry.

metadataValues - A JsonArray containing metadata values to add.

Returns:

The current ResourceMessage.AbstractBuilder instance for method chaining.

Throws:

NullPointerException - If any argument is null.

IllegalStateException - If this ResourceMessage.AbstractBuilder already built a ResourceMessage.

set

@NotNull
public final @NotNull ResourceRequest.Builder set(@NotNull
 @NotNull String metadataName,
 @NotNull
 @NotNull String metadataValue)
                                           throws NullPointerException,
IllegalStateException

Sets a metadata entry for this ResourceMessage, replacing any existing values associated with the specified metadata name.

Parameters:

metadataName - The name of the metadata entry.

metadataValue - The value of the metadata entry.

Returns:

The current ResourceMessage.AbstractBuilder instance for method chaining.

Throws:

NullPointerException - If any argument is null.

IllegalStateException - If this ResourceMessage.AbstractBuilder already built a ResourceMessage.

setData

public final ResourceRequest.Builder setData(byte @NotNull [] data)
                                      throws NullPointerException,
IllegalStateException

Sets the raw byte data for the resource response.

Parameters:

data - A byte array containing the resource data.

Returns:

The current ResourceMessage.AbstractBuilder instance for method chaining.

Throws:

NullPointerException - If the argument is null.

IllegalStateException - If this ResourceMessage.AbstractBuilder already built a ResourceMessage.

build

@NotNull
public final @NotNull ResourceRequest build()

Builds and returns a new ResourceRequest instance based on the current state of the builder.

Returns:

A new ResourceRequest instance.

getUri

@NotNull
public final @NotNull URI getUri()

Returns the URI this ResourceMessage.AbstractBuilder is for.