Document Outline

• Open Source Java Frameworks on NonStop User's Guide (Spring 3.0.2, Hibernate 3.5.1, MyFaces 2.0.2, Axis2/Java 1.5.2)
• Contents
• About This Document
  • Supported Release Version Updates (RVUs)
  • Intended Audience
  • New and Changed Information in This Edition
  • Document Organization
  • Notation Conventions
    • General Syntax Notation
    • Notation for Messages
    • Notation for Management Programming Interfaces
    • General Syntax Notation
  • Related Information
  • Publishing History
  • HP Encourages Your Comments
• 1 Introduction
  • Prerequisites
    • NonStop System
      • NonStop iTP WebServer
      • NSJSP
      • NonStop SQL/MX
      • JDBC Type 2 Driver for NonStop SQL/MX
      • NonStop Server for Java (NSJ)
    • Windows System
      • Java Development Kit (JDK)
      • Ant
      • Maven
      • JDBC Type 4 Driver for NonStop SQL/MX
      • SVN
      • Eclipse Galileo IDE
• Part I Spring Framework
  • 2 Spring Overview
    • Spring Projects
      • Spring Framework
      • Spring Web Flow
    • Spring Applications on NonStop
  • 3 Installing the Spring Framework
    • Prerequisites
      • NonStop System
      • Windows System
    • Installing Spring Framework Libraries on NonStop
      • Downloading the Spring Distribution on Windows
      • Downloading Spring Dependency JAR Files on Windows
      • Downloading Sample Spring Applications on Windows
      • Copying Spring Runtime Libraries from Windows to NonStop
    • Deploying and Running Sample Spring Applications on NonStop
      • PetClinic
        • Building PetClinic on Windows
        • Setting up PetClinic Database on NonStop
        • Deploying PetClinic on NonStop
        • Running PetClinic on NonStop
      • JPetStore
        • Building JPetStore on Windows
        • Setting up JPetStore Database on NonStop
        • Deploying JPetStore on NonStop
        • Running JPetStore on NonStop
  • 4 Configuring Spring Applications on NonStop Systems
    • NonStop Platform Configurations
      • Determining the Application Parameters
      • Determining the Maximum Capacity of NSJSP Instance
      • Configuring iTP WebServer for Spring Applications
        • Configuring httpd Processes to Handle Maximum Load
        • Limiting the Maximum Number of Incoming Requests
      • Configuring NSJSP for Spring Applications
        • Configuring SessionBasedLoadBalancing
        • Configuring Connector Threads
          • Configuring the Connector Element
          • Configuring the Executor Element
        • Configuring TS/MP Specific Parameters
          • NSJSP Configured with SessionBasedLoadBalancing Turned OFF
          • NSJSP Configured with SessionBasedLoadBalancing Turned ON
        • Configuring Java Runtime Arguments
          • -Xmx
          • -Xss
          • -Xnoclassgc
    • Spring Framework Configurations
      • Configuring JDBC Driver for SQL/MX Database
        • Configuring JDBC Type 2 Driver for SQL/MX Database
          • Configurations in the jdbc.properties File
            • Defining JDBC Type 2 Driver Class for SQL/MX Database
            • Defining the Connection URL
            • Establishing the Connection
          • Configurations in the applicationContext.xml File
            • Defining the placeholder for JDBC Type 2 Driver Class
            • Defining the Placeholder for Connection URL
            • Defining the Placeholder for Establishing the Connection
            • Wiring of JDBC Properties
        • Configuring JDBC Type 4 Driver for SQL/MX Database
          • Configurations in the jdbc.properties File
            • Defining JDBC Type 4 Driver Class for SQL/MX Database
            • Defining the Connection URL
            • Establishing the Connection
          • Configurations in the applicationContext.xml File
            • Defining the Placeholder for JDBC Type 4 Driver Class
            • Defining the Placeholder for Connection URL
            • Defining the Placeholder for Establishing the Connection
            • Wiring of JDBC Properties
      • Configuring Database Transaction Management
        • Declarative Transaction Management
          • Defining the Transactional Object
          • Defining the Transactional Advice
          • Defining the Transactional Execution Point
          • Defining the Transaction Datasource
          • Defining the PlatformTransactionManager
          • Defining the Transaction Rollback (Optional)
        • Programmatic Transaction Management
          • Using the TransactionTemplate
          • Using a PlatformTransactionManager
        • Recommendation
      • Connection Pooling
        • Connection Pooling using Apache C3P0
        • Recommendations
          • Tuning Connection Pool
            • Minimum Pool Size
            • Maximum Pool Size
            • checkoutTimeout
            • maxIdleTime
    • Module File Caching Configurations
      • Configuring NonStop SQL/MX DataSource for MFC
      • Modifying the Spring Application
  • 5 Getting Started with Spring
    • Prerequisites
      • NonStop System
      • Windows System
    • Overview of EmpInfo
      • Developing EmpInfo on Windows using the Eclipse Galileo IDE
        • Creating the Eclipse Workspace
        • Developing a Basic EmpInfo Application
          • Creating a Dynamic Web Project
          • Creating the index.jsp File
          • Modifying the index.jsp File
          • Modifying the web.xml File
          • Creating the EmpInfo-servlet.xml File
          • Adding Dependency JAR Files in the Project Library Path
          • Creating the Controller for EmpInfo
            • Create the Package for the Controller Class
            • Create the Controller Class
          • Creating the View
        • Developing and Configuring Views and the Controller
          • Configuring the JSP Standard Tag Library
            • Creating a folder to store JSPs
            • Creating the include.jsp File
            • Modifying the index.jsp File
            • Modifying the insert.jsp File
          • Adding JSTL and JSP Related Dependency JARs
          • Enhancing the Controller
          • Decoupling View from the Controller
        • Developing Business Logic and Providing the Web Interface
          • Creating a Simple POJO
          • Creating Data Access Object Implementation for JDBC
          • Creating and Modifying Supporting Views to Display Business Data
          • Adding Dependency JAR Files
        • Integrating the Web-tier of EmpInfo with NonStop SQL/MX Database
          • Creating the applicationContext.xml File
          • Creating the jdbc.properties File
          • Modifying the EmpInfo-servlet.xml File
          • Improving the Controller
          • Modifying the web.xml File
          • Adding Dependency JAR Files
          • Creating Database Catalog, Schema, and Tables on NonStop
        • Enabling EmpInfo to Delete and Retrieve Employee Details
          • Creating JSPs to Delete and Retrieve Employee Details
          • Creating the RowMapper Class
          • Modifying the EmployeeDao.java Class File
          • Modifying the Employee.java File
          • Modifying the EmployeeController.java File
          • Modifying the EmpInfo-servlet.xml File
          • Modifying the index.jsp File
          • Implementing the RMI Service in EmpInfo
      • Deploying EmpInfo on NonStop
        • Creating the Application WAR File on Windows
        • Deploying the EmpInfo WAR File in NSJSP on NonStop
      • Running EmpInfo on NonStop
  • A EmpInfo Database Script
  • B Customizing Sample Applications
    • Customizing PetClinic
      • Added Directories
        • /mxci
        • /etc
      • Added File
        • SetDatabase.java
      • Modified Files
        • web.xml
        • petclinic.hbm.xml
        • applicationContext-dataSource.xml
        • jdbc.properties
    • Customizing JPetStore
      • Added File
        • SetDatabase.java
      • Modified Files
        • Item.xml
        • dataAccessContext-local.xml
        • jdbc.properties
        • Order.xml
        • Pom.xml
  • C JDBC Configuration
  • D Installing Spring Web Flow
    • Downloading Spring Web Flow Distribution on Windows
    • Copying Spring Web Flow Runtime Libraries from Windows to NonStop
