Added logo's, and made site nicer in general

This commit is contained in:
Arjen Poutsma
2007-03-08 17:57:25 +00:00
parent 4a35124b83
commit 3aa579f97e
8 changed files with 274 additions and 42 deletions

View File

@@ -41,14 +41,14 @@ Frequently Asked Questions
See below:
*--------------------+--------------+
| Application Server | SAAJ Version |
*--------------------+--------------+
| BEA WebLogic 8 | 1.1 |
| BEA WebLogic 9 | 1.2 |
| IBM WebSphere 6 | 1.2 |
| SUN Glassfish | 1.3 |
*--------------------+--------------+
*---------------------+----------------+
|| Application Server || SAAJ Version ||
*---------------------+----------------+
| BEA WebLogic 8 | 1.1 |
| BEA WebLogic 9 | 1.2 |
| IBM WebSphere 6 | 1.2 |
| SUN Glassfish | 1.3 |
*---------------------+----------------+
Additionally, Java SE 6 includes SAAJ 1.3.

176
src/site/fml/faq2.fml Normal file
View File

@@ -0,0 +1,176 @@
<?xml version="1.0" encoding="UTF-8"?>
<faqs title="Frequently Asked Questions" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://maven.apache.org/maven-1.x/plugins/faq/faq.xsd">
<part id="java">
<title>Java</title>
<faq id="java-1.4">
<question>Does Spring-WS work under Java 1.4?</question>
<answer>
<p>
Spring Web Services works under Java 1.4, but it requires some effort to make it work. Java 1.4 is
bundled with the older XML parser Crimson, which does not handle namespaces correctly. Additionally,
it is bundled with an older version of Xalan, which also has problems.
Unfortunately, placing newer versions of these on the class path does not override them.
See
<a href="http://xml.apache.org/xalan-j/faq.html#faq-N100D6">this FAQ</a>
entry on the Xalan site, and also
<a href="http://xerces.apache.org/xerces2-j/faq-general.html#faq-4">this entry</a>
on the Xerces site.
</p>
<p>
The only solution that works is to add newer versions of Xerces and Xalan in the lib/endorsed
directory of your JDK, as explained in those FAQs.
</p>
</answer>
</faq>
<faq id="osx">
<question>Why do the Spring-WS unit tests fail under Mac OS X?</question>
<answer>
<p>
For some reason, Apple decided to include a Java 1.4 compatibility jar with their JDK 1.5. This jar
includes the XML parsers which were included in Java 1.4. No other JDK distribution does this, so it
is unclear what the purpose of this compatibility jar is.
</p>
<p>
The jar can be found at
<tt>
/System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Classes/.compatibility/14compatibility.jar
</tt>
.
You can safely remove or rename it, and the tests will run again.
</p>
</answer>
</faq>
</part>
<part id="saaj">
<title>SAAJ</title>
<faq id="whats-saaj">
<question>What is SAAJ?</question>
<answer>
SAAJ is the SOAP with Attachments API for Java. Previously, it has been part of JAXM, but it has been
released as a seperate API as part of the
<a href="http://java.sun.com/webservices/jwsdp/index.jsp">Java Web Service
Developer Pack
</a>
, and also as part of J2EE 1.4. SAAJ is generally known as the package
<tt>javax.xml.soap</tt>
.
</answer>
</faq>
<faq id="saaj-versions">
<question>What version of SAAJ does my application server support?</question>
<answer>
<table class="bodyTable">
<tbody>
<tr>
<th>Application Server</th>
<th>SAAJ Version</th>
</tr>
<tr>
<td>BEA WebLogic 8</td>
<td>1.1</td>
</tr>
<tr>
<td>BEA WebLogic 9</td>
<td>1.2</td>
</tr>
<tr>
<td>IBM WebSphere 6</td>
<td>1.2</td>
</tr>
<tr>
<td>SUN Glassfish 1</td>
<td>1.3</td>
</tr>
</tbody>
</table>
<p>Additionally, Java SE 6 includes SAAJ 1.3.</p>
</answer>
</faq>
<faq id="saaj-nosuchmethod">
<question>I get an
<tt>NoSuchMethodError</tt>
when using SAAJ. What can I do about it?
</question>
<answer>
<p>If you get the following stack trace:</p>
<code>
org.springframework.beans.factory.BeanCreationException: Error creating bean with name
'org.springframework.ws.soap.saaj.SaajSoapMessageContextFactory#e4cb82' defined in ServletContext
resource [/WEB-INF/springws-servlet.xml]: Invocation of init method failed;
nested exception is java.lang.NoSuchMethodError:
javax.xml.soap.MessageFactory.newInstance(Ljava/lang/String;)Ljavax/xml/soap/MessageFactory;
Caused by:
java.lang.NoSuchMethodError:
javax.xml.soap.MessageFactory.newInstance(Ljava/lang/String;)Ljavax/xml/soap/MessageFactory;
</code>
<p>
Like most J2EE libraries, SAAJ consists of two parts: the API that consists of interfaces (
<tt>saaj-api.jar</tt>
) and the implementation (
<tt>saaj-impl.jar</tt>
).
The stack trace is due to the fact that you are using a new version of the API (SAAJ 1.3), while
your application server provides an earlier version of the implementation (SAAJ 1.2 or even 1.1).
Spring-WS supports all three versions of SAAJ (1.1 through 1.3), but things break when it sees
the 1.3 API, while there is no 1.3 implementation.
</p>
<p>
The solution therefore is quite simple: to remove the newer 1.3 version of the API, from the class
path, and replace it with the version supported by your application server.
</p>
</answer>
</faq>
</part>
<part id="wsdl">
<title>WSDL</title>
<faq id="wsdl-retrieve">
<question>How do I retrieve the WSDL from a Service? The &amp;WSDL query parameter does not work.</question>
<answer>
<p>
The &amp;WSDL query parameter is a way to get a WSDL of a class. In SWS, a service is generally not
implemented as a single class, but as a collection of endpoints.
</p>
<p>
There are two ways to expose a WSDL:
<ul>
<li>
Simply add the WSDL to the root of the WAR, and the file is served normally. This has the
disadvantage
that the "location" attribute in the WSDL is static, i.e. it does not necessarily reflect
the
host name
of
the
server. That is why in the airline sample
<tt>airline-servlet.xml</tt>
, we define an
<tt>WsdlDefinitionHandlerAdapter</tt>
there, which
transforms the
location.
</li>
<li>Use the
<tt>MessageDispatcherServlet</tt>
, which is done is the echo sample. Every
<tt>WsdlDefinition</tt>
listed in the
<tt>*-servlet.xml</tt>
will be exposed under the bean name. So if you define a
<tt>WsdlDefinition</tt>
named
<tt>echo</tt>
, it will be
exposed as
<tt>echo.wsdl</tt>
. (i.e.
<tt>http://localhost:8080/echo/echo.wsdl
</tt>
).
</li>
</ul>
</p>
</answer>
</faq>
</part>
</faqs>

