org.media.standard

Interface MediaPlayerFactory

public interface MediaPlayerFactory

Factory for MediaPlayer objects. Providers should implement this interface with a concrete newPlayer method, returning a suitable MediaPlayer instance. Providers should also document their factory classname for end users. The actual factory to be used can be specified two ways:

• Explicitly by specifying the factory classname to newInstance(String)
• Implicitly by specifying the factory classname as a system property: org.media.standard.MediaPlayerFactory

Since:

1.0

Author:

SMO, the Standards Media Consortium.

See Also:

MediaPlayer

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	FACTORY_CLASS_NAME System property specifying classname of factory.

Method Summary

Modifier and Type	Method and Description
static MediaPlayerFactory	newInstance() Instantiates factory from system property org.media.standard.MediaPlayerFactory.
static MediaPlayerFactory	newInstance(java.lang.String factoryClassName) Instantiates factory from specified classname.
MediaPlayer	newPlayer() Creates new MediaPlayer instance from this factory.

Field Detail

FACTORY_CLASS_NAME

static final java.lang.String FACTORY_CLASS_NAME

System property specifying classname of factory.

See Also:

Constant Field Values

Method Detail

newPlayer

MediaPlayer newPlayer()

Creates new MediaPlayer instance from this factory.

newInstance

static MediaPlayerFactory newInstance()
                               throws FactoryConfigurationException

Instantiates factory from system property org.media.standard.MediaPlayerFactory.

Throws:

FactoryConfigurationException - if the factory could not be instantiated. Note that this exception will wrap the underlying exception, e.g., ClassNotFoundException.

See Also:

FACTORY_CLASS_NAME

newInstance

static MediaPlayerFactory newInstance(java.lang.String factoryClassName)
                               throws FactoryConfigurationException

Instantiates factory from specified classname.

Parameters:

factoryClassName - the fully qualified classname of the factory.

Throws:

FactoryConfigurationException - if the factory could not be instantiated. Note that this exception will wrap the underlying exception, e.g., ClassNotFoundException.