javax.microedition.sip
Class SipProtocolPermission

java.lang.Object
  extended by GCFPermission
      extended by 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:user@172.21.38.219:5070.

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

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

where:

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:

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

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


Copyright © 2007 Nokia Corporation. All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.