Author: mmerz
Date: Fri Oct 29 19:28:01 2004
New Revision: 56010

Added:
   incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/
   incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/
   
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/attachments/
   
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/server-config.wsdd
   incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/
   
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/log4j.properties
   
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/
   
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/EmployeeWebService.jws
   
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/apache/
   
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/apache/beehive/
   
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/apache/beehive/wsmSample/
   
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/apache/beehive/wsmSample/dbControlExtension/
   
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/apache/beehive/wsmSample/dbControlExtension/EmployeeDBControl.jcx
   
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/apache/beehive/wsmSample/dbControlExtension/WSEmployee.java
   
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/web.xml
   incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/build.xml
   incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/happyaxis.jsp
   incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/index.html
Log:
Added a new sample for control and web service integrtation.

Contributor: Daryoush Mehrtash



Added: 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/server-config.wsdd
==============================================================================
--- (empty file)
+++ 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/server-config.wsdd
   Fri Oct 29 19:28:01 2004
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<deployment xmlns="http://xml.apache.org/axis/wsdd/"; 
xmlns:java="http://xml.apache.org/axis/wsdd/providers/java";>
+ <globalConfiguration>
+  <parameter name="adminPassword" value="admin"/>
+  <parameter name="disablePrettyXML" value="true"/>
+  <parameter name="attachments.implementation" 
value="org.apache.axis.attachments.AttachmentsImpl"/>
+  <parameter name="sendXsiTypes" value="true"/>
+  <!--<parameter name="sendMultiRefs" value="true"/>-->
+  <parameter name="sendXMLDeclaration" value="true"/>
+  <requestFlow>
+  <handler 
type="java:org.apache.beehive.wsm.axis.AnnotatedWebServiceDeploymentHandler">
+    <parameter name="scope" value="session"/>
+   </handler>
+      <handler type="java:org.apache.beehive.wsm.axis.DropInDeploymentHandler">
+    <parameter name="scope" value="session"/>
+   </handler>
+  <handler type="java:org.apache.axis.handlers.JWSHandler">
+    <parameter name="scope" value="session"/>
+   </handler>
+    <!--<handler type="java:org.apache.axis.handlers.JWSHandler">
+    <parameter name="scope" value="request"/>
+    <parameter name="extension" value=".jwr"/>
+   </handler>-->
+  </requestFlow>
+ </globalConfiguration>
+ <handler name="LocalResponder" 
type="java:org.apache.axis.transport.local.LocalResponder"/>
+ <handler name="URLMapper" 
type="java:org.apache.axis.handlers.http.URLMapper"/>
+ <handler name="Authenticate" 
type="java:org.apache.axis.handlers.SimpleAuthenticationHandler"/>
+ <service name="AdminService" provider="java:MSG">
+  <parameter name="allowedMethods" value="AdminService"/>
+  <parameter name="enableRemoteAdmin" value="false"/>
+  <parameter name="className" value="org.apache.axis.utils.Admin"/>
+  <namespace>http://xml.apache.org/axis/wsdd/</namespace>
+ </service>
+ <service name="Version" provider="java:RPC">
+  <parameter name="allowedMethods" value="getVersion"/>
+  <parameter name="className" value="org.apache.axis.Version"/>
+ </service>
+ <transport name="http">
+  <requestFlow>
+   <handler type="URLMapper"/>
+   <handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/>
+  </requestFlow>
+  <parameter name="qs:list" 
value="org.apache.axis.transport.http.QSListHandler"/>
+  <parameter name="qs:wsdl" 
value="org.apache.axis.transport.http.QSWSDLHandler"/>
+  <parameter name="qs:method" 
value="org.apache.axis.transport.http.QSMethodHandler"/>
+ </transport>
+ <transport name="local">
+  <responseFlow>
+   <handler type="LocalResponder"/>
+  </responseFlow>
+ </transport>
+</deployment>
+

Added: 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/log4j.properties
==============================================================================
--- (empty file)
+++ 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/log4j.properties
 Fri Oct 29 19:28:01 2004
