Класс 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определенного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определенного промежутка реального времени.

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

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.