For the following methods, the documentation does not specify the behaviour if there is no instance of a device of the respective category available at all in the system:
javax.sound.midi.MidiSystem.getSequencer()
javax.sound.midi.MidiSystem.getSynthesizer()
javax.sound.midi.MidiSystem.getTransmitter()
javax.sound.midi.MidiSystem.getReceiver()
The current behaviour of the implementation is to throw an IllegalArgumentException. This behaviour seems appropriate, since the user can find out the installed devices with MidiSystem.getMidiDeviceInfo(). Furthermore, the behaviour is consistent with MidiSystem.getDevice(), which does specify the IllegalArgumentException (if the passed info  customer  doesn't match any device). Therefore, for the methods named above, IllegalArgumentException should be added to the documentation.

N/A

  xxxxx@xxxxx   2003-08-26
Indeed, the requested clearification seems appropriate.

  xxxxx@xxxxx   2003-10-15
We agreed with JCK that throwing an IAE is not a good idea, because it would break compatibility. Instead, we will throw a MidiUnavailableException, which is already declared.


Edited synopsis: this bug became a spec bug after the implementation is fixed along with bug 4932838.
  xxxxx@xxxxx   2003-10-23