@@ -0,0 +1,20 @@
+# Set root category priority to INFO and its only appender to CONSOLE.
+log4j.rootCategory=INFO, CONSOLE
+#log4j.rootCategory=INFO, CONSOLE, LOGFILE
+
+# Set the enterprise logger category to FATAL and its only appender to CONSOLE.
+log4j.logger.org.apache.axis.enterprise=FATAL, CONSOLE
+
+# CONSOLE is set to be a ConsoleAppender using a PatternLayout.
+log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
+log4j.appender.CONSOLE.Threshold=INFO
+log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
+log4j.appender.CONSOLE.layout.ConversionPattern=- %m%n
+
+# LOGFILE is set to be a File appender using a PatternLayout.
+log4j.appender.LOGFILE=org.apache.log4j.FileAppender
+log4j.appender.LOGFILE.File=axis.log
+log4j.appender.LOGFILE.Append=true
+log4j.appender.LOGFILE.Threshold=INFO
+log4j.appender.LOGFILE.layout=org.apache.log4j.PatternLayout
+log4j.appender.LOGFILE.layout.ConversionPattern=%-4r [%t] %-5p %c %x - %m%n

Added: 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/EmployeeWebService.jws
==============================================================================
--- (empty file)
+++ 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/EmployeeWebService.jws
       Fri Oct 29 19:28:01 2004
@@ -0,0 +1,70 @@
+package org;
+
+import java.rmi.RemoteException;
+import java.sql.SQLException;
+import org.apache.beehive.controls.api.bean.Control;
+//import org.apache.beehive.wsmSample.dbControlExtension.EmployeeDBControlBean;
+//import org.apache.beehive.wsmSample.dbControlExtension.Employee;
+
+
+
+
+import org.apache.beehive.wsmSample.dbControlExtension.*;
+
+
+import javax.jws.Oneway;
+import javax.jws.WebMethod;
+import javax.jws.WebParam;
+import javax.jws.WebResult;
+import javax.jws.WebService;
+
+/* 
+ * Web service to demonstrate integration of controls with drop in deploymnet.
+ */
[EMAIL PROTECTED]( targetNamespace="http://www.beehive.com/EmployeeDB";)
+public class EmployeeWebService {
+
+
+ 
+    @Control public EmployeeDBControl employeeDB;
+
+
+   
+       @WebMethod
+       public void createTable() throws RemoteException,SQLException {
+               employeeDB.createTable();
+    }
+
+    @WebMethod
+    public void dropTable() throws RemoteException,SQLException {
+       employeeDB.dropTable();
+    }
+    
+    
+    @WebMethod
+    public void insertEmployee(WSEmployee e) throws RemoteException, 
SQLException {
+        employeeDB.insertEmployee(e);
+    }
+
+    @WebMethod
+    public WSEmployee selectEmployee(int p_id) throws RemoteException, 
SQLException {
+        return employeeDB.selectEmployee(p_id);
+    }
+
+    @WebMethod
+    public WSEmployee[] selectEmployees() throws RemoteException, SQLException 
{
+        return employeeDB.selectEmployees();
+    }
+
+    @WebMethod
+    public void changeTitle(int p_id, String p_title) throws RemoteException, 
SQLException {
+        employeeDB.changeTitle(p_id, p_title);
+    }
+
+    @WebMethod
+    public void deleteEmployee(int p_id) throws RemoteException, SQLException {
+        employeeDB.deleteEmployee(p_id);
+
+    }
+
+}
\ No newline at end of file

Added: 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/apache/beehive/wsmSample/dbControlExtension/EmployeeDBControl.jcx
==============================================================================
--- (empty file)
+++ 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/apache/beehive/wsmSample/dbControlExtension/EmployeeDBControl.jcx
    Fri Oct 29 19:28:01 2004
