Package com.norconex.crawler.fs.fetch.impl.s3

Class S3Fetcher

java.lang.Object

com.norconex.crawler.core.fetch.AbstractFetcher<S3FetcherConfig>

com.norconex.crawler.fs.fetch.impl.AbstractNioFetcher<S3FetcherConfig>

com.norconex.crawler.fs.fetch.impl.s3.S3Fetcher

All Implemented Interfaces:

Configurable<S3FetcherConfig>, EventListener<Event>, Fetcher, EventListener, Consumer<Event>

public class S3Fetcher
extends AbstractNioFetcher<S3FetcherConfig>

Fetcher for Amazon S3 (s3://bucket/key), backed by a custom, read-only NIO.2 FileSystemProvider (S3FileSystemProvider) built directly on the standard AWS SDK v2 S3Client - not the AWS Common Runtime (CRT) client, avoiding its ~19MB native-library dependency.

S3 has no real directories: a reference like s3://bucket/folder/ is treated as a directory whenever any object exists with that key as a prefix, matching how the AWS console and CLI simulate folders.

Field Summary

Fields inherited from interface com.norconex.commons.lang.config.Configurable

PROPERTY

Constructor Summary

Constructors

Constructor	Description
S3Fetcher()

Method Summary

Modifier and Type	Method	Description
protected boolean	acceptRequest(@NonNull FetchRequest fetchRequest)	Optional method for subclasses to override when in need for additional acceptance logic beyond reference filters (which this abstract class provides).
protected boolean	canEqual(Object other)
boolean	equals(Object o)
protected void	fetcherShutdown(CrawlerSession crawler)	Invoked once per fetcher when the crawler ends.
S3FetcherConfig	getConfiguration()
int	hashCode()
protected Path	resolvePath(String reference)	Resolves a crawler reference (as found on Doc.getReference()) into a NIO.2 Path.
String	toString()

Methods inherited from class com.norconex.crawler.fs.fetch.impl.AbstractNioFetcher

fetch, fetchChildPaths, fetchContent, fetchFileObject, fetchMetadata, getOrOpenFileSystem

Methods inherited from class com.norconex.crawler.core.fetch.AbstractFetcher

accept, accept, fetcherStartup

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.function.Consumer

andThen

Constructor Details

S3Fetcher

public S3Fetcher()

Method Details

fetcherShutdown

protected void fetcherShutdown(CrawlerSession crawler)

Description copied from class: AbstractFetcher

Invoked once per fetcher when the crawler ends. Default implementation does nothing.

Overrides:

fetcherShutdown in class AbstractNioFetcher<S3FetcherConfig>

Parameters:

crawler - crawler

acceptRequest

protected boolean acceptRequest(@NonNull
 @NonNull FetchRequest fetchRequest)

Description copied from class: AbstractFetcher

Optional method for subclasses to override when in need for additional acceptance logic beyond reference filters (which this abstract class provides). This method is only invoked if there are no reference filters configured on this class, or all of them accepts the request document. Default implementation does nothing (always return true).

Overrides:

acceptRequest in class AbstractFetcher<S3FetcherConfig>

Parameters:

fetchRequest - the fetch request to evaluate (never null)

Returns:

true if accepted

resolvePath

protected Path resolvePath(String reference)
                    throws IOException

Description copied from class: AbstractNioFetcher

Resolves a crawler reference (as found on Doc.getReference()) into a NIO.2 Path.

Specified by:

resolvePath in class AbstractNioFetcher<S3FetcherConfig>

Parameters:

reference - the reference to resolve

Returns:

the resolved path

Throws:

IOException - if the reference cannot be resolved

toString

public String toString()

Overrides:

toString in class AbstractNioFetcher<S3FetcherConfig>

equals

public boolean equals(Object o)

Overrides:

equals in class AbstractNioFetcher<S3FetcherConfig>

canEqual

protected boolean canEqual(Object other)

Overrides:

canEqual in class AbstractNioFetcher<S3FetcherConfig>

hashCode

public int hashCode()

Overrides:

hashCode in class AbstractNioFetcher<S3FetcherConfig>

getConfiguration

public S3FetcherConfig getConfiguration()