Share |

JAX-WS Start From WSDL-doc style

JAX-WS supports both Start from Java and Start from WSDL approch. Let's look into how we can build a webservice with a WSDL first approach. Again the WSDL can be of doc style or rpc style. From Java perspective that does not make much of difference. The difference in doc style and rpc style make more of difference in how you think about when you first write WSDL for webservice.

Let's suppose we have a WSDL which is a doc style. Let's have a WSDL which is for Temperature conversion. This WSDL provides two service. To convert Farenheit to Celsius and vice versa.
WSDL:


<definitions targetNamespace="http://ws.crayom.com/"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:tns="http://ws.crayom.com/"
xmlns:omTypes="http://crayom.com/omTypes"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
name="TemperatureConvertorService">

<types>
<xsd:schema targetNamespace="http://crayom.com/omTypes"
    xmlns="http://www.w3.org/2001/XMLSchema"
    xmlns:omTypes="http://crayom.com/omTypes"
    elementFormDefault="qualified">

<complexType name="temperatureCelsius">
  <sequence>
    <element name="return" type="xsd:double" />
  </sequence>
</complexType>

<element name="temperatureCelsiusValue" type="omTypes:temperatureCelsius" />

<complexType name="temperatureFar">
  <sequence>
    <element name="return" type="xsd:double" />
  </sequence>
</complexType>

<element name="temperatureFarValue" type="omTypes:temperatureFar" />

</xsd:schema>
</types>

<message name="temperatureCelsiusValue">
  <part name="parameters" element="omTypes:temperatureCelsiusValue" />
</message>

<message name="temperatureFarValue">
  <part name="parameters" element="omTypes:temperatureFarValue" />
</message>

<portType name="TemperatureConvertor">
  <operation name="celsiusToFarenheitOp">
    <input message="tns:temperatureCelsiusValue" />
    <output message="tns:temperatureFarValue" />
  </operation>
  <operation name="farenheitToCelsiusOp">
    <input message="tns:temperatureFarValue" />
    <output message="tns:temperatureCelsiusValue" />
    </operation>
</portType>

<binding name="TemperatureConvertorPortBinding" type="tns:TemperatureConvertor">
  <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document" />
    <operation name="celsiusToFarenheitOp">
      <soap:operation soapAction="" />
        <input>	<soap:body use="literal"/></input>
        <output><soap:body use="literal" /></output>
    </operation>
    <operation name="farenheitToCelsiusOp">
      <soap:operation soapAction="" />
        <input>	<soap:body use="literal" /></input>
        <output><soap:body use="literal" /></output>
    </operation>
</binding>

<service name="TemperatureConvertorService">
   <port name="TemperatureConvertorPort" binding="tns:TemperatureConvertorPortBinding">
     <soap:address location="REPLACE_WITH_URL" />
   </port>
</service>

</definitions>

Make a dynamic web application and put the above WSDL at WEB-INF/wsdl/. Let's name this WSDL as temperatureConvertor.wsdl
Now run the wsimport tool and generate the artifacts


wsimport -keep -s <source_folder_location> -d <generated_compiled_class>  <WSDL location with WSDL Name>

-keep will keep the generated file.
After the above command runs successfully, a TemperatureConvertor Interface is generated. The generated interface looks as follows:


@WebService(name = "TemperatureConvertor", 
            targetNamespace = "http://ws.crayom.com/")
@SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
@XmlSeeAlso({ObjectFactory.class})
public interface TemperatureConvertor {

    @WebMethod
    @WebResult(name = "temperatureFarValue",
    targetNamespace = "http://crayom.com/omTypes", 
    partName = "parameters")
    public TemperatureFar celsiusToFarenheitOp(
        @WebParam(name = "temperatureCelsiusValue",
                  targetNamespace = "http://crayom.com/omTypes",
                  partName = "parameters") TemperatureCelsius parameters);
}

Also note that it will generate JAXB binding classes of type TemperaturFar and TemperatureClesius.
Now implement this class which will become the service end point


@WebService(
     endpointInterface="com.crayom.ws.TemperatureConvertor")
public class TemperatureConvertorImpl implements TemperatureConvertor {