• Part II Hibernate Framework
  • 6 Hibernate Overview
    • Hibernate Projects
      • Hibernate Annotations
      • Hibernate EntityManager
    • Hibernate Applications on NonStop
  • 7 Installing the Hibernate Framework
    • Prerequisites
      • NonStop system
      • Windows system
    • Installing Hibernate Framework Libraries on NonStop
      • Downloading the Hibernate Distribution on Windows
      • Downloading Hibernate Dependency JAR Files using Maven
      • Including the Hibernate Dialect for the SQL/MX database to the Hibernate Distribution
      • Copying the Hibernate Distribution from Windows to NonStop
    • Deploying and Running Sample Hibernate Applications on NonStop
      • Caveat Emptor
        • Building Caveat Emptor on Windows
        • Setting up the Deployment Environment on NonStop
          • Setting up SQL/MX database on NonStop
          • Setting up the Hibernate and JDBC environment on NonStop
        • Deploying Caveat Emptor on NonStop
        • Running Caveat Emptor on NonStop
      • The EventManager Web Application
        • Building EventManger on Windows
        • Setting up the SQL/MX database on NonStop
        • Deploying Event Manager on NonStop
        • Running EventManager on NonStop
  • 8 Configuring Hibernate Applications on NonStop Systems
    • NonStop Platform Configurations
      • Determining the Application Parameters
      • Determining the Maximum Capacity of NSJSP Instance
      • Configuring iTP WebServer for Hibernate Applications
        • Configuring httpd Processes to Handle Maximum Load
        • Limiting the Maximum Number of Incoming Requests
      • Configuring NSJSP for Hibernate Applications
        • Configuring SessionBasedLoadBalancing
        • Configuring Connector Threads
          • Configuring the Connector Element
          • Configuring the Executor Element
        • Configuring TS/MP Specific Parameters
          • NSJSP Configured with SessionBasedLoadBalancing Turned OFF
          • NSJSP Configured with SessionBasedLoadBalancing Turned ON
        • Configuring Java Runtime Arguments
          • -Xmx
          • -Xss
          • -Xnoclassgc
    • Hibernate Framework Configurations for NonStop Systems
      • JDBC Driver for SQL/MX Database
        • Configuring the JDBC Type 2 Driver for SQL/MX Database
          • Configuring the JDBC Type 2 Driver for the SQL/MX Database using hibernate.cfg.xml
            • Specifying the JDBC Type 2 Driver for SQL/MX Database
            • Defining the Connection URL
            • Establishing the Connection
            • Defining the Hibernate Dialect for SQL/MX Database
            • Specifying the Mapping Resources
            • Opening a Session for Database Operation
              • Configuring SessionFactory in the hibernate.cfg.xml File
              • Creating a New Session from the SessionFactory in your Java Program
            • Closing the Session
          • Configuring JDBC Type 2 Driver for SQL/MX Database using hibernate.properties
            • Specifying the JDBC Type 2 Driver for SQL/MX Database
            • Defining the Connection URL
            • Establishing the Connection
            • Defining the Hibernate Dialect for SQL/MX Database
            • Opening a Session for Database Operation
              • Configuring SessionFactory in your Java Program
              • Creating a New Session from the SessionFactory in Java
            • Specifying the Mapping Resources
            • Closing the Session
        • Configuring JDBC Type 4 Driver for SQL/MX Database
          • Configuring JDBC Type 4 Driver for SQL/MX Database using hibernate.cfg.xml
            • Specifying the JDBC Type 4 Driver for SQL/MX Database
            • Defining the Connection URL
            • Establishing the Connection
            • Defining the Hibernate Dialect for SQL/MX Database
            • Specifying the Mapping Resources
            • Opening a Session for Database Operation
              • Configuring SessionFactory in the hibernate.cfg.xml File
              • Creating a New Session from the SessionFactory in Java
            • Closing the Session
          • Configuring JDBC Type 4 Driver for SQL/MX Database using hibernate.properties
            • Specifying the JDBC Type 4 Driver for SQL/MX Database
            • Defining the Connection URL
            • Establishing the Connection
            • Defining the Hibernate Dialect for SQL/MX Database
            • Opening a Session for Database Operation
              • Configuring SessionFactory in your Java Program
              • Creating a New Session from the SessionFactory in Java
            • Specifying the Mapping Resources
            • Closing the Session
      • Database Transaction Management
      • Connection Pooling
    • Module File Caching Configurations
      • Configuring NonStop SQL/MX DataSource for MFC
      • Modifying the Hibernate Application
    • Enabling Browse Access
      • Hibernate Applications
      • Spring and Hibernate Applications
  • 9 Getting Started with Hibernate
    • Prerequisites
      • NonStop System
      • Windows System
    • Overview of EmpIoyeeInfo
      • Developing EmployeeInfo on Windows using the Eclipse Galileo IDE
        • Creating the Eclipse Workspace
        • Creating a New Java Project
        • Adding Dependency JAR Files to the Project Library
        • Creating the Package for the EmployeeInfo Application
        • Creating the Employee.java Class File
        • Creating the Main Class
        • Implementing the Business Logic
        • Creating the Hibernate Mapping File
        • Setting Hibernate Configurations
          • hibernate.cfg.xml
          • hibernate.properties
        • Creating the EmployeeInfo Application JAR File
      • Setting Up the NonStop Environment
      • Running EmployeeInfo on NonStop
  • E Customizing Sample Applications
    • Customizing Caveat Emptor
      • Added Files
        • hibernate.properties
        • setenv
        • Caveatemptor_script.sql
      • Modified Files
        • Main.java
    • Customizing EventManager
      • Added Directories
        • /dbconfig
        • /etc
      • Added Files
        • hibernate.properties
        • eventmanager_script.sql
      • Modified File
        • Hibernate.cfg.xml
  • F JDBC Configuration
  • G Hibernate Environment Setup Script
