<%@ 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. */ %> Axis Happiness Page <%! /* * 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= "Note: On Tomcat 4.x and Java1.4, you may need to put libraries that contain " +"java.* or javax.* packages into CATALINA_HOME/common/lib" +"
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="
See "+homePage+""; } out.write("

"+category+": could not find class "+classname +" from file "+jarFile +"
"+errorText +url +"

"); return 1; } else { String location = getLocation(out, clazz); if(location == null) { out.write("Found "+ description + " (" + classname + ")
"); } else { out.write("Found "+ description + " (" + classname + ") at " + location + "
"); } return 0; } } catch(NoClassDefFoundError ncdfe) { String url=""; if(homePage!=null) { url="
See "+homePage+""; } out.write("

"+category+": could not find a dependency" +" of class "+classname +" from file "+jarFile +"
"+errorText +url +"
The root cause was: "+ncdfe.getMessage() +"
This can happen e.g. if "+classname+" is in" +" the 'common' classpath, but a dependency like " +" activation.jar is only in the webapp classpath." +"

"); 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, "Error", 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, "Warning", 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("

Warning: could not find resource "+resource +"
" +errorText); return 0; } else { out.write("found "+resource+"
"); 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; } %> Axis Happiness Page

Axis Happiness Page

Examining webapp configuration

Needed Components

<% 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"); %>

Optional Components

<% /* * 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("

"); //is everythng we need here if(needed==0) { //yes, be happy out.write("The core axis libraries are present. "); } else { //no, be very unhappy response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR); out.write("" +needed +" core axis librar" +(needed==1?"y is":"ies are") +" missing"); } //now look at wanted stuff if(wanted>0) { out.write("" +wanted +" optional axis librar" +(wanted==1?"y is":"ies are") +" missing"); } else { out.write("The optional components are present."); } out.write("

"); //hint if anything is missing if(needed>0 || wanted>0 ) { out.write(getInstallHints(request)); } %>

Note: 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 necessary but not sufficient


Examining Application Server

<% String servletVersion=getServletVersion(); String xmlParser=getParserName(); String xmlParserLocation = getParserLocation(out); %>
Servlet version<%= servletVersion %>
XML Parser<%= xmlParser %>
XML ParserLocation<%= xmlParserLocation %>
<% if(xmlParser.indexOf("crimson")>=0) { %>

We recommend Xerces 2 over Crimson as the XML parser for Axis

<% } %>

Examining System Properties

<% /** * Dump the system properties */ java.util.Enumeration e=null; try { e= System.getProperties().propertyNames(); } catch (SecurityException se) { } if(e!=null) { out.write("
");
        for (;e.hasMoreElements();) {
            String key = (String) e.nextElement();
            out.write(key + "=" + System.getProperty(key)+"\n");
        }
        out.write("

"); } else { out.write("System properties are not accessible

"); } %>


Platform: <%= getServletConfig().getServletContext().getServerInfo() %>