javax.microedition.io

Class IMCProtocolPermission

java.lang.Object

java.security.Permission

javax.microedition.io.GCFPermission

javax.microedition.io.IMCProtocolPermission

public class IMCProtocolPermission
extends javax.microedition.io.GCFPermission

This class represents access rights to connections via the "imc" protocol. A IMCProtocolPermission consists of a URI string but no actions list. For details of the URI syntax see IMCConnection and IMCServerConnection description.

See Also:

IMCConnection

Constructor Summary

Constructors

Constructor and Description
IMCProtocolPermission(java.lang.String uri) Creates a new IMCProtocolPermission with the specified URI as its name.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Checks two IMCProtocolPermission objects for equality.
java.lang.String	getActions() Returns the canonical string representation of the actions, which currently is the empty string "", since there are no actions defined for IMCProtocolPermission.
int	hashCode() Returns the hash code value for this object.
boolean	implies(java.security.Permission p) Checks if this IMCProtocolPermission object "implies" the specified permission.
java.security.PermissionCollection	newPermissionCollection() Returns a new PermissionCollection for storing IMCProtocolPermission objects.

Methods inherited from class javax.microedition.io.GCFPermission

getProtocol, getURI

Methods inherited from class java.security.Permission

getName, toString

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

IMCProtocolPermission

public IMCProtocolPermission(java.lang.String uri)

Creates a new IMCProtocolPermission with the specified URI as its name. The URI string must conform to the specification given in the IMCConnection or IMCServerConnection description, but it is allowed to replace and / or components by a wildcard ('*'). It is then normalized to facilitate subsequent comparisons.

Parameters:

uri - the URI string

Throws:

java.lang.NullPointerException - if uri is null

java.lang.IllegalArgumentException - if uri is malformed

Method Detail

equals

public boolean equals(java.lang.Object obj)

Checks two IMCProtocolPermission objects for equality.

Specified by:

equals in class java.security.Permission

Parameters:

obj - the object we are testing for equality with the current object

Returns:

true if obj is an IMCProtocolPermission and has the same URI string as this IMCProtocolPermission object.

getActions

public java.lang.String getActions()

Returns the canonical string representation of the actions, which currently is the empty string "", since there are no actions defined for IMCProtocolPermission.

Specified by:

getActions in class java.security.Permission

Returns:

canonical string representation of the actions, currently ""

hashCode

public int hashCode()

Returns the hash code value for this object.

Specified by:

hashCode in class java.security.Permission

Returns:

a hash code value for this object.

implies

public boolean implies(java.security.Permission p)

Checks if this IMCProtocolPermission object "implies" the specified permission.

Returns true iff:

• p's class is the same as this Object's class, and
• p's name (URI) equals this Object's name (URI) for all URI components not being "*" in the Object's name (URI)

For example:

• "imc://ExampleIMCAppUID:ExampleIMCApps:1.5:example.Server:1.0;" implies only "imc://ExampleIMCAppUID:ExampleIMCApps:1.5:example.Server:1.0;"
• "imc://*:com.foo.services.barServer:1.0" implies "imc://ExampleIMCAppUID:ExampleIMCApps:1.5:com.foo.services.barServer:1.0;"
• "imc://*:*:*" implies "imc://ExampleIMCAppUID:ExampleIMCApps:1.5:com.foo.services.barServer:1.0;"
• "imc://*:ExampleIMCApps:1.5:com.foo.services.barServer:*" implies "imc://*:ExampleIMCApps:1.5:com.foo.services.barServer:1.0;"

Specified by:

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 if not

newPermissionCollection

public java.security.PermissionCollection newPermissionCollection()

Returns a new PermissionCollection for storing IMCProtocolPermission objects.

IMCProtocolPermission objects must be stored in a manner that allows them to be inserted into the collection in any order, but that also enables the PermissionCollection implies method to be implemented in an efficient (and consistent) manner.

If null is returned, then the caller of this method is free to store permissions of this type in any PermissionCollection he chooses (one that uses a Hashtable, one that uses a Vector, etc).

Overrides:

newPermissionCollection in class java.security.Permission

Returns:

a new PermissionCollection suitable for storing IMCProtocolPermission objects, or null if none is defined.