The Java Community Process(SM) Program - communityprocess

Use of JCP site is subject to the JCP Terms of Use and the Oracle Privacy Policy

SipProtocolPermission (API Reference)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.microedition.sip
Class SipProtocolPermission

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

public final class SipProtocolPermission
extends GCFPermission
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:

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