| <!doctype HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <html> |
| <head> |
| <meta http-equiv=Content-Type content="text/html; charset=ISO-8859-1"> |
| <!-- /******************************************************************************* |
| * Copyright (c) 2000, 2006 IBM Corporation and others. |
| * All rights reserved. This program and the accompanying materials |
| * are made available under the terms of the Eclipse Public License v1.0 |
| * which accompanies this distribution, and is available at |
| * http://www.eclipse.org/legal/epl-v10.html |
| * |
| * Contributors: |
| * IBM Corporation - initial API and implementation |
| *******************************************************************************/ --> |
| <link rel="stylesheet" type="text/css" |
| href="../../org.eclipse.wst.doc.user/common.css" > |
| <title>Web Tools Platform Limitations and Known Issues</title> |
| </head> |
| <body> |
| <h1>Web Tools Platform Limitations and Known Issues</h1> |
| <p>The following are limitations and known issues:</p> |
| <dl> |
| <dt class="dlterm"><b>When using XDoclet the generation does not appear to run.</b></dt> |
| <dd><p>Cause: XDoclet has some limitations with long path names.</p> |
| <p>Solution: You should install Eclipse and the Web Tools Platform into a directory with a short |
| path.</p> |
| </dd> |
| <dt class="dlterm"><b>When creating a Web service you may see a message similar to the following one:</b></dt> |
| <dd><p><samp>org.apache.axis.utils.JavaUtils isAttachmentSupported |
| WARNING: Unable to find required classes (javax.activation.DataHandler and |
| javax.mail.internet.MimeMultipart). Attachment support is disabled. |
| </samp></p> |
| <p>Cause: Attachment support is disabled.</p> |
| <p>Solution: The Apache Axis tools should auto-detect the javax.activation classes provided you add |
| <samp>activation.jar</samp> to the build path of the project to which you are generating your Web service or client. |
| For services, you will also need to make sure <samp>activation.jar</samp> is available to the Tomcat JRE, either by |
| including it in the server's global classpath or by placing a copy of activation.jar into the target Web |
| project's <samp>lib/</samp> directory. |
| </p> |
| </dd> |
| <dt class="dlterm"><b>Problems encountered publishing from dynamic Web projects with non-ASCII characters in the context root</b></dt> |
| <dd> |
| <p>Cause: By default the context root of a dynamic Web project uses the project name. If non-ASCII characters are used as project names for dynamic Web projects, |
| the default context root causes problems when trying to publish from the Web project.</p> |
| <p>You may encounter the following errors if this occurs: |
| <ul> |
| <li>If you create a dynamic Web project with non-ASCII characters (leaving the context root |
| to default to the project name containing non ASCII characters) and try to |
| publish, you will see an error message similar to "The requested resource is not available".</li> |
| <li>If a dynamic Web project containing a non-ASCII context root is used in an Axis1 Web service creation |
| scenario, you will see an error message similar to "Unable to deploy to Axis".</li> |
| </ul> |
| <p>Solution: The following ASCII characters are valid in the context root: all letters, all numbers, an underscore, a hyphen (dash), a forward slash, or a period.</p> |
| </dd> |
| </dl> |
| </body> |
| </html> |
