io.humble.video.customio

Class URLProtocolManager

java.lang.Object

io.humble.video.customio.URLProtocolManager

public class URLProtocolManager
extends Object

This class manages URL protocols that we have handlers for. It is used (and called from) the Native code that integrates with FFMPEG. To register a handler you would use the singleton manager as follows:

  URLProtocolManager mgr = URLProtocolManager.getManager();
  mgr.registerFactory("myprotocol", myProtocolHandlerFactory);
 

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_PROTOCOL
static String	NULL_PROTOCOL

Method Summary

Modifier and Type	Method and Description
IURLProtocolHandler	getHandler(String url, int flags)
static URLProtocolManager	getManager() Factory method to get the global protocol manager.
static String	getProtocolFromURL(String url) Get the protocol portion of a url.
static String	getResourceFromURL(String url) Get the resource portion of a url.
static void	init() Method to be called to initialize this library.
IURLProtocolHandlerFactory	registerFactory(String protocol, IURLProtocolHandlerFactory factory) Register a new factory for IURLProtocolHandlers for a given protocol.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_PROTOCOL

public static final String DEFAULT_PROTOCOL

See Also:

Constant Field Values

NULL_PROTOCOL

public static final String NULL_PROTOCOL

See Also:

Constant Field Values

Method Detail

getManager

public static URLProtocolManager getManager()

Factory method to get the global protocol manager.

init

public static void init()

Method to be called to initialize this library.

registerFactory

public IURLProtocolHandlerFactory registerFactory(String protocol,
                                                  IURLProtocolHandlerFactory factory)

Register a new factory for IURLProtocolHandlers for a given protocol.

FFMPEG is very picky; protocols must be only alpha characters (no numbers).

Parameters:

protocol - The protocol, without colon, this factory is to be used for.

factory - The factory for the manager to use whenever a handler is requested for a registered protocol; null means disable handling for this factory.

Returns:

The factory that was previously used for that protocol (or null if none).

getHandler

public IURLProtocolHandler getHandler(String url,
                                      int flags)

getResourceFromURL

public static String getResourceFromURL(String url)

Get the resource portion of a url. For example for the URL

 http://www.humble.io/video
 

The protocol string is http and the resource string is www.humble.io/video

Parameters:

url - The url to parse

Returns:

The resource

getProtocolFromURL

public static String getProtocolFromURL(String url)

Get the protocol portion of a url. For example for the URL

 http://www.humble.io/video
 

The protocol string is http and the resource string is //www.humble.io/video

Parameters:

url - The url to parse

Returns:

The protocol