Added: maven/doxia/website/content/doxia-example-book/http-transport.html URL: http://svn.apache.org/viewvc/maven/doxia/website/content/doxia-example-book/http-transport.html?rev=1829011&view=auto ============================================================================== --- maven/doxia/website/content/doxia-example-book/http-transport.html (added) +++ maven/doxia/website/content/doxia-example-book/http-transport.html Thu Apr 12 21:22:02 2018 @@ -0,0 +1,226 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia Site Renderer 1.8 from target/generated-site/xdoc/doxia-example-book/http-transport.xml at 2018-04-12 + | Rendered using Apache Maven Fluido Skin 1.7 +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="author" content="XFire User's Guide" /> + <meta name="Date-Revision-yyyymmdd" content="20180412" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Doxia – HTTP Transport</title> + <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" /> + <link rel="stylesheet" href="../css/site.css" /> + <link rel="stylesheet" href="../css/print.css" media="print" /> + <script type="text/javascript" src="../js/apache-maven-fluido-1.7.min.js"></script> + <!-- Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-140879-1']); + _gaq.push(['_trackPageview']); + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + </head> + <body class="topBarDisabled"> + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"><a href="https://www.apache.org/"; id="bannerLeft"><img src="../../images/apache-maven-project.png" alt="Doxia Site"/></a></div> + <div class="pull-right"><a href=".././" id="bannerRight"><img src="../images/doxia-logo.png" alt="Doxia"/></a></div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li class=""><a href="https://www.apache.org/"; class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> + <li class=""><a href="../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> + <li class=""><a href="http://maven.apache.org/doxia/index.html"; class="externalLink" title="Doxia">Doxia</a><span class="divider">/</span></li> + <li class="active ">HTTP Transport</li> + <li id="publishDate" class="pull-right">Last Published: 2018-04-12</li> + </ul> + </div> + <div class="row-fluid"> + <div id="leftColumn" class="span2"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">About Doxia</li> + <li><a href="../index.html" title="What is Doxia?"><span class="none"></span>What is Doxia?</a></li> + <li><a href="../overview.html" title="Overview"><span class="none"></span>Overview</a></li> + <li><a href="../upgrading.html" title="Upgrading"><span class="icon-chevron-right"></span>Upgrading</a></li> + <li><a href="../downloads.html" title="Downloads"><span class="none"></span>Downloads</a></li> + <li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> + <li class="nav-header">Documentation</li> + <li><a href="../references/index.html" title="Format References"><span class="icon-chevron-right"></span>Format References</a></li> + <li><a href="../modules/index.html" title="Doxia Modules Guide"><span class="none"></span>Doxia Modules Guide</a></li> + <li><a href="../macros/index.html" title="Doxia Macros Guide"><span class="none"></span>Doxia Macros Guide</a></li> + <li><a href="../book/index.html" title="Writing Books"><span class="none"></span>Writing Books</a></li> + <li><a href="../issues/index.html" title="Issues & Gotchas"><span class="none"></span>Issues & Gotchas</a></li> + <li><a href="../resources.html" title="External Resources"><span class="none"></span>External Resources</a></li> + <li class="nav-header">Developer Docs</li> + <li><a href="../developers/index.html" title="Developer Centre"><span class="icon-chevron-right"></span>Developer Centre</a></li> + <li><a href="../doxia/index.html" title="Doxia 1.8"><span class="icon-chevron-down"></span>Doxia 1.8</a> + <ul class="nav nav-list"> + <li><a href="../doxia/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 1.7"><span class="icon-chevron-down"></span>Doxia 1.7</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.7.5/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 1.6"><span class="icon-chevron-down"></span>Doxia 1.6</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.6/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia/index.html" title="Doxia 1.5"><span class="icon-chevron-down"></span>Doxia 1.5</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.5/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 1.4"><span class="icon-chevron-down"></span>Doxia 1.4</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.4/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 1.3"><span class="icon-chevron-down"></span>Doxia 1.3</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.3/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 1.2"><span class="icon-chevron-down"></span>Doxia 1.2</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.2/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-tools/index.html" title="Doxia Tools"><span class="none"></span>Doxia Tools</a></li> + <li><a href="../doxia-ide.html" title="Doxia IDE"><span class="none"></span>Doxia IDE</a></li> + <li class="nav-header">Project Documentation</li> + <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> + <li class="nav-header">Maven Projects</li> + <li><a href="../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> + <li><a href="../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> + <li><a href="../index.html" title="Doxia"><span class="none"></span>Doxia</a></li> + <li><a href="../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> + <li><a href="../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> + <li><a href="../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> + <li><a href="../../plugins/index.html" title="Plugins"><span class="none"></span>Plugins</a></li> + <li><a href="../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> + <li><a href="../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> + <li><a href="../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> + <li><a href="../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> + <li><a href="../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> + <li><a href="../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> + <li><a href="../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> + <li><a href="../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> + <li class="nav-header">ASF</li> + <li><a href="https://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="https://www.apache.org/foundation/"; class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="https://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="https://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> +</ul> +<form id="search-form" action="https://www.google.com/search"; method="get" > + <input value="$sitesearchValue" name="sitesearch" type="hidden"/> + <input class="search-query" name="q" id="query" type="text" /> +</form> +<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> + <hr /> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div id="twitter"> + <a href="https://twitter.com/ASFMavenProject"; class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> + <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> + </div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> + </div> + </div> + </div> + <div id="bodyColumn" class="span10" > +<div class="section"> +<h2></h2> +<table class="table table-striped" width="100%" align="center" border="0"> +<tr class="a"> +<td align="left">Previous: <a href="transport-and-channel-api.html">Transport and Channel API</a></td> +<td align="center">Up: <a href="transports.html">Transports</a></td> +<td align="right">Next: <a href="jms-transport.html">JMS Transport</a></td></tr></table><hr /></div> +<div class="section"> +<h2><a name="HTTP_Transport"></a>HTTP Transport</h2> +<div class="section"> +<h3><a name="XFireServlet"></a>XFireServlet</h3> +<p>The core of the HTTP Transport takes place in the XFireServletController. Your own servlets can delegate appropriate requests to this class or you can use one of XFire's internal servlet classes. The XFireServlet is just a thin wrapper for the controller. The XFireServletController provides an xml configuration layer on top of this.</p> +<p>XFire also provides the XFireConfigurableServlet which reads the services.xml format automatically for you and the XFireSpringServlet which provides Sprign integration.</p></div> +<div class="section"> +<h3><a name="HttpServletRequest.2FHttpServletResponse"></a>HttpServletRequest/HttpServletResponse</h3> +<p>The HttpServletRequest/HttpServletResponse can be accessed via the XFireServletController.</p> +<div class="source"><pre class="prettyprint linenums">HttpServletRequest request = XFireServletController.getRequest(); +HttpServletResponse response = XFireServletController.getResponse();</pre></div> +<p>This method will work all the XFire servlets (XFireServlet, XFireConfigurableServlet, XFireSpringServlet).</p></div> +<div class="section"> +<h3><a name="Client_authentication"></a>Client authentication</h3> +<p>The Apache Jakarta HttpClient is used under the covers to provide HTTP client support. There are two ways which you can override the HttpClient settings:</p> +<ol style="list-style-type: decimal"> +<li>You can set the USERNAME/PASSWORD +<div class="source"><pre class="prettyprint linenums">// Create your client +Client client = ....; + +// Or get it from your proxy +Client client = ((XFireProxy) Proxy.getInvocationHandler(myClientProxy)).getClient(); + +client.setProperty(Channel.USERNAME, "username"); +client.setProperty(Channel.PASSWORD, "pass");</pre></div></li> +<li>You can supply your own HttpClientParms +<div class="source"><pre class="prettyprint linenums">client.setProperty(CommonsHttpMessageSender.HTTP_CLIENT_PARAMS, myParams);</pre></div> +<p>The HTTPClient javadocs provide information on how to configure the HttpClientParams.</p></li></ol></div> +<div class="section"> +<h3><a name="Proxy_Support"></a>Proxy Support</h3> +<p>Proxy support looks very similar to the username/password scenario:</p> +<div class="source"><pre class="prettyprint linenums">// Create your client +Client client = ....; + +// Or get it from your proxy +Client client = ((XFireProxy) Proxy.getInvocationHandler(myClientProxy)).getClient(); +client.setProperty(CommonsHttpMessageSender.HTTP_PROXY_HOST, "host"); +client.setProperty(CommonsHttpMessageSender.HTTP_PROXY_PORT, "8080");</pre></div></div> +<div class="section"> +<h3><a name="HTTP_Chunking"></a>HTTP Chunking</h3> +<p>You'll need to enable HTTP chunking on the client if you are sending large files which can't be cached in memory:</p> +<div class="source"><pre class="prettyprint linenums">import org.codehaus.xfire.transport.http.HttpTransport; + +Client client = ....; +client.setProperty(HttpTransport.CHUNKING_ENABLED, "true");</pre></div></div></div> +<div class="section"> +<h2></h2><hr /> +<table class="table table-striped" width="100%" align="center" border="0"> +<tr class="a"> +<td align="left">Previous: <a href="transport-and-channel-api.html">Transport and Channel API</a></td> +<td align="center">Up: <a href="transports.html">Transports</a></td> +<td align="right">Next: <a href="jms-transport.html">JMS Transport</a></td></tr></table></div> + </div> + </div> + </div> + <hr/> + <footer> + <div class="container-fluid"> + <div class="row-fluid"> + <p>Copyright ©2005–2018 +<a href="https://www.apache.org/";>The Apache Software Foundation</a>. +All rights reserved.</p> + </div> + </div> + </footer> + </body> +</html> \ No newline at end of file
Added: maven/doxia/website/content/doxia-example-book/index.html URL: http://svn.apache.org/viewvc/maven/doxia/website/content/doxia-example-book/index.html?rev=1829011&view=auto ============================================================================== --- maven/doxia/website/content/doxia-example-book/index.html (added) +++ maven/doxia/website/content/doxia-example-book/index.html Thu Apr 12 21:22:02 2018 @@ -0,0 +1,214 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia Site Renderer 1.8 from target/generated-site/xdoc/doxia-example-book/index.xml at 2018-04-12 + | Rendered using Apache Maven Fluido Skin 1.7 +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20180412" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Doxia – XFire User Manual - Table Of Content</title> + <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" /> + <link rel="stylesheet" href="../css/site.css" /> + <link rel="stylesheet" href="../css/print.css" media="print" /> + <script type="text/javascript" src="../js/apache-maven-fluido-1.7.min.js"></script> + <!-- Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-140879-1']); + _gaq.push(['_trackPageview']); + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + </head> + <body class="topBarDisabled"> + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"><a href="https://www.apache.org/"; id="bannerLeft"><img src="../../images/apache-maven-project.png" alt="Doxia Site"/></a></div> + <div class="pull-right"><a href=".././" id="bannerRight"><img src="../images/doxia-logo.png" alt="Doxia"/></a></div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li class=""><a href="https://www.apache.org/"; class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> + <li class=""><a href="../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> + <li class=""><a href="http://maven.apache.org/doxia/index.html"; class="externalLink" title="Doxia">Doxia</a><span class="divider">/</span></li> + <li class="active ">XFire User Manual - Table Of Content</li> + <li id="publishDate" class="pull-right">Last Published: 2018-04-12</li> + </ul> + </div> + <div class="row-fluid"> + <div id="leftColumn" class="span2"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">About Doxia</li> + <li><a href="../index.html" title="What is Doxia?"><span class="none"></span>What is Doxia?</a></li> + <li><a href="../overview.html" title="Overview"><span class="none"></span>Overview</a></li> + <li><a href="../upgrading.html" title="Upgrading"><span class="icon-chevron-right"></span>Upgrading</a></li> + <li><a href="../downloads.html" title="Downloads"><span class="none"></span>Downloads</a></li> + <li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> + <li class="nav-header">Documentation</li> + <li><a href="../references/index.html" title="Format References"><span class="icon-chevron-right"></span>Format References</a></li> + <li><a href="../modules/index.html" title="Doxia Modules Guide"><span class="none"></span>Doxia Modules Guide</a></li> + <li><a href="../macros/index.html" title="Doxia Macros Guide"><span class="none"></span>Doxia Macros Guide</a></li> + <li><a href="../book/index.html" title="Writing Books"><span class="none"></span>Writing Books</a></li> + <li><a href="../issues/index.html" title="Issues & Gotchas"><span class="none"></span>Issues & Gotchas</a></li> + <li><a href="../resources.html" title="External Resources"><span class="none"></span>External Resources</a></li> + <li class="nav-header">Developer Docs</li> + <li><a href="../developers/index.html" title="Developer Centre"><span class="icon-chevron-right"></span>Developer Centre</a></li> + <li><a href="../doxia/index.html" title="Doxia 1.8"><span class="icon-chevron-down"></span>Doxia 1.8</a> + <ul class="nav nav-list"> + <li><a href="../doxia/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 1.7"><span class="icon-chevron-down"></span>Doxia 1.7</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.7.5/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 1.6"><span class="icon-chevron-down"></span>Doxia 1.6</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.6/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia/index.html" title="Doxia 1.5"><span class="icon-chevron-down"></span>Doxia 1.5</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.5/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 1.4"><span class="icon-chevron-down"></span>Doxia 1.4</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.4/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 1.3"><span class="icon-chevron-down"></span>Doxia 1.3</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.3/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 1.2"><span class="icon-chevron-down"></span>Doxia 1.2</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.2/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-tools/index.html" title="Doxia Tools"><span class="none"></span>Doxia Tools</a></li> + <li><a href="../doxia-ide.html" title="Doxia IDE"><span class="none"></span>Doxia IDE</a></li> + <li class="nav-header">Project Documentation</li> + <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> + <li class="nav-header">Maven Projects</li> + <li><a href="../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> + <li><a href="../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> + <li><a href="../index.html" title="Doxia"><span class="none"></span>Doxia</a></li> + <li><a href="../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> + <li><a href="../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> + <li><a href="../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> + <li><a href="../../plugins/index.html" title="Plugins"><span class="none"></span>Plugins</a></li> + <li><a href="../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> + <li><a href="../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> + <li><a href="../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> + <li><a href="../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> + <li><a href="../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> + <li><a href="../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> + <li><a href="../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> + <li><a href="../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> + <li class="nav-header">ASF</li> + <li><a href="https://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="https://www.apache.org/foundation/"; class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="https://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="https://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> +</ul> +<form id="search-form" action="https://www.google.com/search"; method="get" > + <input value="$sitesearchValue" name="sitesearch" type="hidden"/> + <input class="search-query" name="q" id="query" type="text" /> +</form> +<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> + <hr /> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div id="twitter"> + <a href="https://twitter.com/ASFMavenProject"; class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> + <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> + </div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> + </div> + </div> + </div> + <div id="bodyColumn" class="span10" > +<div class="section"> +<h2></h2> +<table border="0" class="table table-striped" width="100%" align="center"> +<tr class="a"> +<td> +<div align="right">Next: <a href="bind.html">Bindings</a></div></td></tr></table><hr /></div> +<div class="section"> +<h2><a name="XFire_User_Manual_-_Table_Of_Content"></a>XFire User Manual - Table Of Content</h2> +<ul> +<li><a href="bind.html">Bindings</a> +<ul> +<li><a href="bindings.html">Bindings Overview</a> +<ul> +<li><a href="bindings.html#Bindings_Overview">Bindings Overview</a></li> +<li><a href="bindings.html#Using_another_binding">Using another binding</a></li> +<li><a href="bindings.html#Convenience_ServiceFactorys">Convenience ServiceFactorys</a></li> +<li><a href="bindings.html#The_MessageBinding">The MessageBinding</a></li></ul></li> +<li><a href="aegis-binding.html">Aegis Binding</a> +<ul> +<li><a href="aegis-binding.html#Aegis_Binding">Aegis Binding</a></li> +<li><a href="aegis-binding.html#XML_and_Annotation_Mapping_Overview">XML and Annotation Mapping Overview</a></li> +<li><a href="aegis-binding.html#Controlling_Naming">Controlling Naming</a></li> +<li><a href="aegis-binding.html#Interfaces_and_Aegis">Interfaces and Aegis</a></li></ul></li> +<li><a href="castor.html">Castor</a> +<ul> +<li><a href="castor.html#Castor">Castor</a></li> +<li><a href="castor.html#Top-down_Approach_starting_with_XML_schema:">Top-down Approach (starting with XML schema):</a></li> +<li><a href="castor.html#Bottom-up_Approach_starting_with_Java_classes:">Bottom-up Approach (starting with Java classes):</a></li></ul></li></ul></li> +<li><a href="transports.html">Transports</a> +<ul> +<li><a href="transport-and-channel-api.html">Transport and Channel API</a> +<ul> +<li><a href="transport-and-channel-api.html#Transports_and_Channels">Transports and Channels</a></li></ul></li> +<li><a href="http-transport.html">HTTP Transport</a> +<ul> +<li><a href="http-transport.html#HTTP_Transport">HTTP Transport</a></li></ul></li> +<li><a href="jms-transport.html">JMS Transport</a> +<ul> +<li><a href="jms-transport.html#JMS_Transport">JMS Transport</a></li></ul></li> +<li><a href="local-transport.html">Local Transport</a> +<ul> +<li><a href="local-transport.html#Local_Transport">Local Transport</a></li></ul></li></ul></li></ul></div> +<div class="section"> +<h2></h2><hr /> +<table border="0" class="table table-striped" width="100%" align="center"> +<tr class="a"> +<td> +<div align="right">Next: <a href="bind.html">Bindings</a></div></td></tr></table></div> + </div> + </div> + </div> + <hr/> + <footer> + <div class="container-fluid"> + <div class="row-fluid"> + <p>Copyright ©2005–2018 +<a href="https://www.apache.org/";>The Apache Software Foundation</a>. +All rights reserved.</p> + </div> + </div> + </footer> + </body> +</html> \ No newline at end of file Added: maven/doxia/website/content/doxia-example-book/jms-transport.html URL: http://svn.apache.org/viewvc/maven/doxia/website/content/doxia-example-book/jms-transport.html?rev=1829011&view=auto ============================================================================== --- maven/doxia/website/content/doxia-example-book/jms-transport.html (added) +++ maven/doxia/website/content/doxia-example-book/jms-transport.html Thu Apr 12 21:22:02 2018 @@ -0,0 +1,280 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia Site Renderer 1.8 from target/generated-site/xdoc/doxia-example-book/jms-transport.xml at 2018-04-12 + | Rendered using Apache Maven Fluido Skin 1.7 +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="author" content="XFire User's Guide" /> + <meta name="Date-Revision-yyyymmdd" content="20180412" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Doxia – JMS Transport</title> + <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" /> + <link rel="stylesheet" href="../css/site.css" /> + <link rel="stylesheet" href="../css/print.css" media="print" /> + <script type="text/javascript" src="../js/apache-maven-fluido-1.7.min.js"></script> + <!-- Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-140879-1']); + _gaq.push(['_trackPageview']); + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + </head> + <body class="topBarDisabled"> + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"><a href="https://www.apache.org/"; id="bannerLeft"><img src="../../images/apache-maven-project.png" alt="Doxia Site"/></a></div> + <div class="pull-right"><a href=".././" id="bannerRight"><img src="../images/doxia-logo.png" alt="Doxia"/></a></div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li class=""><a href="https://www.apache.org/"; class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> + <li class=""><a href="../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> + <li class=""><a href="http://maven.apache.org/doxia/index.html"; class="externalLink" title="Doxia">Doxia</a><span class="divider">/</span></li> + <li class="active ">JMS Transport</li> + <li id="publishDate" class="pull-right">Last Published: 2018-04-12</li> + </ul> + </div> + <div class="row-fluid"> + <div id="leftColumn" class="span2"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">About Doxia</li> + <li><a href="../index.html" title="What is Doxia?"><span class="none"></span>What is Doxia?</a></li> + <li><a href="../overview.html" title="Overview"><span class="none"></span>Overview</a></li> + <li><a href="../upgrading.html" title="Upgrading"><span class="icon-chevron-right"></span>Upgrading</a></li> + <li><a href="../downloads.html" title="Downloads"><span class="none"></span>Downloads</a></li> + <li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> + <li class="nav-header">Documentation</li> + <li><a href="../references/index.html" title="Format References"><span class="icon-chevron-right"></span>Format References</a></li> + <li><a href="../modules/index.html" title="Doxia Modules Guide"><span class="none"></span>Doxia Modules Guide</a></li> + <li><a href="../macros/index.html" title="Doxia Macros Guide"><span class="none"></span>Doxia Macros Guide</a></li> + <li><a href="../book/index.html" title="Writing Books"><span class="none"></span>Writing Books</a></li> + <li><a href="../issues/index.html" title="Issues & Gotchas"><span class="none"></span>Issues & Gotchas</a></li> + <li><a href="../resources.html" title="External Resources"><span class="none"></span>External Resources</a></li> + <li class="nav-header">Developer Docs</li> + <li><a href="../developers/index.html" title="Developer Centre"><span class="icon-chevron-right"></span>Developer Centre</a></li> + <li><a href="../doxia/index.html" title="Doxia 1.8"><span class="icon-chevron-down"></span>Doxia 1.8</a> + <ul class="nav nav-list"> + <li><a href="../doxia/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 1.7"><span class="icon-chevron-down"></span>Doxia 1.7</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.7.5/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 1.6"><span class="icon-chevron-down"></span>Doxia 1.6</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.6/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia/index.html" title="Doxia 1.5"><span class="icon-chevron-down"></span>Doxia 1.5</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.5/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 1.4"><span class="icon-chevron-down"></span>Doxia 1.4</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.4/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 1.3"><span class="icon-chevron-down"></span>Doxia 1.3</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.3/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 1.2"><span class="icon-chevron-down"></span>Doxia 1.2</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.2/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-tools/index.html" title="Doxia Tools"><span class="none"></span>Doxia Tools</a></li> + <li><a href="../doxia-ide.html" title="Doxia IDE"><span class="none"></span>Doxia IDE</a></li> + <li class="nav-header">Project Documentation</li> + <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> + <li class="nav-header">Maven Projects</li> + <li><a href="../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> + <li><a href="../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> + <li><a href="../index.html" title="Doxia"><span class="none"></span>Doxia</a></li> + <li><a href="../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> + <li><a href="../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> + <li><a href="../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> + <li><a href="../../plugins/index.html" title="Plugins"><span class="none"></span>Plugins</a></li> + <li><a href="../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> + <li><a href="../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> + <li><a href="../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> + <li><a href="../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> + <li><a href="../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> + <li><a href="../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> + <li><a href="../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> + <li><a href="../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> + <li class="nav-header">ASF</li> + <li><a href="https://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="https://www.apache.org/foundation/"; class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="https://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="https://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> +</ul> +<form id="search-form" action="https://www.google.com/search"; method="get" > + <input value="$sitesearchValue" name="sitesearch" type="hidden"/> + <input class="search-query" name="q" id="query" type="text" /> +</form> +<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> + <hr /> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div id="twitter"> + <a href="https://twitter.com/ASFMavenProject"; class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> + <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> + </div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> + </div> + </div> + </div> + <div id="bodyColumn" class="span10" > +<div class="section"> +<h2></h2> +<table class="table table-striped" width="100%" align="center" border="0"> +<tr class="a"> +<td align="left">Previous: <a href="http-transport.html">HTTP Transport</a></td> +<td align="center">Up: <a href="transports.html">Transports</a></td> +<td align="right">Next: <a href="local-transport.html">Local Transport</a></td></tr></table><hr /></div> +<div class="section"> +<h2><a name="JMS_Transport"></a>JMS Transport</h2> +<p>This guide gives you a quick rundown of how to configure XFire to use JMS as a transport. JMS is one of the easiest means to create a reliable SOAP connection. Additionally it is much faster then things such as WS-Reliability.</p> +<p>This example assumes that you already know how to:</p> +<ul> +<li>Configure services via XFire's services.xml format</li> +<li>Build and deploy simple XFire applications</li> +<li>Use your JMS provider</li> +<li>A working knowledge of Spring</li></ul> +<p>We're just going to show a simple synchronous Echo example running over JMS. The first thing you need to do is create your services.xml file:</p> +<div class="source"><pre class="prettyprint linenums"><beans xmlns="http://xfire.codehaus.org/config/1.0"> + + <!-- + Register the JMS transport. Note: this needs to happen *before* we + create our service. + --> + <xfire> + <transports> + <bean id="jmsTransport" + class="org.codehaus.xfire.transport.jms.JMSTransport" + xmlns="http://xbean.org/schemas/spring/1.0"> + <constructor-arg ref="xfire"/> + <constructor-arg ref="connectionFactory"/> + </bean> + </transports> + </xfire> + + <service xmlns:e="urn:Echo"> + <name>Echo</name> + <serviceClass>org.codehaus.xfire.test.Echo</serviceClass> + <implementationClass>org.codehaus.xfire.test.EchoImpl</implementationClass> + <bindings> + <soap11Binding name="e:EchoJMSBinding" transport="urn:xfire:transport:jms"> + <endpoints> + <endpoint name="e:EchoJMSEndpoint" url="jms://Echo" /> + </endpoints> + </soap11Binding> + </bindings> + </service> + + <bean id="connectionFactory" + class="org.apache.activemq.ActiveMQConnectionFactory" + singleton="true" + xmlns="http://xbean.org/schemas/spring/1.0/"> + <constructor-arg value="vm://localhost?broker.persistent=false" type="java.lang.String"/> + </bean> + +</beans></pre></div> +<p>There is a lot in here, so lets recap this a little bit.</p> +<p>The <i>xfire</i> section contains a <i>transports</i> element. In <i>transports</i> we are creating our JMSTransport via the Spring bean syntax. XFire will then automatically register this transport for us into the TransportManager.</p> +<p>The <i>service</i> element contains our service definition. This is pretty standard, except you'll notice we're creating a new binding for JMS. <i>soap11Binding transport="urn:xfire:transport:jms"</i> tells XFire that we want to add a SOAP 1.1 binding for JMS. In the endpoints section we tell XFire exactly what that endpoint will be. The JMS urls take the form of jms://<a name="QueueName">QueueName</a>.</p> +<p>In the sections below we configure our JMS QueueConnectionFactory using ActiveMQ.</p> +<p>Once all of this is properly configured we will of course want to write a client:</p> +<div class="source"><pre class="prettyprint linenums">import java.lang.reflect.Proxy; + +import org.codehaus.xfire.client.XFireProxy; +import org.codehaus.xfire.client.XFireProxyFactory; +import org.codehaus.xfire.service.Service; +import org.codehaus.xfire.service.binding.ObjectServiceFactory; +import org.codehaus.xfire.spring.AbstractXFireSpringTest; +import org.codehaus.xfire.test.Echo; +import org.codehaus.xfire.transport.jms.JMSTransport; +import org.springframework.context.ApplicationContext; +import org.apache.xbean.spring.context.ClassPathXmlApplicationContext; + +public class JMSExampleTest + extends AbstractXFireSpringTest +{ + protected ApplicationContext createContext() + { + return new ClassPathXmlApplicationContext(new String[] { + "/org/codehaus/xfire/transport/jms/example/jms.xml", + "/org/codehaus/xfire/spring/xfire.xml" }); + } + + public void testClient() + throws Exception + { + // Create a ServiceFactory to create the ServiceModel. + // We need to add the JMSTransport to the list of bindings to create. + ObjectServiceFactory sf = new ObjectServiceFactory(getTransportManager()); + sf.addSoap11Transport(JMSTransport.BINDING_ID); + + // Create the service model + Service serviceModel = sf.create(Echo.class); + + // Create a proxy for the service + XFireProxyFactory factory = new XFireProxyFactory(getXFire()); + Echo echo = (Echo) factory.create(serviceModel, "jms://Echo"); + + // Since JMS doesn't really have a concept of anonymous endpoints, we need + // need to let xfire know what JMS endpoint we should use + ((XFireProxy) Proxy.getInvocationHandler(echo)).getClient().setEndpointUri("jms://Peer1"); + + // run the client! + String resString = echo.echo("hello"); + assertEquals("hello", resString); + } +}</pre></div></div> +<div class="section"> +<h2></h2><hr /> +<table class="table table-striped" width="100%" align="center" border="0"> +<tr class="a"> +<td align="left">Previous: <a href="http-transport.html">HTTP Transport</a></td> +<td align="center">Up: <a href="transports.html">Transports</a></td> +<td align="right">Next: <a href="local-transport.html">Local Transport</a></td></tr></table></div> + </div> + </div> + </div> + <hr/> + <footer> + <div class="container-fluid"> + <div class="row-fluid"> + <p>Copyright ©2005–2018 +<a href="https://www.apache.org/";>The Apache Software Foundation</a>. +All rights reserved.</p> + </div> + </div> + </footer> + </body> +</html> \ No newline at end of file Added: maven/doxia/website/content/doxia-example-book/local-transport.html URL: http://svn.apache.org/viewvc/maven/doxia/website/content/doxia-example-book/local-transport.html?rev=1829011&view=auto ============================================================================== --- maven/doxia/website/content/doxia-example-book/local-transport.html (added) +++ maven/doxia/website/content/doxia-example-book/local-transport.html Thu Apr 12 21:22:02 2018 @@ -0,0 +1,190 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia Site Renderer 1.8 from target/generated-site/xdoc/doxia-example-book/local-transport.xml at 2018-04-12 + | Rendered using Apache Maven Fluido Skin 1.7 +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="author" content="XFire User's Guide" /> + <meta name="Date-Revision-yyyymmdd" content="20180412" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Doxia – Local Transport</title> + <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" /> + <link rel="stylesheet" href="../css/site.css" /> + <link rel="stylesheet" href="../css/print.css" media="print" /> + <script type="text/javascript" src="../js/apache-maven-fluido-1.7.min.js"></script> + <!-- Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-140879-1']); + _gaq.push(['_trackPageview']); + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + </head> + <body class="topBarDisabled"> + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"><a href="https://www.apache.org/"; id="bannerLeft"><img src="../../images/apache-maven-project.png" alt="Doxia Site"/></a></div> + <div class="pull-right"><a href=".././" id="bannerRight"><img src="../images/doxia-logo.png" alt="Doxia"/></a></div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li class=""><a href="https://www.apache.org/"; class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> + <li class=""><a href="../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> + <li class=""><a href="http://maven.apache.org/doxia/index.html"; class="externalLink" title="Doxia">Doxia</a><span class="divider">/</span></li> + <li class="active ">Local Transport</li> + <li id="publishDate" class="pull-right">Last Published: 2018-04-12</li> + </ul> + </div> + <div class="row-fluid"> + <div id="leftColumn" class="span2"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">About Doxia</li> + <li><a href="../index.html" title="What is Doxia?"><span class="none"></span>What is Doxia?</a></li> + <li><a href="../overview.html" title="Overview"><span class="none"></span>Overview</a></li> + <li><a href="../upgrading.html" title="Upgrading"><span class="icon-chevron-right"></span>Upgrading</a></li> + <li><a href="../downloads.html" title="Downloads"><span class="none"></span>Downloads</a></li> + <li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> + <li class="nav-header">Documentation</li> + <li><a href="../references/index.html" title="Format References"><span class="icon-chevron-right"></span>Format References</a></li> + <li><a href="../modules/index.html" title="Doxia Modules Guide"><span class="none"></span>Doxia Modules Guide</a></li> + <li><a href="../macros/index.html" title="Doxia Macros Guide"><span class="none"></span>Doxia Macros Guide</a></li> + <li><a href="../book/index.html" title="Writing Books"><span class="none"></span>Writing Books</a></li> + <li><a href="../issues/index.html" title="Issues & Gotchas"><span class="none"></span>Issues & Gotchas</a></li> + <li><a href="../resources.html" title="External Resources"><span class="none"></span>External Resources</a></li> + <li class="nav-header">Developer Docs</li> + <li><a href="../developers/index.html" title="Developer Centre"><span class="icon-chevron-right"></span>Developer Centre</a></li> + <li><a href="../doxia/index.html" title="Doxia 1.8"><span class="icon-chevron-down"></span>Doxia 1.8</a> + <ul class="nav nav-list"> + <li><a href="../doxia/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 1.7"><span class="icon-chevron-down"></span>Doxia 1.7</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.7.5/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 1.6"><span class="icon-chevron-down"></span>Doxia 1.6</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.6/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia/index.html" title="Doxia 1.5"><span class="icon-chevron-down"></span>Doxia 1.5</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.5/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 1.4"><span class="icon-chevron-down"></span>Doxia 1.4</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.4/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 1.3"><span class="icon-chevron-down"></span>Doxia 1.3</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.3/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 1.2"><span class="icon-chevron-down"></span>Doxia 1.2</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.2/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-tools/index.html" title="Doxia Tools"><span class="none"></span>Doxia Tools</a></li> + <li><a href="../doxia-ide.html" title="Doxia IDE"><span class="none"></span>Doxia IDE</a></li> + <li class="nav-header">Project Documentation</li> + <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> + <li class="nav-header">Maven Projects</li> + <li><a href="../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> + <li><a href="../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> + <li><a href="../index.html" title="Doxia"><span class="none"></span>Doxia</a></li> + <li><a href="../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> + <li><a href="../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> + <li><a href="../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> + <li><a href="../../plugins/index.html" title="Plugins"><span class="none"></span>Plugins</a></li> + <li><a href="../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> + <li><a href="../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> + <li><a href="../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> + <li><a href="../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> + <li><a href="../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> + <li><a href="../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> + <li><a href="../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> + <li><a href="../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> + <li class="nav-header">ASF</li> + <li><a href="https://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="https://www.apache.org/foundation/"; class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="https://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="https://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> +</ul> +<form id="search-form" action="https://www.google.com/search"; method="get" > + <input value="$sitesearchValue" name="sitesearch" type="hidden"/> + <input class="search-query" name="q" id="query" type="text" /> +</form> +<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> + <hr /> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div id="twitter"> + <a href="https://twitter.com/ASFMavenProject"; class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> + <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> + </div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> + </div> + </div> + </div> + <div id="bodyColumn" class="span10" > +<div class="section"> +<h2></h2> +<table class="table table-striped" width="100%" align="center" border="0"> +<tr class="a"> +<td align="left">Previous: <a href="jms-transport.html">JMS Transport</a></td> +<td align="center">Up: <a href="transports.html">Transports</a></td> +<td align="right"><i>End of book</i></td></tr></table><hr /></div> +<div class="section"> +<h2><a name="Local_Transport"></a>Local Transport</h2> +<p>XFire includes an in-JVM transport called the LocalTransport. If you are using the XFire client or the Channel API, you can address a local service like so:</p> +<div class="source"><pre class="prettyprint linenums">xfire.local://FooService</pre></div> +<p>For example, when creating a service:</p> +<div class="source"><pre class="prettyprint linenums">Service service = getServiceRegistry().getService("FooService"); + +XFireProxyFactory factory = new XFireProxyFactory(getXFire()); +FooService foo = (FooService) factory.create(service, "xfire.local://FooService");</pre></div></div> +<div class="section"> +<h2></h2><hr /> +<table class="table table-striped" width="100%" align="center" border="0"> +<tr class="a"> +<td align="left">Previous: <a href="jms-transport.html">JMS Transport</a></td> +<td align="center">Up: <a href="transports.html">Transports</a></td> +<td align="right"><i>End of book</i></td></tr></table></div> + </div> + </div> + </div> + <hr/> + <footer> + <div class="container-fluid"> + <div class="row-fluid"> + <p>Copyright ©2005–2018 +<a href="https://www.apache.org/";>The Apache Software Foundation</a>. +All rights reserved.</p> + </div> + </div> + </footer> + </body> +</html> \ No newline at end of file Added: maven/doxia/website/content/doxia-example-book/transport-and-channel-api.html URL: http://svn.apache.org/viewvc/maven/doxia/website/content/doxia-example-book/transport-and-channel-api.html?rev=1829011&view=auto ============================================================================== --- maven/doxia/website/content/doxia-example-book/transport-and-channel-api.html (added) +++ maven/doxia/website/content/doxia-example-book/transport-and-channel-api.html Thu Apr 12 21:22:02 2018 @@ -0,0 +1,213 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia Site Renderer 1.8 from target/generated-site/xdoc/doxia-example-book/transport-and-channel-api.xml at 2018-04-12 + | Rendered using Apache Maven Fluido Skin 1.7 +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="author" content="XFire User's Guide" /> + <meta name="Date-Revision-yyyymmdd" content="20180412" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Doxia – Transport and Channel API</title> + <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" /> + <link rel="stylesheet" href="../css/site.css" /> + <link rel="stylesheet" href="../css/print.css" media="print" /> + <script type="text/javascript" src="../js/apache-maven-fluido-1.7.min.js"></script> + <!-- Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-140879-1']); + _gaq.push(['_trackPageview']); + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + </head> + <body class="topBarDisabled"> + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"><a href="https://www.apache.org/"; id="bannerLeft"><img src="../../images/apache-maven-project.png" alt="Doxia Site"/></a></div> + <div class="pull-right"><a href=".././" id="bannerRight"><img src="../images/doxia-logo.png" alt="Doxia"/></a></div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li class=""><a href="https://www.apache.org/"; class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> + <li class=""><a href="../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> + <li class=""><a href="http://maven.apache.org/doxia/index.html"; class="externalLink" title="Doxia">Doxia</a><span class="divider">/</span></li> + <li class="active ">Transport and Channel API</li> + <li id="publishDate" class="pull-right">Last Published: 2018-04-12</li> + </ul> + </div> + <div class="row-fluid"> + <div id="leftColumn" class="span2"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">About Doxia</li> + <li><a href="../index.html" title="What is Doxia?"><span class="none"></span>What is Doxia?</a></li> + <li><a href="../overview.html" title="Overview"><span class="none"></span>Overview</a></li> + <li><a href="../upgrading.html" title="Upgrading"><span class="icon-chevron-right"></span>Upgrading</a></li> + <li><a href="../downloads.html" title="Downloads"><span class="none"></span>Downloads</a></li> + <li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> + <li class="nav-header">Documentation</li> + <li><a href="../references/index.html" title="Format References"><span class="icon-chevron-right"></span>Format References</a></li> + <li><a href="../modules/index.html" title="Doxia Modules Guide"><span class="none"></span>Doxia Modules Guide</a></li> + <li><a href="../macros/index.html" title="Doxia Macros Guide"><span class="none"></span>Doxia Macros Guide</a></li> + <li><a href="../book/index.html" title="Writing Books"><span class="none"></span>Writing Books</a></li> + <li><a href="../issues/index.html" title="Issues & Gotchas"><span class="none"></span>Issues & Gotchas</a></li> + <li><a href="../resources.html" title="External Resources"><span class="none"></span>External Resources</a></li> + <li class="nav-header">Developer Docs</li> + <li><a href="../developers/index.html" title="Developer Centre"><span class="icon-chevron-right"></span>Developer Centre</a></li> + <li><a href="../doxia/index.html" title="Doxia 1.8"><span class="icon-chevron-down"></span>Doxia 1.8</a> + <ul class="nav nav-list"> + <li><a href="../doxia/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 1.7"><span class="icon-chevron-down"></span>Doxia 1.7</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.7.5/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 1.6"><span class="icon-chevron-down"></span>Doxia 1.6</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.6/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia/index.html" title="Doxia 1.5"><span class="icon-chevron-down"></span>Doxia 1.5</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.5/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 1.4"><span class="icon-chevron-down"></span>Doxia 1.4</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.4/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 1.3"><span class="icon-chevron-down"></span>Doxia 1.3</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.3/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 1.2"><span class="icon-chevron-down"></span>Doxia 1.2</a> + <ul class="nav nav-list"> + <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia base"><span class="none"></span>Doxia base</a></li> + <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.2/index.html" title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li> + </ul> +</li> + <li><a href="../doxia-tools/index.html" title="Doxia Tools"><span class="none"></span>Doxia Tools</a></li> + <li><a href="../doxia-ide.html" title="Doxia IDE"><span class="none"></span>Doxia IDE</a></li> + <li class="nav-header">Project Documentation</li> + <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> + <li class="nav-header">Maven Projects</li> + <li><a href="../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> + <li><a href="../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> + <li><a href="../index.html" title="Doxia"><span class="none"></span>Doxia</a></li> + <li><a href="../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> + <li><a href="../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> + <li><a href="../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> + <li><a href="../../plugins/index.html" title="Plugins"><span class="none"></span>Plugins</a></li> + <li><a href="../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> + <li><a href="../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> + <li><a href="../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> + <li><a href="../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> + <li><a href="../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> + <li><a href="../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> + <li><a href="../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> + <li><a href="../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> + <li class="nav-header">ASF</li> + <li><a href="https://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="https://www.apache.org/foundation/"; class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="https://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="https://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> +</ul> +<form id="search-form" action="https://www.google.com/search"; method="get" > + <input value="$sitesearchValue" name="sitesearch" type="hidden"/> + <input class="search-query" name="q" id="query" type="text" /> +</form> +<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> + <hr /> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div id="twitter"> + <a href="https://twitter.com/ASFMavenProject"; class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> + <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> + </div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> + </div> + </div> + </div> + <div id="bodyColumn" class="span10" > +<div class="section"> +<h2></h2> +<table class="table table-striped" width="100%" align="center" border="0"> +<tr class="a"> +<td align="left">Previous: <a href="transports.html">Transports</a></td> +<td align="center">Up: <a href="transports.html">Transports</a></td> +<td align="right">Next: <a href="http-transport.html">HTTP Transport</a></td></tr></table><hr /></div> +<div class="section"> +<h2><a name="Transports_and_Channels"></a>Transports and Channels</h2> +<p>Channels and Transports provide the basic unit of communication in XFire. A Channel simply sends messages (via send()) and listens for messages (via receive()). If you want to send a message to a particular URL you do:</p> +<div class="source"><pre class="prettyprint linenums">TransportManager tm = ...; +Transport t = tm.getTransportForUri("http://foo"); + +OutMessage msg = ...; // create an outmessage yourself +Channel c = t.createChannel(); // create an anonymous endpoint +MessageContext context = new MessageContext(); +c.send(msg, context);</pre></div> +<p>Each transport is responsible for creating its own protocol specific listener, for example a servlet in the case of HTTP. This listener then passes whatever messages it receives to the channel via Channel.receive(MessageContext, InMessage). Channels simply delegate their receive() to a ChannelEndpoint which application specific handling of what to do with the message. The default endpoint is aptly named DefaultEndpoint and will be covered in the next section.</p> +<div class="section"> +<h3><a name="InMessage_and_OutMessage"></a>InMessage and OutMessage</h3></div> +<div class="section"> +<h3><a name="MessageSerializer"></a>MessageSerializer</h3> +<p>Each OutMessage has a MessageSerializer. A message serializer takes the message body (message.getBody()) and writes it to an XMLStreamWriter that the Channel provides. The semantics of MessageSerializers should be such that they can be invoked multiple times.</p></div> +<div class="section"> +<h3><a name="Channels.2FTransports_without_Services"></a>Channels/Transports without Services</h3> +<p>Its important to note that Channels and transports are completely independent of XFire's Services. So I can use a channel to send a receive messages and never even create a service. I simply need to provide my own ChannelEndpoint.</p></div> +<div class="section"> +<h3><a name="DefaultEndpoint_and_the_processing_flow"></a>DefaultEndpoint and the processing flow</h3> +<p>DefaultEndpoint takes a message, creates a default message exchange called InMessageExchange and creates a message pipeline. The message pipeline at first consists of the global in handlers from XFire.getInHandlers() and the transport handlers from Transport.getInHandlers. Later on when the service is resolved, the service's handlers get added into the pipeline. Once the operation is resolved, if there is an out message to be set an Out pipeline is created and added to the MessageContext.</p></div> +<div class="section"> +<h3><a name="Phases_and_Handlers"></a>Phases and Handlers</h3> +<p>See Processing Pipeline for now.</p></div> +<div class="section"> +<h3><a name="SOAP_Processing"></a>SOAP Processing</h3> +<p>SOAPTransport.createTransport() adds SOAP support to a particular transport. It does so by adding three additional handlers:</p> +<ol style="list-style-type: decimal"> +<li>ReadHeaderHandler - this handler reads in the soap headers. It stops reading the XML stream the moment the whitespace stops after the <i>Body</i> tag. If it encounters a <i>Fault</i> in the Body, an XFireFault is thrown. [[1]] ValidateHeadersHandler - Ensure that all the necessary headers are understood by the receiving handlers. [[1]] SoapSerializerHandler - Services provide a MessageSerializer of their own which is responsible for serializing the soap body. But what about the message headers? This is written out by the SoapSerializer. What the SoapSerializerHandler does is replace the outMessage.MessageSerializer with new SoapSerializer(outMsg.getMessageSerializer()).</li></ol></div> +<div class="section"> +<h3><a name="MessageExchanges"></a>MessageExchanges</h3></div></div> +<div class="section"> +<h2></h2><hr /> +<table class="table table-striped" width="100%" align="center" border="0"> +<tr class="a"> +<td align="left">Previous: <a href="transports.html">Transports</a></td> +<td align="center">Up: <a href="transports.html">Transports</a></td> +<td align="right">Next: <a href="http-transport.html">HTTP Transport</a></td></tr></table></div> + </div> + </div> + </div> + <hr/> + <footer> + <div class="container-fluid"> + <div class="row-fluid"> + <p>Copyright ©2005–2018 +<a href="https://www.apache.org/";>The Apache Software Foundation</a>. +All rights reserved.</p> + </div> + </div> + </footer> + </body> +</html> \ No newline at end of file
