Product Documentation

dev2dev Home> Weblogic SIP Server 2.0.2 > Programmign SIP Servlets > Developing SIP Servlets Using Eclipse

Developing SIP Servlets Using Eclipse

The following sections describe how to use Eclipse to develop SIP Servlets for use with WebLogic SIP Server:

 

Overview

This document provides detailed instructions for using the Eclipse IDE as a tool for developing and deploying SIP Servlets with WebLogic SIP Server 2.0.2. The full development environment requires the following components, which you must obtain and install before proceeding:

SIP Servlet Organization

Building a SIP Servlet produces a Web Archive (WAR file or directory) as an end product. A basic SIP Servlet WAR file contains the subdirectories and contents described in Figure 1.

Figure 1 SIP Servlet WAR Contents

SIP Servlet WAR Contents


 

 

Setting Up the Development Environment

Follow these steps to set up the development environment for a new SIP Servlet project:

  1. Create a new WebLogic SIP Server Domain.
  2. Create a new Eclipse project.
  3. Create an Ant build file.

The sections that follow describe each step in detail.

Creating a WebLogic SIP Server Domain

In order to deploy and test your SIP Servlet, you need access to a WebLogic SIP Server domain that you can reconfigure and restart as necessary. Follow the instructions in Creating a New WebLogic SIP Server Domain to create a new domain using the Configuration Wizard. When generating a new domain:

Creating a New Eclipse Project

Follow these steps to create a new Eclipse project for your SIP Servlet development, adding the WebLogic SIP Server libraries required for building and deploying the application:

  1. Start Eclipse.
  2. Select File->New->Project...
  3. Select Java Project and click Next.
  4. Enter a name for your project in the Project Name field.
  5. In the Location field, select Create project in workspace if you have not yet begun writing the SIP Servlet code. If you already have source code available in another location, Select Create project at external location and specify the directory. Click Next.
  6. Click the Libraries tab and follow these steps to add required JARs to your project:
    1. Click Add External JARs...
    2. Use the JAR selection dialog to add the BEA_HOME/wlss202/server/lib/weblogic.jar file to your project.
    3. Click Add External JARs... once again.
    4. Use the JAR selection dialog to add the BEA_HOME/wlss202/telco/auxlib/sipservlet.jar file to your project.
  7. Add any additional JAR files that you may require for your project.
  8. Click Finish to create the new project. Eclipse displays your new project name in the Package Explorer.
  9. Right-click on the name of your project and use the New->Folder command to recreate the directory structure shown in Figure 1, SIP Servlet WAR Contents.

Creating an Ant Build File

Follow these steps to create an Ant build file that you can use for building and deploying your project:

  1. Right-click on the name of your project in Eclipse, and select New->File
  2. Enter the name build.xml and click Finish. Eclipse opens the empty file in a new window.
  3. Copy the sample text from Listing 1, substituting your domain name and application name for myDomain and myApplication.

Listing 10-1 Ant Build File Contents

<?xml version="1.0" encoding="ISO-8859-1"?>
<project default="all">
  <property environment="env"/>
  <property name="beahome" value="${env.BEA_HOME}"/>
  <target name="all" depends="compile,install"/>
  <target name="compile">
    <mkdir dir="WEB-INF/classes"/>
    <javac destdir="WEB-INF/classes" srcdir="src" debug="true" debuglevel="lines,vars,source">
      <classpath>
        <pathelement path="${weblogic.jar}"/>
      </classpath>
    </javac>
  </target>
  <target name="install">
    <jar destfile="${beahome}/user_projects/domains/myDomain/applications/myApplication.war">
      <zipfileset dir="WEB-INF" prefix="WEB-INF"/>
      <zipfileset dir="WEB-INF" includes="*.html"/>
      <zipfileset dir="WEB-INF" includes="*.jsp"/>
    </jar>
  </target>
</project>
  1. Close the build.xml file and save your changes.
  2. Verify that the build.xml file is valid by selecting Window->Show View->Ant and dragging the build.xml file into the Ant view. Correct any problems before proceeding.
  3. Right-click on the project name and select Properties.
  4. Select the Builders property in the left column, and click New.
  5. Select the Ant Build tool type and click OK to add an Ant builder.
  6. In the Buildfile field, click Browse Workspace and select the build.xml file you created.
  7. In the Base Directory field, click Browse Workspace and select the top-level directory for your project.
  8. Click the JRE tab and choose Separate JRE in the Runtime JRE field. Use the drop-down list or the Installed JREs... button to select an installed version 1.4.2 JRE.
  9. Click the Environment tab, and Click New. Enter a new name/value pair to define the BEA_HOME variable. The BEA_HOME variable must point to the home directory of the WebLogic SIP Server 2.0.2 directory. For example:
  10. Click OK to add the new Ant builder to the project.
  11. De-select Java Builder in the builder list to remove the Java builder from the project.
  12. Click OK to finish configuring Builders for the project.

 

Building and Deploying the Project

The build.xml file that you created compiles your code, packages the WAR, and copies the WAR file to the /applications subdirectory of your development domain. WebLogic SIP Server automatically deploys valid applications located in the /applications subdirectory.

 

Debugging SIP Servlets

In order to debug SIP Servlets, you must enable certain debug options when you start WebLogic SIP Server. Follow these steps to add the required debug options to the script used to start WebLogic SIP Server:

  1. Use a text editor to open the StartWebLogic.cmd script for your development domain.
  2. Beneath the line that reads:
    3. set JAVA_OPTIONS=

    Enter the following line:

    set DEBUG_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,address=9000,server=y,suspend=n
  3. Save the file and use the script to restart WebLogic SIP Server.