public interface Line extends AutoCloseable
Line interface represents a mono or multi-channel
 audio feed. A line is an element of the digital audio
 "pipeline," such as a mixer, an input or output port,
 or a data path into or out of a mixer.
 
 A line can have controls, such as gain, pan, and reverb.
 The controls themselves are instances of classes that extend the
 base ControlLine interface provides two accessor methods for
 obtaining the line's controls: getControlsgetControl
 Lines exist in various states at different times.  When a line opens, it reserves system
 resources for itself, and when it closes, these resources are freed for
 other objects or applications. The isOpen()SourceDataLine.writeTargetDataLine.read
 You can register an object to receive notifications whenever the line's
 state changes.  The object must implement the LineListenerupdateDataLine, when it starts and stops).
 An object can be registered to listen to multiple lines.  The event it
 receives in its update method will specify which line created
 the event, what type of event it was
 (OPEN, CLOSE, START, or STOP),
 and how many sample frames the line had processed at the time the event occurred.
 
Certain line operations, such as open and close, can generate security exceptions if invoked by unprivileged code when the line is a shared audio resource.
LineEvent| Modifier and Type | Interface and Description | 
|---|---|
| static class  | Line.InfoA  Line.Infoobject contains information about a line. | 
| Modifier and Type | Method and Description | 
|---|---|
| void | addLineListener(LineListener listener)Adds a listener to this line. | 
| void | close()Closes the line, indicating that any system resources
 in use by the line can be released. | 
| Control | getControl(Control.Type control)Obtains a control of the specified type,
 if there is any. | 
| Control[] | getControls()Obtains the set of controls associated with this line. | 
| Line.Info | getLineInfo()Obtains the  Line.Infoobject describing this
 line. | 
| boolean | isControlSupported(Control.Type control)Indicates whether the line supports a control of the specified type. | 
| boolean | isOpen()Indicates whether the line is open, meaning that it has reserved
 system resources and is operational, although it might not currently be
 playing or capturing sound. | 
| void | open()Opens the line, indicating that it should acquire any required
 system resources and become operational. | 
| void | removeLineListener(LineListener listener)Removes the specified listener from this line's list of listeners. | 
Line.Info getLineInfo()
Line.Info object describing this
 line.void open() throws LineUnavailableException
OPEN event is dispatched
 to the line's listeners.
 
 Note that some lines, once closed, cannot be reopened.  Attempts
 to reopen such a line will always result in an LineUnavailableException.
 
 Some types of lines have configurable properties that may affect
 resource allocation.   For example, a DataLine must
 be opened with a particular format and buffer size.  Such lines
 should provide a mechanism for configuring these properties, such
 as an additional open method or methods which allow
 an application to specify the desired settings.
 
 This method takes no arguments, and opens the line with the current
 settings.  For SourceDataLineTargetDataLineClipopen methods
 provided in the Clip interface to load data into the Clip.
 
 For DataLine's, if the DataLine.Info
 object which was used to retrieve the line, specifies at least
 one fully qualified audio format, the last one will be used
 as the default format.
IllegalArgumentException - if this method is called on a Clip instance.LineUnavailableException - if the line cannot be
 opened due to resource restrictions.SecurityException - if the line cannot be
 opened due to security restrictions.close(), 
isOpen(), 
LineEvent, 
DataLine, 
Clip.open(AudioFormat, byte[], int, int), 
Clip.open(AudioInputStream)void close()
CLOSE event is dispatched
 to the line's listeners.close in interface AutoCloseableSecurityException - if the line cannot be
 closed due to security restrictions.open(), 
isOpen(), 
LineEventboolean isOpen()
Control[] getControls()
getControl(javax.sound.sampled.Control.Type)boolean isControlSupported(Control.Type control)
control - the type of the control for which support is queriedtrue if at least one control of the specified type is
 supported, otherwise false.Control getControl(Control.Type control)
control - the type of the requested controlIllegalArgumentException - if a control of the specified type
 is not supportedgetControls(), 
isControlSupported(Control.Type control)void addLineListener(LineListener listener)
update() method is called with a LineEvent object
 that describes the change.listener - the object to add as a listener to this lineremoveLineListener(javax.sound.sampled.LineListener), 
LineListener.update(javax.sound.sampled.LineEvent), 
LineEventvoid removeLineListener(LineListener listener)
listener - listener to removeaddLineListener(javax.sound.sampled.LineListener) Submit a bug or feature 
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
 Copyright © 1993, 2025, Oracle and/or its affiliates.  All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.