jaxwsdemo/README.md

JAX-WS Hello World Project

A simple JAX-WS web service boilerplate project that returns "Hello World" messages.

Project Structure

jaxws-hello-world/
├── pom.xml
├── src/
│   └── main/
│       ├── java/
│       │   └── com/
│       │       └── example/
│       │           └── service/
│       │               ├── HelloWorldService.java
│       │               └── HelloWorldServiceImpl.java
│       └── webapp/
│           └── WEB-INF/
│               ├── web.xml
│               └── sun-jaxws.xml

Files Overview

• pom.xml: Maven configuration with JAX-WS dependencies
• HelloWorldService.java: Web service interface with @WebService annotation
• HelloWorldServiceImpl.java: Implementation of the web service
• web.xml: Web application deployment descriptor
• sun-jaxws.xml: JAX-WS endpoint configuration
• Dockerfile: Multi-stage Docker build configuration
• docker-compose.yml: Docker Compose orchestration file
• tomcat-users.xml: Tomcat manager user configuration

Quick Start with Docker (Recommended)

The easiest way to test this application is using Docker. No need to install Java, Maven, or Tomcat!

Prerequisites

• Docker Desktop (Windows/Mac/Linux)
• OR Docker Engine (Linux)

Running with Docker Compose

1. Start the application:

docker-compose up -d

2. Wait for the application to start (about 30-40 seconds), then access:

• WSDL: http://localhost:8080/jaxws-hello-world/services/hello?wsdl
• Tomcat Manager: http://localhost:8080/manager (username: admin, password: admin123)

3. View logs:

docker-compose logs -f

4. Stop the application:

docker-compose down

Running with Docker (without Docker Compose)

1. Build the Docker image:

docker build -t jaxws-hello-world .

2. Run the container:

docker run -d -p 8080:8080 --name jaxws-service jaxws-hello-world

3. View logs:

docker logs -f jaxws-service

4. Stop and remove the container:

docker stop jaxws-service
docker rm jaxws-service

Testing the Docker Deployment

Once the container is running, test the service:

# Check if WSDL is accessible
curl http://localhost:8080/jaxws-hello-world/services/hello?wsdl

# Test with a SOAP request
curl -X POST http://localhost:8080/jaxws-hello-world/services/hello \
  -H "Content-Type: text/xml; charset=utf-8" \
  -H "SOAPAction: " \
  -d '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://service.example.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getHelloWorld>
         <arg0>Docker</arg0>
      </ser:getHelloWorld>
   </soapenv:Body>
</soapenv:Envelope>'

---

Environment Setup

Windows Setup

1. Install Java Development Kit (JDK)

Option A: Using Installer

1. Download JDK 8 or higher from Oracle or OpenJDK
2. Run the installer (e.g., jdk-8u351-windows-x64.exe)
3. Follow the installation wizard
4. Set JAVA_HOME environment variable:

   setx JAVA_HOME "C:\Program Files\Java\jdk1.8.0_351"
   setx PATH "%PATH%;%JAVA_HOME%\bin"
   

Option B: Using Chocolatey

choco install openjdk

Verify Installation:

java -version
javac -version

2. Install Apache Maven

Option A: Manual Installation

1. Download Maven from Apache Maven
2. Extract to C:\Program Files\Apache\maven
3. Set environment variables:

   setx MAVEN_HOME "C:\Program Files\Apache\maven"
   setx PATH "%PATH%;%MAVEN_HOME%\bin"
   

Option B: Using Chocolatey

choco install maven

Verify Installation:

mvn -version

3. Install Apache Tomcat

Option A: Manual Installation

1. Download Tomcat 9+ from Apache Tomcat
2. Extract to C:\Program Files\Apache\Tomcat
3. Set CATALINA_HOME:

   setx CATALINA_HOME "C:\Program Files\Apache\Tomcat"
   

Option B: Using Chocolatey

choco install tomcat

Start Tomcat:

cd C:\Program Files\Apache\Tomcat\bin
startup.bat

Stop Tomcat:

cd C:\Program Files\Apache\Tomcat\bin
shutdown.bat

4. Configure Tomcat Manager (Optional)

Edit C:\Program Files\Apache\Tomcat\conf\tomcat-users.xml:

<tomcat-users>
  <role rolename="manager-gui"/>
  <role rolename="manager-script"/>
  <user username="admin" password="admin123" roles="manager-gui,manager-script"/>
</tomcat-users>

Access at: http://localhost:8080/manager

---

Linux Setup

1. Install Java Development Kit (JDK)

Ubuntu/Debian:

# Update package index
sudo apt update

# Install OpenJDK 8
sudo apt install openjdk-8-jdk -y

