You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mina.apache.org by bu...@apache.org on 2012/11/15 14:09:01 UTC
svn commit: r838429 [9/9] - in /websites/staging/mina/trunk/content: ./
asyncweb-project/ ftpserver-project/ vysper-project/
Added: websites/staging/mina/trunk/content/vysper-project/sources.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper-project/sources.html (added)
+++ websites/staging/mina/trunk/content/vysper-project/sources.html Thu Nov 15 13:08:54 2012
@@ -0,0 +1,186 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Sources — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/mina.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ <strong>Apache MINA Project</strong>
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+
+ <div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../downloads-mina.html">Mina 2.0.7</a></li>
+ <li><a href="./../downloads-ftpserver.html">FtpServer 1.0.6</a></li>
+ <li><a href="./../downloads-sshd.html">SSHD 0.8.0</a></li>
+ <li><a href="./../downloads-vysper.html">Vysper 0.7</a></li>
+ </ul>
+ <h5>Projects</h5>
+ <ul>
+ <li><a href="./../mina/index.html">MINA</a></li>
+ <li><a href="./../asyncweb/index.html">AsyncWeb</a></li>
+ <li><a href="./../ftpserver/index.html">FtpServer</a></li>
+ <li><a href="./../sshd/index.html">SSHD</a></li>
+ <li><a href="./../vysper/index.html">Vysper</a></li>
+ </ul>
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="./../contributors.html" class="external-link" rel="nofollow">Team</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html" class="external-link" rel="nofollow">Contributing</a></li>
+ <li><a href="http://www.apache.org/" title="Apache Software Foundation" class="external-link" rel="nofollow">ASF main site</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship program" class="external-link" rel="nofollow">Sponsorship program</a></li>
+ <li><a href="http://www.apache.org/security/" class="external-link" rel="nofollow">Security</a></li>
+ </ul>
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+
+</div>
+
+<!-- navigation -->
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+
+<h1 id="getting-the-source">Getting the source</h1>
+<p>This project uses Subversion to manage its source code. Instructions on Subversion use can be found at <a href="http://svnbook.red-bean.com/">http://svnbook.red-bean.com/</a>. If you are on Windows, the excellent <a href="http://tortoisesvn.tigris.org/">TortoiseSVN</a> client is highly recommended.</p>
+<h2 id="web-access">Web Access</h2>
+<p>The following is a link to the <a href="http://svn.apache.org/viewvc/mina/vysper">online source repository</a>.</p>
+<h2 id="anonymous-access">Anonymous access</h2>
+<p>The source can be checked out anonymously from SVN with this command:</p>
+<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">checkout</span> <span class="n">http:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/mina/</span><span class="n">vysper</span><span class="o">/</span><span class="n">trunk</span> <span class="n">vysper</span>
+</pre></div>
+
+
+<h2 id="developer-access">Developer access</h2>
+<p>Everyone can access the Subversion repository via HTTPS, but Committers must checkout the Subversion repository via HTTPS.</p>
+<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">checkout</span> <span class="n">https:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/mina/</span><span class="n">vysper</span><span class="o">/</span><span class="n">trunk</span> <span class="n">vysper</span>
+</pre></div>
+
+
+<p>To commit changes to the repository, execute the following command to commit your changes (svn will prompt you for your password)</p>
+<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">commit</span> <span class="o">--</span><span class="n">username</span> <span class="n">your</span><span class="o">-</span><span class="n">username</span> <span class="o">-</span><span class="n">m</span> <span class="o">&</span><span class="n">quot</span><span class="p">;</span><span class="n">A</span> <span class="n">message</span><span class="o">&</span><span class="n">quot</span><span class="p">;</span>
+</pre></div>
+
+
+<h2 id="access-from-behind-a-firewall">Access from behind a firewall</h2>
+<p>For those users who are stuck behind a corporate firewall which is blocking http access to the Subversion repository, you can try to access it via the developer connection:</p>
+<div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span> <span class="n">checkout</span> <span class="n">https:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/mina/</span><span class="n">vysper</span><span class="o">/</span><span class="n">trunk</span> <span class="n">vysper</span>
+</pre></div>
+
+
+<h2 id="access-through-a-proxy">Access through a proxy</h2>
+<p>The Subversion client can go through a proxy, if you configure it to do so. First, edit your "servers" configuration file to indicate which proxy to use. The files location depends on your operating system. On Linux or Unix it is located in the directory "~/.subversion". On Windows it is in "%APPDATA%\Subversion". (Try "echo %APPDATA%", note this is a hidden directory.)</p>
+<p>There are comments in the file explaining what to do. If you don't have that file, get the latest Subversion client and run any command; this will cause the configuration directory and template files to be created.</p>
+<p>Example : Edit the 'servers' file and add something like :</p>
+<div class="codehilite"><pre><span class="k">[global]</span>
+<span class="na">http-proxy-host</span> <span class="o">=</span> <span class="s">your.proxy.name</span>
+<span class="na">http-proxy-port</span> <span class="o">=</span> <span class="s">3128</span>
+</pre></div>
+
+
+<h2 id="building">Building</h2>
+<p>We use Maven for managing our dependencies and packaging. Please use Maven 2.2.1 or later.
+To install all of Vysper (core, modules etc) you can try this after the checkout:</p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span class="n">clean</span> <span class="n">install</span>
+</pre></div>
+
+
+<p>You can also build a complete, runnable Vysper server:</p>
+<div class="codehilite"><pre><span class="n">cd</span> <span class="n">dist</span>
+<span class="n">mvn</span> <span class="n">clean</span> <span class="nb">package</span>
+</pre></div>
+
+
+<p>On successful build, you will find a functional binary package at</p>
+<div class="codehilite"><pre><span class="n">target</span><span class="o">/</span><span class="n">vysper</span><span class="o">-</span><span class="mf">1.0.0</span><span class="o">-</span><span class="n">SNAPSHOT</span><span class="o">-</span><span class="n">bin</span><span class="o">.</span><span class="p">{</span><span class="n">zip</span><span class="o">|</span><span class="n">tar</span><span class="o">.</span><span class="n">gz</span><span class="p">}</span>
+</pre></div>
+
+
+<p>Unpackaging a bin-package reveals a bin/ directory, containing run-scripts for Windows and Unix/MacOS.
+Executing this script will boot a working Vysper XMPP server.</p>
+
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper-project/standards_supported.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper-project/standards_supported.html (added)
+++ websites/staging/mina/trunk/content/vysper-project/standards_supported.html Thu Nov 15 13:08:54 2012
@@ -0,0 +1,251 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Standards Supported — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/mina.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ <strong>Apache MINA Project</strong>
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+
+ <div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../downloads-mina.html">Mina 2.0.7</a></li>
+ <li><a href="./../downloads-ftpserver.html">FtpServer 1.0.6</a></li>
+ <li><a href="./../downloads-sshd.html">SSHD 0.8.0</a></li>
+ <li><a href="./../downloads-vysper.html">Vysper 0.7</a></li>
+ </ul>
+ <h5>Projects</h5>
+ <ul>
+ <li><a href="./../mina/index.html">MINA</a></li>
+ <li><a href="./../asyncweb/index.html">AsyncWeb</a></li>
+ <li><a href="./../ftpserver/index.html">FtpServer</a></li>
+ <li><a href="./../sshd/index.html">SSHD</a></li>
+ <li><a href="./../vysper/index.html">Vysper</a></li>
+ </ul>
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="./../contributors.html" class="external-link" rel="nofollow">Team</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html" class="external-link" rel="nofollow">Contributing</a></li>
+ <li><a href="http://www.apache.org/" title="Apache Software Foundation" class="external-link" rel="nofollow">ASF main site</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship program" class="external-link" rel="nofollow">Sponsorship program</a></li>
+ <li><a href="http://www.apache.org/security/" class="external-link" rel="nofollow">Security</a></li>
+ </ul>
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+
+</div>
+
+<!-- navigation -->
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+
+<h1 id="standards-supported">Standards Supported</h1>
+<table>
+<thead>
+<tr>
+<th>Specification</th>
+<th>Status</th>
+<th>Comment</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="http://www.ietf.org/rfc/rfc3920.txt">RFC 3920 XMPP Core</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://www.ietf.org/rfc/rfc3921.txt">RFC 3921 XMPP Instant Messaging and Presence</a></td>
+<td>80%</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0004.html">XEP-0004 Data Forms</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0030.html">XEP-0030 Service Discovery</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0045.html">XEP-0045 Multi-User Chat</a></td>
+<td>80%</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0029.html">XEP-0049 Private XML Storage</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0050.html">XEP-0050 Ad-Hoc Commands</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0054.html">XEP-0054 vcard-temp</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0060.html">XEP-0060 Publish-Subscribe</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0065.html">XEP-0065 SOCKS5 Bytestreams</a></td>
+<td>Complete</td>
+<td>The optional UDP support not implemented</td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0077.html">XEP-0077 In-band registration</a></td>
+<td>80%</td>
+<td>Canceling existing registration not supported</td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0082.html">XEP-0082 XMPP Date and Time Profiles</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0092.html">XEP-0092 Software Version</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0124.html">XEP-0124 Bidirectional-streams Over Synchronous HTTP (BOSH)</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0133.html">XEP-0133 Service Administration</a></td>
+<td>40%</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0185.html">XEP-0185 Dialback Key Generation and Validation</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0199.html">XEP-0199 XMPP Ping</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0202.html">XEP-0202 Entity Time</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0206.html">XEP-0206 XMPP Over BOSH</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0220.html">XEP-0220 Server Dialback</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://xmpp.org/extensions/xep-0220.html">XEP-0220 Server Dialback</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+<tr>
+<td><a href="http://tools.ietf.org/html/draft-moffitt-xmpp-over-websocket-00">An XMPP Sub-protocol for WebSocket</a></td>
+<td>Complete</td>
+<td> </td>
+</tr>
+</tbody>
+</table>
+
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper-project/stanza_processing_layer.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper-project/stanza_processing_layer.html (added)
+++ websites/staging/mina/trunk/content/vysper-project/stanza_processing_layer.html Thu Nov 15 13:08:54 2012
@@ -0,0 +1,137 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Stanza Processing — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/mina.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ <strong>Apache MINA Project</strong>
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+
+ <div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../downloads-mina.html">Mina 2.0.7</a></li>
+ <li><a href="./../downloads-ftpserver.html">FtpServer 1.0.6</a></li>
+ <li><a href="./../downloads-sshd.html">SSHD 0.8.0</a></li>
+ <li><a href="./../downloads-vysper.html">Vysper 0.7</a></li>
+ </ul>
+ <h5>Projects</h5>
+ <ul>
+ <li><a href="./../mina/index.html">MINA</a></li>
+ <li><a href="./../asyncweb/index.html">AsyncWeb</a></li>
+ <li><a href="./../ftpserver/index.html">FtpServer</a></li>
+ <li><a href="./../sshd/index.html">SSHD</a></li>
+ <li><a href="./../vysper/index.html">Vysper</a></li>
+ </ul>
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="./../contributors.html" class="external-link" rel="nofollow">Team</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html" class="external-link" rel="nofollow">Contributing</a></li>
+ <li><a href="http://www.apache.org/" title="Apache Software Foundation" class="external-link" rel="nofollow">ASF main site</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship program" class="external-link" rel="nofollow">Sponsorship program</a></li>
+ <li><a href="http://www.apache.org/security/" class="external-link" rel="nofollow">Security</a></li>
+ </ul>
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+
+</div>
+
+<!-- navigation -->
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+
+<h1 id="stanza-processing">Stanza Processing</h1>
+<p>Commands in the XMPP world are called Stanzas.</p>
+<p>At the transport layer, when going over the net between client and server, they have a textual representation in XML.</p>
+<p>In Vysper, the Stanza processing layer only deals with Stanza java objects. They are created by the transport layer, or using Builder utility classes from within Vysper. That makes this layer independent from any underlying transport layer. Stanzas are directly injectable on this level. This helps when testing. It makes accessing specific stanza elements easier.</p>
+<p>Every Stanza is processed in the context of a Session and a Server. The general approach is comparable to the Servlet architecture.
+A Session has a state which indicates how far the process of stream negotiation has advanced. The protocol worker determines that the incoming stanza can be processed, depending on the session state. Otherwise, an stream error is returned. For example, Message stanzas can only be compliantly processed after the session is bound to a resource.</p>
+<p>In the next step, the protocol worker searches for the right Stanza Handler. This often requires inspecting the Stanza,
+The handler incorporates the actual command execution logic.</p>
+
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper-project/test_client.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper-project/test_client.html (added)
+++ websites/staging/mina/trunk/content/vysper-project/test_client.html Thu Nov 15 13:08:54 2012
@@ -0,0 +1,142 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Using the test client — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/mina.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ <strong>Apache MINA Project</strong>
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+
+ <div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../downloads-mina.html">Mina 2.0.7</a></li>
+ <li><a href="./../downloads-ftpserver.html">FtpServer 1.0.6</a></li>
+ <li><a href="./../downloads-sshd.html">SSHD 0.8.0</a></li>
+ <li><a href="./../downloads-vysper.html">Vysper 0.7</a></li>
+ </ul>
+ <h5>Projects</h5>
+ <ul>
+ <li><a href="./../mina/index.html">MINA</a></li>
+ <li><a href="./../asyncweb/index.html">AsyncWeb</a></li>
+ <li><a href="./../ftpserver/index.html">FtpServer</a></li>
+ <li><a href="./../sshd/index.html">SSHD</a></li>
+ <li><a href="./../vysper/index.html">Vysper</a></li>
+ </ul>
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="./../contributors.html" class="external-link" rel="nofollow">Team</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html" class="external-link" rel="nofollow">Contributing</a></li>
+ <li><a href="http://www.apache.org/" title="Apache Software Foundation" class="external-link" rel="nofollow">ASF main site</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship program" class="external-link" rel="nofollow">Sponsorship program</a></li>
+ <li><a href="http://www.apache.org/security/" class="external-link" rel="nofollow">Security</a></li>
+ </ul>
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+
+</div>
+
+<!-- navigation -->
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+
+<h1 id="using-the-test-client">Using the test client</h1>
+<p>The test clients builds on the XMPP client library Smack.
+It takes two parameters:</p>
+<ul>
+<li>login name for the 'from' user</li>
+<li>login name for the 'to' user</li>
+</ul>
+<p>The domain is assumed to be 'vysper.org', the password to be 'password1'.
+This relates to the default users corrently configured in the default spring configuration file.</p>
+<p>The client logs into the server with the 'from' user login and starts to send messages to the 'to' user.</p>
+<p>The client is invoked similar to the server like this:</p>
+<div class="codehilite"><pre><span class="n">java</span> <span class="n">org</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">vysper</span><span class="o">.</span><span class="n">smack</span><span class="o">.</span><span class="n">BasicClient</span> <span class="n">user1</span> <span class="n">user2</span>
+</pre></div>
+
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper-project/user_guide.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper-project/user_guide.html (added)
+++ websites/staging/mina/trunk/content/vysper-project/user_guide.html Thu Nov 15 13:08:54 2012
@@ -0,0 +1,140 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper User Guide — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/mina.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ <strong>Apache MINA Project</strong>
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+
+ <div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../downloads-mina.html">Mina 2.0.7</a></li>
+ <li><a href="./../downloads-ftpserver.html">FtpServer 1.0.6</a></li>
+ <li><a href="./../downloads-sshd.html">SSHD 0.8.0</a></li>
+ <li><a href="./../downloads-vysper.html">Vysper 0.7</a></li>
+ </ul>
+ <h5>Projects</h5>
+ <ul>
+ <li><a href="./../mina/index.html">MINA</a></li>
+ <li><a href="./../asyncweb/index.html">AsyncWeb</a></li>
+ <li><a href="./../ftpserver/index.html">FtpServer</a></li>
+ <li><a href="./../sshd/index.html">SSHD</a></li>
+ <li><a href="./../vysper/index.html">Vysper</a></li>
+ </ul>
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="./../contributors.html" class="external-link" rel="nofollow">Team</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html" class="external-link" rel="nofollow">Contributing</a></li>
+ <li><a href="http://www.apache.org/" title="Apache Software Foundation" class="external-link" rel="nofollow">ASF main site</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship program" class="external-link" rel="nofollow">Sponsorship program</a></li>
+ <li><a href="http://www.apache.org/security/" class="external-link" rel="nofollow">Security</a></li>
+ </ul>
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+
+</div>
+
+<!-- navigation -->
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+
+<h1 id="user-guide">User Guide</h1>
+<ul>
+<li><a href="dependencies.html">Dependencies</a></li>
+<li><a href="embed.html">Embed into another application</a></li>
+<li><a href="extending_server.html">Extending the Server</a></li>
+<li><a href="extension_roadmap.html">Extension Roadmap</a></li>
+<li><a href="server_standalone.html">Run Server Standalone</a></li>
+<li><a href="service_discovery.html">Service Discovery</a></li>
+<li><a href="test_client.html">Test client</a></li>
+<li><a href="xml_processing.html">XML Processing</a></li>
+</ul>
+
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper-project/user_mgmt.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper-project/user_mgmt.html (added)
+++ websites/staging/mina/trunk/content/vysper-project/user_mgmt.html Thu Nov 15 13:08:54 2012
@@ -0,0 +1,190 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper User Management — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/mina.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ <strong>Apache MINA Project</strong>
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+
+ <div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../downloads-mina.html">Mina 2.0.7</a></li>
+ <li><a href="./../downloads-ftpserver.html">FtpServer 1.0.6</a></li>
+ <li><a href="./../downloads-sshd.html">SSHD 0.8.0</a></li>
+ <li><a href="./../downloads-vysper.html">Vysper 0.7</a></li>
+ </ul>
+ <h5>Projects</h5>
+ <ul>
+ <li><a href="./../mina/index.html">MINA</a></li>
+ <li><a href="./../asyncweb/index.html">AsyncWeb</a></li>
+ <li><a href="./../ftpserver/index.html">FtpServer</a></li>
+ <li><a href="./../sshd/index.html">SSHD</a></li>
+ <li><a href="./../vysper/index.html">Vysper</a></li>
+ </ul>
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="./../contributors.html" class="external-link" rel="nofollow">Team</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html" class="external-link" rel="nofollow">Contributing</a></li>
+ <li><a href="http://www.apache.org/" title="Apache Software Foundation" class="external-link" rel="nofollow">ASF main site</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship program" class="external-link" rel="nofollow">Sponsorship program</a></li>
+ <li><a href="http://www.apache.org/security/" class="external-link" rel="nofollow">Security</a></li>
+ </ul>
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+
+</div>
+
+<!-- navigation -->
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+
+<h1 id="user-management">User Management</h1>
+<p>Apache Vysper comes with very basic user management support out of the box. But, frequently you would rather want to integrate Vysper with your already existing authentication solution. To enable this, Vysper comes with a simple API to implement your own authentication and user management.</p>
+<h2 id="authentication">Authentication</h2>
+<p>UserAuthentication is the interface which will get called when a client authenticates itself using SASL. Vysper currently ships with two implementations, one in-memory and one based on JCR. To write your own, simple create a class which implements UserAuthentication. In the example below, we implement an authentication provider backed by an LDAP directory.</p>
+<div class="codehilite"><pre><span class="kd">public</span> <span class="kd">class</span> <span class="nc">MyLdapAuthentication</span> <span class="kd">implements</span> <span class="n">UserAuthentication</span> <span class="o">{</span>
+ <span class="nd">@Override</span>
+ <span class="kd">public</span> <span class="kt">boolean</span> <span class="nf">verifyCredentials</span><span class="o">(</span><span class="n">Entity</span> <span class="n">jid</span><span class="o">,</span> <span class="n">String</span> <span class="n">passwordCleartext</span><span class="o">,</span> <span class="n">Object</span> <span class="n">credentials</span><span class="o">)</span> <span class="o">{</span>
+ <span class="n">Hashtable</span><span class="o"><</span><span class="n">String</span><span class="o">,</span> <span class="n">String</span><span class="o">></span> <span class="n">env</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Hashtable</span><span class="o"><</span><span class="n">String</span><span class="o">,</span> <span class="n">String</span><span class="o">>();</span>
+ <span class="n">env</span><span class="o">.</span><span class="na">put</span><span class="o">(</span><span class="n">Context</span><span class="o">.</span><span class="na">INITIAL_CONTEXT_FACTORY</span><span class="o">,</span> <span class="s">"com.sun.jndi.ldap.LdapCtxFactory"</span><span class="o">);</span>
+ <span class="n">env</span><span class="o">.</span><span class="na">put</span><span class="o">(</span><span class="n">Context</span><span class="o">.</span><span class="na">PROVIDER_URL</span><span class="o">,</span> <span class="s">"ldap://localhost:389/"</span><span class="o">);</span>
+
+ <span class="n">env</span><span class="o">.</span><span class="na">put</span><span class="o">(</span><span class="n">Context</span><span class="o">.</span><span class="na">SECURITY_AUTHENTICATION</span><span class="o">,</span> <span class="s">"simple"</span><span class="o">);</span>
+
+ <span class="c1">// extract the user name from the entity, e.g. from foo@example.com, foo will be used</span>
+ <span class="n">env</span><span class="o">.</span><span class="na">put</span><span class="o">(</span><span class="n">Context</span><span class="o">.</span><span class="na">SECURITY_PRINCIPAL</span><span class="o">,</span> <span class="n">String</span><span class="o">.</span><span class="na">format</span><span class="o">(</span><span class="s">"cn=%s, ou=Users, o=Acme"</span><span class="o">,</span> <span class="n">jid</span><span class="o">.</span><span class="na">getNode</span><span class="o">()));</span>
+ <span class="n">env</span><span class="o">.</span><span class="na">put</span><span class="o">(</span><span class="n">Context</span><span class="o">.</span><span class="na">SECURITY_CREDENTIALS</span><span class="o">,</span> <span class="n">passwordCleartext</span><span class="o">);</span>
+
+ <span class="k">try</span> <span class="o">{</span>
+ <span class="c1">// connect and authenticate with the directory</span>
+ <span class="k">new</span> <span class="nf">InitialDirContext</span><span class="o">(</span><span class="n">env</span><span class="o">);</span>
+ <span class="k">return</span> <span class="kc">true</span><span class="o">;</span>
+ <span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">NamingException</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="kc">false</span><span class="o">;</span>
+ <span class="o">}</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</pre></div>
+
+
+<p>Next, you need to hook the authentication provider into the Vysper XMPP server:</p>
+<div class="codehilite"><pre><span class="kd">public</span> <span class="kd">static</span> <span class="kt">void</span> <span class="nf">main</span><span class="o">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
+ <span class="n">OpenStorageProviderRegistry</span> <span class="n">providerRegistry</span> <span class="o">=</span> <span class="k">new</span> <span class="n">OpenStorageProviderRegistry</span><span class="o">();</span>
+
+ <span class="c1">// add your custom authentication provider</span>
+ <span class="n">providerRegistry</span><span class="o">.</span><span class="na">add</span><span class="o">(</span><span class="k">new</span> <span class="n">MyLdapAuthentication</span><span class="o">());</span>
+
+ <span class="c1">// a roster manager is also required</span>
+ <span class="n">providerRegistry</span><span class="o">.</span><span class="na">add</span><span class="o">(</span><span class="k">new</span> <span class="n">MemoryRosterManager</span><span class="o">());</span>
+
+ <span class="n">XMPPServer</span> <span class="n">server</span> <span class="o">=</span> <span class="k">new</span> <span class="n">XMPPServer</span><span class="o">(</span><span class="s">"acme.com"</span><span class="o">);</span>
+
+ <span class="c1">// other initialization</span>
+ <span class="c1">// ...</span>
+
+ <span class="n">server</span><span class="o">.</span><span class="na">setStorageProviderRegistry</span><span class="o">(</span><span class="n">providerRegistry</span><span class="o">);</span>
+
+ <span class="n">server</span><span class="o">.</span><span class="na">start</span><span class="o">();</span>
+<span class="o">}</span>
+</pre></div>
+
+
+<p>In this example, we use the OpenStorageProviderRegistry to provide the different storage providers. Only two are required, UserAuthentication and RosterManager.</p>
+<p>That's all that's needed to implement a custom authentication provider.</p>
+<h2 id="user-management_1">User management</h2>
+<p>Some Vysper modules, in particular in-band registration and service administration, requires the ability to add users and change users password. For that, Vysper uses the interface AccountManagement. This interface has three methods:</p>
+<ul>
+<li>addUser(username, password): to add a new user</li>
+<li>changePassword(username, newPassword): to change the password of a user</li>
+<li>verifyAccountExists(username): checks if a user exists</li>
+</ul>
+<p>If you need to make use of any of these modules, provide an AccountManagement implementation in OpenStorageProviderRegistry as in the example above.</p>
+
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper-project/websocket_endpoint.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper-project/websocket_endpoint.html (added)
+++ websites/staging/mina/trunk/content/vysper-project/websocket_endpoint.html Thu Nov 15 13:08:54 2012
@@ -0,0 +1,179 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper Websocket endpoint — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/mina.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ <strong>Apache MINA Project</strong>
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+
+ <div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../downloads-mina.html">Mina 2.0.7</a></li>
+ <li><a href="./../downloads-ftpserver.html">FtpServer 1.0.6</a></li>
+ <li><a href="./../downloads-sshd.html">SSHD 0.8.0</a></li>
+ <li><a href="./../downloads-vysper.html">Vysper 0.7</a></li>
+ </ul>
+ <h5>Projects</h5>
+ <ul>
+ <li><a href="./../mina/index.html">MINA</a></li>
+ <li><a href="./../asyncweb/index.html">AsyncWeb</a></li>
+ <li><a href="./../ftpserver/index.html">FtpServer</a></li>
+ <li><a href="./../sshd/index.html">SSHD</a></li>
+ <li><a href="./../vysper/index.html">Vysper</a></li>
+ </ul>
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="./../contributors.html" class="external-link" rel="nofollow">Team</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html" class="external-link" rel="nofollow">Contributing</a></li>
+ <li><a href="http://www.apache.org/" title="Apache Software Foundation" class="external-link" rel="nofollow">ASF main site</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship program" class="external-link" rel="nofollow">Sponsorship program</a></li>
+ <li><a href="http://www.apache.org/security/" class="external-link" rel="nofollow">Security</a></li>
+ </ul>
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+
+</div>
+
+<!-- navigation -->
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+
+<h1 id="websocket-endpoint">Websocket endpoint</h1>
+<p><DIV class="info" markdown="1">
+ Available since version 0.7.
+</DIV></p>
+<p>While websockets are still being specified, a draft specification for XMPP over websockets has been published at <a href="http://tools.ietf.org/html/draft-moffitt-xmpp-over-websocket-00">http://tools.ietf.org/html/draft-moffitt-xmpp-over-websocket-00</a>. Websockets enables web browsers to establish duplex communications with servers with very little overhead.</p>
+<p>Vysper provides a websocket endpoint. The easiest way to use the endpoint is to simply add it as a regular endpoint:</p>
+<div class="codehilite"><pre><span class="n">XMPPServer</span> <span class="n">server</span> <span class="o">=</span> <span class="k">new</span> <span class="n">XMPPServer</span><span class="o">(</span><span class="s">"vysper.org"</span><span class="o">);</span>
+
+<span class="n">server</span><span class="o">.</span><span class="na">addEndpoint</span><span class="o">(</span><span class="k">new</span> <span class="n">TCPEndpoint</span><span class="o">());</span>
+
+<span class="n">server</span><span class="o">.</span><span class="na">addEndpoint</span><span class="o">(</span><span class="k">new</span> <span class="n">WebSocketEndpoint</span><span class="o">());</span>
+
+<span class="n">server</span><span class="o">.</span><span class="na">start</span><span class="o">();</span>
+</pre></div>
+
+
+<p>Thatâs it. The default configuration will start a web server on port 8080 and supply websockets on <a href="http://vysper.org:8080/">http://vysper.org:8080/</a>.</p>
+<p>The port and context path can be configured:</p>
+<div class="codehilite"><pre><span class="n">WebSocketEndpoint</span> <span class="n">wsEndpoint</span> <span class="o">=</span> <span class="k">new</span> <span class="n">WebSocketEndpoint</span><span class="o">();</span>
+<span class="n">wsEndpoint</span><span class="o">.</span><span class="na">setContextPath</span><span class="o">(</span><span class="s">"/xmpp"</span><span class="o">);</span>
+<span class="n">wsEndpoint</span><span class="o">.</span><span class="na">setPort</span><span class="o">(</span><span class="mi">9000</span><span class="o">);</span>
+<span class="n">server</span><span class="o">.</span><span class="na">addEndpoint</span><span class="o">(</span><span class="n">wsEndpoint</span><span class="o">);</span>
+</pre></div>
+
+
+<h2 id="embedded">Embedded</h2>
+<p>Commonly, thereâs a need to use websockets within the context of a web application. For that purpose, there is a servlet available that can be configured in web.xml inside your regular application.</p>
+<p>Vysper currently supports this for Jetty and Apache Tomcat 7.0.27 or later.</p>
+<p>For Jetty, add the following to your web.xml:</p>
+<div class="codehilite"><pre><span class="n">WebSocketEndpoint</span> <span class="n">wsEndpoint</span> <span class="o">=</span> <span class="k">new</span> <span class="n">WebSocketEndpoint</span><span class="o">();</span>
+<span class="n">wsEndpoint</span><span class="o">.</span><span class="na">setSSLEnabled</span><span class="o">(</span><span class="kc">true</span><span class="o">);</span>
+<span class="n">wsEndpoint</span><span class="o">.</span><span class="na">setSSLCertificateKeystore</span><span class="o">(</span><span class="s">"keystore.jks"</span><span class="o">,</span> <span class="s">"sekrit"</span><span class="o">);</span>
+<span class="n">server</span><span class="o">.</span><span class="na">addEndpoint</span><span class="o">(</span><span class="n">wsEndpoint</span><span class="o">);</span>
+</pre></div>
+
+
+<p>For Tomcat, add the following to your web.xml:</p>
+<div class="codehilite"><pre><span class="nt"><servlet></span>
+ <span class="nt"><servlet-name></span>WebSocket Servlet<span class="nt"></servlet-name></span>
+ <span class="nt"><servlet-class></span>org.apache.vysper.xmpp.extension.websockets.TomcatXmppWebSocketServlet<span class="nt"></servlet-class></span>
+ <span class="nt"><load-on-startup></span>1<span class="nt"></load-on-startup></span>
+<span class="nt"></servlet></span>
+<span class="nt"><servlet-mapping></span>
+ <span class="nt"><servlet-name></span>WebSocket Servlet<span class="nt"></servlet-name></span>
+ <span class="nt"><url-pattern></span>/ws<span class="nt"></url-pattern></span>
+<span class="nt"></servlet-mapping></span>
+</pre></div>
+
+
+<p>Also, when using the servlet, the main Vysper XMPP server needs to be started by some other mean, typically via a context listener. The ServerRuntimeContext of the Vysper server needs to be made available within the servlet context under the key âorg.apache.vysper.xmpp.server.ServerRuntimeContextâ. Thereâs an example application included in the Vysper distribution which does this. The source code is available here: <a href="http://svn.apache.org/repos/asf/mina/vysper/trunk/examples/embedded-war/">http://svn.apache.org/repos/asf/mina/vysper/trunk/examples/embedded-war/</a></p>
+
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/vysper-project/xml_processing.html
==============================================================================
--- websites/staging/mina/trunk/content/vysper-project/xml_processing.html (added)
+++ websites/staging/mina/trunk/content/vysper-project/xml_processing.html Thu Nov 15 13:08:54 2012
@@ -0,0 +1,137 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+<head>
+ <title>Vysper XM Processing — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../css/mina.css" rel="stylesheet" type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ <strong>Apache MINA Project</strong>
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+
+ <div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../downloads-mina.html">Mina 2.0.7</a></li>
+ <li><a href="./../downloads-ftpserver.html">FtpServer 1.0.6</a></li>
+ <li><a href="./../downloads-sshd.html">SSHD 0.8.0</a></li>
+ <li><a href="./../downloads-vysper.html">Vysper 0.7</a></li>
+ </ul>
+ <h5>Projects</h5>
+ <ul>
+ <li><a href="./../mina/index.html">MINA</a></li>
+ <li><a href="./../asyncweb/index.html">AsyncWeb</a></li>
+ <li><a href="./../ftpserver/index.html">FtpServer</a></li>
+ <li><a href="./../sshd/index.html">SSHD</a></li>
+ <li><a href="./../vysper/index.html">Vysper</a></li>
+ </ul>
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="./../contributors.html" class="external-link" rel="nofollow">Team</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</a></li>
+ <li><a href="http://www.apache.org/foundation/contributing.html" class="external-link" rel="nofollow">Contributing</a></li>
+ <li><a href="http://www.apache.org/" title="Apache Software Foundation" class="external-link" rel="nofollow">ASF main site</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship program" class="external-link" rel="nofollow">Sponsorship program</a></li>
+ <li><a href="http://www.apache.org/security/" class="external-link" rel="nofollow">Security</a></li>
+ </ul>
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+
+</div>
+
+<!-- navigation -->
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+
+<h1 id="xml-processing">XML Processing</h1>
+<p>XML data is the payload of the XMPP protocol. More precisely, XMPP only works on a subset of XML. See RFC3920 for details.</p>
+<p>The core handler and protocol code does not deal with xml strings directly. They only deal with java objects representing well-formed XMPP commands, called stanzas.</p>
+<p>To create these objects, the actual XML is processed in stages at the xml processing layer.</p>
+<p>While raw XML continues streaming in, we are faced with arbitrary partitioned stanza and even partial xml. We have to determine the end of a stanza to process it.
+A stanza can go over multiple lines so the line end is not a useful indicator for command boundaries. We have to check for the stanza's closing element.</p>
+<p>What we do is every time new characters arrive in the character stream, we cut what we got into two kinds of fragments, those starting with < and ending with >, and those containing all the characters in between > and <. These fragments are analyzed if they could result in balanced xml. If not, we wait for more data to come.</p>
+<p>At the next stage, fragments are more extensively parsed and if everything works out fine, a Stanza java object is constructed from it and forwarded to the <a href="stanza_processing_layer.html">stanza processing layer</a>.</p>
+
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd, Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+