< prev index next >

src/java.desktop/share/classes/javax/sound/sampled/AudioPermission.java

Print this page




  29 
  30 /**
  31  * The {@code AudioPermission} class represents access rights to the audio
  32  * system resources. An {@code AudioPermission} contains a target name but no
  33  * actions list; you either have the named permission or you don't.
  34  * <p>
  35  * The target name is the name of the audio permission (see the table below).
  36  * The names follow the hierarchical property-naming convention. Also, an
  37  * asterisk can be used to represent all the audio permissions.
  38  * <p>
  39  * The following table lists the possible {@code AudioPermission} target names.
  40  * For each name, the table provides a description of exactly what that
  41  * permission allows, as well as a discussion of the risks of granting code the
  42  * permission.
  43  *
  44  * <table class="striped">
  45  * <caption>Permission target name, what the permission allows, and associated
  46  * risks</caption>
  47  * <thead>
  48  *   <tr>
  49  *     <th>Permission Target Name
  50  *     <th>What the Permission Allows
  51  *     <th>Risks of Allowing this Permission
  52  * </thead>
  53  * <tbody>
  54  *   <tr>
  55  *     <td>play
  56  *     <td>Audio playback through the audio device or devices on the system.
  57  *     Allows the application to obtain and manipulate lines and mixers for
  58  *     audio playback (rendering).
  59  *     <td>In some cases use of this permission may affect other
  60  *     applications because the audio from one line may be mixed with other
  61  *     audio being played on the system, or because manipulation of a mixer
  62  *     affects the audio for all lines using that mixer.
  63  *   <tr>
  64  *     <td>record
  65  *     <td>Audio recording through the audio device or devices on the system.
  66  *     Allows the application to obtain and manipulate lines and mixers for
  67  *     audio recording (capture).
  68  *     <td>In some cases use of this permission may affect other applications
  69  *     because manipulation of a mixer affects the audio for all lines using
  70  *     that mixer. This permission can enable an applet or application to
  71  *     eavesdrop on a user.
  72  * </tbody>
  73  * </table>
  74  *
  75  * @author Kara Kytle
  76  * @since 1.3
  77  */
  78 public class AudioPermission extends BasicPermission {
  79 
  80     /**
  81      * Use serialVersionUID from JDK 1.3 for interoperability.
  82      */
  83     private static final long serialVersionUID = -5518053473477801126L;
  84 




  29 
  30 /**
  31  * The {@code AudioPermission} class represents access rights to the audio
  32  * system resources. An {@code AudioPermission} contains a target name but no
  33  * actions list; you either have the named permission or you don't.
  34  * <p>
  35  * The target name is the name of the audio permission (see the table below).
  36  * The names follow the hierarchical property-naming convention. Also, an
  37  * asterisk can be used to represent all the audio permissions.
  38  * <p>
  39  * The following table lists the possible {@code AudioPermission} target names.
  40  * For each name, the table provides a description of exactly what that
  41  * permission allows, as well as a discussion of the risks of granting code the
  42  * permission.
  43  *
  44  * <table class="striped">
  45  * <caption>Permission target name, what the permission allows, and associated
  46  * risks</caption>
  47  * <thead>
  48  *   <tr>
  49  *     <th scope="col">Permission Target Name
  50  *     <th scope="col">What the Permission Allows
  51  *     <th scope="col">Risks of Allowing this Permission
  52  * </thead>
  53  * <tbody>
  54  *   <tr>
  55  *     <th scope="row">play
  56  *     <td>Audio playback through the audio device or devices on the system.
  57  *     Allows the application to obtain and manipulate lines and mixers for
  58  *     audio playback (rendering).
  59  *     <td>In some cases use of this permission may affect other
  60  *     applications because the audio from one line may be mixed with other
  61  *     audio being played on the system, or because manipulation of a mixer
  62  *     affects the audio for all lines using that mixer.
  63  *   <tr>
  64  *     <th scope="row">record
  65  *     <td>Audio recording through the audio device or devices on the system.
  66  *     Allows the application to obtain and manipulate lines and mixers for
  67  *     audio recording (capture).
  68  *     <td>In some cases use of this permission may affect other applications
  69  *     because manipulation of a mixer affects the audio for all lines using
  70  *     that mixer. This permission can enable an applet or application to
  71  *     eavesdrop on a user.
  72  * </tbody>
  73  * </table>
  74  *
  75  * @author Kara Kytle
  76  * @since 1.3
  77  */
  78 public class AudioPermission extends BasicPermission {
  79 
  80     /**
  81      * Use serialVersionUID from JDK 1.3 for interoperability.
  82      */
  83     private static final long serialVersionUID = -5518053473477801126L;
  84 


< prev index next >