Класс MidiFileReader

java.lang.Object

javax.sound.midi.spi.MidiFileReader

public abstract class MidiFileReader extends Object

A MidiFileReader предоставляет сервисы чтения файлов MIDI. Классы, реализующие этот интерфейс, могут анализировать информацию о формате одного или нескольких типов файлов MIDI и могут создавать объект Sequence из файлов этих типов.

Since:: 1.3

Краткое описание конструкторов

MidiFileReader()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract MidiFileFormat`	`getMidiFileFormat(File file)`	Получение формата файла MIDI предоставленного `File`.
`abstract MidiFileFormat`	`getMidiFileFormat(InputStream stream)`	Получение формата файла MIDI предоставленного потока ввода.
`abstract MidiFileFormat`	`getMidiFileFormat(URL url)`	Получение формата файла MIDI предоставленного `URL`.
`abstract Sequence`	`getSequence(File file)`	Получение последовательности MIDI из предоставленного `File`.
`abstract Sequence`	`getSequence(InputStream stream)`	Получение последовательности MIDI из предоставленного потока ввода.
`abstract Sequence`	`getSequence(URL url)`	Получение последовательности MIDI из предоставленного `URL`.

Методы, объявленные в классе java.lang.Object

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

Подробное описание конструкторов

MidiFileReader

protected MidiFileReader()

Конструктор для вызова подклассами.

Подробное описание методов

getMidiFileFormat

public abstract MidiFileFormat getMidiFileFormat(InputStream stream) throws InvalidMidiDataException, IOException

Получение формата файла MIDI предоставленного потока ввода. Поток должен указывать на данные валидного файла MIDI. В общем случае, читатели файлов MIDI могут нуждаться в чтении некоторых данных из потока перед определением поддерживает ли он этот формат. Эти парсеры должны уметь помечать поток, прочитать достаточно данных для определения поддерживает ли он поток, а если нет, то сбросить указатель чтения потока в исходное положение. Если поток ввода не поддерживает это, этот метод может завершиться ошибкой IOException.

Parameters:

stream - поток ввода, из которого должна извлекаться информация о формате файла

Returns:

объект MidiFileFormat описывающий формат файла MIDI

Throws:

InvalidMidiDataException - если поток не указывает на данные валидного файла MIDI, распознаваемого системой

IOException - если произошла ошибка ввода-вывода

NullPointerException - если stream является null

See Also:

getMidiFileFormat

public abstract MidiFileFormat getMidiFileFormat(URL url) throws InvalidMidiDataException, IOException

Получение формата файла MIDI предоставленного URL. URL должен указывать на данные валидного файла MIDI.

Parameters:: url - URL, из которого должна извлекаться информация о формате файла
Returns:: объект MidiFileFormat описывающий формат файла MIDI
Throws:: InvalidMidiDataException - если URL не указывает на данные валидного файла MIDI, распознаваемого системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если url является null

getMidiFileFormat

public abstract MidiFileFormat getMidiFileFormat(File file) throws InvalidMidiDataException, IOException

Получение формата файла MIDI предоставленного File. File должен указывать на данные валидного файла MIDI.

Parameters:: file - File, из которого должна извлекаться информация о формате файла
Returns:: объект MidiFileFormat описывающий формат файла MIDI
Throws:: InvalidMidiDataException - если File не указывает на данные валидного файла MIDI, распознаваемого системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если file является null

getSequence

public abstract Sequence getSequence(InputStream stream) throws InvalidMidiDataException, IOException

Получение последовательности MIDI из предоставленного потока ввода. Поток должен указывать на данные валидного файла MIDI. В общем случае, читатели файлов MIDI могут нуждаться в чтении некоторых данных из потока перед определением поддерживает ли он этот формат. Эти парсеры должны уметь помечать поток, прочитать достаточно данных для определения поддерживает ли он поток, а если нет, то сбросить указатель чтения потока в исходное положение. Если поток ввода не поддерживает это, этот метод может завершиться ошибкой IOException.

Parameters:

stream - поток ввода, из которого должна быть построена Sequence

Returns:

объект Sequence основанный на данных файла MIDI, содержащихся в потоке ввода

Throws:

InvalidMidiDataException - если поток не указывает на данные валидного файла MIDI, распознаваемого системой

IOException - если произошла ошибка ввода-вывода

NullPointerException - если stream является null

See Also:

getSequence

public abstract Sequence getSequence(URL url) throws InvalidMidiDataException, IOException

Получение последовательности MIDI из предоставленного URL. URL должен указывать на данные валидного файла MIDI.

Parameters:: url - URL, для которого должна быть построена Sequence
Returns:: объект Sequence, основанный на данных файла MIDI, на которые указывает URL
Throws:: InvalidMidiDataException - если URL не указывает на данные валидного файла MIDI, распознаваемого системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если url является null

getSequence

public abstract Sequence getSequence(File file) throws InvalidMidiDataException, IOException

Получение последовательности MIDI из предоставленного File. File должен указывать на данные валидного файла MIDI.

Parameters:: file - File, из которого должна быть построена Sequence
Returns:: объект Sequence, основанный на данных файла MIDI, на которые указывает File
Throws:: InvalidMidiDataException - если File не указывает на данные валидного файла MIDI, распознаваемого системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если file является null

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/sound/midi/spi/MidiFileReader.html