Modifier and Type	Class and Description
private static class	Locator.LocatorConnection Holds connection and response code returned from getConnection()

Field Summary

Modifier and Type	Field and Description
private LocatorCache.CacheReference	cacheEntry
private boolean	canBlock
private static final long	CONNECTION_RETRY_INTERVAL The number of milliseconds between attempts to open a URL connection.
private static final int	CONNECTION_TIMEOUT Timeout in milliseconds to wait for connection (5 min).
private Map<String, Object>	connectionProperties Properties to be associated with the connection made to the URI.
protected long	contentLength A hint for the internal player.
protected String	contentType The content type of the media content.
public static final String	DEFAULT_CONTENT_TYPE The content type used if no more specific one may be derived.
private boolean	isIpod iOS only: determines if the given URL points to the iPod library
private static final int	MAX_CONNECTION_ATTEMPTS The number of times to attempt to open a URL connection to test the URI.
private final Object	propertyLock Mutex for connectionProperties;
private String	protocol
private CountDownLatch	readySignal
private String	scheme
protected URI	uri The URI source.
private String	uriString

Constructor Summary

Access	Constructor and Description
public	Locator(URI The URI source. uri) Constructs an object representing a media source.

Method Summary

Modifier and Type	Method and Description
public void	cacheMedia() Tell this Locator to preload the media into memory, if it hasn't been already.
public boolean	canBlock()
pack-priv static void	closeConnection(URLConnection connection)
public ConnectionHolder	createConnectionHolder()
public ConnectionHolder	getAudioStreamConnectionHolder(ConnectionHolder connectionHolder)
private Locator.LocatorConnection	getConnection(URI uri, String requestMethod)
public long	Returns: size of the media file in bytes. -1 indicates unknown, which may happen with network streams. getContentLength() Retrieves the media size.
private static long	getContentLengthLong(URLConnection connection)
public String	getContentType() Retrieves the content type describing the media content or `"application/octet-stream"` if no more specific content type may be detected.
private String	getContentTypeFromFileSignature(URI uri)
private InputStream	getInputStream(URI uri)
public String	getProtocol() Retrieves the protocol of the media URL
public String	getStringLocation()
public URI	Returns: The URI source. getURI() Retrieves the associated `URI`.
public void	init()
public void	setConnectionProperty(String The name of the property. property, Object The value of the property. value) Sets a property to be used by the connection to the media specified by the URI.
public String	Returns: The `LocatorURI` as a `String`. toString() Overrides java.lang.Object.toString. Retrieves a string representation of the `Locator`
public void	waitForReadySignal() Blocks until locator is ready (connection is established or failed).

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

cacheEntry	back to summary
private LocatorCache.CacheReference cacheEntry

canBlock	back to summary
private boolean canBlock

CONNECTION_RETRY_INTERVAL	back to summary
private static final long CONNECTION_RETRY_INTERVAL The number of milliseconds between attempts to open a URL connection.

CONNECTION_TIMEOUT	back to summary
private static final int CONNECTION_TIMEOUT Timeout in milliseconds to wait for connection (5 min).

connectionProperties	back to summary
private Map<String, Object> connectionProperties Properties to be associated with the connection made to the URI. The significance of the properties depends on the URI protocol and type of media source.

contentLength	back to summary
protected long contentLength A hint for the internal player.

contentType	back to summary
protected String contentType The content type of the media content.

DEFAULT_CONTENT_TYPE	back to summary
public static final String DEFAULT_CONTENT_TYPE The content type used if no more specific one may be derived.

isIpod	back to summary
private boolean isIpod iOS only: determines if the given URL points to the iPod library

MAX_CONNECTION_ATTEMPTS	back to summary
private static final int MAX_CONNECTION_ATTEMPTS The number of times to attempt to open a URL connection to test the URI.

propertyLock	back to summary
private final Object propertyLock Mutex for connectionProperties;

protocol	back to summary
private String protocol

readySignal	back to summary
private CountDownLatch readySignal

scheme	back to summary
private String scheme

uri	back to summary
protected URI uri The URI source.

uriString	back to summary
private String uriString

Constructor Detail

Locator back to summary

Locator	back to summary
public Locator(URI uri) throws URISyntaxException Constructs an object representing a media source. Parameters uri:URI The URI source. Exceptions URISyntaxException: if the supplied URI requires some further manipulation in order to be used and this procedure fails to produce a usable URI. NullPointerException: if `uri` is `null`. IllegalArgumentException: if the URI's scheme is `null`. if the URI is a Jar URL as described in `https://docs.oracle.com/javase/8/docs/api/java/net/JarURLConnection.html`, and the scheme of the URL after removing the leading four characters is `null`. UnsupportedOperationException: if the URI's protocol is unsupported.