• Part III MyFaces Framework
  • 10 MyFaces Overview
    • MyFaces Projects
      • MyFaces Trinidad
      • MyFaces Tomahawk
    • MyFaces Application on NonStop
  • 11 Installing MyFaces Framework
    • Prerequisites
      • NonStop System
      • Windows System
    • Downloading MyFaces Framework Libraries on Windows
    • Deploying and Running Sample MyFaces Application on NonStop
      • myfaces-components
        • Building myfaces-components on Windows
        • Deploying myfaces-components on NonStop
        • Running myfaces-components on NonStop
  • 12 Configuring MyFaces Applications on NonStop Systems
    • NonStop Platform Configurations
      • Determining the Application Parameters
      • Determining the Maximum Capacity of NSJSP Instance
      • Configuring iTP WebServer for MyFaces Applications
        • Configuring httpd Processes to Handle Maximum Load
        • Limiting the Maximum Number of Incoming Requests
      • Configuring NSJSP for MyFaces Applications
        • Configuring SessionBasedLoadBalancing
        • Configuring Connector Threads
          • Configuring the Connector Element
          • Configuring the Executor Element
        • Configuring TS/MP Specific Parameters
          • NSJSP configured with SessionBasedLoadBalancing turned OFF
          • NSJSP is configured with SessionBasedLoadBalancing turned ON
        • Configuring Java Runtime Arguments
          • -Xmx
          • -Xss
          • -Xnoclassgc
        • Determining the Maximum Capacity of NSJSP Instance
  • 13 Getting Started with MyFaces
    • Prerequisites
      • NonStop System
      • Windows System
    • Overview of SkinSelector
      • Developing SkinSelector on Windows using the Eclipse Galileo IDE
        • Creating the Eclipse Workspace
        • Creating a Dynamic Web Project
        • Creating the index.jsp File
        • Modifying the web.xml File
        • Adding Dependency JAR Files to the Project Library
        • Creating Views for SkinSelector
          • Creating the css and results Folder
          • Creating the style.css File
          • Modifying the style.css File
          • Creating the customize.jsp File
          • Modifying the customize.jsp File
          • Creating the same-color.jsp and show-preview.jsp Files
          • Modifying the same-color.jsp File
          • Modifying the show-preview.jsp File
        • Creating the Managed Beans
          • Creating a New Package
          • Creating a New Java Class File
          • Modifying the Java Class File
        • Creating the Configuration File
      • Deploying SkinSelector on NonStop
        • Creating the SkinSelector Application WAR File on Windows
        • Deploying the SkinSelector WAR File in NSJSP on NonStop
      • Running SkinSelector on NonStop
  • H Installing MyFaces Trinidad Framework Libraries on NonStop
    • Downloading MyFaces Trinidad Distribution
    • Copying MyFaces Trinidad Runtime Libraries from Windows to NonStop
  • I Installing MyFaces Tomahawk Framework Libraries on NonStop
    • Downloading MyFaces Tomahawk Distribution on Windows
    • Copying MyFaces Tomahawk Runtime Libraries from Windows to NonStop