  public TemperatureFar celsiusToFarenheitOp(TemperatureCelsius parameters) {
	double celsius = parameters.getReturn();
	double fahr = 1.8*celsius + 32;
	TemperatureFar tempFar = new TemperatureFar();
	tempFar.setReturn(fahr);
	return tempFar;
  }
...


<servlet>
  <servlet-name>TemperaturConvertor</servlet-name>
  <servlet-class>com.oyeJava.TemperatureConvertorImpl</servlet-class>
</servlet>

<servlet-mapping>
  <servlet-name>TemperaturConvertor</servlet-name>
  <url-pattern>/TemperaturConvertor</url-pattern>
</servlet-mapping>

Deploy the war and hit the WSDL/ However you will note that this WSDL is not similar to what you have provided. The server generates its own WSDL. If you want to force the server to use your WSDL than change the following:


@WebService(name = "TemperatureConvertor",
    endpointInterface="com.crayom.ws.TemperatureConvertor",
    targetNamespace = "http://ws.crayom.com/",
    wsdlLocation = "WEB-INF/wsdl/TemperatureConvertorDocStyle.wsdl")
public class TemperatureConvertorService implements TemperatureConvertor {
     ....

Back to JAX-WS Index
Back To Java Home
Back To Home

Add Comment

Post new comment

Wiki Help
Plugin Help

Wiki Syntax

For more information, please see Wiki Page Editor and Wiki Syntax

Wiki Syntax
Bold text __text__
Italic text 2 single quotes ('). ''text''
Underlined text ===text===
Colored text ~~#FFEE33:text~~ or ~~yellow:text~~. Will display using the indicated HTML color or color name. Color name can contain two colors separated by a comma. In this case, the first color would be the foreground and the second one the background.
Deleted text 2 dashes "-". --text--
Headings !heading1, !!heading2, !!!heading3
Show/Hide !+, !!- show/hide heading section. + (shown) or - (hidden) by default.
Autonumbered Headings !#, !!#, !+#, !-# ...
Table of contents {toc}, {maketoc} prints out a table of contents for the current page based on structures (toc) or ! headings (maketoc)
Horizontal rule ----
Text box ^Box content^
Centered text ::text::
Dynamic variables %Name% Inserts an editable variable
External links use square brackets for an external link: [URL], [URL\|link_description],[URL\|link_description\|relation] or [URL\|description\|relation\|nocache] (that last prevents the local Wiki from caching the linked page; relation can be used to insert rel attribute for the link - useful e.g. for shadowbox). For an external Wiki, use ExternalWikiName:PageName or ((External Wiki Name: Page Name))
Square Brackets Use [[foo] to show [foo].
Wiki References ((page)) or ((page\|description)) for wiki references
Lists * for bullet lists, # for numbered lists, ;Word:definition for definiton lists
Indentation +, ++ Creates an indentation for each plus (useful in list to continue at the same level)
Tables \|\|row1-col1\|row1-col2\|row1-col3 row2-col1\|row2-col2\|row2-col3\|\|
Title bar -=Title=-
Monospace font -+Code sample+-
Line break %%% (very useful especially in tables)
Multi-page pages Use ...page... to separate pages
Non parsed sections ~np~ data ~/np~ Prevents wiki parsing of the enclosed data.
Preformated sections ~pp~ data ~/pp~ Displays preformated text/code; no Wiki processing is done inside these sections (as with np), and the spacing is fixed (no word wrapping is done). ~pre~ data ~/pre~ also displayes preformatted text with fixed spacing, but wiki processing still occurs on the text.
Comments ~tc~ Tiki Comment ~/tc~ makes a Tiki comment. It will be completely removed from the display, but saved in the file for future reference. ~hc~ HTML Comment ~/hc~ makes an HTML comment. It will be inserted as a comment in the output HTML; these are not normally displayed in browsers, but can be seen using "View Source" or similar.
Direction {r2l}, {l2r}, {rm}, {lm}Insert resp. right-to-left and left-to-right text direction DIV (up to end of text) and markers for langages as arabic or hebrew.
Special characters ~hs~ hard space, ~c~ ©, ~amp~ &, ~lt~ <, ~gt~ >, ~ldq~ “, ~rdq~ ”, ~lsq~ ‘, ~rsq~ ’, ~--~ —, ~bs~ \, numeric between ~ for html numeric characters entity

Because the Wiki paragraph formatting feature is off, each line will be presented as you write it. This means that if you want paragraphs to be wrapped properly, a paragraph should be all together on one line.

Plugins

Note that plugin arguments can be enclosed with double quotes ("); this allows them to contain , or = or >.
More help here

Filter:

Description
Attachment Displays an attachment or a list of them
Box Insert theme-styled box on wiki page
Center Centers the plugin content in the wiki page
Code Displays a snippet of code
Div Insert a division block, span, blockquote or other text formatting on wiki page.
Definition List Creates a definition list
Fade Displays a label. On click, the block of content will fade in and fade out.
Fancy List Creates a fancy-looking list
Fancy Table Displays the data using the Tikiwiki odd/even table style
File Displays a link to an attachment to a wiki page and can display an image attachment.
Files Displays a list of files from the File Gallery
Flash video Displays a Flash (.swf) file in the wiki page
googlemap Displays a Google map
Group Display wiki text if user is in one of listed groups
Group List List of groups including a group
Group Stats Displays some stat about group belonging
HTML Include literal HTML in a Wiki page
Image Display images
Include Include a page's content.
Invite Invite an email in groups.
Kaltura video Displays a KALTURA video on the wiki page
Language Displays the text only if the language matchs
Mail Allow to send mail to groups or user or email directly
Mediaplayer Simple mp3 or flv Player
Insert Module Displays a module inline in a wiki page. More parameters can be added, not supported by UI.
Mouseover Create a mouseover feature on some text
Poll Displays the output of a poll, fields are indicated with numeric ids.
Quote Quote text by surrounding the text with a box, like the [QUOTE] BBCode
Remarks Box Displays a comment, tip, note or warning box
RSS Feed Inserts an RSS feed output.
Sort Sorts the plugin content in the wiki page
Split Split a page into rows and columns
Subscript Displays text in subscript.
Superscript Displays text in superscript (exponent).
Tabs Provides tabs built using the smarty tabset block.
Thumbnail Displays the thumbnail for an image
Thumbnail Displays the thumbnail for an image
Tracker Comments Displays the number of tracker comments
Translated Links to a translated content
Youtube Display youtube video in a wiki page

Title (required)
Toolbars
Comment (required)
Anti-Bot verification code:
Enter the code you see above:
Enter your name (optional)
Post new comment

JAX-WS Start From WSDL-doc style

Post new comment

Wiki Syntax

Plugins

Sidebar

Last wiki comments

Sidebar

Random Pages

Last blog post comments