diff --git a/src/site/apt/faq.apt b/src/site/apt/faq.apt index 6db354d7..db60a460 100644 --- a/src/site/apt/faq.apt +++ b/src/site/apt/faq.apt @@ -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. diff --git a/src/site/fml/faq2.fml b/src/site/fml/faq2.fml new file mode 100644 index 00000000..6e9ec6e4 --- /dev/null +++ b/src/site/fml/faq2.fml @@ -0,0 +1,176 @@ + + + + Java + + Does Spring-WS work under Java 1.4? + +

+ 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 + this FAQ + entry on the Xalan site, and also + this entry + on the Xerces site. +

+

+ 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. +

+
+
+ + Why do the Spring-WS unit tests fail under Mac OS X? + +

+ 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. +

+

+ The jar can be found at + + /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Classes/.compatibility/14compatibility.jar + + . + You can safely remove or rename it, and the tests will run again. +

+
+
+
+ + SAAJ + + What is SAAJ? + + 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 + Java Web Service + Developer Pack + + , and also as part of J2EE 1.4. SAAJ is generally known as the package + javax.xml.soap + . + + + + What version of SAAJ does my application server support? + + + + + + + + + + + + + + + + + + + + + + + + +
Application ServerSAAJ Version
BEA WebLogic 81.1
BEA WebLogic 91.2
IBM WebSphere 61.2
SUN Glassfish 11.3
+

Additionally, Java SE 6 includes SAAJ 1.3.

+
+
+ + I get an + NoSuchMethodError + when using SAAJ. What can I do about it? + + +

If you get the following stack trace:

+ + 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; + +

+ Like most J2EE libraries, SAAJ consists of two parts: the API that consists of interfaces ( + saaj-api.jar + ) and the implementation ( + saaj-impl.jar + ). + 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. +

+

+ 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. +

+
+
+
+ + WSDL + + How do I retrieve the WSDL from a Service? The &WSDL query parameter does not work. + +

+ The &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. +

+

+ There are two ways to expose a WSDL: +

    +
  • + 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 + airline-servlet.xml + , we define an + WsdlDefinitionHandlerAdapter + there, which + transforms the + location. +
  • +
  • Use the + MessageDispatcherServlet + , which is done is the echo sample. Every + WsdlDefinition + listed in the + *-servlet.xml + will be exposed under the bean name. So if you define a + WsdlDefinition + named + echo + , it will be + exposed as + echo.wsdl + . (i.e. + http://localhost:8080/echo/echo.wsdl + + ). +
  • +
+

+
+
+
+
diff --git a/src/site/resources/css/javadoc.css b/src/site/resources/css/javadoc.css new file mode 100644 index 00000000..98e5237c --- /dev/null +++ b/src/site/resources/css/javadoc.css @@ -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;} diff --git a/src/site/resources/images/logos/contegix.png b/src/site/resources/images/logos/contegix.png new file mode 100644 index 00000000..c982b5f6 Binary files /dev/null and b/src/site/resources/images/logos/contegix.png differ diff --git a/src/site/resources/images/logos/jira.png b/src/site/resources/images/logos/jira.png new file mode 100644 index 00000000..006aca67 Binary files /dev/null and b/src/site/resources/images/logos/jira.png differ diff --git a/src/site/resources/images/logos/powered-by-spring_small.png b/src/site/resources/images/logos/powered-by-spring_small.png new file mode 100644 index 00000000..49bc53cc Binary files /dev/null and b/src/site/resources/images/logos/powered-by-spring_small.png differ diff --git a/src/site/resources/images/logos/s101d.png b/src/site/resources/images/logos/s101d.png new file mode 100644 index 00000000..4d4939c1 Binary files /dev/null and b/src/site/resources/images/logos/s101d.png differ diff --git a/src/site/site.xml b/src/site/site.xml index e6e5084b..420b9d02 100644 --- a/src/site/site.xml +++ b/src/site/site.xml @@ -3,38 +3,46 @@ org.springframework.maven.skins maven-spring-skin - 1.0 - - - http://www.springframework.org/files/xdev-spring_logo.jpg - http://www.springframework.org/spring-ws - - - http://www.springframework.org/files/banners/i21-banner-stamped.jpg - http://www.springframework.com/ - - - - - - - - - - - - - - - - - - - - - - - - - + 1.0.1-SNAPSHOT + + + + http://www.springframework.org/files/xdev-spring_logo.jpg + http://www.springframework.org/spring-ws + + + http://www.springframework.org/files/banners/i21-banner-stamped.jpg + http://www.springframework.com/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file