Download & Instalation
The ItsNat Distribution includes binaries, source code, javadoc, manual and the
ItsNat Feature Showcase demo.
Current version is 1.2 (all releases)
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:
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
this archive contains all is needed to deploy and run the Feature Showcase in any Servlet container.
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)
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
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.
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
WEB-INF/lib to your project, add manually if needed.
- In Maven you can add the following to <dependencies> (ItsNat v1.2):
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
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.