@@ -0,0 +1,50 @@
+package org.apache.beehive.wsmSample.dbControlExtension;
+
+import java.sql.SQLException;
+import java.io.Serializable;
+import java.util.Iterator;
+import java.util.HashMap;
+
+import org.apache.beehive.controls.api.bean.ControlExtension;
+import org.apache.beehive.controls.test.controls.database.DatabaseControl;
+import 
org.apache.beehive.controls.test.controls.database.DatabaseControl.ConnectionDataSource;
+
+
[EMAIL PROTECTED]
[EMAIL PROTECTED](jndiName="jdbc:derby:build/databaseControlTestDB;create=true")
+public interface EmployeeDBControl extends DatabaseControl
+{
+     
+    @SQL(statement="CREATE TABLE EMPLOYEE ( id INT PRIMARY KEY NOT NULL, " +
+                   "fName VARCHAR(20), lName VARCHAR(20), title VARCHAR(15))")
+    public void createTable() throws SQLException;
+
+    @SQL(statement="DROP TABLE EMPLOYEE")
+    public void dropTable() throws SQLException;
+
+    @SQL(statement="INSERT INTO EMPLOYEE " +
+                   "(id, fName, lName, title) " +
+                   "VALUES ({1}, {2}, {3}, {4})")
+    public void insertEmployee(WSEmployee e) throws SQLException;
+
+    @SQL(statement="SELECT * FROM EMPLOYEE WHERE id={1}")
+    public WSEmployee selectEmployee(int p_id) throws SQLException;
+
+    @SQL(statement="SELECT * FROM EMPLOYEE ORDER BY id")
+    public WSEmployee[] selectEmployees() throws SQLException;
+
+    @SQL(statement="SELECT * FROM EMPLOYEE ORDER BY id", 
iteratorElementType=WSEmployee.class)
+    public Iterator selectEmployeesWithIterator() throws SQLException;
+
+    @SQL(statement="SELECT * FROM EMPLOYEE ORDER BY id")
+    public HashMap selectEmployeeWithHashMap() throws SQLException;
+
+    @SQL(statement="SELECT * FROM EMPLOYEE ORDER BY id", maxRows=1)
+    public WSEmployee[] selectOneEmployee() throws SQLException;
+
+    @SQL(statement="UPDATE EMPLOYEE SET title = {2} WHERE id = {1}")
+    public void changeTitle(int p_id, String p_title) throws SQLException;
+
+    @SQL(statement="DELETE FROM EMPLOYEE WHERE id = {1}")
+    public void deleteEmployee(int p_id) throws SQLException;
+}

Added: 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/apache/beehive/wsmSample/dbControlExtension/WSEmployee.java
==============================================================================
--- (empty file)
+++ 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/src/org/apache/beehive/wsmSample/dbControlExtension/WSEmployee.java
  Fri Oct 29 19:28:01 2004
@@ -0,0 +1,49 @@
+package org.apache.beehive.wsmSample.dbControlExtension;
+
+public class WSEmployee
+{
+       public int id;
+       public String fName;
+       public String lName;
+       public String title;
+
+       public WSEmployee() {
+               super();
+       }
+
+       public WSEmployee(int id, String fName, String lName, String title) {
+               this.id = id;
+               this.fName = fName;
+               this.lName = lName;
+               this.title = title;
+       }
+
+       public String toString()
+       {
+               return "[" + id + "," + fName + "," + lName + "," + title + "] 
";
+       }
+
+       public boolean equals(Object obj) {
+               if (obj == null || !(obj instanceof WSEmployee))
+                       return false;
+
+               WSEmployee emp = (WSEmployee)obj;
+
+               if (this.id != emp.id)
+                       return false;
+               else if (this.fName == null && emp.fName != null)
+                       return false;
+               else if (!this.fName.equals(emp.fName))
+                       return false;
+               else if (this.lName == null && emp.lName != null)
+                       return false;
+               else if (!this.lName.equals(emp.lName))
+                       return false;
+               else if (this.title == null && emp.title != null)
+                       return false;
+               else if (!this.title.equals(emp.title))
+                       return false;
+
+               return true;
+       }
+}

Added: 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/web.xml
==============================================================================
--- (empty file)
+++ 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/WEB-INF/web.xml  
    Fri Oct 29 19:28:01 2004