public Locator(URI uri) throws URISyntaxException

Constructs an object representing a media source.

Parameters

uri:URI: The URI source.

Exceptions

URISyntaxException:

if the supplied URI requires some further manipulation in order to be used and this procedure fails to produce a usable URI.

NullPointerException:

if uri is null.

IllegalArgumentException:

if the URI's scheme is null.
if the URI is a Jar URL as described in https://docs.oracle.com/javase/8/docs/api/java/net/JarURLConnection.html, and the scheme of the URL after removing the leading four characters is null.

UnsupportedOperationException:

if the URI's protocol is unsupported.

Method Detail

cacheMedia	back to summary
public void cacheMedia() Tell this Locator to preload the media into memory, if it hasn't been already.

canBlock	back to summary
public boolean canBlock()

closeConnection	back to summary
pack-priv static void closeConnection(URLConnection connection)

createConnectionHolder	back to summary
public ConnectionHolder createConnectionHolder() throws IOException

getAudioStreamConnectionHolder	back to summary
public ConnectionHolder getAudioStreamConnectionHolder(ConnectionHolder connectionHolder) throws IOException

getConnection	back to summary
private Locator.LocatorConnection getConnection(URI uri, String requestMethod) throws MalformedURLException, IOException

getContentLength	back to summary
public long getContentLength() Retrieves the media size. Returns:long size of the media file in bytes. -1 indicates unknown, which may happen with network streams.

getContentLength

back to summary

public long getContentLength()

Retrieves the media size.

Returns:long: size of the media file in bytes. -1 indicates unknown, which may happen with network streams.

getContentLengthLong	back to summary
private static long getContentLengthLong(URLConnection connection)

getContentType	back to summary
public String getContentType() Retrieves the content type describing the media content or `"application/octet-stream"` if no more specific content type may be detected.

getContentTypeFromFileSignature	back to summary
private String getContentTypeFromFileSignature(URI uri) throws MalformedURLException, IOException

getInputStream	back to summary
private InputStream getInputStream(URI uri) throws MalformedURLException, IOException

getProtocol	back to summary
public String getProtocol() Retrieves the protocol of the media URL

getStringLocation	back to summary
public String getStringLocation()

getURI back to summary

getURI	back to summary
public URI getURI() Retrieves the associated `URI`. Returns:URI The URI source.

public URI getURI()

Retrieves the associated URI.

Returns:URI: The URI source.

init	back to summary
public void init() throws URISyntaxException, IOException, FileNotFoundException

setConnectionProperty back to summary

setConnectionProperty	back to summary
public void setConnectionProperty(String property, Object value) Sets a property to be used by the connection to the media specified by the URI. The meaning of the property is a function of the URI protocol and type of media source. This method should be invoked before calling `createConnectionHolder()` or it will have no effect. Parameters property:String The name of the property. value:Object The value of the property.

public void setConnectionProperty(String property, Object value)

Sets a property to be used by the connection to the media specified by the URI. The meaning of the property is a function of the URI protocol and type of media source. This method should be invoked before calling createConnectionHolder() or it will have no effect.

Parameters

property:String: The name of the property.
value:Object: The value of the property.

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Retrieves a string representation of the `Locator` Returns:String The `LocatorURI` as a `String`. Annotations @Override

public String toString()

Overrides java.lang.Object.toString.

Retrieves a string representation of the Locator

Returns:String

The LocatorURI as a String.

Annotations

@Override

waitForReadySignal	back to summary
public void waitForReadySignal() Blocks until locator is ready (connection is established or failed).

com.sun.media.jfxmedia.locator back to summary

private Class Locator.LocatorConnection

Class Inheritance

extends Object

java.lang.Object
com.sun.media.jfxmedia.locator.Locator.LocatorConnection

Holds connection and response code returned from getConnection()

Field Summary

Modifier and Type	Field and Description
public HttpURLConnection	connection
public int	responseCode

Constructor Summary

Access	Constructor and Description
private	LocatorConnection()

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

connection	back to summary
public HttpURLConnection connection

responseCode	back to summary
public int responseCode

Constructor Detail

LocatorConnection	back to summary
private LocatorConnection()

public Class Locator

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class Locator.LocatorConnection

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail