The Sun JavaTM Wireless Toolkit for CLDC supports the SIP API for J2ME (JSR 180) with a
proxy server, registrar, and network monitor support.
Session Initiation Protocol (SIP) is defined by RFC 3261, available at
http://www.ietf.org/rfc/rfc3261.txt.
SIP provides a standard way for applications to set up communications. The application determines
what communication actually takes place. SIP can be used to set up instant messaging, text chat,
voice chat, video conferencing, or other types of sessions.
Display name and Address fields set the system properties sip.display.name and
sip.address, respectively. Applications can use these system properties as a standard way to
retrieve the identity associated with the device.
To stop the server, click Stop. To start the server, click Start.
While the server is running, the top left pane shows all users known to the registrar. Click a user
name to see details about the user in the top right pane. The bottom pane of the window is a console
that shows SIP messages that are received and sent by the proxy.
You can adjust the server options when the server is not running. Stop the server and click Options
to see the options window (see FIGURE 15-4).
FIGURE 15-4 Setting Proxy Options
On the Proxy tab, you can set the IP address and ports upon which the server listens for incoming
messages. Note that 5060, the default listening point, is a well known port for the SIP proxy. If you
are working in a multiuser environment there is a chance another user may be using the port and
you might accidentally connect to someone else's SIP server instance(the SIP server does not have
any authentication mechanism and TCP/IP ports are freely accessible). If this happens you must
specify another port.
Click Add to specify more ports and their types. Select a port and click Remove to remove a
listening port.
Check Use Authentication to force connecting clients to authenticate themselves to the server. The
scheme used is digest authentication, which is described in section 22.4 of RFC 3261. SIP's digest
authentication is nearly identical to HTTP digest authentication.
On the Registrar tab, you can set up the users and domains known to the registrar. The top list
contains SIP users that are automatically registered when the SIP server is started. You can add a
new user, edit an existing user, or remove a user.
In addition, you can adjust the list of domains managed by this registrar. Press Add to add a domain,
Edit to edit an existing domain name, or Remove to remove a domain.
FIGURE 15-5 Setting Registrar Options