com.bramosystems.oss.player.core.client.playlist

Class MRL

java.lang.Object

com.bramosystems.oss.player.core.client.playlist.MRL

public class MRL
extends Object

Media Resource Locator that holds multiple alternative URLs of the same media resource (probably in different formats).

Since:

1.3

Author:

Sikiru Braheem

Constructor Summary

Constructors

Constructor and Description
MRL() Constructs MRL object
MRL(List<String> urls) Constructs MRL object with the specified URLs
MRL(String... urls) Constructs MRL object with the specified URLs
MRL(String name, String author) Constructs MRL object with the specified name and author

Method Summary

Methods

Modifier and Type	Method and Description
void	addURL(String... urls) Adds the specified URLs to this locator
String	getAuthor() Returns the author of the media resource
String	getCurrentResource() Return the current URL.
String	getName() Returns a descriptive name of the media resource
String	getNextResource(boolean roll) Returns the next alternative URL of the media
String	getResource(int index) Returns the resource URL at the specified index
int	getResourceCount() Returns the number of URLs in this locator
void	setAuthor(String author) Sets the author of the media resource
void	setName(String name) Assigns a descriptive name for the media resource
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MRL

public MRL()

Constructs MRL object

MRL

public MRL(String name,
   String author)

Constructs MRL object with the specified name and author

Parameters:

name - the descriptive name of the media resource

author - the author of the media resource

MRL

public MRL(String... urls)

Constructs MRL object with the specified URLs

Parameters:

urls - URLs of the media

MRL

public MRL(List<String> urls)

Constructs MRL object with the specified URLs

Parameters:

urls - URLs of the media

Method Detail

addURL

public void addURL(String... urls)

Adds the specified URLs to this locator

Parameters:

urls - URLs of the media

getNextResource

public String getNextResource(boolean roll)

Returns the next alternative URL of the media

Parameters:

roll - true if an end-of-list should roll over to the first URL

Returns:

the next alternative URL of the media

Throws:

IndexOutOfBoundsException - if end-of-list is reached and roll is false

getCurrentResource

public String getCurrentResource()

Return the current URL. The current URL is that returned by the last getNextResource(boolean) method call

Returns:

the current URL

getResourceCount

public int getResourceCount()

Returns the number of URLs in this locator

Returns:

the number of URLs in this locator

getResource

public String getResource(int index)

Returns the resource URL at the specified index

Parameters:

index - the index of the required resource URL

Returns:

the resource URL

Throws:

IndexOutOfBoundsException - if the index is out of range

toString

public String toString()

Overrides:

toString in class Object

getAuthor

public String getAuthor()

Returns the author of the media resource

Returns:

the author of the media resource

setAuthor

public void setAuthor(String author)

Sets the author of the media resource

Parameters:

author - the author of the media resource

getName

public String getName()

Returns a descriptive name of the media resource

Returns:

a descriptive name of the media resource

setName

public void setName(String name)

Assigns a descriptive name for the media resource

Parameters:

name - a descriptive name of the media resource