<![CDATA[
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<title>The Java™ WSIT Tutorial</title>
<link rel="StyleSheet" href="document.css" type="text/css" media="all" />
<link rel="StyleSheet" href="catalog.css" type="text/css" media="all" />
<link rel="Table of Contents" href="WSITTutorialTOC.html" />
<link rel="Previous" href="" />
<link rel="Next" href="WSITTutorialFront.html" />
<link rel="Index" href="WSITTutorialIX.html" />
<!--[if gte IE 5.5000]>
<script language="JavaScript">
function correctPNG() { // correctly handle PNG transparency in Win IE 5.5 or higher.
for(var i=0; i<document.images.length; i++) {
var img = document.images[i]
var imgName = img.src.toUpperCase()
if (imgName.substring(imgName.length-3, imgName.length) == "PNG") {
var imgID = (img.id) ? "id='" + img.id + "' " : ""
var imgClass = (img.className) ? "class='" + img.className + "' " : ""
var imgTitle = (img.title) ? "title='" + img.title + "' " : "title='" + img.alt + "' "
var imgStyle = "display:inline-block;" + img.style.cssText
if (img.align == "left") imgStyle = "float:left;" + imgStyle
if (img.align == "right") imgStyle = "float:right;" + imgStyle
if (img.parentElement.href) imgStyle = "cursor:hand;" + imgStyle
var strNewHTML = "<span " + imgID + imgClass + imgTitle
+ " style=\"" + "width:" + img.width + "px; height:" + img.height + "px;" + imgStyle + ";"
+ "filter:progid:DXImageTransform.Microsoft.AlphaImageLoader"
+ "(src=\'" + img.src + "\', sizingMethod='scale');\"></span>"
img.outerHTML = strNewHTML
i = i-1
}
}
}
window.attachEvent("onload", correctPNG);
</script>
<![endif]-->
</head>
<body>
<body>
<div id="header">
<img src="images/WSITbanner.gif" width="704" height="120" alt="The Java™ WSIT Tutorial"/>
<div id="header-links">
<a href="index.html" target="_blank">Home</a> | <a href="WSITTutorial.pdf" target="_blank">PDF</a>
</div>
<div class="navigation">
<a accesskey="p" href="" title="Previous"><img id="LongDescNotReq1" src="images/leftButton.gif" width="23" height="23" border="0" alt="Prev" /></a><a accesskey="c" href="WSITTutorialFront.html" title="Beginning"><img id="LongDescNotReq1" src="images/upButton.gif" width="23" height="23" border="0" alt="Beginning" /></a><a accesskey="n" href="WSITTutorialFront.html" title="Next"><img id="LongDescNotReq3" src="images/rightButton.gif" width="23" height="23" border="0" alt="Next" /></a>
</div>
</div>
<blockquote>
<a name="wp425857"> </a><h2 class="pTOC1">
<a href="About.html#wp89160">About This Tutorial</a>
</h2>
<a name="wp425859"> </a><p class="pTOC2">
<a href="About.html#wp88893">Who Should Use This Tutorial</a>
</p>
<a name="wp425861"> </a><p class="pTOC2">
<a href="About.html#wp88645">How to Use This Tutorial</a>
</p>
<a name="wp425863"> </a><p class="pTOC2">
<a href="About.html#wp88410">About the Examples</a>
</p>
<a name="wp425865"> </a><p class="pTOC2">
<a href="About.html#wp63754">Typographical Conventions</a>
</p>
<a name="wp425867"> </a><p class="pTOC2">
<a href="About.html#wp82178">Feedback</a>
</p>
<a name="wp425869"> </a><h2 class="pTOC1">
<a href="Overview.html#wp146934">Chapter 1: Introduction</a>
</h2>
<a name="wp425871"> </a><p class="pTOC2">
<a href="Overview2.html#wp149787">What is WSIT?</a>
</p>
<a name="wp425873"> </a><p class="pTOC3">
<a href="Overview2.html#wp150549">Bootstrapping and Configuration</a>
</p>
<a name="wp425875"> </a><p class="pTOC3">
<a href="Overview2.html#wp150089">Message Optimization Technology</a>
</p>
<a name="wp425877"> </a><p class="pTOC3">
<a href="Overview2.html#wp150464">Reliable Messaging Technology</a>
</p>
<a name="wp425879"> </a><p class="pTOC3">
<a href="Overview2.html#wp150191">Security Technology</a>
</p>
<a name="wp425881"> </a><p class="pTOC2">
<a href="Overview3.html#wp149561">How WSIT Relates to Windows Communication Foundation (WCF)</a>
</p>
<a name="wp425883"> </a><p class="pTOC2">
<a href="Overview4.html#wp151702">WSIT Specifications</a>
</p>
<a name="wp425885"> </a><p class="pTOC3">
<a href="Overview4.html#wp151722">Bootstrapping and Configuration Specifications</a>
</p>
<a name="wp425887"> </a><p class="pTOC3">
<a href="Overview4.html#wp151745">Message Optimization Specifications</a>
</p>
<a name="wp425889"> </a><p class="pTOC3">
<a href="Overview4.html#wp151774">Reliable Messaging Specifications</a>
</p>
<a name="wp425891"> </a><p class="pTOC3">
<a href="Overview4.html#wp151797">Security Specifications</a>
</p>
<a name="wp425893"> </a><p class="pTOC2">
<a href="Overview5.html#wp151822">How the WSIT Technologies Work</a>
</p>
<a name="wp425895"> </a><p class="pTOC3">
<a href="Overview5.html#wp151838">How Message Optimization Works</a>
</p>
<a name="wp425897"> </a><p class="pTOC3">
<a href="Overview5.html#wp151850">How Reliable Messaging Works</a>
</p>
<a name="wp425899"> </a><p class="pTOC3">
<a href="Overview5.html#wp151889">How Security Works</a>
</p>
<a name="wp425901"> </a><h2 class="pTOC1">
<a href="Examples_netbeans.html#wp100322">Chapter 2: WSIT Example Using a Web Container and NetBeans</a>
</h2>
<a name="wp425903"> </a><p class="pTOC2">
<a href="Examples_netbeans2.html#wp107627">Registering GlassFish with the IDE</a>
</p>
<a name="wp425905"> </a><p class="pTOC2">
<a href="Examples_netbeans3.html#wp104773">Creating a Web Service</a>
</p>
<a name="wp425907"> </a><p class="pTOC2">
<a href="Examples_netbeans4.html#wp106035">Configuring WSIT Features in the Web Service</a>
</p>
<a name="wp425909"> </a><p class="pTOC2">
<a href="Examples_netbeans5.html#wp104867">Deploying and Testing a Web Service</a>
</p>
<a name="wp425911"> </a><p class="pTOC2">
<a href="Examples_netbeans6.html#wp104950">Creating a Client to Consume a WSIT-Enabled Web Service</a>
</p>
<a name="wp425913"> </a><h2 class="pTOC1">
<a href="Initialization.html#wp100322">Chapter 3: Bootstrapping and Configuration</a>
</h2>
<a name="wp425915"> </a><p class="pTOC2">
<a href="Initialization2.html#wp102365">What is a Server-Side Endpoint?</a>
</p>
<a name="wp425917"> </a><p class="pTOC2">
<a href="Initialization3.html#wp104050">Creating a Client from WSDL</a>
</p>
<a name="wp425919"> </a><p class="pTOC2">
<a href="Initialization4.html#wp107111">Client From WSDL Examples</a>
</p>
<a name="wp425921"> </a><h2 class="pTOC1">
<a href="Optimization.html#wp100322">Chapter 4: Message Optimization</a>
</h2>
<a name="wp425923"> </a><p class="pTOC2">
<a href="Optimization2.html#wp106676">Creating a Web Service</a>
</p>
<a name="wp425925"> </a><p class="pTOC2">
<a href="Optimization3.html#wp106668">Configuring Message Optimization in a Web Service</a>
</p>
<a name="wp425927"> </a><p class="pTOC2">
<a href="Optimization4.html#wp106694">Deploying and Testing a Web Service</a>
</p>
<a name="wp425929"> </a><p class="pTOC2">
<a href="Optimization5.html#wp106602">Creating a Client to Consume a WSIT-enabled Web Service</a>
</p>
<a name="wp425931"> </a><p class="pTOC2">
<a href="Optimization6.html#wp106809">Message Optimization and Secure Conversation</a>
</p>
<a name="wp425933"> </a><h2 class="pTOC1">
<a href="Reliability.html#wp100322">Chapter 5: Using Reliable Messaging</a>
</h2>
<a name="wp425935"> </a><p class="pTOC2">
<a href="Reliability2.html#wp106745">Reliable Messaging Options</a>
</p>
<a name="wp425937"> </a><p class="pTOC2">
<a href="Reliability3.html#wp106966">Creating Web Service Providers and Clients that use Reliable Messaging</a>
</p>
<a name="wp425939"> </a><p class="pTOC2">
<a href="Reliability4.html#wp106460">Using Secure Conversation With Reliable Messaging</a>
</p>
<a name="wp425941"> </a><h2 class="pTOC1">
<a href="WSIT_Security.html#wp113333">Chapter 6: Using WSIT Security</a>
</h2>
<a name="wp425943"> </a><p class="pTOC2">
<a href="WSIT_Security2.html#wp138135">Configuring Security Using NetBeans IDE</a>
</p>
<a name="wp425945"> </a><p class="pTOC3">
<a href="WSIT_Security2.html#wp159528">Securing the Service</a>
</p>
<a name="wp425947"> </a><p class="pTOC3">
<a href="WSIT_Security2.html#wp159532">Securing the Client</a>
</p>
<a name="wp425949"> </a><p class="pTOC2">
<a href="WSIT_Security3.html#wp159778">Summary of Configuration Requirements</a>
</p>
<a name="wp425951"> </a><p class="pTOC3">
<a href="WSIT_Security3.html#wp159783">Summary of Service-Side Configuration Requirements</a>
</p>
<a name="wp425953"> </a><p class="pTOC3">
<a href="WSIT_Security3.html#wp160305">Summary of Client-Side Configuration Requirements</a>
</p>
<a name="wp425955"> </a><p class="pTOC2">
<a href="WSIT_Security4.html#wp160769">Security Mechanisms</a>
</p>
<a name="wp425957"> </a><p class="pTOC3">
<a href="WSIT_Security4.html#wp129315">Username Authentication with Symmetric Keys</a>
</p>
<a name="wp425959"> </a><p class="pTOC3">
<a href="WSIT_Security4.html#wp129317">Mutual Certificates Security</a>
</p>
<a name="wp425961"> </a><p class="pTOC3">
<a href="WSIT_Security4.html#wp130667">Transport Security (SSL)</a>
</p>
<a name="wp425963"> </a><p class="pTOC3">
<a href="WSIT_Security4.html#wp129409">Message Authentication over SSL</a>
</p>
<a name="wp425965"> </a><p class="pTOC3">
<a href="WSIT_Security4.html#wp161157">SAML Authorization over SSL</a>
</p>
<a name="wp425967"> </a><p class="pTOC3">
<a href="WSIT_Security4.html#wp129474">Endorsing Certificate</a>
</p>
<a name="wp425969"> </a><p class="pTOC3">
<a href="WSIT_Security4.html#wp131635">SAML Sender Vouches with Certificates</a>
</p>
<a name="wp425971"> </a><p class="pTOC3">
<a href="WSIT_Security4.html#wp161236">SAML Holder of Key</a>
</p>
<a name="wp425973"> </a><p class="pTOC3">
<a href="WSIT_Security4.html#wp129480">STS Issued Token</a>
</p>
<a name="wp425975"> </a><p class="pTOC3">
<a href="WSIT_Security4.html#wp129482">STS Issued Token with Service Certificate</a>
</p>
<a name="wp425977"> </a><p class="pTOC3">
<a href="WSIT_Security4.html#wp129484">STS Issued Endorsing Token</a>
</p>
<a name="wp425979"> </a><p class="pTOC2">
<a href="WSIT_Security5.html#wp161450">Configuring SSL and Authorized Users</a>
</p>
<a name="wp425981"> </a><p class="pTOC3">
<a href="WSIT_Security5.html#wp161451">Configuring SSL For Your Applications</a>
</p>
<a name="wp425983"> </a><p class="pTOC3">
<a href="WSIT_Security5.html#wp161537">Adding Users to GlassFish</a>
</p>
<a name="wp425985"> </a><p class="pTOC2">
<a href="WSIT_Security6.html#wp147741">Configuring Keystores and Truststores</a>
</p>
<a name="wp425987"> </a><p class="pTOC3">
<a href="WSIT_Security6.html#wp138685">Updating GlassFish Certificates</a>
</p>
<a name="wp425989"> </a><p class="pTOC3">
<a href="WSIT_Security6.html#wp136402">Specifying Aliases with the Updated Stores</a>
</p>
<a name="wp425991"> </a><p class="pTOC3">
<a href="WSIT_Security6.html#wp146708">Configuring the Keystore and Truststore</a>
</p>
<a name="wp425993"> </a><p class="pTOC3">
<a href="WSIT_Security6.html#wp129124">Configuring Validators</a>
</p>
<a name="wp425995"> </a><p class="pTOC2">
<a href="WSIT_Security7.html#wp133875">Securing an Operation</a>
</p>
<a name="wp425997"> </a><p class="pTOC3">
<a href="WSIT_Security7.html#wp162253">Specifying Security at the Operation, Input Message, or Output Message Level</a>
</p>
<a name="wp425999"> </a><p class="pTOC3">
<a href="WSIT_Security7.html#wp144317">Supporting Token Options</a>
</p>
<a name="wp426001"> </a><p class="pTOC2">
<a href="WSIT_Security8.html#wp142879">Configuring A Secure Token Service (STS)</a>
</p>
<a name="wp426003"> </a><p class="pTOC3">
<a href="WSIT_Security8.html#wp142891">Creating a Third-Party STS</a>
</p>
<a name="wp426005"> </a><p class="pTOC3">
<a href="WSIT_Security8.html#wp162441">Specifying an STS on the Service Side</a>
</p>
<a name="wp426007"> </a><p class="pTOC3">
<a href="WSIT_Security8.html#wp162326">Specifying an STS on the Client Side</a>
</p>
<a name="wp426009"> </a><p class="pTOC2">
<a href="WSIT_Security9.html#wp162461">Example Applications</a>
</p>
<a name="wp426011"> </a><p class="pTOC3">
<a href="WSIT_Security9.html#wp162458">Example: Username Authentication with Symmetric Keys (UA)</a>
</p>
<a name="wp426013"> </a><p class="pTOC3">
<a href="WSIT_Security9.html#wp162511">Example: Mutual Certificates Security (MCS)</a>
</p>
<a name="wp426015"> </a><p class="pTOC3">
<a href="WSIT_Security9.html#wp151774">Example: Transport Security (SSL)</a>
</p>
<a name="wp426017"> </a><p class="pTOC3">
<a href="WSIT_Security9.html#wp151769">Example: SAML Authorization over SSL (SA)</a>
</p>
<a name="wp426019"> </a><p class="pTOC3">
<a href="WSIT_Security9.html#wp140996">Example: SAML Sender Vouches with Certificates (SV)</a>
</p>
<a name="wp426021"> </a><p class="pTOC3">
<a href="WSIT_Security9.html#wp142952">Example: STS Issued Token (STS)</a>
</p>
<a name="wp426023"> </a><p class="pTOC3">
<a href="WSIT_Security9.html#wp146538">Example: Other STS Examples</a>
</p>
<a name="wp426025"> </a><p class="pTOC2">
<a href="WSIT_Security10.html#wp149795">Further Information</a>
</p>
<a name="wp426027"> </a><h2 class="pTOC1">
<a href="WSIT_Security_descr.html#wp113333">Chapter 7: Further Detail on WSIT Security Features</a>
</h2>
<a name="wp426029"> </a><p class="pTOC2">
<a href="WSIT_Security_descr2.html#wp139243">Issues Addressed Using Security Mechanisms</a>
</p>
<a name="wp426031"> </a><p class="pTOC2">
<a href="WSIT_Security_descr3.html#wp159473">Understanding WSIT Configuration Files</a>
</p>
<a name="wp426033"> </a><p class="pTOC3">
<a href="WSIT_Security_descr3.html#wp159474">Service-Side WSIT Configuration Files</a>
</p>
<a name="wp426035"> </a><p class="pTOC3">
<a href="WSIT_Security_descr3.html#wp159475">Client-Side WSIT Configuration Files</a>
</p>
<a name="wp426037"> </a><p class="pTOC2">
<a href="WSIT_Security_descr4.html#wp160268">Security Mechanism Configuration Options</a>
</p>
<a name="wp426039"> </a><h2 class="pTOC1">
<a href="Examples_glassfish.html#wp109232">Chapter 8: WSIT Example Using a Web Container Without NetBeans</a>
</h2>
<a name="wp426041"> </a><p class="pTOC2">
<a href="Examples_glassfish2.html#wp112425">Environment Configuration Settings</a>
</p>
<a name="wp426043"> </a><p class="pTOC3">
<a href="Examples_glassfish2.html#wp112436">Setting the Web Container Listener Port</a>
</p>
<a name="wp426045"> </a><p class="pTOC3">
<a href="Examples_glassfish2.html#wp112445">Setting the Web Container Home Directory</a>
</p>
<a name="wp426047"> </a><p class="pTOC2">
<a href="Examples_glassfish3.html#wp106698">WSIT Configuration and WS-Policy Assertions</a>
</p>
<a name="wp426049"> </a><p class="pTOC2">
<a href="Examples_glassfish4.html#wp106695">Creating a Web Service</a>
</p>
<a name="wp426051"> </a><p class="pTOC3">
<a href="Examples_glassfish4.html#wp104810">Creating a Web Service From Java</a>
</p>
<a name="wp426053"> </a><p class="pTOC3">
<a href="Examples_glassfish4.html#wp108805"> Creating a Web Service From WSDL</a>
</p>
<a name="wp426055"> </a><p class="pTOC2">
<a href="Examples_glassfish5.html#wp106080">Building and Deploying the Web Service</a>
</p>
<a name="wp426057"> </a><p class="pTOC3">
<a href="Examples_glassfish5.html#wp106350">Building and Deploying a Web Service Created From Java</a>
</p>
<a name="wp426059"> </a><p class="pTOC3">
<a href="Examples_glassfish5.html#wp106572">Building and Deploying a Web Service Created From WSDL</a>
</p>
<a name="wp426061"> </a><p class="pTOC3">
<a href="Examples_glassfish5.html#wp106610">Deploying the Web Service to a Web Container</a>
</p>
<a name="wp426063"> </a><p class="pTOC3">
<a href="Examples_glassfish5.html#wp106663">Verifying Deployment</a>
</p>
<a name="wp426065"> </a><p class="pTOC2">
<a href="Examples_glassfish6.html#wp105648"> Creating a Web Service Client</a>
</p>
<a name="wp426067"> </a><p class="pTOC3">
<a href="Examples_glassfish6.html#wp106936">Creating a Client from Java</a>
</p>
<a name="wp426069"> </a><p class="pTOC3">
<a href="Examples_glassfish6.html#wp107167">Creating a Client from WSDL</a>
</p>
<a name="wp426071"> </a><p class="pTOC2">
<a href="Examples_glassfish7.html#wp112691">Building and Deploying a Client</a>
</p>
<a name="wp426073"> </a><p class="pTOC2">
<a href="Examples_glassfish8.html#wp106851">Running a Web Service Client</a>
</p>
<a name="wp426075"> </a><p class="pTOC2">
<a href="Examples_glassfish9.html#wp106871">Undeploying a Web Service</a>
</p>
<a name="wp426077"> </a><h2 class="pTOC1">
<a href="WCFClient.html#wp78460">Chapter 9: Accessing WSIT Services Using WCF Clients</a>
</h2>
<a name="wp426079"> </a><p class="pTOC2">
<a href="WCFClient2.html#wp80132">Creating a WCF Client</a>
</p>
<a name="wp426081"> </a><p class="pTOC3">
<a href="WCFClient2.html#wp80137">Prerequisites to Creating the WCF Client</a>
</p>
<a name="wp426083"> </a><p class="pTOC3">
<a href="WCFClient2.html#wp80524">The Client Class</a>
</p>
<a name="wp426085"> </a><p class="pTOC3">
<a href="WCFClient2.html#wp80838">Building and Running the Client</a>
</p>
<a name="wp426087"> </a><h2 class="pTOC1">
<a href="DataBinding.html#wp80419">Chapter 10: Data Contracts</a>
</h2>
<a name="wp426089"> </a><p class="pTOC2">
<a href="DataBinding2.html#wp80138">Web Service - Start from Java</a>
</p>
<a name="wp426091"> </a><p class="pTOC3">
<a href="DataBinding2.html#wp93610">DataTypes</a>
</p>
<a name="wp426093"> </a><p class="pTOC3">
<a href="DataBinding2.html#wp89670">Fields/Properties</a>
</p>
<a name="wp426095"> </a><p class="pTOC3">
<a href="DataBinding2.html#wp91933">Class</a>
</p>
<a name="wp426097"> </a><p class="pTOC3">
<a href="DataBinding2.html#wp94929">Open Content</a>
</p>
<a name="wp426099"> </a><p class="pTOC3">
<a href="DataBinding2.html#wp97608">Enum Type</a>
</p>
<a name="wp426101"> </a><p class="pTOC3">
<a href="DataBinding2.html#wp97612">Package</a>
</p>
<a name="wp426103"> </a><p class="pTOC2">
<a href="DataBinding3.html#wp87773">Web Service - Start from WSDL</a>
</p>
<a name="wp426105"> </a><p class="pTOC2">
<a href="DataBinding4.html#wp89371">Java Client</a>
</p>
<a name="wp426107"> </a><p class="pTOC2">
<a href="DataBinding5.html#wp88768">Customizations for WCF Service WSDL</a>
</p>
<a name="wp426109"> </a><p class="pTOC3">
<a href="DataBinding5.html#wp87393">generateElementProperty</a>
</p>
<a name="wp426111"> </a><p class="pTOC2">
<a href="DataBinding6.html#wp94407">Developing a Microsoft .NET Client</a>
</p>
<a name="wp426113"> </a><p class="pTOC2">
<a href="DataBinding7.html#wp95772">BP 1.1 Conformance</a>
</p>
<a name="wp426115"> </a><p class="pTOC3">
<a href="DataBinding7.html#wp95880">BP 1.1 R2211</a>
</p>
<a name="wp426117"> </a><h2 class="pTOC1">
<a href="AtomicTransactions.html#wp100322">Chapter 11: Using Atomic Transactions</a>
</h2>
<a name="wp426119"> </a><p class="pTOC2">
<a href="AtomicTransactions2.html#wp107573">About the basicWSTX Example</a>
</p>
<a name="wp426121"> </a><p class="pTOC2">
<a href="AtomicTransactions3.html#wp107636">Building, Deploying and Running the basicWSTX Example</a>
</p>
<a name="wp426123"> </a><h2 class="pTOC1">
<a href="WSITTutorialIX.html#wp2199026">Index</a>
</h2>
</blockquote>
<div id="footer">
<div class="navigation">
<a accesskey="p" href="" title="Previous"><img id="LongDescNotReq1" src="images/leftButton.gif" width="23" height="23" border="0" alt="Prev" /></a><a accesskey="c" href="WSITTutorialFront.html" title="Beginning"><img id="LongDescNotReq1" src="images/upButton.gif" width="23" height="23" border="0" alt="Beginning" /></a><a accesskey="n" href="WSITTutorialFront.html" title="Next"><img id="LongDescNotReq3" src="images/rightButton.gif" width="23" height="23" border="0" alt="Next" /></a>
</div>
<div id="copyright">
<p>All of the material in <em>The WSIT Tutorial</em> is <a href="WSITTutorialFront2.html">copyright</a>-protected and may not be published in other works without express written permission from Sun Microsystems.</p>
</div>
</div>
</body>
</html>
]]>