Added faq about WebLogic 9 & SAAJ.

src/site/fml/faq.fml

@@ -80,7 +80,9 @@
                         </tr>
                         <tr>
                             <td>BEA WebLogic 9</td>
-                            <td>1.2</td>
+                            <td>1.1/1.2
+                                <sup>*</sup>
+                            </td>
                         </tr>
                         <tr>
                             <td>IBM WebSphere 6</td>
@@ -92,6 +94,10 @@
                         </tr>
                     </tbody>
                 </table>
+                <p>* = See
+                    <a href="#saaj-weblogic9">below</a>
+                    .
+                </p>
                 <p>Additionally, Java SE 6 includes SAAJ 1.3.</p>
             </answer>
         </faq>
@@ -130,6 +136,46 @@
                 </p>
             </answer>
         </faq>
+        <faq id="saaj-weblogic9">
+            <question>
+                I get a
+                <tt>UnsupportedOperationException</tt>
+                "This class does not support SAAJ 1.1" when I use SAAJ
+                under WebLogic 9. What can I do about it?
+            </question>
+            <answer>
+                <p>
+                    Weblogic 9 has a known bug in the SAAJ 1.2 implementation: it implement all the 1.2 interfaces,
+                    but throws
+                    <tt>UnsupportedOperationExceptions</tt>
+                    when you call them.
+                    Confusingly, the exception message is
+                    <tt>This class does not support SAAJ 1.1</tt>
+                    , even though
+                    supports SAAJ 1.1 just fine; it just doesn't support SAAJ
+                    <strong>1.2</strong>
+                    .
+                    See also
+                    <a href="http://forums.bea.com/bea/thread.jspa?threadID=600007964">this BEA forum post</a>
+                    .
+                </p>
+                <p>
+                    Spring-WS has a workaround for this, we basically use SAAJ 1.1 only when dealing with Weblogic 9.
+                    Unfortunately, other frameworks which depend on SAAJ, such as XWSS, do not have this workaround.
+                    These frameworks happily call SAAJ 1.2 methods, which throw this exception.
+                </p>
+                <p>
+                    The solution is to not use BEA's version of SAAJ, but to use another implementation, like the one
+                    from Axis 1, or SUN. In you application context, use the following:
+                    <pre>
+                        &lt;bean id=&quot;messageFactory&quot; class=&quot;org.springframework.ws.soap.saaj.SaajSoapMessageFactory&quot;&gt;
+                        &lt;property name=&quot;messageFactory&quot;&gt;
+                        &lt;bean class=&quot;com.sun.xml.messaging.saaj.soap.MessageFactoryImpl&quot;/&gt;
+                        &lt;/bean&gt;
+                    </pre>
+                </p>
+            </answer>
+        </faq>
     </part>
     <part id="wsdl">
         <title>WSDL</title>