Often you have to copy the maven settings.xml file which is configured for a specific customer. But while developing in my spare time I just want to use my own settings.xml file. The easiest way to switch to using a different file is shown below:
mvn -gs $M2_HOME/conf/settings_pelssers.xml clean install
Connectivity has been setup from our staging environment to the third party server (endpoint of our soap clients). However, I wanted to connect locally with SOAP UI to this server, so I needed to setup an ssh tunnel with portforwarding on my macbook. I used to do this with putty on windows in the past so it took me a bit longer to figure this out.
Let's say the endpoint used from our staging environment would be "http://3rdpartyhostname/coolservice". In this case I want to listen on port 8877, and forward traffic from this port using the ssh tunnel to 3rdpartyhostname on port 80
ssh -f username@staginghostname -L 8877:3rdpartyhostname:80 -N
Now I can connect in SOAPUI to the following endpoint "http://localhost:8877/coolservice"
Often you have to deal with WSDL's from third parties. Sometimes the WSDL including referenced schemas are setup crappy and you run into issues while converting the WSDL to Java. Below we will look into how to fix these issues.
| <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" | |
| xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> | |
| <modelVersion>4.0.0</modelVersion> | |
| <groupId>com.pelssers</groupId> | |
| <artifactId>objectfactory</artifactId> | |
| <version>0.0.1-SNAPSHOT</version> | |
| <properties> | |
| <cxf.version>2.7.8</cxf.version> | |
| <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> | |
| </properties> | |
| <build> | |
| <defaultGoal>clean generate-sources install</defaultGoal> | |
| <plugins> | |
| <plugin> | |
| <groupId>org.apache.cxf</groupId> | |
| <artifactId>cxf-codegen-plugin</artifactId> | |
| <version>${cxf.version}</version> | |
| <executions> | |
| <execution> | |
| <id>generate-sources</id> | |
| <phase>generate-sources</phase> | |
| <configuration> | |
| <sourceRoot>${project.build.directory}/generated/cxf</sourceRoot> | |
| <wsdlOptions> | |
| <wsdlOption> | |
| <wsdl>${basedir}/src/main/resources/helloworld.wsdl</wsdl> | |
| <extraargs> | |
| <extraarg>-frontend</extraarg> | |
| <extraarg>jaxws21</extraarg> | |
| <extraarg>-p</extraarg> | |
| <extraarg>http://com.pelssers.helloworld/=com.pelssers.helloworld</extraarg> | |
| <extraarg>-p</extraarg> | |
| <extraarg>http://com.pelssers.helloworld/wrapper=com.pelssers.helloworld.wrapper</extraarg> | |
| <extraarg>-b</extraarg> | |
| <extraarg>${basedir}/src/main/resources/bindings.xml</extraarg> | |
| </extraargs> | |
| </wsdlOption> | |
| </wsdlOptions> | |
| </configuration> | |
| <goals> | |
| <goal>wsdl2java</goal> | |
| </goals> | |
| </execution> | |
| </executions> | |
| </plugin> | |
| </plugins> | |
| </build> | |
| <dependencies> | |
| <dependency> | |
| <groupId>org.apache.cxf.xjc-utils</groupId> | |
| <artifactId>cxf-xjc-runtime</artifactId> | |
| <version>2.6.1</version> | |
| </dependency> | |
| </dependencies> | |
| </project> |
| <definitions targetNamespace="http://com.pelssers.helloworld/" | |
| name="HelloWorldService" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" | |
| xmlns:tns="http://com.pelssers.helloworld/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" | |
| xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:wrapper="http://com.pelssers.helloworld/wrapper"> | |
| <types> | |
| <xsd:schema> | |
| <xsd:import namespace="http://com.pelssers.helloworld/wrapper" | |
| schemaLocation="xsd/helloworld.xsd" /> | |
| </xsd:schema> | |
| </types> | |
| <message name="helloWorldFault"> | |
| <part name="fault" element="wrapper:error" /> | |
| </message> | |
| <message name="helloWorldRequest"> | |
| <part name="parameters" element="wrapper:helloWorldRequest"/> | |
| </message> | |
| <message name="helloWorldResponse"> | |
| <part name="parameters" element="wrapper:helloWorldResponse"/> | |
| </message> | |
| <portType name="HelloWorldService"> | |
| <operation name="sayHi"> | |
| <input message="tns:helloWorldRequest" /> | |
| <output message="tns:helloWorldResponse" /> | |
| <fault name="helloWorldFault" message="tns:helloWorldFault" /> | |
| </operation> | |
| </portType> | |
| <binding name="HelloWorldServicePortBinding" type="tns:HelloWorldService"> | |
| <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document" /> | |
| <operation name="sayHi"> | |
| <soap:operation soapAction="" /> | |
| <input> | |
| <soap:body use="literal" /> | |
| </input> | |
| <output> | |
| <soap:body use="literal" /> | |
| </output> | |
| <fault name="helloWorldFault"> | |
| <soap:fault name="helloWorldFault" use="literal" /> | |
| </fault> | |
| </operation> | |
| </binding> | |
| <service name="HelloWorldService"> | |
| <port name="HelloWorldServicePort" binding="tns:HelloWorldServicePortBinding"> | |
| <soap:address location="http://localhost:7001/HelloWorldService" /> | |
| </port> | |
| </service> | |
| </definitions> |
| <?xml version='1.0' encoding='UTF-8'?> | |
| <xs:schema xmlns:tns="http://com.pelssers.helloworld/wrapper" | |
| xmlns:xs="http://www.w3.org/2001/XMLSchema" version="1.0" | |
| targetNamespace="http://com.pelssers.helloworld/wrapper"> | |
| <xs:element name="helloWorldRequest" type="tns:HelloWorldRequestType" /> | |
| <xs:element name="helloWorldResponse" type="tns:HelloWorldResponseType" /> | |
| <xs:element name="error" type="tns:errorType"/> | |
| <xs:element name="unused" type="xs:string"/> | |
| <xs:element name="Unused" type="xs:integer"/> | |
| <xs:complexType name="HelloWorldRequestType"> | |
| <xs:sequence> | |
| <xs:element name="firstName" type="xs:string"/> | |
| <xs:element name="first_name" type="xs:string"/> | |
| <xs:element name="lastName" type="xs:string"/> | |
| </xs:sequence> | |
| </xs:complexType> | |
| <xs:complexType name="HelloWorldResponseType"> | |
| <xs:sequence> | |
| <xs:element name="greeting" type="xs:string"/> | |
| </xs:sequence> | |
| </xs:complexType> | |
| <xs:complexType name="reasonType"> | |
| <xs:simpleContent> | |
| <xs:extension base="xs:string" /> | |
| </xs:simpleContent> | |
| </xs:complexType> | |
| <xs:complexType name="ReasonType"> | |
| <xs:simpleContent> | |
| <xs:extension base="xs:string" /> | |
| </xs:simpleContent> | |
| </xs:complexType> | |
| <xs:complexType name="errorType"> | |
| <xs:sequence> | |
| <xs:element name="errorCode" type="xs:string"/> | |
| <xs:element name="detail" type="xs:string"/> | |
| <xs:element name="reason" type="tns:reasonType"/> | |
| </xs:sequence> | |
| </xs:complexType> | |
| </xs:schema> | |
| <jaxb:bindings version="2.1" xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" | |
| xmlns:xjc="http://java.sun.com/xml/ns/jaxb/xjc" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> | |
| <jaxb:globalBindings generateElementProperty="false"> | |
| <jaxb:javaType name="java.util.Date" xmlType="xsd:dateTime" | |
| parseMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.parseDateTime" | |
| printMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.printDateTime" /> | |
| <jaxb:javaType name="java.util.Date" xmlType="xsd:date" | |
| parseMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.parseDateTime" | |
| printMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.printDateTime" /> | |
| <jaxb:javaType name="java.util.Date" xmlType="xsd:time" | |
| parseMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.parseTime" | |
| printMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.printTime" /> | |
| </jaxb:globalBindings> | |
| </jaxb:bindings> |
Eclipse will complain with following message
[ERROR] file:/playground/objectfactory/src/main/resources/xsd/helloworld.xsd [32,3]:
(Relevant to above error) another "ReasonType" is generated from here.
[ERROR] file:/playground/objectfactory/src/main/resources/xsd/helloworld.xsd [32,3]:
Two declarations cause a collision in the ObjectFactory class.
[ERROR] file:/playground/objectfactory/src/main/resources/xsd/helloworld.xsd [26,3]:
(Related to above error) This is the other declaration.
[ERROR] file:/playground/objectfactory/src/main/resources/xsd/helloworld.xsd [9,3]:
Two declarations cause a collision in the ObjectFactory class.
[ERROR] file:/playground/objectfactory/src/main/resources/xsd/helloworld.xsd [10,3]:
(Related to above error) This is the other declaration.
[ERROR] file:/playground/objectfactory/src/main/resources/xsd/helloworld.xsd [15,7]:
Two declarations cause a collision in the ObjectFactory class.
[ERROR] file:/playground/objectfactory/src/main/resources/xsd/helloworld.xsd [14,7]:
(Related to above error) This is the other declaration. A class/interface with the same
name "com.pelssers.helloworld.wrapper.ReasonType" is already in use.
Use a class customization to resolve this conflict.
Below a version that fixes all issues. Ps. Sometimes it might also be useful to add @underscoreBinding="asCharInWord" to the globalBindings.
| <jaxb:bindings version="2.1" xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" | |
| xmlns:xjc="http://java.sun.com/xml/ns/jaxb/xjc" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> | |
| <jaxb:globalBindings generateElementProperty="false"> | |
| <jaxb:javaType name="java.util.Date" xmlType="xsd:dateTime" | |
| parseMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.parseDateTime" | |
| printMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.printDateTime" /> | |
| <jaxb:javaType name="java.util.Date" xmlType="xsd:date" | |
| parseMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.parseDateTime" | |
| printMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.printDateTime" /> | |
| <jaxb:javaType name="java.util.Date" xmlType="xsd:time" | |
| parseMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.parseTime" | |
| printMethod="org.apache.cxf.xjc.runtime.DataTypeAdapter.printTime" /> | |
| </jaxb:globalBindings> | |
| <jaxb:bindings schemaLocation="xsd/helloworld.xsd"> | |
| <jaxb:bindings | |
| node="//xsd:complexType[@name='HelloWorldRequestType']/xsd:sequence/xsd:element[@name='firstName']"> | |
| <jaxb:property name="firstName1" /> | |
| </jaxb:bindings> | |
| <jaxb:bindings | |
| node="//xsd:complexType[@name='HelloWorldRequestType']/xsd:sequence/xsd:element[@name='first_name']"> | |
| <jaxb:property name="firstName2" /> | |
| </jaxb:bindings> | |
| <jaxb:bindings node="//xsd:complexType[@name='reasonType']"> | |
| <jaxb:class name="ReasonType1" /> | |
| </jaxb:bindings> | |
| <jaxb:bindings node="//xsd:complexType[@name='ReasonType']"> | |
| <jaxb:class name="ReasonType2" /> | |
| </jaxb:bindings> | |
| <jaxb:bindings node="xsd:element[@name='unused']"> | |
| <jaxb:factoryMethod name="String"/> | |
| </jaxb:bindings> | |
| <jaxb:bindings node="xsd:element[@name='Unused']"> | |
| <jaxb:factoryMethod name="Integer"/> | |
| </jaxb:bindings> | |
| </jaxb:bindings> | |
| </jaxb:bindings> |