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

Параметры:

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, 2021, 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/17/docs/api/java.desktop/javax/sound/midi/spi/MidiFileReader.html