com.datastax.oss.dsbulk.url

Interface URLStreamHandlerProvider

All Known Implementing Classes:

StdinStdoutURLStreamHandlerProvider

public interface URLStreamHandlerProvider

A provider for URLStreamHandler instances. Provider instances are discovered using the Service Loader API, see BulkLoaderURLStreamHandlerFactory.

This interface and the URL stream handler discovery mechanism used in DSBulk are very close to the mechanism implemented by default in the JDK starting with JDK 9, see java.net.spi.URLStreamHandlerProvider. However DSBulk still supports Java 8 and thus has to implement its own discovery mechanism.

Method Summary

Modifier and Type	Method and Description
Optional<URLStreamHandler>	maybeCreateURLStreamHandler(String protocol) Creates a URLStreamHandler for the given protocol, if possible, otherwise returns empty.

Method Detail

maybeCreateURLStreamHandler

@NonNull
Optional<URLStreamHandler> maybeCreateURLStreamHandler(@NonNull
                                                                String protocol)

Creates a URLStreamHandler for the given protocol, if possible, otherwise returns empty.

Parameters:

protocol - The protocol to create a handler for.

Returns:

The created handler, or empty if the protocol is not supported.