Класс MidiFileReader

java.lang.Object

javax.sound.midi.spi.MidiFileReader

public abstract class MidiFileReader extends Object

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

Начиная с:: 1.3

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

MidiFileReader()

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

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

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

Методы, объявленные в классе 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.

Параметры:

stream — входной поток, из которого следует извлечь сведения о формате файла

Возвращает:

объект MidiFileFormat с описанием формата MIDI-файла

Выбрасывает:

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

IOException — если возникает ошибка ввода-вывода

NullPointerException — если stream равно null

См. также:

getMidiFileFormat

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

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

Параметры:: url — URL, из которого следует извлечь сведения о формате файла
Возвращает:: объект MidiFileFormat с описанием формата MIDI-файла
Выбрасывает:: InvalidMidiDataException — если URL не указывает на корректные данные MIDI-файла, распознаваемые системой; IOException — если возникает ошибка ввода-вывода; NullPointerException — если url равно null

getMidiFileFormat

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

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

Параметры:: file — File, из которого следует извлечь сведения о формате файла
Возвращает:: объект MidiFileFormat с описанием формата MIDI-файла
Выбрасывает:: InvalidMidiDataException — если File не указывает на корректные данные MIDI-файла, распознаваемые системой; IOException — если возникает ошибка ввода-вывода; NullPointerException — если file равно null

getSequence

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

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

Параметры:

stream — входной поток, из которого следует создать Sequence

Возвращает:

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

Выбрасывает:

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

IOException — если возникает ошибка ввода-вывода

NullPointerException — если stream равно null

См. также:

getSequence

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

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

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

getSequence

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

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

Параметры:: file — File, из которого следует создать Sequence
Возвращает:: объект Sequence, созданный на основе данных MIDI-файла, на которые указывает File
Выбрасывает:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/sound/midi/spi/MidiFileReader.html