Reference Guide

Getting Started
 Using Resin with some IDEs

Reference Guide

Inprise JBuilder

Resin OpenTool

The Caucho projects section now has an OpenTool jar for Resin at resin-jbuilder.jar.

To install the tool, put the resin-jbuilder.jar in the JBuilder lib/ext directory, for example, c:\JBuilder6\lib\ext. Then you can change the server using the Project/Project Properties/Server table.

Older instructions

Kellan Elliott-McCrea writes:

This works w/ JBuilder 3.5, I assume it will work with 4. FYI: I've noticed a definite slow down when doing this.

  1. Go To Project Properties - required libraries
  2. Remove the JSWDK 1.0 stuff from the required libraries, you don't need it any more
  3. Click "Add..." then Click "New..."
  4. fill out a name for resin, I would naming it Resin 1.2.1 (or whatever version you are running)
  5. Click "Add..."
  6. Browse to your resin directory and add all the jar files under the lib directory
  7. Click "OK" to select then "OK" again
  8. Go to the "Run" tab in properties
  9. Click "Set"
  10. Find the class com.caucho.server.http.HttpServer
  11. Click "OK" to close set window and "OK" to accept properties

Allaire Kawa

Kevin Altis writes:

For those people wanting to do source-level debugging of servlets under Windows with Resin and the Kawa Pro 5.0 IDE from Allaire (this should work with the Enterprise Edition as well) I've adapted the example of using Kawa with Tomcat at Allaire.

Note that you can download Kawa and try it for free for 30 days if you are looking for a new IDE under Windows. It sure beats using jdb for debugging ;D

Select Project/New menu option and create a new project under doc\WEB-INF\classes directory of Resin. Please type the name for this project as HelloServlet. Kawa will create a new project and open it as the current project.

Select Project/Add File... and select file to add to the newly created project.

Since Kawa is not setup by default to work with Resin, add resin.jar, jsdk22.jar, jdk12.jar, jdbc2_0-stdext.jar, jta-spec1_0_1.jar, jndi.jar, dom.jar, sax.jar, jaxp.jar, and webutil.jar to the classpath by selecting Project/Classpath and click on File... button to add resin.jar, jsdk22.jar, jdk12.jar, jdbc2_0-stdext.jar, jta-spec1_0_1.jar, jndi.jar, dom.jar, sax.jar, jaxp.jar, and webutil.jar under the resin/lib directory to the classpath.

Set the Compilation output directory to doc\WEB-INF\classes by selecting Project/Compiler Options and click on the ">>" to add it. For example, if you have installed Resin in your D:\ drive, then check the "Compilation output directory" and add the value "D:\resin\doc\WEB-INF\classes"

Perform a rebuild all to compile all files in the project.

Select Project/Interpreter options to set the Java class name to run. Set the "Java class name to run" to com.caucho.server.http.HttpServer and check the box. This will force the class name to run Startup when you select Build/Run.

Select Project/Interpreter options to set the Working directory. Set the "Execute program in directory" to Resin install directory and check the box. For example, if you have installed Resin on your d:\ drive then set this option to "D:\resin". This will force the working directory to the Resin install directory when select Build/Run.

If you are interested in debugging the servlet, then go to Project/Compiler Options and check the "Debugging Tables (-g)" option. This will display local variables during debugging of the servlet.

Select Build/Run to start the Resin WebServer daemon. If all the settings were done correctly Kawa output window will display the following lines and the daemon is started successfully. [Note: in my case Resin is installed at c:\java\resin, I'm using Sun JDK 1.3 and I've turned off srun in my .conf file.]

Wait, Starting the Debugger...
Working Directory - C:\java\resin\
ClassPath -
Properties -   -Xbootclasspath:c:\jdk1.3\lib\tools.jar;c:\jdk1.3\jre\lib\rt.
Debug Start...
Resin 1.2.3 (built Thu Feb 15 11:31:58 PST 2001)
Copyright(c) 1998-2001 Caucho Technology. All rights reserved.

Starting Resin on Fri, 23 Feb 2001 22:14:06 -0800 (PST)
http listening to *:8080

Now start up a browser and bring up the servlet by typing "http://localhost:8080/servlet/HelloServlet" If all of the above steps were done correctly, the servlet will print "Hello, world!" on the page.

In order to start the debugger, set some breakpoints in file and press F5 to start the debugger. Once again go to a browser and open "http://localhost:8080/servlet/HelloServlet" At this time Kawa will hit the breakpoint and you can debug the servlet just like you would debug a non-servlet project. Please refer to debugger tutorial for more details on how to debug under Kawa.

I'm using Kawa Pro 5.0 under Windows 2000 with Resin 1.2.3 and the Sun JDK 1.3. isn't very interesting, but you should easily be able to adapt the above directions for your own servlet, just remember to set the paths correctly. Kawa can debug threads, but I haven't tried it yet with Resin.

Reference Guide
Copyright © 1998-2002 Caucho Technology, Inc. All rights reserved.
Resin® is a registered trademark, and HardCoretm and Quercustm are trademarks of Caucho Technology, Inc.