Download

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

DOWNLOAD

Current version is 1.2   (all releases)

Overview of New Features

Release Notes    (Old Release Notes, versions <= 1.0)

Browse Source Code at GitHub

How to Install and Run the Feature Showcase

Decompress the ItsNat distribution .zip file. ItsNat distribution is a Netbeans 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 with NetBeans:

• 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. To ensure Tomcat is executed by JVM 1.4 select the Tomcat 5.5 entry in Services/Servers, right click, select “Properties”, tab "Platform" and select "JDK 1.4" as the Java Platform.

ItsNat has its own templating system so JSP files are not needed, anyway if you are developing with NetBeans an ItsNat based web application based on JDK 1.4 and including some JSP files, DO NOT use NetBeans 6.9, this release does not correctly work with JSP files and JDK 1.4 (JSP compilation fails), use NetBeans v6.8 or lower or JDK 1.5 or upper.

To quickest way to execute (run or debug) the "Feature Showcase" example with NetBeans, is through the file run.html 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 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 (the distribution includes a file ItsNat.jar with binaries only), but is very useful to understand how ItsNat exactly works. The source code directory of provided examples is located below WEB-INF, again this is not a usual position too, this source code is part of the web application because is showed online 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 and upper.

Execute the Feature Showcase outside NetBeans

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.

Framework Files

The fw_dist/lib contains the ItsNat.jar file containing ItsNat binaries and external required jar files:

• batik-dom.jar, batik-util.jar, batik-xml.jar: Batik DOM jars (SVG not included)
• nekohtml.jar: NekoHTML parser
• xercesImpl.jar: Xerces framework
• serializer.jar: standard Apache XML serialization included in Xerces distribution
• xml-apis.jar: Java standard and W3C XML/DOM APIS (included in Xerces)

The file fw_dist/ItsNat_src.zip contains the framework source code.

fw_dist/batik_applet contains binaries and source code of the ItsNat Batik applet, a derivative of the Batik applet included in Batik distribution, to run SVG documents in ItsNat applications.

fw_dist/gae contains binaries and source code of the minimal modifications to batik-dom.jar required to execute ItsNat in Google App Engine. The folder gae contains scripts to upload the Feature Showcase to GAE (some minor modifications are required).

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 libraries included in fw_dist/lib folder, check if your IDE has added the libraries in WEB-INF/lib to your project, add manually if needed.
• In Maven you can add the following to <dependencies> (ItsNat v1.2):

          <dependency>
              <groupId>ItsNat</groupId>
              <artifactId>ItsNat-jar</artifactId>
              <version>1.2</version>
              <scope>system</scope>
              <systemPath>${basedir}/src/main/webapp/WEB-INF/lib/ItsNat.jar</systemPath>
          </dependency>
  
          <dependency>
              <groupId>org.apache.xmlgraphics</groupId>
              <artifactId>batik-dom</artifactId>
              <version>1.7</version>
          </dependency>
  
          <dependency>
              <groupId>org.apache.xmlgraphics</groupId>
              <artifactId>batik-xml</artifactId>
              <version>1.7</version>
          </dependency>
  
          <dependency>
              <groupId>org.apache.xmlgraphics</groupId>
              <artifactId>batik-util</artifactId>
              <version>1.7</version>
          </dependency>
  
          <dependency>
              <groupId>net.sourceforge.nekohtml</groupId>
              <artifactId>nekohtml</artifactId>
              <version>1.9.12</version>
          </dependency>
  
          <dependency>
              <groupId>xalan</groupId>
              <artifactId>serializer</artifactId>
              <version>2.7.1</version>
          </dependency>
  
      

  This pom.xml is an example of a Java EE 5 project configuration (ItsNat v1.2)

  Another option is to install ItsNat.jar into your local Maven repository.

  Note: thanks Ravindranath Akila and Dileep Hareendran for Maven tips

• In Google App Engine use fw_dist/gae/lib/batik-dom-gae.jar instead of batik-dom.jar.

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

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

How to configure ItsNat with Spring

The following example is a web application configured with Spring, most of the code is generic and can be reused in any ItsNat project.

Slides "How to configure with Spring an api not based on Spring" about this example in support section.