# OR Install OpenJDK 11
sudo apt install openjdk-11-jdk -y

# Set JAVA_HOME
echo 'export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64' >> ~/.bashrc
echo 'export PATH=$PATH:$JAVA_HOME/bin' >> ~/.bashrc
source ~/.bashrc

RHEL/CentOS/Fedora:

# Install OpenJDK 8
sudo yum install java-1.8.0-openjdk-devel -y

# OR Install OpenJDK 11
sudo dnf install java-11-openjdk-devel -y

# Set JAVA_HOME
echo 'export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk' >> ~/.bashrc
echo 'export PATH=$PATH:$JAVA_HOME/bin' >> ~/.bashrc
source ~/.bashrc

Verify Installation:

java -version
javac -version

2. Install Apache Maven

Ubuntu/Debian:

sudo apt update
sudo apt install maven -y

RHEL/CentOS/Fedora:

sudo yum install maven -y
# OR
sudo dnf install maven -y

Manual Installation (All Distributions):

# Download Maven
cd /opt
sudo wget https://dlcdn.apache.org/maven/maven-3/3.9.5/binaries/apache-maven-3.9.5-bin.tar.gz
sudo tar xzf apache-maven-3.9.5-bin.tar.gz
sudo ln -s apache-maven-3.9.5 maven

# Set environment variables
echo 'export MAVEN_HOME=/opt/maven' >> ~/.bashrc
echo 'export PATH=$PATH:$MAVEN_HOME/bin' >> ~/.bashrc
source ~/.bashrc

Verify Installation:

mvn -version

3. Install Apache Tomcat

Using Package Manager (Ubuntu/Debian):

sudo apt update
sudo apt install tomcat9 -y

# Start Tomcat
sudo systemctl start tomcat9
sudo systemctl enable tomcat9

# Check status
sudo systemctl status tomcat9

Manual Installation (All Distributions):

# Download Tomcat
cd /opt
sudo wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.80/bin/apache-tomcat-9.0.80.tar.gz
sudo tar xzf apache-tomcat-9.0.80.tar.gz
sudo ln -s apache-tomcat-9.0.80 tomcat

# Set permissions
sudo chmod +x /opt/tomcat/bin/*.sh

# Set environment variable
echo 'export CATALINA_HOME=/opt/tomcat' >> ~/.bashrc
source ~/.bashrc

# Start Tomcat
/opt/tomcat/bin/startup.sh

# Stop Tomcat
/opt/tomcat/bin/shutdown.sh

4. Configure Tomcat Manager (Optional)

Edit /opt/tomcat/conf/tomcat-users.xml or /etc/tomcat9/tomcat-users.xml:

sudo nano /opt/tomcat/conf/tomcat-users.xml

Add:

<tomcat-users>
  <role rolename="manager-gui"/>
  <role rolename="manager-script"/>
  <user username="admin" password="admin123" roles="manager-gui,manager-script"/>
</tomcat-users>

Restart Tomcat:

# If using systemd
sudo systemctl restart tomcat9

# If manual installation
/opt/tomcat/bin/shutdown.sh
/opt/tomcat/bin/startup.sh

Access at: http://localhost:8080/manager

---

Verify Complete Setup

Check all installations:

Windows:

java -version
javac -version
mvn -version
echo %CATALINA_HOME%

Linux:

java -version
javac -version
mvn -version
echo $CATALINA_HOME
curl http://localhost:8080

If all commands return valid output, your environment is ready!

Building the Project

mvn clean package

This will create a WAR file in the target/ directory.

Deploying

Deploy the generated WAR file to a servlet container like:

• Apache Tomcat 9+
• Jetty
• GlassFish
• WildFly

Testing the Service

Once deployed, the service will be available at:

WSDL URL: http://localhost:8080/jaxws-hello-world/services/hello?wsdl

Service Endpoint: http://localhost:8080/jaxws-hello-world/services/hello

Using SOAP UI or similar tool:

Send a SOAP request like:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://service.example.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getHelloWorld>
         <arg0>World</arg0>
      </ser:getHelloWorld>
   </soapenv:Body>
</soapenv:Envelope>

Response:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getHelloWorldResponse xmlns:ns2="http://service.example.com/">
         <return>Hello World, World!</return>
      </ns2:getHelloWorldResponse>
   </soap:Body>
</soap:Envelope>

Requirements

Option 1: Using Docker (Recommended)

• Docker Desktop or Docker Engine
• Docker Compose (usually included with Docker Desktop)

Option 2: Traditional Setup

• Java 8 or higher
• Maven 3.6+
• Servlet container (Tomcat 9+, etc.)