WSO2 Application Server, version 5.3.0 WSO2 Application Server Documentation Version 5.3.0 1 WSO2 Application Server, version 5.3.0 Table of Contents 1. Working with AS Tooling . 7 1.1 Installing the AS Tooling Plug-In . 7 1.2 Creating an Axis2 Project . 11 1.3 Creating a Web Application . 15 1.4 Creating JAX-WS and JAX-RS Service Projects . 20 2. WSO2 Application Server Documentation . 23 2.1 About WSO2 AS . 24 2.1.1 Introducing AS . 25 2.1.2 Features . 27 2.1.3 Architecture . 29 2.1.4 About this Release . 32 2.2 Getting Started . 32 2.2.1 Quick Start Guide . 33 2.2.2 Downloading the Product . 38 2.2.3 Installation Prerequisites . 38 2.2.4 Installing the Product . 40 2.2.4.1 Installing on Linux or OS X . 40 2.2.4.2 Installing on Solaris . 42 2.2.4.3 Installing on Windows . 44 2.2.4.4 Installing as a Windows Service . 47 2.2.4.5 Installing as a Linux Service . 54 2.2.5 Running the Product . 56 2.3 User Guide . 61 2.3.1 Application Development and Deployment . 62 2.3.1.1 Developing Web Applications . 63 2.3.1.1.1 JAX-WS and JAX-RS Support . 65 2.3.1.1.2 Developing JAX-RS Applications . 65 2.3.1.1.3 Developing JAX-WS Applications . 72 2.3.1.1.4 Versioning Web Applications . 78 2.3.1.2 Developing Jaggery Applications . 79 2.3.1.3 Deploying Applications in AS . 79 2.3.1.4 Managing and Monitoring Applications . 82 2.3.1.4.1 Using the Application Dashboard . 82 2.3.1.4.2 Web Application Statistics Monitoring with BAM . 86 2.3.2 Services Development and Deployment . 91 2.3.2.1 Deploying Axis2 Services . 92 2.3.2.2 Deploying JAR Services . 94 2.3.2.3 Deploying Spring Services . 96 2.4 Samples . 99 2.4.1 Deploying your First Custom Web Application . 100 2.4.2 The Entitlement Servlet Filter Sample . 101 2.4.3 JAX-RS Samples . 104 2.4.3.1 Building and Running JAX-RS Samples . 104 2.4.3.2 JAX-RS Basics . 106 2.4.3.3 JAX-RS Advanced . 107 2.4.3.4 JAX-RS Sample on Content Negotiation . 110 2.4.4 JAX-WS Samples . 111 Copyright © WSO2 Inc. 2014 2 WSO2 Application Server, version 5.3.0 2.4.4.1 Building and Running JAX-WS Samples . 112 2.4.4.2 Asynchronous Invocation . 113 2.4.4.3 Build and Invoke a Service Using a WSDL . 114 2.4.4.4 Develop Services in Code-First Approach . 115 2.4.4.5 JAX-WS Handlers . 115 2.4.4.6 MTOM Sample for SWA and XOP . 116 2.4.4.7 WS-Security Sample on Signature and Encryption . 116 2.4.4.8 WS-Security Sample on UsernameToken and Timestamp . 116 2.4.5 Jaggery Samples . 117 2.4.5.1 Building Jaggery Samples . 117 2.4.5.2 Available Jaggery Samples . 118 2.4.6 WebSockets Sample . 118 2.4.7 SSO Sample . 119 2.5 Configuration Guide . 121 2.5.1 Clustered Deployment . 122 2.5.2 Working with Databases . 122 2.5.2.1 Setting up the Physical Database . 122 2.5.2.1.1 Setting up.