Class Line.Info

java.lang.Object
javax.sound.sampled.Line.Info
Direct Known Subclasses:
DataLine.Info, Port.Info
Enclosing interface:
Line
public static class Line.Info extends Object
A Line.Info object contains information about a line. The only information provided by Line.Info itself is the Java class of the line. A subclass of Line.Info adds other kinds of information about the line. This additional information depends on which Line subinterface is implemented by the kind of line that the Line.Info subclass describes.

A Line.Info can be retrieved using various methods of the Line, Mixer, and AudioSystem interfaces. Other such methods let you pass a Line.Info as an argument, to learn whether lines matching the specified configuration are available and to obtain them.

Since:
1.3
See Also:

  • Constructor Summary

    Constructors
    Constructor
    Description
    Info(Class<?> lineClass)
    Constructs an info object that describes a line of the specified class.

  • Method Summary

    Modifier and Type
    Method
    Description
    Class<?>
    getLineClass()
    Obtains the class of the line that this Line.Info object describes.
    boolean
    matches(Line.Info info)
    Indicates whether the specified info object matches this one.
    String
    toString()
    Returns a string representation of the info object.

    Methods declared in class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    clone()
    Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
    boolean
    equals(Object o)
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    getClass()
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    int
    hashCode()
    Answers an integer hash code for the receiver.
    final void
    notify()
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    notifyAll()
    Causes all threads which are waiting on the receiver to be made ready to run.
    final void
    wait()
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

  • Constructor Details

    • Info

      public Info(Class<?> lineClass)
      Constructs an info object that describes a line of the specified class. This constructor is typically used by an application to describe a desired line.
      Parameters:
      lineClass - the class of the line that the new Line.Info object describes

  • Method Details

    • getLineClass

      public Class<?> getLineClass()
      Obtains the class of the line that this Line.Info object describes.
      Returns:
      the described line's class

    • matches

      public boolean matches(Line.Info info)
      Indicates whether the specified info object matches this one. To match, the specified object must be identical to or a special case of this one. The specified info object must be either an instance of the same class as this one, or an instance of a sub-type of this one. In addition, the attributes of the specified object must be compatible with the capabilities of this one. Specifically, the routing configuration for the specified info object must be compatible with that of this one. Subclasses may add other criteria to determine whether the two objects match.
      Parameters:
      info - the info object which is being compared to this one
      Returns:
      true if the specified object matches this one, false otherwise

    • toString

      public String toString()
      Returns a string representation of the info object.
      Overrides:
      toString in class Object
      Returns:
      a string representation of the info object