Download

The ItsNat Distribution includes binaries, source code, javadoc, manuals and the ItsNat Feature Showcase demo.

Download Here

Current version is 0.6   (all releases)

Overview of new features

Release Notes

How to Install and Run

Decompress the ItsNat distribution .zip file. ItsNat distribution is a Netbeans 6.5 web project, this web application is the Feature Showcase, an ItsNat based web application with source code showing the ItsNat main features and components.

The Feature Showcase is a JVM 1.4 web application and contains the framework in source code form for debugging. To run the Feature Showcase in a pure JVM 1.4 environment:

• Install the last JDK 1.4. Select the project in NetBeans, right button, Properties option, Categories: Libraries, "Manage Platforms…", follow the instructions to add the new JDK to NetBeans, then select this JDK as the default Java platform of the project (in Java Platform combo).
• Download and install Tomcat 5.5 (install the JVM 1.4 compatibility pack too), select Services/Servers, button right, select "Add Server …", follow the instructions (is recommended JVM 1.4 to run Tomcat 5.5 if you want a pure JVM 1.4 project).

To execute the Feature Showcase, start the web application (run or debug) with the file index.jsp as shown in the figure:

Or start the application server and load the main page with this URL:

http://localhost:8080/itsnat

This web application is very useful to show how a complex ItsNat application can be developed. Is ready to debug the ItsNat source code too because the framework is included in the web application in source code form (fw_src directory). This is not the recommended way in production of course, but is very useful to understand how ItsNat works exactly. The source code directory of provided examples is located below WEB-INF, of course this is not a usual position too, this source code is distributed alongside the web application because is showed on line to the user.

JVM 1.4 is not mandatory for web applications based on ItsNat, in fact the framework itself can be compiled with JDK 1.5 (-source 1.4 and –target 1.4 are necessary flags).

Framework Files

The fw_dist/lib contains the ItsNat.jar file containing the binaries and a separated jar containing the source code. The js subdirectory contains four JavaScript files used by the framework.

How to redeploy the Feature Showcase

If you want to execute the “Feature Showcase” example as a “production ready” Java web application outside NetBeans, pick the itsnat.war archive inside the dist directory, this archive contains all is needed to deploy and run the Feature Showcase in any Servlet container.

What does a new ItsNat based web application need?

Of course a Java web application developed using ItsNat does not need the ItsNat source code. The fw_dist/lib/ItsNat.jar contains Java binaries only. Any ItsNat based Java web application needs in the standard WEB-INF/lib directory the following libraries/files, these files are located in fw_dist/lib directory:

• ItsNat.jar: the framework in bytecode form
• nekohtml.jar: NekoHTML parser
• serializer.jar: standard Apache XML serialization
• xercesImpl.jar: Xerces framework
• xml-apis.jar: Java standard and W3C XML/DOM APIS

And the following JavaScript files:

itsnat.js, itsnat_ajax.js, itsnat_msie.js, itsnat_w3c.js, itsnat_msie_pocket.js

They all are located in the fw_dist/js folder and must be put in a public directory of the new web application, usually the js directory. These files can be added manually to HTML pages or delegate to ItsNat, in the latter case, ItsNat will be informed about the location of the JavaScript standard files, default directory is "js" (for instance /web/js in a NetBeans project).

To create a very simple ItsNat AJAX application read the tutorial A Simple ItsNat (Core) Application.

In the same page the Reference Manual and JavaDoc give you a deep knowledge about the framework.