View File

@@ -0,0 +1,48 @@
/* Spring-specific Javadoc style sheet rules */
#overviewBody {
}
.code {
border: 1px solid black;
background-color: #F4F4F4;
padding: 5px;
}
/* Vanilla Javadoc style sheet rules */
body {
font-family: Arial;
background-color: white;
font-size: 10pt;
}
td { font-size: 10pt; font-family: Arial }/* Javadoc style sheet */
/* Define colors, fonts and other style attributes here to override the defaults */
/* Page background color */
body { background-color: #FFFFFF }
/* Headings */
h1 { font-size: 145% }
/* Table colors */
.TableHeadingColor { background: #CCCCFF } /* Dark mauve */
.TableSubHeadingColor { background: #EEEEFF } /* Light mauve */
.TableRowColor { background: #FFFFFF } /* White */
/* Font used in left-hand frame lists */
.FrameTitleFont { font-size: 100%; font-family: Helvetica, Arial, sans-serif }
.FrameHeadingFont { font-size: 90%; font-family: Helvetica, Arial, sans-serif }
.FrameItemFont { font-size: 90%; font-family: Helvetica, Arial, sans-serif }
/* Navigation bar fonts and colors */
.NavBarCell1 { background-color:#EEEEFF;} /* Light mauve */
.NavBarCell1Rev { background-color:#00008B;} /* Dark Blue */
.NavBarFont1 { font-family: Arial, Helvetica, sans-serif; color:#000000;}
.NavBarFont1Rev { font-family: Arial, Helvetica, sans-serif; color:#FFFFFF;}
.NavBarCell2 { font-family: Arial, Helvetica, sans-serif; background-color:#FFFFFF;}
.NavBarCell3 { font-family: Arial, Helvetica, sans-serif; background-color:#FFFFFF;}

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 KiB

View File

@@ -3,38 +3,46 @@
<skin>
<groupId>org.springframework.maven.skins</groupId>
<artifactId>maven-spring-skin</artifactId>
<version>1.0</version>
</skin>
<bannerLeft>
<src>http://www.springframework.org/files/xdev-spring_logo.jpg</src>
<href>http://www.springframework.org/spring-ws</href>
</bannerLeft>
<bannerRight>
<src>http://www.springframework.org/files/banners/i21-banner-stamped.jpg</src>
<href>http://www.springframework.com/</href>
</bannerRight>
<body>
<links>
<item name="Spring Framework" href="http://www.springframework.org/" />
<item name="Spring Web Services" href="http://www.springframework.org/spring-ws/" />
</links>
<menu name="Overview">
<item name="Home" href="/"/>
</menu>
<menu name="Downloads">
<item name="Releases" href="downloads/releases.html"/>
<item name="Snapshots" href="downloads/snapshots.html"/>
</menu>
<menu name="Documentation">
<item name="FAQ" href="faq.html"/>
<item name="Upgrading" href="upgrading.html"/>
<item name="Tutorial" href="tutorial/tutorial1.html"/>
<item name="Resources &amp; Tools" href="resources.html"/>
</menu>
<menu name="Support">
<item name="Support Forums" href="http://forum.springframework.org/forumdisplay.php?f=39"/>
<item name="JIRA" href="http://opensource.atlassian.com/projects/spring/browse/SWS"/>
</menu>
<menu ref="reports" />
</body>
<version>1.0.1-SNAPSHOT</version>
</skin>
<publishDate position="top" format="dd-MM-yy"/>
<bannerLeft>
<src>http://www.springframework.org/files/xdev-spring_logo.jpg</src>
<href>http://www.springframework.org/spring-ws</href>
</bannerLeft>
<bannerRight>
<src>http://www.springframework.org/files/banners/i21-banner-stamped.jpg</src>
<href>http://www.springframework.com/</href>
</bannerRight>
<body>
<links>
<item name="Spring Framework" href="http://www.springframework.org/"/>
<item name="Spring Web Services" href="http://www.springframework.org/spring-ws/"/>
</links>
<menu name="Overview">
<item name="Home" href="/"/>
<item name="Downloads" href="downloads/releases.html"/>
</menu>
<menu name="Documentation">
<item name="API" href="apidocs/index.html"/>
<item name="Reference"
href="http://static.springframework.org/spring-ws/docs/1.0-m3/reference/html/index.html"/>
<item name="FAQ" href="faq.html"/>
<item name="Upgrading" href="upgrading.html"/>
<item name="Tutorial" href="tutorial/tutorial1.html"/>
<item name="Resources &amp; Tools" href="resources.html"/>
</menu>
<menu name="Support">
<item name="Support Forums" href="http://forum.springframework.org/forumdisplay.php?f=39"/>
<item name="JIRA" href="http://opensource.atlassian.com/projects/spring/browse/SWS"/>
</menu>
<menu ref="reports"/>
</body>
<poweredBy>
<logo name="Powered by Spring" href="http://www.springframework.org" img="images/logos/powered-by-spring_small.png"/>
<logo name="Hosted on SourceForge.net" href="http://sourceforge.net" img="http://sourceforge.net/sflogo.php?group_id=73357&amp;type=1"/>
<logo name="Powered by JIRA" href="http://www.atlassian.com/software/jira/" img="images/logos/jira.png"/>
<logo name="Powered by Structure 101" href="http://www.headwaysoftware.com/products/structure101/" img="images/logos/s101d.png"/>
<logo name="Build with Maven 2" href="http://maven.apache.org" img="images/logos/maven-feather.png"/>
</poweredBy>
</project>