Java TV(tm) API 1.0

javax.tv.media
Class MediaSelectPermission

java.lang.Object
  |
  +--java.security.Permission
        |
        +--javax.tv.media.MediaSelectPermission
All Implemented Interfaces:
java.security.Guard, java.io.Serializable

public final class MediaSelectPermission
extends java.security.Permission
implements java.io.Serializable

This class represents permission to select, via a MediaSelectControl, the content that a JMF Player presents. A caller might have permission to select content referenced by some locators, but not others.

See Also:
Serialized Form

Constructor Summary
MediaSelectPermission(Locator locator)
          Creates a new MediaSelectPermission object for the specified Locator.
MediaSelectPermission(java.lang.String locator, java.lang.String actions)
          Creates a new MediaSelectPermission object for a Locator with the given external form.
 
Method Summary
 boolean equals(java.lang.Object other)
          Tests two MediaSelectPermission objects for equality.
 java.lang.String getActions()
          Reports the canonical string representation of the actions.
 int hashCode()
          Returns the hash code value for this object.
 boolean implies(java.security.Permission p)
          Checks if this MediaSelectPermission "implies" the specified Permission.
 
Methods inherited from class java.security.Permission
checkGuard, getName, newPermissionCollection, toString
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

MediaSelectPermission

public MediaSelectPermission(Locator locator)
Creates a new MediaSelectPermission object for the specified Locator.
Parameters:
locator - The locator for which to create the permission. A value of null indicates permission for all locators.

MediaSelectPermission

public MediaSelectPermission(java.lang.String locator,
                             java.lang.String actions)
Creates a new MediaSelectPermission object for a Locator with the given external form. The actions string is currently unused and should be null. This constructor is used by the Policy class to instantiate new Permission objects.
Parameters:
locator - The external form of the locator. The string "*" indicates all locators.
actions - Should be null.
Method Detail

implies

public boolean implies(java.security.Permission p)
Checks if this MediaSelectPermission "implies" the specified Permission.

More specifically, this method returns true if:

Overrides:
implies in class java.security.Permission
Parameters:
p - The Permission to check against.
Returns:
true if the specified Permission is implied by this object; false otherwise.

equals

public boolean equals(java.lang.Object other)
Tests two MediaSelectPermission objects for equality. This method tests that other is of type MediaSelectPermission, and has the same Locator as this object.
Overrides:
equals in class java.security.Permission
Parameters:
other - The object to test for equality.
Returns:
true if other is a MediaSelectPermission, and has the same Locator as this MediaSelectPermission.

hashCode

public int hashCode()
Returns the hash code value for this object.
Overrides:
hashCode in class java.security.Permission
Returns:
The hash code value for this object.

getActions

public java.lang.String getActions()
Reports the canonical string representation of the actions. This is currently the empty string "", since there are no actions for a MediaSelectPermission.
Overrides:
getActions in class java.security.Permission
Returns:
The empty string "".

Java TV(tm) API 1.0

Copyright © 1998 - 2000 Sun Microsystems, Inc.