javax.sound.midi.spi
클래스 MidiFileReader

java.lang.Object 
  |
  +--javax.sound.midi.spi.MidiFileReader

public abstract class MidiFileReader

extends Object

MidiFileReader 는 MIDI 파일 read 서비스를 제공합니다. 이 인터페이스를 구현하고 있는 클래스는 1 종류 이상의 MIDI 파일로부터 형식 정보를 구문 분석 할 수가 있습니다. 또, 이러한 종류의 파일로부터 Sequence 오브젝트를 생성할 수도 있습니다.

도입된 버젼:

1.3

생성자의 개요

MidiFileReader ()

메소드의 개요

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) 지정된 File 로부터 MIDI 순차 순서를 취득합니다.
abstract Sequence	getSequence (InputStream stream) 지정된 입력 스트림으로부터 MIDI 순차 순서를 취득합니다.
abstract Sequence	getSequence (URL url) 지정된 URL 의 MIDI 순차 순서를 취득합니다.

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자의 상세

MidiFileReader

public MidiFileReader()

메소드의 상세

getMidiFileFormat

public abstract MidiFileFormat  getMidiFileFormat(InputStream  stream)
                                          throws InvalidMidiDataException ,
                                                 IOException 

지정된 입력 스트림의 MIDI 파일 형식을 취득합니다. 스트림은 유효한 MIDI 파일 데이터를 나타낼 필요가 있습니다. 일반적으로, MIDI 파일 리더는 그 스트림을 서포트할지 어떨지를 판정하기 전에 일부의 데이터를 읽어들일 필요가 있습니다. 이러한 구문 분석부에는 스트림을 마크 해, 스트림을 서포트할지 어떨지를 판정하는데 충분한 데이터를 읽어들여, 서포트하지 않는 경우는 스트림의 read 포인터도와의 위치에 되돌린다, 라고 하는 기능이 필요합니다. 입력 스트림이 이것을 서포트하지 않는 경우, 이 메소드는 IOException 를 표시해 실패하는 일이 있습니다.

파라미터:

stream - 파일 형식 정보를 추출하는 입력 스트림

반환값:

MIDI 파일 형식을 기술하는 MidiFileFormat 오브젝트

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 파일 데이터를 스트림이 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우

관련 항목:

InputStream.markSupported() , InputStream.mark(int)

getMidiFileFormat

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

지정된 URL 의 MIDI 파일 형식을 취득합니다. URL 는 유효한 MIDI 파일 데이터를 나타낼 필요가 있습니다.

파라미터:

url - 파일 형식 정보를 추출하는 URL

반환값:

MIDI 파일 형식을 기술하는 MidiFileFormat 오브젝트

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 파일 데이터를 URL 가 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우

getMidiFileFormat

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

지정된 File 의 MIDI 파일 형식을 취득합니다. File 는 유효한 MIDI 파일 데이터를 나타낼 필요가 있습니다.

파라미터:

file - 파일 형식 정보를 추출하는 File

반환값:

MIDI 파일 형식을 기술하는 MidiFileFormat 오브젝트

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 파일 데이터를 File 가 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우

getSequence

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

지정된 입력 스트림으로부터 MIDI 순차 순서를 취득합니다. 스트림은 유효한 MIDI 파일 데이터를 나타낼 필요가 있습니다. 일반적으로, MIDI 파일 리더는 그 스트림을 서포트할지 어떨지를 판정하기 전에 일부의 데이터를 읽어들일 필요가 있습니다. 이러한 구문 분석부에는 스트림을 마크 해, 스트림을 서포트할지 어떨지를 판정하는데 충분한 데이터를 읽어들여, 서포트하지 않는 경우는 스트림의 read 포인터도와의 위치에 되돌린다, 라고 하는 기능이 필요합니다. 입력 스트림이 이것을 서포트하지 않는 경우, 이 메소드는 IOException 를 표시해 실패하는 일이 있습니다.

파라미터:

stream - Sequence 를 구축하는 입력 스트림

반환값:

입력 스트림에 포함되는 MIDI 파일 데이터에 의거하는 Sequence 오브젝트

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 파일 데이터를 스트림이 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우

관련 항목:

InputStream.markSupported() , InputStream.mark(int)

getSequence

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

지정된 URL 의 MIDI 순차 순서를 취득합니다. URL 는 유효한 MIDI 파일 데이터를 나타낼 필요가 있습니다.

파라미터:

url - Sequence 를 구축하는 URL

반환값:

URL 가 가리키는 MIDI 파일 데이터에 의거하는 Sequence 오브젝트

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 파일 데이터를 URL 가 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우

getSequence

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

지정된 File 로부터 MIDI 순차 순서를 취득합니다. File 는 유효한 MIDI 파일 데이터를 나타낼 필요가 있습니다.

파라미터:

file - Sequence 를 구축하는 File

반환값:

File 가 가리키는 MIDI 파일 데이터에 의거하는 Sequence 오브젝트

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 파일 데이터를 File 가 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우