Package javazoom.jl.player
Class AudioDeviceFactory
java.lang.Object
javazoom.jl.player.AudioDeviceFactory
- Direct Known Subclasses:
FactoryRegistry
,JavaSoundAudioDeviceFactory
An
AudioDeviceFactory
class is responsible for creating
a specific AudioDevice
implementation. A factory implementation
can be as simple or complex as desired and may support just one implementation
or may return several implementations depending upon the execution
environment.
When implementing a factory that provides an AudioDevice that uses class that may not be present, the factory should dynamically link to any specific implementation classes required to instantiate or test the audio implementation. This is so that the application as a whole can run without these classes being present. The audio device implementation, however, will usually statically link to the classes required. (See the JavaSound deivce and factory for an example of this.)
- Since:
- 0.0.8
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionabstract AudioDevice
Creates a newAudioDevice
.protected AudioDevice
instantiate
(ClassLoader loader, String name) Creates an instance of an AudioDevice implementation.
-
Constructor Details
-
AudioDeviceFactory
public AudioDeviceFactory()
-
-
Method Details
-
createAudioDevice
Creates a newAudioDevice
.- Returns:
- a new instance of a specific class of
AudioDevice
. - Throws:
JavaLayerException
- if an instance of AudioDevice could not be created.
-
instantiate
protected AudioDevice instantiate(ClassLoader loader, String name) throws ClassNotFoundException, IllegalAccessException, InstantiationException Creates an instance of an AudioDevice implementation.- Parameters:
loader
- TheClassLoader
to use to load the named class, or null to use the system class loader.name
- The name of the class to load.- Returns:
- A newly-created instance of the audio device class.
- Throws:
ClassNotFoundException
IllegalAccessException
InstantiationException
-