java.lang.Object
javax.sound.midi.spi.MidiFileReader
A 
MidiFileReader supplies MIDI file-reading services. Classes
 implementing this interface can parse the format information from one or more
 types of MIDI file, and can produce a Sequence object from files of
 these types.- Since:
- 1.3
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionabstract MidiFileFormatgetMidiFileFormat(File file) Obtains the MIDI file format of theFileprovided.abstract MidiFileFormatgetMidiFileFormat(InputStream stream) Obtains the MIDI file format of the input stream provided.abstract MidiFileFormatgetMidiFileFormat(URL url) Obtains the MIDI file format of theURLprovided.abstract SequencegetSequence(File file) Obtains a MIDI sequence from theFileprovided.abstract SequencegetSequence(InputStream stream) Obtains a MIDI sequence from the input stream provided.abstract SequencegetSequence(URL url) Obtains a MIDI sequence from theURLprovided.
- 
Constructor Details- 
MidiFileReaderprotected MidiFileReader()Constructor for subclasses to call.
 
- 
- 
Method Details- 
getMidiFileFormatpublic abstract MidiFileFormat getMidiFileFormat(InputStream stream) throws InvalidMidiDataException, IOException Obtains the MIDI file format of the input stream provided. The stream must point to valid MIDI file data. In general, MIDI file readers may need to read some data from the stream before determining whether they support it. These parsers must be able to mark the stream, read enough data to determine whether they support the stream, and, if not, reset the stream's read pointer to its original position. If the input stream does not support this, this method may fail with anIOException.- Parameters:
- stream- the input stream from which file format information should be extracted
- Returns:
- a MidiFileFormatobject describing the MIDI file format
- Throws:
- InvalidMidiDataException- if the stream does not point to valid MIDI file data recognized by the system
- IOException- if an I/O exception occurs
- NullPointerException- if- streamis- null
- See Also:
 
- 
getMidiFileFormatpublic abstract MidiFileFormat getMidiFileFormat(URL url) throws InvalidMidiDataException, IOException Obtains the MIDI file format of theURLprovided. TheURLmust point to valid MIDI file data.- Parameters:
- url- the- URLfrom which file format information should be extracted
- Returns:
- a MidiFileFormatobject describing the MIDI file format
- Throws:
- InvalidMidiDataException- if the- URLdoes not point to valid MIDI file data recognized by the system
- IOException- if an I/O exception occurs
- NullPointerException- if- urlis- null
 
- 
getMidiFileFormatpublic abstract MidiFileFormat getMidiFileFormat(File file) throws InvalidMidiDataException, IOException Obtains the MIDI file format of theFileprovided. TheFilemust point to valid MIDI file data.- Parameters:
- file- the- Filefrom which file format information should be extracted
- Returns:
- a MidiFileFormatobject describing the MIDI file format
- Throws:
- InvalidMidiDataException- if the- Filedoes not point to valid MIDI file data recognized by the system
- IOException- if an I/O exception occurs
- NullPointerException- if- fileis- null
 
- 
getSequencepublic abstract Sequence getSequence(InputStream stream) throws InvalidMidiDataException, IOException Obtains a MIDI sequence from the input stream provided. The stream must point to valid MIDI file data. In general, MIDI file readers may need to read some data from the stream before determining whether they support it. These parsers must be able to mark the stream, read enough data to determine whether they support the stream, and, if not, reset the stream's read pointer to its original position. If the input stream does not support this, this method may fail with anIOException.- Parameters:
- stream- the input stream from which the- Sequenceshould be constructed
- Returns:
- a Sequenceobject based on the MIDI file data contained in the input stream
- Throws:
- InvalidMidiDataException- if the stream does not point to valid MIDI file data recognized by the system
- IOException- if an I/O exception occurs
- NullPointerException- if- streamis- null
- See Also:
 
- 
getSequenceObtains a MIDI sequence from theURLprovided. TheURLmust point to valid MIDI file data.- Parameters:
- url- the- URLfor which the- Sequenceshould be constructed
- Returns:
- a Sequenceobject based on the MIDI file data pointed to by theURL
- Throws:
- InvalidMidiDataException- if the- URLdoes not point to valid MIDI file data recognized by the system
- IOException- if an I/O exception occurs
- NullPointerException- if- urlis- null
 
- 
getSequenceObtains a MIDI sequence from theFileprovided. TheFilemust point to valid MIDI file data.- Parameters:
- file- the- Filefrom which the- Sequenceshould be constructed
- Returns:
- a Sequenceobject based on the MIDI file data pointed to by theFile
- Throws:
- InvalidMidiDataException- if the- Filedoes not point to valid MIDI file data recognized by the system
- IOException- if an I/O exception occurs
- NullPointerException- if- fileis- null
 
 
-