• Part IV Axis2/Java Framework
  • 14 Axis2/Java Overview
    • Apache Axis2/Java Project
    • Axis2/Java Framework
    • Axis2/Java Modules
    • Axis2/Java Applications on NonStop
  • 15 Installing Axis2/Java Framework
    • Prerequisites
      • NonStop System
      • Windows System
    • Installing Axis2/Java on NonStop
      • Downloading the Axis2/Java Distribution on Windows
      • Building the Axis2/Java Web Archive using Standard Binary Distribution
      • Deploying Axis2/Java as a Web Application on NonStop
      • Running Axis2/Java on NonStop
    • Installing the Sandesha2 Module
      • Downloading the Sandesha2 Distribution on Windows
      • Modifying the Configuration File on Windows
      • Copying the Sandesha2 Binaries to the Axis2/Java Directory
      • Modifying the Build File on Windows
      • Building the Axis2/Java Web Archive with Sandesha2
      • Deploying the Axis2/Java Web Archive with Sandesha2
    • Installing the Rampart Module
      • Downloading the Axis2/Java Distribution on Windows
      • Copying the Rampart Binaries to Axis2/Java
      • Building the Axis2/Java Web Archive with Rampart
      • Deploying the Axis2/Java Web Archive with Rampart
    • Deploying and Running Axis2/Java Sample Applications on NonStop
      • FaultHandling
        • Building FaultHandling on Windows
        • Deploying FaultHandling on NonStop
        • Running FaultHandling
      • MTOM
        • Building MTOM on Windows
        • Deploying MTOM on NonStop
        • Configuring the client for running MTOM
        • Running MTOM
  • 16 Configuring Axis2/Java Applications on NonStop Systems
    • NonStop Platform Configurations
      • Determining the Application Parameters
      • Determining the Maximum Capacity of an NSJSP Instance
      • Configuring iTP WebServer for Axis2/Java Applications
        • Configuring httpd Processes to Handle Maximum Load
        • Limiting the Maximum Number of Incoming Requests
      • Configuring NSJSP for Axis2/Java Applications
        • Configuring SessionBasedLoadBalancing
        • Configuring Connector Threads
          • Configuring the Connector Element
          • Configuring the Executor Element
        • Configuring TS/MP Specific Parameters
          • NSJSP configured with SessionBasedLoadBalancing turned OFF
          • NSJSP is configured with SessionBasedLoadBalancing turned ON
        • Configuring Java Runtime Arguments
          • -Xmx
          • -Xss
          • -Xnoclassgc
    • Axis2/Java Framework Configurations for NonStop Systems
      • Global Configuration
      • Service Configuration
      • Module Configuration
  • 17 Getting Started with Axis2/Java
    • Prerequisites
      • NonStop System
      • Windows System
    • Overview of TemperatureConverter
      • Code-First approach
        • Developing TemperatureConverter Web Service on Windows
          • Creating the Web Service Implementation Class
          • Creating the Deployment Descriptor
          • Creating an Axis2/Java AAR File
        • Deploying the TemperatureConverter Web Service on NonStop
        • Running TemperatureConverter Web Service on NonStop
        • Developing TemperatureConverter Client on Windows using the Eclipse Galileo IDE
          • Creating the Client Project in Eclipse
          • Creating the Java Package for Client Project
          • Creating the Class Files under the Java Package
          • Modifying the Class File of the Client
          • Adding Dependency JAR Files
        • Running TemperatureConverter Client on Windows
          • Accessing a REST Web Service using HTTP GET
      • Contract-First approach
        • Developing the TemperatureConverter Web Service on Windows
          • Generating the web service skeleton file using WSDL2Java
          • Update the service skeleton file with the business logic
          • Creating an Axis2/Java AAR File
        • Deploying the TemperatureConverter Web Service on NonStop
        • Running the TemperatureConverter Web Service on NonStop
        • Developing the TemperatureConverter Client on Windows using the Eclipse Galileo IDE
          • Creating the Client Project in Eclipse
          • Adding Dependency JAR Files
          • Creating the Client stub file using WSDL2Java
        • Modifying the Client Stub File
        • Running the TemperatureConverter Client on Windows
