Document Outline

• Open Source Java Frameworks on NonStop User's Guide (Spring 3.1.0, Hibernate 4.1.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
• 2 Spring Framework
  • Spring Overview
    • Spring Projects
      • Spring Framework
      • Spring Web Flow
    • Spring Applications on NonStop
  • Installing the Spring Framework
    • Prerequisites​​
      • NonStop System​​
      • Windows System​​
    • Installing Spring Framework Libraries on a NonStop System
      • Downloading​​ the Spring Distribution on Windows​​
      • Copying Spring Runtime Libraries from Windows to NonStop
    • Setting up Sample Spring Applications on NonStop
      • Prerequisites​​
      • 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
  • Integrating Spring with Transaction Management Facility (TMF)
    • What is Spring TMF Adapter?​​
    • Setting up the Sample SpringTMFAdapter on NonStop
      • Prerequisites​​
      • Setting up an SQL/MX Database on NonStop​​
      • Dependent Libraries for the Sample TMFAdapter​​
      • Running TMFAdapter on NonStop
  • Configuring Spring Applications on NonStop Systems
    • Spring Framework Configurations
      • Configuring JDBC Driver for SQL/MX Database
        • Configurations in the jdbc.properties File
          • Defining JDBC Driver Class for SQL/MX Database
          • Defining the Connection URL
          • Establishing the Connection
        • Configurations in the applicationContext.xml File
          • Defining the Placeholder​​ for JDBC Driver Class​​
          • Defining the Placeholder for Connection URL
          • Defining the Placeholder for Establishing the Connection
          • Wiring of JDBC Properties
      • Configuring ​​TmfTransactionManager​​
        • Declarative Transaction Management​​
          • Annotations​​
          • Aspect Oriented Programming (AOP)​​
        • Programmatic Transaction Management​​
          • Configuring Using the Transaction Template​​
          • Configuring Using the ​​TmfTransactionManager​​ Programmatically​​
  • Getting Started with Spring
    • Prerequisites
    • 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 (JSTL)
            • 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
• 3 Hibernate Framework
  • Hibernate Overview
    • Hibernate Projects
      • Hibernate Annotations
      • Hibernate EntityManager
    • Hibernate Applications on NonStop
  • 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 Gradle​​
      • Including the Hibernate Dialect for the SQL/MX database
      • Copying the Hibernate Distribution from Windows to NonStop
    • Customizing the Hibernate Dialect​​ for NonStop​​
      • IDENTITY Column​​
      • Error Mapping​​
    • Setting up Sample Hibernate Applications on NonStop
      • Prerequisites​​
      • 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 EventManager on Windows
        • Setting up the SQL/MX database on NonStop
        • Deploying Event Manager on NonStop
        • Running EventManager on NonStop
  • Configuring Hibernate Applications on NonStop Systems
    • Hibernate Framework Configurations for NonStop Systems
      • JDBC Driver for SQL/MX Database
        • Configuring the JDBC Type 2 or Type 4 Driver for SQL/MX Database
          • Configuring the JDBC Type 2 or Type 4 Driver for the SQL/MX Database using hibernate.cfg.xml
            • Specifying the Driver Class 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 or Type 4 Driver for SQL/MX Database using hibernate.properties
            • Specifying the JDBC Driver Class 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​​
    • Enabling Browse Access
      • Hibernate Applications
      • Spring and Hibernate Applications
  • Getting Started with Hibernate
    • Prerequisites
    • 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
• 4 MyFaces Framework
  • MyFaces Overview
    • MyFaces Projects
      • MyFaces Trinidad
      • MyFaces Tomahawk
    • MyFaces Application on NonStop
  • 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
  • Configuring MyFaces Applications on NonStop Systems
  • 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
• 5 Axis2/Java Framework
  • Axis2/Java Overview
    • Apache Axis2/Java Project
    • Axis2/Java Framework
    • Axis2/Java Modules
    • Axis2/Java Applications on NonStop
  • 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
  • Configuring Axis2/Java Applications on NonStop Systems
    • Axis2/Java Framework Configurations for NonStop Systems
      • Global Configuration
      • Service Configuration
      • Module Configuration
  • 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
• 6 Integrating Frameworks
  • 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
      • Running EmpInfo on NonStop
  • 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
      • Running EmpInfo on NonStop
  • Developing Spring JPA Applications Using Hibernate
    • Example of Developing Spring JPA Applications Using Hibernate
      • 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
      • Running EmpInfo on NonStop
  • 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
  • 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
• A EmpInfo Database Script
• B NonStop Specific Configurations
  • NonStop Platform Configurations
    • Determining the Application Parameters
    • Determining the Maximum Capacity of NSJSP Instance
    • Configuring iTP WebServer for Spring, Hibernate, MyFaces, and Axis2/Java Applications
      • Configuring httpd Processes to Handle Maximum Load
      • Limiting the Maximum Number of Incoming Requests
    • Configuring NSJSP for Spring, Hibernate, MyFaces, and 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 Configured with SessionBasedLoadBalancing Turned ON
      • Configuring Java Runtime Arguments
        • -Xmx
        • -Xss
        • -Xnoclassgc
  • Module File Caching Configurations
    • Recommendations​​
    • Configuring NonStop SQL/MX DataSource for MFC
• C Deploying Sample Applications on NonStop
• D Sample JDBC Configuration for Spring
• E Installing Spring Web Flow
  • Downloading Spring Web Flow Distribution on Windows
  • Copying Spring Web Flow Runtime Libraries from Windows to NonStop
• F Sample JDBC Configuration for Hibernate
• G Hibernate Environment Setup Script
• H Installing MyFaces Trinidad/Tomahawk Framework Libraries on NonStop
  • Downloading MyFaces Trinidad/Tomahawk Distribution
  • Copying MyFaces Trinidad Runtime Libraries from Windows to NonStop
• I Frequently Asked Questions
• Glossary
• Index