Home Overview Demos/Webs News Download/Install Docs/Support Investors/Partners Commercial
Download & Installation
Download
How to Install and Run the Feature Showcase
Execute the Feature Showcase outside NetBeans
Framework Files
What does a new ItsNat based web application need?
How to configure ItsNat with Spring

spiral Download


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

DOWNLOAD


Current version is 1.3.1   (all releases)


Overview of New Features


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


Browse Source Code at GitHub


spiral 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.5 web application and contains the ItsNat framework in source code form for debugging. Running in NetBeans is out of the box, it just needs a JVM 1.5 compatible servlet engine, furthermore ItsNat has its own templating system and no JSP engine is needed.

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:

Run From NetBeans

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.


spiral 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.


spiral 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).


spiral 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.3.1):
            <dependency>
                <groupId>ItsNat</groupId>
                <artifactId>ItsNat-jar</artifactId>
                <version>1.3.1</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.3.1)

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

    Note: thanks Dileep Hareendran for this Maven example

  • Another approach with Maven with finer grain control of JARs (ItsNat v1.3.1):
            <dependency>
                <groupId>ItsNat</groupId>
                <artifactId>ItsNat</artifactId>
                <version>1.3.1</version>
                <scope>system</scope>
                <systemPath>${basedir}/src/main/webapp/WEB-INF/lib/ItsNat.jar</systemPath>
            </dependency>
            <dependency>
                <groupId>ItsNat</groupId>
                <artifactId>nekohtml</artifactId>
                <version>1.3.1</version>
                <scope>system</scope>
                <systemPath>${basedir}/src/main/webapp/WEB-INF/lib/nekohtml.jar</systemPath>
            </dependency>
            <dependency>
                <groupId>ItsNat</groupId>
                <artifactId>serializer</artifactId>
                <version>1.3.1</version>
                <scope>system</scope>
                <systemPath>${basedir}/src/main/webapp/WEB-INF/lib/serializer.jar</systemPath>
            </dependency>
            <dependency>
                <groupId>ItsNat</groupId>
                <artifactId>xercesImpl</artifactId>
                <version>1.3.1</version>
                <scope>system</scope>
                <systemPath>${basedir}/src/main/webapp/WEB-INF/lib/xercesImpl.jar</systemPath>
            </dependency>
            <dependency>
                <groupId>ItsNat</groupId>
                <artifactId>xml-apis</artifactId>
                <version>1.3.1</version>
                <scope>system</scope>
                <systemPath>${basedir}/src/main/webapp/WEB-INF/lib/xml-apis.jar</systemPath>
            </dependency>
            <dependency>
                <groupId>ItsNat</groupId>
                <artifactId>batik-dom</artifactId>
                <version>1.3.1</version>
                <scope>system</scope>
                <systemPath>${basedir}/src/main/webapp/WEB-INF/lib/batik-dom.jar</systemPath>
            </dependency>
            <dependency>
                <groupId>ItsNat</groupId>
                <artifactId>batik-util</artifactId>
                <version>1.3.1</version>
                <scope>system</scope>
                <systemPath>${basedir}/src/main/webapp/WEB-INF/lib/batik-util.jar</systemPath>
            </dependency>
            <dependency>
                <groupId>ItsNat</groupId>
                <artifactId>batik-xml</artifactId>
                <version>1.3.1</version>
                <scope>system</scope>
                <systemPath>${basedir}/src/main/webapp/WEB-INF/lib/batik-xml.jar</systemPath>
            </dependency>
            

    The complete POM is here

    Note: thanks Ravindranath Akila for this Maven example

  • 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.


spiral 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.




Terms of Use Privacy Statement Contributor Agreement delicious icon Add to delicious