javax.sound.midi

Class SysexMessage

public class SysexMessage extends MidiMessage

A system exclusive MIDI message.

Since: 1.3

Field Summary
static intSPECIAL_SYSTEM_EXCLUSIVE
static intSYSTEM_EXCLUSIVE
Constructor Summary
SysexMessage()
Create a default valid system exclusive message.
protected SysexMessage(byte[] data)
Create a SysexMessage object.
Method Summary
Objectclone()
byte[]getData()
Get the data for this message, not including the status byte.
voidsetMessage(byte[] data, int length)
Set the sysex message.
voidsetMessage(int status, byte[] data, int length)
Set the sysex message. status must be either 0xF0 or 0xF7.

Field Detail

SPECIAL_SYSTEM_EXCLUSIVE

public static final int SPECIAL_SYSTEM_EXCLUSIVE

SYSTEM_EXCLUSIVE

public static final int SYSTEM_EXCLUSIVE

Constructor Detail

SysexMessage

public SysexMessage()
Create a default valid system exclusive message. The official specs don't specify what message is to be created. Our implementation creates an empty system exclusive message.

SysexMessage

protected SysexMessage(byte[] data)
Create a SysexMessage object.

Parameters: data a complete system exclusive message

Method Detail

clone

public Object clone()

getData

public byte[] getData()
Get the data for this message, not including the status byte.

Returns: the message data, not including the status byte

setMessage

public void setMessage(byte[] data, int length)
Set the sysex message. The first data byte (status) must be 0xF0 or 0xF7.

Parameters: data the message data length the length of the message data

Throws: InvalidMidiDataException if the status byte is not 0xF0 or 0xF7

setMessage

public void setMessage(int status, byte[] data, int length)
Set the sysex message. status must be either 0xF0 or 0xF7.

Parameters: status the sysex statys byte (0xF0 or 0xF7) data the message data length the length of the message data

Throws: InvalidMidiDataException if status is not 0xF0 or 0xF7