javax.microedition.sip
Class SipProtocolPermission

java.lang.Object
  GCFPermission
      javax.microedition.sip.SipProtocolPermission

public final class SipProtocolPermission
extends GCFPermission

This class represents access rights to connections via the sip protocol. SipProtocolPermission consists of a URI string but no actions list. The URI string specifies a connection target and used protocol e.g. sip:[email protected]:5070.

The URI is specified in RFC3261 [1] and here it takes general form of:

{scheme}:[{target}][{params}]

where:

• scheme is SIP scheme supported by the system sip or sips
• target is user network address in form of [{user_name}@]{target_host}[:{port}] or {telephone_number}
• params stands for additional SIP URI parameters like ;transport=udp

The SIP URI may contain quote characters. The application can use either the quote character or it's escaped version (%22), the API implementation must support both forms.

See Also:

in MIDP 3.0 Specification

Constructor Summary

SipProtocolPermission(java.lang.String uri)
Creates a new SipProtocolPermission instance with the specified URI as its name.

Method Summary

boolean	equals(java.lang.Object object) Checks two Permission objects for equality
java.lang.String	getActions() Returns the actions as a String.
java.lang.String	getProtocol() Returns the protocol scheme of this SipProtocolPermission
java.lang.String	getURI() Returns the URI of this SipProtocolPermission
int	hashCode() Returns the hash code value for this Permission object
boolean	implies(java.security.Permission p) Checks if this SipProtocolPermission object implies the specified permission.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SipProtocolPermission

public SipProtocolPermission(java.lang.String uri)

Creates a new SipProtocolPermission instance with the specified URI as its name.

Parameters:

uri - the URI string.

Throws:

java.lang.IllegalArgumentException - if the uri is malformed

java.lang.NullPointerException - if uri is null

See Also:

Permission.getName()

Method Detail

getProtocol

public java.lang.String getProtocol()

Returns the protocol scheme of this SipProtocolPermission

See Also:

java.security.GCFPermission

getURI

public java.lang.String getURI()

Returns the URI of this SipProtocolPermission

See Also:

java.security.GCFPermission

implies

public boolean implies(java.security.Permission p)

Checks if this SipProtocolPermission object implies the specified permission.

Method returns true if:

• p is an instance of SipProtocolPermission and
• p's URI equals this object's URI (Refer to the RFC3261 [1] section 25 how the URIs are constructed.)

are true and if one or more of following condition is met:

• If this object has a IP address and p's IP address is equal to this object's IP address.
• If this object has a wildcard domain (such as *.amazon.com), and p's absolute name (the name with any preceding * removed) ends with this object's absolute name. For example, *.amazon.com implies *.uk.amazon.com.
• If this object's name equals p's name.

Parameters:

p - the permission to check against.

Returns:

true if the specified permission is implied by this object, false if not.

equals

public boolean equals(java.lang.Object object)

Checks two Permission objects for equality

Returns:

true if obj is a HttpsProtocolPermission and has the same URI string as this SipProtocolPermission object.

See Also:

Permission

getActions

public java.lang.String getActions()

Returns the actions as a String. Since the SipProtocolPermission does not have actions, method will always return empty string.

Returns:

the empty string

See Also:

Permission

hashCode

public int hashCode()

Returns the hash code value for this Permission object

Returns:

a hash code value for this object

See Also:

Permission