1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125
/* * @(#)MidiFileReader.java 1.14 05/11/17 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package javax.sound.midi.spi; import java.io.File; import java.io.InputStream; import java.io.IOException; import java.net.URL; import javax.sound.midi.MidiFileFormat; import javax.sound.midi.Sequence; import javax.sound.midi.InvalidMidiDataException; /** * A <code>MidiFileReader</code> supplies MIDI file-reading services. Classes implementing this * interface can parse the format information from one or more types of * MIDI file, and can produce a <code>Sequence</code> object from files of these types. * * @author Kara Kytle * @version 1.14 05/11/17 * @since 1.3 */ public abstract class MidiFileReader { /** * Obtains the MIDI file format of the input stream provided. The stream must * point to valid MIDI file data. In general, MIDI file readers may * need to read some data from the stream before determining whether they * support it. These parsers must * be able to mark the stream, read enough data to determine whether they * support the stream, and, if not, reset the stream's read pointer to its original * position. If the input stream does not support this, this method may fail * with an <code>IOException</code>. * @param stream the input stream from which file format information should be * extracted * @return a <code>MidiFileFormat</code> object describing the MIDI file format * @throws InvalidMidiDataException if the stream does not point to valid MIDI * file data recognized by the system * @throws IOException if an I/O exception occurs * @see InputStream#markSupported * @see InputStream#mark */ public abstract MidiFileFormat getMidiFileFormat(InputStream stream) throws InvalidMidiDataException, IOException; /** * Obtains the MIDI file format of the URL provided. The URL must * point to valid MIDI file data. * @param url the URL from which file format information should be * extracted * @return a <code>MidiFileFormat</code> object describing the MIDI file format * @throws InvalidMidiDataException if the URL does not point to valid MIDI * file data recognized by the system * @throws IOException if an I/O exception occurs */ public abstract MidiFileFormat getMidiFileFormat(URL url) throws InvalidMidiDataException, IOException; /** * Obtains the MIDI file format of the <code>File</code> provided. * The <code>File</code> must point to valid MIDI file data. * @param file the <code>File</code> from which file format information should be * extracted * @return a <code>MidiFileFormat</code> object describing the MIDI file format * @throws InvalidMidiDataException if the <code>File</code> does not point to valid MIDI * file data recognized by the system * @throws IOException if an I/O exception occurs */ public abstract MidiFileFormat getMidiFileFormat(File file) throws InvalidMidiDataException, IOException; /** * Obtains a MIDI sequence from the input stream provided. The stream must * point to valid MIDI file data. In general, MIDI file readers may * need to read some data from the stream before determining whether they * support it. These parsers must * be able to mark the stream, read enough data to determine whether they * support the stream, and, if not, reset the stream's read pointer to its original * position. If the input stream does not support this, this method may fail * with an IOException. * @param stream the input stream from which the <code>Sequence</code> should be * constructed * @return a <code>Sequence</code> object based on the MIDI file data contained * in the input stream. * @throws InvalidMidiDataException if the stream does not point to valid MIDI * file data recognized by the system * @throws IOException if an I/O exception occurs * @see InputStream#markSupported * @see InputStream#mark */ public abstract Sequence getSequence(InputStream stream) throws InvalidMidiDataException, IOException; /** * Obtains a MIDI sequence from the URL provided. The URL must * point to valid MIDI file data. * @param url the URL for which the <code>Sequence</code> should be * constructed * @return a <code>Sequence</code> object based on the MIDI file data pointed * to by the URL * @throws InvalidMidiDataException if the URL does not point to valid MIDI * file data recognized by the system * @throws IOException if an I/O exception occurs */ public abstract Sequence getSequence(URL url) throws InvalidMidiDataException, IOException; /** * Obtains a MIDI sequence from the <code>File</code> provided. The <code>File</code> must * point to valid MIDI file data. * @param file the <code>File</code> from which the <code>Sequence</code> should be * constructed * @return a <code>Sequence</code> object based on the MIDI file data pointed * to by the <code>File</code> * @throws InvalidMidiDataException if the <code>File</code> does not point to valid MIDI * file data recognized by the system * @throws IOException if an I/O exception occurs */ public abstract Sequence getSequence(File file) throws InvalidMidiDataException, IOException; }