@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web
+Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd";>
+
+<web-app>
+
+  <display-name>Apache-Axis</display-name>
+    
+  <filter>
+    <filter-name>ControlFilter</filter-name>
+    
<filter-class>org.apache.beehive.controls.runtime.servlet.ControlFilter</filter-class>
+  </filter>
+
+  <filter-mapping>
+    <filter-name>ControlFilter</filter-name>
+    <url-pattern>*.jws</url-pattern>
+  </filter-mapping>
+
+  <listener>
+    
<listener-class>org.apache.axis.transport.http.AxisHTTPSessionListener</listener-class>
+  </listener>
+
+  <servlet>
+    <servlet-name>AxisServlet</servlet-name>
+    <display-name>Apache-Axis Servlet</display-name>
+    <servlet-class>
+        org.apache.axis.transport.http.AxisServlet
+    </servlet-class>
+  </servlet>
+
+  <servlet>
+    <servlet-name>AdminServlet</servlet-name>
+    <display-name>Axis Admin Servlet</display-name>
+    <servlet-class>
+        org.apache.axis.transport.http.AdminServlet
+    </servlet-class>
+    <load-on-startup>100</load-on-startup>
+  </servlet>
+
+  <servlet>
+    <servlet-name>SOAPMonitorService</servlet-name>
+    <display-name>SOAPMonitorService</display-name>
+    <servlet-class>
+        org.apache.axis.monitor.SOAPMonitorService
+    </servlet-class>
+    <init-param>
+      <param-name>SOAPMonitorPort</param-name>
+      <param-value>5001</param-value>
+    </init-param>
+    <load-on-startup>100</load-on-startup>
+  </servlet>
+
+  <servlet-mapping>
+    <servlet-name>AxisServlet</servlet-name>
+    <url-pattern>/servlet/AxisServlet</url-pattern>
+  </servlet-mapping>
+
+  <servlet-mapping>
+    <servlet-name>AxisServlet</servlet-name>
+    <url-pattern>*.jws</url-pattern>
+  </servlet-mapping>
+
+  <servlet-mapping>
+    <servlet-name>AxisServlet</servlet-name>
+    <url-pattern>/services/*</url-pattern>
+  </servlet-mapping>
+
+  <servlet-mapping>
+    <servlet-name>SOAPMonitorService</servlet-name>
+    <url-pattern>/SOAPMonitor</url-pattern>
+  </servlet-mapping>
+
+ <!-- uncomment this if you want the admin servlet -->
+ <!--
+  <servlet-mapping>
+    <servlet-name>AdminServlet</servlet-name>
+    <url-pattern>/servlet/AdminServlet</url-pattern>
+  </servlet-mapping>
+ -->
+
+    <session-config>
+        <!-- Default to 5 minute session timeouts -->
+        <session-timeout>5</session-timeout>
+    </session-config>
+
+    <!-- currently the W3C havent settled on a media type for WSDL;
+    http://www.w3.org/TR/2003/WD-wsdl12-20030303/#ietf-draft
+    for now we go with the basic 'it's XML' response -->
+  <mime-mapping>
+    <extension>wsdl</extension>
+     <mime-type>text/xml</mime-type>
+  </mime-mapping>
+  
+
+  <mime-mapping>
+    <extension>xsd</extension>
+    <mime-type>text/xml</mime-type>
+  </mime-mapping>
+
+  <welcome-file-list id="WelcomeFileList">
+    <welcome-file>index.html</welcome-file>
+    <welcome-file>index.jsp</welcome-file>
+    <welcome-file>index.jws</welcome-file>
+  </welcome-file-list>
+
+</web-app>

Added: incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/build.xml
==============================================================================
--- (empty file)
+++ incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/build.xml    
Fri Oct 29 19:28:01 2004
@@ -0,0 +1,91 @@
+<?xml version="1.0" ?>
+
+<!--
+   Copyright 2004 The Apache Software Foundation 
+ 
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+  
+      http://www.apache.org/licenses/LICENSE-2.0
+  
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+ 
+   $Header:$
+ -->
+
+<project name="ControlIntegrationExample" default="compile" basedir=".">
+
+       <taskdef name="apt" 
classname="org.apache.beehive.controls.runtime.generator.AptTask" 
classpath="lib/controls.jar" onerror="report" />
+
+
+       <property environment="env" />
+
+       <property name="build.dir" location="build" />
+       <property name="gen.dir" location="${build.dir}/gen" />
+       <property name="classes.dir" location="${build.dir}/classes" />
+       
+
+
+       <path id="build_classpath">
+               <dirset dir="${classes.dir}" />
+
+               <fileset dir="./lib">
+                       <include name="**/*.jar" />
+               </fileset>
+       </path>
+
+
+
+
+       <!-- ========================================= -->
+       <!-- build - build jar-file                    -->
+       <!-- ========================================= -->
+
+       <target name="build" depends="compile">
+               <jar jarfile="ControlIntegrationExample.jar">
+                       <fileset dir="${classes.dir}">
+                               <exclude name="**/Test.class" />
+                       </fileset>
+               </jar>
+       </target>
+
+
+       <target name="compile" depends="dirs" >
+               <apt srcdir="./WEB-INF/src" destdir="${classes.dir}" 
gendir="${gen.dir}" compileByExtension="true" 
+                       classpathref="build_classpath" 
srcExtensions="*.java,*.jcx,*.jcs,*.jws" >
+
+               </apt>
+
+       </target>
+       
+
+
+       <!-- ========================================= -->
+       <!-- dirs - create dirs required for compile   -->
+       <!-- ========================================= -->
+
+       <target name="dirs">
+               <mkdir dir="${classes.dir}" />
+               <mkdir dir="${gen.dir}" />
+       </target>
+
+
+       <!-- ========================================= -->
+       <!-- clean - remove build files                -->
+       <!-- ========================================= -->
+
+       <target name="clean">
+               <delete file="velocity.log" />
+               <delete dir="${build.dir}" />
+               <delete dir="${gen.dir}" />
+       </target>
+
+
+
+
+</project>
\ No newline at end of file

