Класс MidiFileReader

java.lang.Object

javax.sound.midi.spi.MidiFileReader

public abstract class MidiFileReader extends Object

Класс, предоставляющий сервисы чтения 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-файла предоставленного входного потока. Поток должен указывать на данные valid MIDI-файла. В общем случае, читатели MIDI-файлов могут потребовать прочитать некоторые данные из потока, прежде чем определить, поддерживают ли они его. Эти парсеры должны иметь возможность помечать поток, читать достаточно данных, чтобы определить поддерживают ли они поток, и, если нет, сбросить указатель чтения потока в его исходное положение. Если входной поток не поддерживает это, этот метод может завершиться ошибкой IOException.

Parameters:

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

Returns:

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

Throws:

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

IOException - если происходит исключение ввода/вывода

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

See Also:

getMidiFileFormat

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

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

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

getMidiFileFormat

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

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

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

getSequence

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

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

Parameters:

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

Returns:

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

Throws:

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

IOException - если происходит исключение ввода/вывода

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

See Also:

getSequence

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

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

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

getSequence

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

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

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

© 1993, 2023, 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/21/docs/api/java.desktop/javax/sound/midi/spi/MidiFileReader.html