• Part V Integrating Frameworks
  • 18 Using Spring Transaction Manager
    • Why Transaction Management is required
    • Spring Transaction Management
      • Declarative Transaction Management
      • Programmatic Transaction Management
    • Example of Using Spring Transaction Manager
      • Modifying EmpInfo on Windows using Eclipse Galileo IDE
        • Modifying EmpInfo based on the Type of Transaction
          • For Declarative Transaction
            • Creating the IEmployeeDao.java File
            • Modifying the EmployeeController.java File
            • Modifying the applicationContext.xml File
          • For Programmatic Transaction
            • Modifying the applicationContext.xml File
            • Modifying the EmployeeController.java File
        • Adding Dependency JAR Files
          • For Declarative Transaction
          • For Programmatic Transaction
      • Deploying EmpInfo on NonStop
        • Creating the Application WAR File on Windows
        • Deploying the EmpInfo WAR File in NSJSP on NonStop
      • Running EmpInfo on NonStop
  • 19 Integrating Hibernate into Spring
    • Why Integrate Hibernate into Spring
    • Example of Integrating Hibernate into Spring
      • Modifying EmpInfo on Windows using Eclipse Galileo IDE
        • Modifying the applicationContext.xml File
        • Modifying the EmployeeDao.java File
        • Creating the Employee.hbm.xml File
        • Removing the EmployeeRowMapper.java File
        • Adding Dependency JAR Files
      • Deploying EmpInfo on NonStop
        • Creating the EmpInfo WAR File on Windows
        • Deploying the EmpInfo WAR File in NSJSP on NonStop
      • Running EmpInfo on NonStop
  • 20 Integrating JPA with Hibernate into Spring
    • Why Integrate JPA with Hibernate in Spring
    • Example of Integrating JPA with Hibernate into Spring
      • Modifying EmpInfo on Windows using Eclipse Galileo IDE
        • Creating the persistence.xml File
        • Creating the EntityEmployee.java File
        • Modifying the applicationContext.xml File
        • Modifying the EmployeeDao.java File
        • Removing the Employee.hbm.xml File
        • Adding Dependency JAR Files
          • Downloading Hibernate Entity Manager
          • Adding Dependency JAR Files
      • Deploying EmpInfo on NonStop
        • Creating the EmpInfo WAR File on Windows
        • Deploying the EmpInfo WAR File in NSJSP on NonStop
      • Running EmpInfo on NonStop
  • 21 Integrating Axis2/Java into Spring
    • Why Integrate Axis2/Java into Spring
    • Example of Integrating Axis2/Java with Spring
      • Modifying EmpInfo on Windows using Eclipse Galileo IDE
        • Creating the SpringInit.java File
        • Creating the services.xml File
        • Modifying the applicationContext.xml File
        • Creating the build.xml File
        • Adding Dependency JAR Files
      • Deploying EmpInfo on NonStop
        • Creating the EmpInfo AAR File on Windows
        • Deploying the EmpInfo AAR File in Axis2/Java on NonStop
      • Running EmpInfo Web Service on NonStop
      • Developing EmpInfoClient on Windows
        • Creating the EmpInfoClient Project in Eclipse
        • Creating the Package for EmpInfoClient
        • Creating the EmpInfoClient.java File
        • Modifying the EmpInfoClient.java File
        • Adding Dependency JAR Files
      • Running EmpInfoClient on Windows
  • 22 Integrating MyFaces into Spring
    • Why Integrate MyFaces into Spring
    • Example of Integrating MyFaces into Spring
      • Modifying EmpInfo on Windows using Eclipse Galileo IDE
        • Removing the Folders and Files from the EmpInfo Application
        • Modifying the web.xml File
        • Creating the IEmployeeDao.java File
        • Modifying the EmployeeDao.java File
        • Creating the ServiceFinder.java File
        • Creating the EmpBean.java File
        • Creating the MessageFactory.java File
        • Creating the message.properties File
        • Creating views using MyFaces tag libraries
          • Creating Pages folder
          • Creating JSPs
          • Modifying JSPs
            • welcome.jsp
            • insert.jsp
            • empUpdate.jsp
            • empDetail.jsp
            • success.jsp
          • Creating the mycss.css File
        • Modifying the index.jsp File
        • Creating the faces-config.xml File
        • Adding Dependency JAR Files
      • Deploying EmpInfo on NonStop
        • Creating the EmpInfo WAR File on Windows
        • Deploying the EmpInfo WAR File in NSJSP on NonStop
      • Running EmpInfo on NonStop
• 23 Frequently Asked Questions
• Glossary
• Index