Added: 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/happyaxis.jsp
==============================================================================
--- (empty file)
+++ 
incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/happyaxis.jsp    
    Fri Oct 29 19:28:01 2004
@@ -0,0 +1,488 @@
+<html>
+<%@ page import="java.io.InputStream,
+                 java.io.IOException,
+                 javax.xml.parsers.SAXParser,
+                 javax.xml.parsers.SAXParserFactory"
+   session="false" %>
+ <%
+    /*
+ * Copyright 2002,2004 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * 
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+%>
+<head>
+<title>Axis Happiness Page</title>
+</head>
+<body bgcolor='#ffffff'>
+<%!
+
+    /*
+     * Happiness tests for axis. These look at the classpath and warn if things
+     * are missing. Normally addng this much code in a JSP page is mad
+     * but here we want to validate JSP compilation too, and have a drop-in
+     * page for easy re-use
+     * @author Steve 'configuration problems' Loughran
+     * @author dims
+     * @author Brian Ewins
+     */
+
+
+    /**
+     * Get a string providing install information.
+     * TODO: make this platform aware and give specific hints
+     */
+    public String getInstallHints(HttpServletRequest request) {
+
+        String hint=
+            "<B><I>Note:</I></B> On Tomcat 4.x and Java1.4, you may need to 
put libraries that contain "
+            +"java.* or javax.* packages into CATALINA_HOME/common/lib"
+            +"<br>jaxrpc.jar and saaj.jar are two such libraries.";
+        return hint;
+    }
+
+    /**
+     * test for a class existing
+     * @param classname
+     * @return class iff present
+     */
+    Class classExists(String classname) {
+        try {
+            return Class.forName(classname);
+        } catch (ClassNotFoundException e) {
+            return null;
+        }
+    }
+
+    /**
+     * test for resource on the classpath
+     * @param resource
+     * @return true iff present
+     */
+    boolean resourceExists(String resource) {
+        boolean found;
+        InputStream instream=this.getClass().getResourceAsStream(resource);
+        found=instream!=null;
+        if(instream!=null) {
+            try {
+                instream.close();
+            } catch (IOException e) {
+            }
+        }
+        return found;
+    }
+
+    /**
+     * probe for a class, print an error message is missing
+     * @param out stream to print stuff
+     * @param category text like "warning" or "error"
+     * @param classname class to look for
+     * @param jarFile where this class comes from
+     * @param errorText extra error text
+     * @param homePage where to d/l the library
+     * @return the number of missing classes
+     * @throws IOException
+     */
+    int probeClass(JspWriter out,
+                   String category,
+                   String classname,
+                   String jarFile,
+                   String description,
+                   String errorText,
+                   String homePage) throws IOException {
+        try {
+            Class clazz = classExists(classname);
+            if(clazz == null)  {
+               String url="";
+               if(homePage!=null) {
+                  url="<br>  See <a href="+homePage+">"+homePage+"</a>";
+               }
+               out.write("<p>"+category+": could not find class "+classname
+                   +" from file <b>"+jarFile
+                   +"</b><br>  "+errorText
+                   +url
+                   +"<p>");
+               return 1;
+            } else {
+               String location = getLocation(out, clazz);
+               if(location == null) {
+                  out.write("Found "+ description + " (" + classname + 
")<br>");
+               }
+               else {
+                  out.write("Found "+ description + " (" + classname + ") at " 
+ location + "<br>");
+               }
+               return 0;
+            }
+        } catch(NoClassDefFoundError ncdfe) { 
+            String url="";
+            if(homePage!=null) {
+                url="<br>  See <a href="+homePage+">"+homePage+"</a>";
+            }
+            out.write("<p>"+category+": could not find a dependency"
+                    +" of class "+classname
+                    +" from file <b>"+jarFile
+                    +"</b><br> "+errorText
+                    +url
+                    +"<br>The root cause was: "+ncdfe.getMessage()
+                    +"<br>This can happen e.g. if "+classname+" is in" 
+                    +" the 'common' classpath, but a dependency like "
+                    +" activation.jar is only in the webapp classpath."
+                    +"<p>");
+            return 1;
+        }
+    }
+
+    /**
+     * get the location of a class
+     * @param out
+     * @param clazz
+     * @return the jar file or path where a class was found
+     */
+
+    String getLocation(JspWriter out,
+                       Class clazz) {
+        try {
+            java.net.URL url = 
clazz.getProtectionDomain().getCodeSource().getLocation();
+            String location = url.toString();
+            if(location.startsWith("jar")) {
+                url = 
((java.net.JarURLConnection)url.openConnection()).getJarFileURL();
+                location = url.toString();
+            } 
+            
+            if(location.startsWith("file")) {
+                java.io.File file = new java.io.File(url.getFile());
+                return file.getAbsolutePath();
+            } else {
+                return url.toString();
+            }
+        } catch (Throwable t){
+        }
+        return "an unknown location";
+    }
+
+    /**
+     * a class we need if a class is missing
+     * @param out stream to print stuff
+     * @param classname class to look for
+     * @param jarFile where this class comes from
+     * @param errorText extra error text
+     * @param homePage where to d/l the library
+     * @throws IOException when needed
+     * @return the number of missing libraries (0 or 1)
+     */
+    int needClass(JspWriter out,
+                   String classname,
+                   String jarFile,
+                   String description,
+                   String errorText,
+                   String homePage) throws IOException {
+        return probeClass(out,
+                "<b>Error</b>",
+                classname,
+                jarFile,
+                description,
+                errorText,
+                homePage);
+    }
+
+    /**
+     * print warning message if a class is missing
+     * @param out stream to print stuff
+     * @param classname class to look for
+     * @param jarFile where this class comes from
+     * @param errorText extra error text
+     * @param homePage where to d/l the library
+     * @throws IOException when needed
+     * @return the number of missing libraries (0 or 1)
+     */
+    int wantClass(JspWriter out,
+                   String classname,
+                   String jarFile,
+                   String description,
+                   String errorText,
+                   String homePage) throws IOException {
+        return probeClass(out,
+                "<b>Warning</b>",
+                classname,
+                jarFile,
+                description,
+                errorText,
+                homePage);
+    }
+
+    /**
+     * probe for a resource existing,
+     * @param out
+     * @param resource
+     * @param errorText
+     * @throws Exception
+     */
+    int wantResource(JspWriter out,
+                      String resource,
+                      String errorText) throws Exception {
+        if(!resourceExists(resource)) {
+            out.write("<p><b>Warning</b>: could not find resource "+resource
+                        +"<br>"
+                        +errorText);
+            return 0;
+        } else {
+            out.write("found "+resource+"<br>");
+            return 1;
+        }
+    }
+
+
+    /**
+     *  get servlet version string
+     *
+     */
+
+    public String getServletVersion() {
+        ServletContext context=getServletConfig().getServletContext();
+        int major = context.getMajorVersion();
+        int minor = context.getMinorVersion();
+        return Integer.toString(major) + '.' + Integer.toString(minor);
+    }
+
+
+
+    /**
+     * what parser are we using.
+     * @return the classname of the parser
+     */
+    private String getParserName() {
+        SAXParser saxParser = getSAXParser();
+        if (saxParser == null) {
+            return "Could not create an XML Parser";
+        }
+
+        // check to what is in the classname
+        String saxParserName = saxParser.getClass().getName();
+        return saxParserName;
+    }
+
+    /**
+     * Create a JAXP SAXParser
+     * @return parser or null for trouble
+     */
+    private SAXParser getSAXParser() {
+        SAXParserFactory saxParserFactory = SAXParserFactory.newInstance();
+        if (saxParserFactory == null) {
+            return null;
+        }
+        SAXParser saxParser = null;
+        try {
+            saxParser = saxParserFactory.newSAXParser();
+        } catch (Exception e) {
+        }
+        return saxParser;
+    }
+
+    /**
+     * get the location of the parser
+     * @return path or null for trouble in tracking it down
+     */
+
+    private String getParserLocation(JspWriter out) {
+        SAXParser saxParser = getSAXParser();
+        if (saxParser == null) {
+            return null;
+        }
+        String location = getLocation(out,saxParser.getClass());
+        return location;
+    }
+    %>
+<html><head><title>Axis Happiness Page</title></head>
+<body>
+<h1>Axis Happiness Page</h1>
+<h2>Examining webapp configuration</h2>
+
+<p>
+<h3>Needed Components</h3>
+<%
+    int needed=0,wanted=0;
+
+    /**
+     * the essentials, without these Axis is not going to work
+     */
+    needed=needClass(out, "javax.xml.soap.SOAPMessage",
+            "saaj.jar",
+            "SAAJ API",
+            "Axis will not work",
+            "http://xml.apache.org/axis/";);
+
+    needed+=needClass(out, "javax.xml.rpc.Service",
+            "jaxrpc.jar",
+            "JAX-RPC API",
+            "Axis will not work",
+            "http://xml.apache.org/axis/";);
+
+    needed+=needClass(out, "org.apache.axis.transport.http.AxisServlet",
+            "axis.jar",
+            "Apache-Axis",
+            "Axis will not work",
+            "http://xml.apache.org/axis/";);
+
+    needed+=needClass(out, "org.apache.commons.discovery.Resource",
+            "commons-discovery.jar",
+            "Jakarta-Commons Discovery",
+            "Axis will not work",
+            "http://jakarta.apache.org/commons/discovery.html";);
+
+    needed+=needClass(out, "org.apache.commons.logging.Log",
+            "commons-logging.jar",
+            "Jakarta-Commons Logging",
+            "Axis will not work",
+            "http://jakarta.apache.org/commons/logging.html";);
+
+    needed+=needClass(out, "org.apache.log4j.Layout",
+            "log4j-1.2.8.jar",
+            "Log4j",
+            "Axis may not work",
+            "http://jakarta.apache.org/log4j";);
+
+    //should we search for a javax.wsdl file here, to hint that it needs
+    //to go into an approved directory? because we dont seem to need to do 
that.
+    needed+=needClass(out, "com.ibm.wsdl.factory.WSDLFactoryImpl",
+            "wsdl4j.jar",
+            "IBM's WSDL4Java",
+            "Axis will not work",
+            null);
+
+    needed+=needClass(out, "javax.xml.parsers.SAXParserFactory",
+            "xerces.jar",
+            "JAXP implementation",
+            "Axis will not work",
+            "http://xml.apache.org/xerces-j/";);
+
+    needed+=needClass(out,"javax.activation.DataHandler",
+            "activation.jar",
+            "Activation API",
+            "Axis will not work",
+            "http://java.sun.com/products/javabeans/glasgow/jaf.html";);
+%>
+<h3>Optional Components</h3>
+<%
+    /*
+     * now the stuff we can live without
+     */
+    wanted+=wantClass(out,"javax.mail.internet.MimeMessage",
+            "mail.jar",
+            "Mail API",
+            "Attachments will not work",
+            "http://java.sun.com/products/javamail/";);
+
+    wanted+=wantClass(out,"org.apache.xml.security.Init",
+            "xmlsec.jar",
+            "XML Security API",
+            "XML Security is not supported",
+            "http://xml.apache.org/security/";);
+
+    wanted += wantClass(out, "javax.net.ssl.SSLSocketFactory",
+            "jsse.jar or java1.4+ runtime",
+            "Java Secure Socket Extension",
+            "https is not supported",
+            "http://java.sun.com/products/jsse/";);
+    /*
+     * resources on the classpath path
+     */
+    /* broken; this is a file, not a resource
+    wantResource(out,"/server-config.wsdd",
+            "There is no server configuration file;"
+            +"run AdminClient to create one");
+    */
+    /* add more libraries here */
+
+    out.write("<h3>");
+    //is everythng we need here
+    if(needed==0) {
+       //yes, be happy
+        out.write("<i>The core axis libraries are present. </i>");
+    } else {
+        //no, be very unhappy
+        response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
+        out.write("<i>"
+                +needed
+                +" core axis librar"
+                +(needed==1?"y is":"ies are")
+                +" missing</i>");
+    }
+    //now look at wanted stuff
+    if(wanted>0) {
+        out.write("<i>"
+                +wanted
+                +" optional axis librar"
+                +(wanted==1?"y is":"ies are")
+                +" missing</i>");
+    } else {
+        out.write("The optional components are present.");
+    }
+    out.write("</h3>");
+    //hint if anything is missing
+    if(needed>0 || wanted>0 ) {
+        out.write(getInstallHints(request));
+    }
+
+    %>
+    <p>
+    <B><I>Note:</I></B> Even if everything this page probes for is present, 
there is no guarantee your
+    web service will work, because there are many configuration options that 
we do
+    not check for. These tests are <i>necessary</i> but not <i>sufficient</i>
+    <hr>
+
+    <h2>Examining Application Server</h2>
+    <%
+        String servletVersion=getServletVersion();
+        String xmlParser=getParserName();
+        String xmlParserLocation = getParserLocation(out);
+
+    %>
+    <table>
+        <tr><td>Servlet version</td><td><%= servletVersion %></td></tr>
+        <tr><td>XML Parser</td><td><%= xmlParser %></td></tr>
+        <tr><td>XML ParserLocation</td><td><%= xmlParserLocation %></td></tr>
+    </table>
+<% if(xmlParser.indexOf("crimson")>=0) { %>
+    <p>
+    <b>We recommend <a href="http://xml.apache.org/xerces2-j/";>Xerces 2</a>
+        over Crimson as the XML parser for Axis</b>
+    </p>
+<%    } %>
+
+    <h2>Examining System Properties</h2>
+<%
+    /** 
+     * Dump the system properties
+     */
+    java.util.Enumeration e=null;
+    try {
+        e= System.getProperties().propertyNames();
+    } catch (SecurityException se) {
+    }
+    if(e!=null) {
+        out.write("<pre>");
+        for (;e.hasMoreElements();) {
+            String key = (String) e.nextElement();
+            out.write(key + "=" + System.getProperty(key)+"\n");
+        }
+        out.write("</pre><p>");
+    } else {
+        out.write("System properties are not accessible<p>");
+    }
+%>
+    <hr>
+    Platform: <%= getServletConfig().getServletContext().getServerInfo()  %>
+</body>
+</html>
+
+

Added: incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/index.html
==============================================================================
--- (empty file)
+++ incubator/beehive/branches/v1/alpha/samples/EmployeeWebService/index.html   
Fri Oct 29 19:28:01 2004
@@ -0,0 +1,24 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+  <meta http-equiv="Content-Type"
+ content="text/html; charset=iso-8859-1">
+  <title>Apache-Beehive</title>
+</head>
+<body style="background-color: rgb(255, 255, 255);">
+<h1 align="center">Beehive Web Services</h1>
+<p><em>Welcome</em> to Address Book Web Service!</p>
+<p>What would you like to do today?</p>
+<ul>
+  <li> <a href="happyaxis.jsp">Validate</a> the local installation <br>
+    <i>see below if this does not work.</i> </li>
+  <li> View Employee Web Service's <a
+ href="org/EmployeeWebService.jws?wsdl">WSDL</a> </li>
+</ul>
+<h3>Validating the local configuration</h3>
+If the validation page displays an exception instead of a
+status page, the likely cause is that you have multiple XML parsers in
+your classpath. Clean up your classpath by eliminating extraneous
+parsers.
+</body>
+</html>

Reply via email to