javax.microedition.xlet.ixc
Class IxcPermission

This class represents access to the inter-xlet communication registry.
An IxcPermission consists of a name specification and a set
of actions specifying what can be done with those names.

The name specification is the name passed into the IxcRegistry
methods such as bind() and lookup(). The names are simple strings; this
specification does not impose any special meaning on these strings,
such as name canonicalization.
Limited wildcarding is
allowed at the end of a name string. The name string of length one
"*" will match any name. At the end of a string, the special sequence
"/*" will match forward-slash followed by any other characters. Otherwise,
all characters are simply matched. For example:

"*" as the entire name string will match any other string

"xlet:/1a/2b/*" ends in a wildcard, and will match
any string that begins with "xlet:/1a/2b/", e.g.
"xlet:/1a/2b/foo", "xlet:/1a/2b/3c/foo" or
"xlet:/1a/2b/". It will not match "xlet://1a/2b/"
or "xlet:/1a/2b".

"*foo" does not contain a wildcard, and will only match
the string "*foo".

"foo*" does not contain a wildcard, and will only match
the string "foo*".

"a*b" does not contain a wildcard, and will only match
the string "a*b"

"/a/*/b" does not contain a wildcard, and will only match
the string "/a/*/b"

The actions to be granted are passed to the constructor in a string
containing a list of one or more comma-seperated keywords. The
possible keywords are "bind" and "lookup". See the methods
on IxcRegistry for a detailed explanation of the meaning of these.

IxcPermission

Creates a new IxcPermission object with the specified name and actions.
The name specification is the name passed into the IxcRegistry
methods such as bind() and lookup(). See the class description
for the specification of the name string.

The actions to be granted are passed to the constructor in a string
containing a list of one or more comma-seperated keywords. The
possible keywords are "bind" and "lookup". See the methods
on IxcRegistry for a detailed explanation of the meaning of these.

hashCode

getActions

Returns the "canonical string representation" of the actions.
That is, this method always returns present actions in the
following order: bind, lookup.
For example, if this IxcPermission object allows both bind and
lookup actions, a call to getActions will return the string
"bind,lookup".

newPermissionCollection

Returns a new PermissionCollection object for storing
IxcPermission objects.

IxcPermission 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.

For example, if you have two IxcPermission objects:
"/1234/*", "lookup"
"/1234/5678/*", "bind"
and you are calling the implies method with the
IxcPermission: "/1234/5678/foo",
"bind,lookup",
then the implies method must take into account both the
"/1234/*" and "/1234/5678/*" permissions, so the effective permission
is "bind,lookup" and implies returns true. The
"implies" semantics for IxcPermissions are handled properly by the
permission collection object returned by this
newPermissionCollection method.

A script enabled browser is required for this page to function properly.A script enabled browser is required for this page to function properly.A script enabled browser is required for this page to function properly.A script enabled browser is required for this page to function properly.A script enabled browser is required for this page to function properly.