javax.sound.sampled
Class AudioPermission

java.lang.Object sample code for java.lang.Object definition code for java.lang.Object 
  extended by java.security.Permission sample code for java.security.Permission definition code for java.security.Permission 
      extended by java.security.BasicPermission sample code for java.security.BasicPermission definition code for java.security.BasicPermission 
          extended by javax.sound.sampled.AudioPermission
All Implemented Interfaces:
Serializable sample code for java.io.Serializable definition code for java.io.Serializable , Guard sample code for java.security.Guard definition code for java.security.Guard

public class AudioPermission
extends BasicPermission sample code for java.security.BasicPermission definition code for java.security.BasicPermission

The AudioPermission class represents access rights to the audio system resources. An AudioPermission contains a target name but no actions list; you either have the named permission or you don't.

The target name is the name of the audio permission (see the table below). The names follow the hierarchical property-naming convention. Also, an asterisk can be used to represent all the audio permissions.

The following table lists the possible AudioPermission target names. For each name, the table provides a description of exactly what that permission allows, as well as a discussion of the risks of granting code the permission.

Permission Target Name What the Permission Allows Risks of Allowing this Permission
play Audio playback through the audio device or devices on the system. Allows the application to obtain and manipulate lines and mixers for audio playback (rendering). In some cases use of this permission may affect other applications because the audio from one line may be mixed with other audio being played on the system, or because manipulation of a mixer affects the audio for all lines using that mixer.
record Audio recording through the audio device or devices on the system. Allows the application to obtain and manipulate lines and mixers for audio recording (capture). In some cases use of this permission may affect other applications because manipulation of a mixer affects the audio for all lines using that mixer. This permission can enable an applet or application to eavesdrop on a user.

Since:
1.3
See Also:
Serialized Form

Constructor Summary
AudioPermission sample code for javax.sound.sampled.AudioPermission.AudioPermission(java.lang.String) definition code for javax.sound.sampled.AudioPermission.AudioPermission(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  name)
          Creates a new AudioPermission object that has the specified symbolic name, such as "play" or "record".
AudioPermission sample code for javax.sound.sampled.AudioPermission.AudioPermission(java.lang.String, java.lang.String) definition code for javax.sound.sampled.AudioPermission.AudioPermission(java.lang.String, java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  name, String sample code for java.lang.String definition code for java.lang.String  actions)
          Creates a new AudioPermission object that has the specified symbolic name, such as "play" or "record".
 
Method Summary
 
Methods inherited from class java.security.BasicPermission sample code for java.security.BasicPermission definition code for java.security.BasicPermission
equals sample code for java.security.BasicPermission.equals(java.lang.Object) definition code for java.security.BasicPermission.equals(java.lang.Object) , getActions sample code for java.security.BasicPermission.getActions() definition code for java.security.BasicPermission.getActions() , hashCode sample code for java.security.BasicPermission.hashCode() definition code for java.security.BasicPermission.hashCode() , implies sample code for java.security.BasicPermission.implies(java.security.Permission) definition code for java.security.BasicPermission.implies(java.security.Permission) , newPermissionCollection sample code for java.security.BasicPermission.newPermissionCollection() definition code for java.security.BasicPermission.newPermissionCollection()
 
Methods inherited from class java.security.Permission sample code for java.security.Permission definition code for java.security.Permission
checkGuard sample code for java.security.Permission.checkGuard(java.lang.Object) definition code for java.security.Permission.checkGuard(java.lang.Object) , getName sample code for java.security.Permission.getName() definition code for java.security.Permission.getName() , toString sample code for java.security.Permission.toString() definition code for java.security.Permission.toString()
 
Methods inherited from class java.lang.Object sample code for java.lang.Object definition code for java.lang.Object
clone sample code for java.lang.Object.clone() definition code for java.lang.Object.clone() , finalize sample code for java.lang.Object.finalize() definition code for java.lang.Object.finalize() , getClass sample code for java.lang.Object.getClass() definition code for java.lang.Object.getClass() , notify sample code for java.lang.Object.notify() definition code for java.lang.Object.notify() , notifyAll sample code for java.lang.Object.notifyAll() definition code for java.lang.Object.notifyAll() , wait sample code for java.lang.Object.wait() definition code for java.lang.Object.wait() , wait sample code for java.lang.Object.wait(long) definition code for java.lang.Object.wait(long) , wait sample code for java.lang.Object.wait(long, int) definition code for java.lang.Object.wait(long, int)
 

Constructor Detail

AudioPermission sample code for javax.sound.sampled.AudioPermission(java.lang.String) definition code for javax.sound.sampled.AudioPermission(java.lang.String)

public AudioPermission(String sample code for java.lang.String definition code for java.lang.String  name)
Creates a new AudioPermission object that has the specified symbolic name, such as "play" or "record". An asterisk can be used to indicate all audio permissions.

Parameters:
name - the name of the new AudioPermission
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if name is empty

AudioPermission sample code for javax.sound.sampled.AudioPermission(java.lang.String, java.lang.String) definition code for javax.sound.sampled.AudioPermission(java.lang.String, java.lang.String)

public AudioPermission(String sample code for java.lang.String definition code for java.lang.String  name,
                       String sample code for java.lang.String definition code for java.lang.String  actions)
Creates a new AudioPermission object that has the specified symbolic name, such as "play" or "record". The actions parameter is currently unused and should be null.

Parameters:
name - the name of the new AudioPermission
actions - (unused; should be null)
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if name is empty