org.apache.druid.data.input.impl

Class HttpInputSource

java.lang.Object

org.apache.druid.data.input.AbstractInputSource

org.apache.druid.data.input.impl.HttpInputSource

All Implemented Interfaces:

SplittableInputSource<URI>, InputSource

public class HttpInputSource
extends AbstractInputSource
implements SplittableInputSource<URI>

Field Summary

Fields

Modifier and Type	Field and Description
static String	TYPE_KEY

Fields inherited from interface org.apache.druid.data.input.impl.SplittableInputSource

DEFAULT_SPLIT_HINT_SPEC

Fields inherited from interface org.apache.druid.data.input.InputSource

TYPE_PROPERTY

Constructor Summary

Constructors

Constructor and Description
HttpInputSource(List<URI> uris, String httpAuthenticationUsername, PasswordProvider httpAuthenticationPasswordProvider, HttpInputSourceConfig config)

Method Summary

Modifier and Type	Method and Description
Stream<InputSplit<URI>>	createSplits(InputFormat inputFormat, SplitHintSpec splitHintSpec) Creates a Stream of InputSplits.
boolean	equals(Object o)
int	estimateNumSplits(InputFormat inputFormat, SplitHintSpec splitHintSpec) Returns an estimated total number of splits to be created via SplittableInputSource.createSplits(org.apache.druid.data.input.InputFormat, org.apache.druid.data.input.SplitHintSpec).
protected InputSourceReader	formattableReader(InputRowSchema inputRowSchema, InputFormat inputFormat, File temporaryDirectory)
PasswordProvider	getHttpAuthenticationPasswordProvider()
String	getHttpAuthenticationUsername()
Set<String>	getTypes() The types of input sources uses.
List<URI>	getUris()
int	hashCode()
boolean	needsFormat() Returns true if this inputSource supports different InputFormats.
static void	throwIfInvalidProtocols(HttpInputSourceConfig config, List<URI> uris)
String	toString()
SplittableInputSource<URI>	withSplit(InputSplit<URI> split) Helper method for ParallelIndexSupervisorTask.

Methods inherited from class org.apache.druid.data.input.AbstractInputSource

fixedFormatReader, reader

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.druid.data.input.impl.SplittableInputSource

getSplitHintSpecOrDefault, isSplittable

Methods inherited from interface org.apache.druid.data.input.InputSource

reader

Field Detail

TYPE_KEY

public static final String TYPE_KEY

See Also:

Constant Field Values

Constructor Detail

HttpInputSource

public HttpInputSource(List<URI> uris,
                       @Nullable
                       String httpAuthenticationUsername,
                       @Nullable
                       PasswordProvider httpAuthenticationPasswordProvider,
                       HttpInputSourceConfig config)

Method Detail

getTypes

@Nonnull
public Set<String> getTypes()

Description copied from interface: InputSource

The types of input sources uses. A set is returned here, as some InputSource implementation allow for combining of multiple input sources.

Specified by:

getTypes in interface InputSource

Returns:

The types of input sources uses

throwIfInvalidProtocols

public static void throwIfInvalidProtocols(HttpInputSourceConfig config,
                                           List<URI> uris)

getUris

public List<URI> getUris()

getHttpAuthenticationUsername

@Nullable
public String getHttpAuthenticationUsername()

getHttpAuthenticationPasswordProvider

@Nullable
public PasswordProvider getHttpAuthenticationPasswordProvider()

createSplits

public Stream<InputSplit<URI>> createSplits(InputFormat inputFormat,
                                            @Nullable
                                            SplitHintSpec splitHintSpec)

Description copied from interface: SplittableInputSource

Creates a Stream of InputSplits. The returned stream is supposed to be evaluated lazily to avoid consuming too much memory. Note that this interface also has SplittableInputSource.estimateNumSplits(org.apache.druid.data.input.InputFormat, org.apache.druid.data.input.SplitHintSpec) which is related to this method. The implementations should be careful to NOT cache the created splits in memory. Implementations can consider InputFormat.isSplittable() and SplitHintSpec to create splits in the same way with SplittableInputSource.estimateNumSplits(org.apache.druid.data.input.InputFormat, org.apache.druid.data.input.SplitHintSpec).

Specified by:

createSplits in interface SplittableInputSource<URI>

estimateNumSplits

public int estimateNumSplits(InputFormat inputFormat,
                             @Nullable
                             SplitHintSpec splitHintSpec)

Description copied from interface: SplittableInputSource

Returns an estimated total number of splits to be created via SplittableInputSource.createSplits(org.apache.druid.data.input.InputFormat, org.apache.druid.data.input.SplitHintSpec). The estimated number of splits doesn't have to be accurate and can be different from the actual number of InputSplits returned from SplittableInputSource.createSplits(org.apache.druid.data.input.InputFormat, org.apache.druid.data.input.SplitHintSpec). This will be used to estimate the progress of a phase in parallel indexing. See TaskMonitor for more details of the progress estimation. This method can be expensive if an implementation iterates all directories or whatever substructure to find all input entities. Implementations can consider InputFormat.isSplittable() and SplitHintSpec to find splits in the same way with SplittableInputSource.createSplits(org.apache.druid.data.input.InputFormat, org.apache.druid.data.input.SplitHintSpec).

Specified by:

estimateNumSplits in interface SplittableInputSource<URI>

withSplit

public SplittableInputSource<URI> withSplit(InputSplit<URI> split)

Description copied from interface: SplittableInputSource

Helper method for ParallelIndexSupervisorTask. Most of implementations can simply create a new instance with the given split.

Specified by:

withSplit in interface SplittableInputSource<URI>

formattableReader

protected InputSourceReader formattableReader(InputRowSchema inputRowSchema,
                                              InputFormat inputFormat,
                                              @Nullable
                                              File temporaryDirectory)

Overrides:

formattableReader in class AbstractInputSource

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

needsFormat

public boolean needsFormat()

Description copied from interface: InputSource

Returns true if this inputSource supports different InputFormats. Some inputSources such as LocalInputSource can store files of any format. These storage types require an InputFormat to be passed so that InputSourceReader can parse data properly. However, some storage types have a fixed format. For example, druid inputSource always reads segments. These inputSources should return false for this method.

Specified by:

needsFormat in interface InputSource

toString

public String toString()

Overrides:

toString in class Object