[prev in list] [next in list] [prev in thread] [next in thread]
List: mina-commits
Subject: svn commit: r1042586 - in /websites/staging/mina/trunk/content: ./ mina-project/userguide/ch1-gettin
From: buildbot () apache ! org
Date: 2019-03-27 5:50:09
Message-ID: 20190327055009.5085B3A01C3 () svn01-us-west ! apache ! org
[Download RAW message or body]
Author: buildbot
Date: Wed Mar 27 05:50:09 2019
New Revision: 1042586
Log:
Staging update by buildbot for mina
Added:
websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.1-nio-overview.html
websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.2-why-mina.html
websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.3-features.html
websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.4-first-steps.html
websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.5-summary.html
Removed:
websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/features.html
websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/first-steps.html
websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/nio-overview.html
websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/summary.html
websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/why-mina.html
Modified:
websites/staging/mina/trunk/content/ (props changed)
Propchange: websites/staging/mina/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Mar 27 05:50:09 2019
@@ -1 +1 @@
-1856366
+1856367
Added: websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.1-nio-overview.html
==============================================================================
--- websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.1-nio-overview.html \
(added)
+++ websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.1-nio-overview.html \
Wed Mar 27 05:50:09 2019 @@ -0,0 +1,258 @@
+<!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>1.1 - NIO Overview — Apache MINA</title>
+
+ <link href="./../../../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../../../css/mina.css" rel="stylesheet" type="text/css">
+
+
+ <link rel="shortcut icon" \
href="./../../../staticresources/images/mina-icon_16x16.png"/> +
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../../../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../../../mina-project/index.html">
+
+ <strong>MINA</strong>
+
+ </a>
+ |
+ <a href="./../../../asyncweb-project/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../../../ftpserver-project/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../../../sshd-project/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../../../vysper-project/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > \
.headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > \
.elementid-permalink { visibility: visible }</style> +<div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../../../mina-project/downloads_2_0.html">Mina \
2.0.20</a></li> + <li><a \
href="./../../../mina-project/downloads_2_1.html">Mina 2.1.0</a></li> + <li><a \
href="./../../../mina-project/downloads_old.html">Mina old versions</a></li> + \
</ul> + <h5>Documentation</h5>
+ <ul>
+ <li><a href="./../../../mina-project/documentation.html" class="external-link" \
rel="nofollow">Base documentation</a></li> + <li><a \
href="./../../../mina-project/userguide/user-guide-toc.html" class="external-link" \
rel="nofollow">User guide</a></li> + <li><a \
href="./../../../mina-project/2.1-vs-2.0.html" class="external-link" \
rel="nofollow">2.1 vs 2.0</a></li> + <li><a \
href="./../../../mina-project/features.html" class="external-link" \
rel="nofollow">Features</a></li> + <li><a \
href="./../../../mina-project/road-map.html" class="external-link" \
rel="nofollow">Road Map</a></li> + <li><a \
href="./../../../mina-project/quick-start-guide.html" class="external-link" \
rel="nofollow">Quick Start Guide</a></li> + <li><a \
href="./../../../mina-project/faq.html" class="external-link" \
rel="nofollow">FAQ</a></li> + </ul>
+ <h5>Resources</h5>
+ <ul>
+ <li><a href="./../../../mina-project/mailing-lists.html" class="external-link" \
rel="nofollow">Mailing lists & IRC</a></li> + <li><a \
href="./../../../mina-project/issue-tracking.html" class="external-link" \
rel="nofollow">Issue tracking</a></li> + <li><a \
href="./../../../mina-project/sources.html" class="external-link" \
rel="nofollow">Sources</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.0/apidocs/index.html" \
class="external-link" rel="nofollow">API Javadoc 2.0.20</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.1/apidocs/index.html" \
class="external-link" rel="nofollow">API Javadoc 2.1.0</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.0/xref/index.html" \
class="external-link" rel="nofollow">API xref 2.0.20</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.1/xref/index.html" \
class="external-link" rel="nofollow">API xref 2.1.0</a></li> + <li><a \
href="./../../../mina-project/performances.html" class="external-link" \
rel="nofollow">Performances</a></li> + <li><a \
href="./../../../mina-project/testimonials.html" class="external-link" \
rel="nofollow">Testimonials</a></li> + <li><a \
href="./../../../mina-project/conferences.html" class="external-link" \
rel="nofollow">Conferences</a></li> + <li><a \
href="./../../../mina-project/developer-guide.html" class="external-link" \
rel="nofollow">Developers Guide</a></li> + <li><a \
href="./../../../mina-project/related-projects.html" class="external-link" \
rel="nofollow">Related Projects</a></li> + <li><a \
href="https://people.apache.org/~vgritsenko/stats/projects/mina.html" \
class="external-link" rel="nofollow">Statistics</a></li> + </ul>
+
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="https://www.apache.org/foundation/contributing.html" \
class="external-link" rel="nofollow">Contributing</a></li> + <li><a \
href="./../../../contributors.html" class="external-link" \
rel="nofollow">Team</a></li> + <li><a href="./../../../special-thanks.html" \
class="external-link" rel="nofollow">Special Thanks</a></li> + <li><a \
href="https://www.apache.org/security/" class="external-link" \
rel="nofollow">Security</a></li> + </ul>
+
+
+ <h5>About Apache</h5>
+ <ul>
+ <li><a href="https://www.apache.org" class="external-link" \
rel="nofollow">Apache main site</a></li> + <li><a \
href="https://www.apache.org/licenses/" class="external-link" \
rel="nofollow">License</a></li> + <li><a \
href="https://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship \
program" class="external-link" rel="nofollow">Sponsorship program</a></li> + \
<li><a href="https://www.apache.org/foundation/thanks.html" class="external-link" \
rel="nofollow">Thanks</a></li> + </ul>
+
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+ <ul>
+ <li>No event</li>
+ </ul>
+
+</div>
+
+<!-- navigation -->
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+ <div class="nav">
+ <div class="nav_prev">
+
+
+
+ </div>
+ <div class="nav_up">
+
+ <a href="ch1-getting-started.html">Chapter 1 - Getting Started</a>
+
+ </div>
+ <div class="nav_next">
+
+ <a href="ch1.2-why-mina.html">1.2 - Why MINA ?</a>
+
+ </div>
+ <div class="clearfix"></div>
+ </div>
+
+
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > \
.headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > \
.elementid-permalink { visibility: visible }</style> +<h1 id="nio-overview">NIO \
Overview<a class="headerlink" href="#nio-overview" title="Permanent \
link">¶</a></h1> +<p>The <strong>NIO</strong> API was introduced in <strong>Java \
1.4</strong> and had since been used for wide number of applications. The \
<strong>NIO</strong> API covers <strong>IO</strong> non-blocking operations.</p> \
+<DIV class="note" markdown="1"> + First of all, it's good to know that \
<strong>MINA</strong> is written on top of <strong>NIO 1</strong>. A new version has \
been designed in <strong>Java 7</strong>, <strong>NIO-2</strong>, we don't yet \
benefit from the added features this version is carrying. +</DIV>
+
+<DIV class="note" markdown="1">
+ It's also important to know that the <strong>N</strong> in <strong>NIO</strong> \
means <strong>New</strong>, but we will use the <strong>Non-Blocking</strong> term in \
many places. <strong>NIO-2</strong> should be seen as a <strong>New New \
I/O</strong>... +</DIV>
+
+<p>The <code>java.nio.*</code> package contains following key constructs</p>
+<ul>
+<li><em>Buffers</em> - Data Containers</li>
+<li><em>Chartsets</em> - Containers translators for bytes and Unicode</li>
+<li><em>Channels</em> - represents connections to entities capable of I/O \
operations</li> +<li><em>Selectors</em> - provide selectable, multiplexed \
non-blocking IO </li> +<li><em>Regexps</em> - provide provide some tools to \
manipulate regular expressions</li> +</ul>
+<p>We are mostly interested in the <em>Channels</em>, _ Selectors_ and \
<em>Buffers</em> parts in the <strong>MINA</strong> framework, except that we want to \
hide those elements to the user. </p> +<p>This user guide will thus focus on \
everything built on top of those internal components.</p> +<h1 id="nio-vs-bio">NIO vs \
BIO<a class="headerlink" href="#nio-vs-bio" title="Permanent link">¶</a></h1> \
+<p>It's important to understand the difference between those two APIs. \
<strong>BIO</strong>, or <strong>Blocking</strong> <strong>IO</strong>, relies on \
plain sockets used in a blocking mode : when you read, write or do whatever operation \
on a socket, the called operation will blcok the caller until the operation is \
completed.</p> +<p>In some cases, it's critical to be able to call the operation, and \
to expect the called operation to inform the caller when the operation is done : the \
caller can then do something else in the mean time.</p> +<p>This is also where \
<strong>NIO</strong> offers a better way to handle <strong>IO</strong> when you have \
numerous connected sockets : you dn't have to create a specific thread for each \
connection, you can just use a few threads to do the same job.</p> +<p>If you want to \
get more information about what covers <strong>NIO</strong>, there is a lot of good \
articles around the web, and a few books cobering this matter.</p> +
+
+ <div class="nav">
+ <div class="nav_prev">
+
+
+
+ </div>
+ <div class="nav_up">
+
+ <a href="ch1-getting-started.html">Chapter 1 - Getting Started</a>
+
+ </div>
+ <div class="nav_next">
+
+ <a href="ch1.2-why-mina.html">1.2 - Why MINA ?</a>
+
+ </div>
+ <div class="clearfix"></div>
+ </div>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2019, <a href="https://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 -->
+ <script type="text/javascript">
+
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-11074178-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>
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.2-why-mina.html
==============================================================================
--- websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.2-why-mina.html \
(added)
+++ websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.2-why-mina.html \
Wed Mar 27 05:50:09 2019 @@ -0,0 +1,262 @@
+<!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>1.2 - Why MINA — Apache MINA</title>
+
+ <link href="./../../../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../../../css/mina.css" rel="stylesheet" type="text/css">
+
+
+ <link rel="shortcut icon" \
href="./../../../staticresources/images/mina-icon_16x16.png"/> +
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../../../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../../../mina-project/index.html">
+
+ <strong>MINA</strong>
+
+ </a>
+ |
+ <a href="./../../../asyncweb-project/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../../../ftpserver-project/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../../../sshd-project/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../../../vysper-project/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > \
.headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > \
.elementid-permalink { visibility: visible }</style> +<div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../../../mina-project/downloads_2_0.html">Mina \
2.0.20</a></li> + <li><a \
href="./../../../mina-project/downloads_2_1.html">Mina 2.1.0</a></li> + <li><a \
href="./../../../mina-project/downloads_old.html">Mina old versions</a></li> + \
</ul> + <h5>Documentation</h5>
+ <ul>
+ <li><a href="./../../../mina-project/documentation.html" class="external-link" \
rel="nofollow">Base documentation</a></li> + <li><a \
href="./../../../mina-project/userguide/user-guide-toc.html" class="external-link" \
rel="nofollow">User guide</a></li> + <li><a \
href="./../../../mina-project/2.1-vs-2.0.html" class="external-link" \
rel="nofollow">2.1 vs 2.0</a></li> + <li><a \
href="./../../../mina-project/features.html" class="external-link" \
rel="nofollow">Features</a></li> + <li><a \
href="./../../../mina-project/road-map.html" class="external-link" \
rel="nofollow">Road Map</a></li> + <li><a \
href="./../../../mina-project/quick-start-guide.html" class="external-link" \
rel="nofollow">Quick Start Guide</a></li> + <li><a \
href="./../../../mina-project/faq.html" class="external-link" \
rel="nofollow">FAQ</a></li> + </ul>
+ <h5>Resources</h5>
+ <ul>
+ <li><a href="./../../../mina-project/mailing-lists.html" class="external-link" \
rel="nofollow">Mailing lists & IRC</a></li> + <li><a \
href="./../../../mina-project/issue-tracking.html" class="external-link" \
rel="nofollow">Issue tracking</a></li> + <li><a \
href="./../../../mina-project/sources.html" class="external-link" \
rel="nofollow">Sources</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.0/apidocs/index.html" \
class="external-link" rel="nofollow">API Javadoc 2.0.20</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.1/apidocs/index.html" \
class="external-link" rel="nofollow">API Javadoc 2.1.0</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.0/xref/index.html" \
class="external-link" rel="nofollow">API xref 2.0.20</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.1/xref/index.html" \
class="external-link" rel="nofollow">API xref 2.1.0</a></li> + <li><a \
href="./../../../mina-project/performances.html" class="external-link" \
rel="nofollow">Performances</a></li> + <li><a \
href="./../../../mina-project/testimonials.html" class="external-link" \
rel="nofollow">Testimonials</a></li> + <li><a \
href="./../../../mina-project/conferences.html" class="external-link" \
rel="nofollow">Conferences</a></li> + <li><a \
href="./../../../mina-project/developer-guide.html" class="external-link" \
rel="nofollow">Developers Guide</a></li> + <li><a \
href="./../../../mina-project/related-projects.html" class="external-link" \
rel="nofollow">Related Projects</a></li> + <li><a \
href="https://people.apache.org/~vgritsenko/stats/projects/mina.html" \
class="external-link" rel="nofollow">Statistics</a></li> + </ul>
+
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="https://www.apache.org/foundation/contributing.html" \
class="external-link" rel="nofollow">Contributing</a></li> + <li><a \
href="./../../../contributors.html" class="external-link" \
rel="nofollow">Team</a></li> + <li><a href="./../../../special-thanks.html" \
class="external-link" rel="nofollow">Special Thanks</a></li> + <li><a \
href="https://www.apache.org/security/" class="external-link" \
rel="nofollow">Security</a></li> + </ul>
+
+
+ <h5>About Apache</h5>
+ <ul>
+ <li><a href="https://www.apache.org" class="external-link" \
rel="nofollow">Apache main site</a></li> + <li><a \
href="https://www.apache.org/licenses/" class="external-link" \
rel="nofollow">License</a></li> + <li><a \
href="https://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship \
program" class="external-link" rel="nofollow">Sponsorship program</a></li> + \
<li><a href="https://www.apache.org/foundation/thanks.html" class="external-link" \
rel="nofollow">Thanks</a></li> + </ul>
+
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+ <ul>
+ <li>No event</li>
+ </ul>
+
+</div>
+
+<!-- navigation -->
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+ <div class="nav">
+ <div class="nav_prev">
+
+ <a href="ch1.1-nio-overview.html">1.1 - NIO Overview</a>
+
+ </div>
+ <div class="nav_up">
+
+ <a href="ch1-getting-started.html">Chapter 1 - Getting Started</a>
+
+ </div>
+ <div class="nav_next">
+
+ <a href="ch1.3-features.html">1.3 - Features</a>
+
+ </div>
+ <div class="clearfix"></div>
+ </div>
+
+
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > \
.headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > \
.elementid-permalink { visibility: visible }</style> +<h1 id="why-mina">Why MINA ?<a \
class="headerlink" href="#why-mina" title="Permanent link">¶</a></h1> \
+<p>Writing network applications are generally seen as a burden and perceived as low \
level development. It is an area which is not frequently studied or known by \
developers, either because it has been studied in school a long time ago and \
everything has been forgotten, or because the complexity of the network layer is \
frequently hidden by higher level layers, so you never get deep into it.</p> \
+<p>Added to that (when it comes to asynchronous IO) an extra layer of complexity \
comes into play: time.</p> +<p>The big difference between <strong>BIO</strong> \
(Blocking IO) and <strong>NIO</strong> (Non-Blocking IO) is that in \
<strong>BIO</strong>, you send a request, and you wait until you get the response. On \
the server side, it means one thread wil be associated with any incoming connection, \
so you won't have to deal with the complexity of multiplexing the connections. In \
<strong>NIO</strong>, on the other hand, you have to deal with the synchronous \
nature of a non-blocking system, which means that your application will be invoked \
when some events occur. In <strong>NIO</strong>, you don't call and wait for a \
result, you send a command and you are informed when the result is ready.</p> +<h2 \
id="the-need-of-a-framework">The need of a framework<a class="headerlink" \
href="#the-need-of-a-framework" title="Permanent link">¶</a></h2> \
+<p>Considering those differences, and the fact that most of the applications are \
usually expecting a blocking mode when invoking the network layer, the best solution \
is to hide this aspect by writing a framework that mimics a blocking mode. This is \
what <strong>MINA</strong> does!</p> +<p>But <strong>MINA</strong> does more. It \
provides a common IO vision to an application that needs to communicate over \
<strong>TCP</strong>, <strong>UDP</strong> or whatever mechanism. If we consider only \
<strong>TCP</strong> and <strong>UDP</strong>, one is a connected protocol \
(<strong>TCP</strong>) where the other is connectionless (<strong>UDP</strong>). \
<strong>MINA</strong> masks this difference, and makes you focus on the two parts \
that are important for your application: the application code and the application \
protocol encoding/decoding.</p> +<p><strong><em>MINA</em>* does not only handle \
</strong>TCP<strong> and </strong>UDP<strong>, it also offers a layer on top of \
serial communication (</strong>RSC232<strong>), over </strong>VmpPipe<strong> or \
</strong>APR**. </p> +<p>Last but not least, <strong>MINA</strong> is a network \
framework that has been specifically designed to work on both the client side and \
server side. Writing a server makes it critical to have a scalable system, which is \
tunable to fit the server needs, in terms of performance and memory usage. This is \
what <strong>MINA</strong> is good for, making it easy to develop you server.</p> \
+<h2 id="when-to-use-mina">When to use MINA ?<a class="headerlink" \
href="#when-to-use-mina" title="Permanent link">¶</a></h2> +<p>This is a \
interesting question! <strong>MINA</strong> does not expect to be the best possible \
choice in all cases. There are a few elements to take into account when considering \
using <strong>MINA</strong>. Let's list them:</p> +<ul>
+<li>
+<p>Ease of use
+ When you have no special performance requirements, <strong>MINA</strong> is \
probably a good choice as it allows you to develop a server or a client easily, \
without having to deal with the various parameters and use cases to handle when \
writing the same application on top of <strong>BIO</strong> or <strong>NIO</strong>. \
You could probably write your server with only a few lines of code, and there are \
less pitfalls in which you are likely to fall.</p> +</li>
+<li>
+<p>A high number of connected users
+ <strong>BIO</strong> is definitively faster that <strong>NIO</strong>. The \
difference is something like 30% in favor of <strong>BIO</strong>. This is true for \
up to a few thousands of connected users, but up to a point, the <strong>BIO</strong> \
approach just stops scaling; you won't be able to handle millions of connected users \
using one thread per user! <strong>NIO</strong> can. Now, one other aspect is that \
the time spent in the <strong>MINA</strong> part of your code is probably non \
significant, compared to whatever your application will consume. At some point, it's \
probably not worthwhile to spend the energy trying to writing a faster network layer \
on your own for a gain which will be barely noticeable.</p> +</li>
+<li>
+<p>A proven system
+ <strong>MINA</strong> is used by many applications all over the world. There are \
some <em>Apache</em> projects based on <strong>MINA</strong>, and they are working \
pretty well. This gives you the ease of mind that you won't have to spend hours on \
some cryptic errors in your own implementation of the network layer.</p> +</li>
+<li>
+<p>Existing supported protocols
+ <strong>MINA</strong> ships with various implemented protocols: HTTP, XML, TCP, \
LDAP, DHCP, NTP, DNS, XMPP, SSH, FTP... At some point, <strong>MINA</strong> can be \
seen not only as a <strong>NIO</strong> framework, but as a network layer with some \
protocol implementation. In the near future <strong>MINA</strong> may offer a more \
extensive collection of protocols for you to use.</p> +</li>
+</ul>
+
+
+ <div class="nav">
+ <div class="nav_prev">
+
+ <a href="ch1.1-nio-overview.html">1.1 - NIO Overview</a>
+
+ </div>
+ <div class="nav_up">
+
+ <a href="ch1-getting-started.html">Chapter 1 - Getting Started</a>
+
+ </div>
+ <div class="nav_next">
+
+ <a href="ch1.3-features.html">1.3 - Features</a>
+
+ </div>
+ <div class="clearfix"></div>
+ </div>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2019, <a href="https://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 -->
+ <script type="text/javascript">
+
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-11074178-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>
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.3-features.html
==============================================================================
--- websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.3-features.html \
(added)
+++ websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.3-features.html \
Wed Mar 27 05:50:09 2019 @@ -0,0 +1,263 @@
+<!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>1.3 Features — Apache MINA</title>
+
+ <link href="./../../../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../../../css/mina.css" rel="stylesheet" type="text/css">
+
+
+ <link rel="shortcut icon" \
href="./../../../staticresources/images/mina-icon_16x16.png"/> +
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../../../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../../../mina-project/index.html">
+
+ <strong>MINA</strong>
+
+ </a>
+ |
+ <a href="./../../../asyncweb-project/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../../../ftpserver-project/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../../../sshd-project/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../../../vysper-project/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > \
.headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > \
.elementid-permalink { visibility: visible }</style> +<div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../../../mina-project/downloads_2_0.html">Mina \
2.0.20</a></li> + <li><a \
href="./../../../mina-project/downloads_2_1.html">Mina 2.1.0</a></li> + <li><a \
href="./../../../mina-project/downloads_old.html">Mina old versions</a></li> + \
</ul> + <h5>Documentation</h5>
+ <ul>
+ <li><a href="./../../../mina-project/documentation.html" class="external-link" \
rel="nofollow">Base documentation</a></li> + <li><a \
href="./../../../mina-project/userguide/user-guide-toc.html" class="external-link" \
rel="nofollow">User guide</a></li> + <li><a \
href="./../../../mina-project/2.1-vs-2.0.html" class="external-link" \
rel="nofollow">2.1 vs 2.0</a></li> + <li><a \
href="./../../../mina-project/features.html" class="external-link" \
rel="nofollow">Features</a></li> + <li><a \
href="./../../../mina-project/road-map.html" class="external-link" \
rel="nofollow">Road Map</a></li> + <li><a \
href="./../../../mina-project/quick-start-guide.html" class="external-link" \
rel="nofollow">Quick Start Guide</a></li> + <li><a \
href="./../../../mina-project/faq.html" class="external-link" \
rel="nofollow">FAQ</a></li> + </ul>
+ <h5>Resources</h5>
+ <ul>
+ <li><a href="./../../../mina-project/mailing-lists.html" class="external-link" \
rel="nofollow">Mailing lists & IRC</a></li> + <li><a \
href="./../../../mina-project/issue-tracking.html" class="external-link" \
rel="nofollow">Issue tracking</a></li> + <li><a \
href="./../../../mina-project/sources.html" class="external-link" \
rel="nofollow">Sources</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.0/apidocs/index.html" \
class="external-link" rel="nofollow">API Javadoc 2.0.20</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.1/apidocs/index.html" \
class="external-link" rel="nofollow">API Javadoc 2.1.0</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.0/xref/index.html" \
class="external-link" rel="nofollow">API xref 2.0.20</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.1/xref/index.html" \
class="external-link" rel="nofollow">API xref 2.1.0</a></li> + <li><a \
href="./../../../mina-project/performances.html" class="external-link" \
rel="nofollow">Performances</a></li> + <li><a \
href="./../../../mina-project/testimonials.html" class="external-link" \
rel="nofollow">Testimonials</a></li> + <li><a \
href="./../../../mina-project/conferences.html" class="external-link" \
rel="nofollow">Conferences</a></li> + <li><a \
href="./../../../mina-project/developer-guide.html" class="external-link" \
rel="nofollow">Developers Guide</a></li> + <li><a \
href="./../../../mina-project/related-projects.html" class="external-link" \
rel="nofollow">Related Projects</a></li> + <li><a \
href="https://people.apache.org/~vgritsenko/stats/projects/mina.html" \
class="external-link" rel="nofollow">Statistics</a></li> + </ul>
+
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="https://www.apache.org/foundation/contributing.html" \
class="external-link" rel="nofollow">Contributing</a></li> + <li><a \
href="./../../../contributors.html" class="external-link" \
rel="nofollow">Team</a></li> + <li><a href="./../../../special-thanks.html" \
class="external-link" rel="nofollow">Special Thanks</a></li> + <li><a \
href="https://www.apache.org/security/" class="external-link" \
rel="nofollow">Security</a></li> + </ul>
+
+
+ <h5>About Apache</h5>
+ <ul>
+ <li><a href="https://www.apache.org" class="external-link" \
rel="nofollow">Apache main site</a></li> + <li><a \
href="https://www.apache.org/licenses/" class="external-link" \
rel="nofollow">License</a></li> + <li><a \
href="https://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship \
program" class="external-link" rel="nofollow">Sponsorship program</a></li> + \
<li><a href="https://www.apache.org/foundation/thanks.html" class="external-link" \
rel="nofollow">Thanks</a></li> + </ul>
+
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+ <ul>
+ <li>No event</li>
+ </ul>
+
+</div>
+
+<!-- navigation -->
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+ <div class="nav">
+ <div class="nav_prev">
+
+ <a href="ch1.2-why-mina.html">1.2 - Why MINA ?</a>
+
+ </div>
+ <div class="nav_up">
+
+ <a href="ch1-getting-started.html">Chapter 1 - Getting Started</a>
+
+ </div>
+ <div class="nav_next">
+
+ <a href="ch1.4-first-steps.html">1.4 - First steps</a>
+
+ </div>
+ <div class="clearfix"></div>
+ </div>
+
+
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > \
.headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > \
.elementid-permalink { visibility: visible }</style> +<h1 id="features">Features<a \
class="headerlink" href="#features" title="Permanent link">¶</a></h1> +<p>MINA \
is a simple yet full-featured network application framework which provides:</p> +<ul>
+<li>Unified API for various transport types:<ul>
+<li>TCP/IP & UDP/IP via Java NIO</li>
+<li>Serial communication (RS232) via RXTX</li>
+<li>In-VM pipe communication</li>
+<li>You can implement your own!</li>
+</ul>
+</li>
+<li>Filter interface as an extension point; similar to Servlet filters</li>
+<li>Low-level and high-level API:<ul>
+<li>Low-level: uses ByteBuffers</li>
+<li>High-level: uses user-defined message objects and codecs</li>
+</ul>
+</li>
+<li>Highly customizable thread model:<ul>
+<li>Single thread</li>
+<li>One thread pool</li>
+<li>More than one thread pools (i.e. SEDA)</li>
+</ul>
+</li>
+<li>Out-of-the-box SSL · TLS · StartTLS support using Java 5 \
SSLEngine</li> +<li>Overload shielding & traffic throttling</li>
+<li>Unit testability using mock objects</li>
+<li>JMX managability</li>
+<li>Stream-based I/O support via StreamIoHandler</li>
+<li>Integration with well known containers such as PicoContainer and Spring</li>
+<li>Smooth migration from Netty, an ancestor of Apache MINA.</li>
+</ul>
+
+
+ <div class="nav">
+ <div class="nav_prev">
+
+ <a href="ch1.2-why-mina.html">1.2 - Why MINA ?</a>
+
+ </div>
+ <div class="nav_up">
+
+ <a href="ch1-getting-started.html">Chapter 1 - Getting Started</a>
+
+ </div>
+ <div class="nav_next">
+
+ <a href="ch1.4-first-steps.html">1.4 - First steps</a>
+
+ </div>
+ <div class="clearfix"></div>
+ </div>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2019, <a href="https://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 -->
+ <script type="text/javascript">
+
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-11074178-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>
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.4-first-steps.html
==============================================================================
--- websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.4-first-steps.html \
(added)
+++ websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.4-first-steps.html \
Wed Mar 27 05:50:09 2019 @@ -0,0 +1,305 @@
+<!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>1.4 - First Steps — Apache MINA</title>
+
+ <link href="./../../../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../../../css/mina.css" rel="stylesheet" type="text/css">
+
+
+ <link rel="shortcut icon" \
href="./../../../staticresources/images/mina-icon_16x16.png"/> +
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../../../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../../../mina-project/index.html">
+
+ <strong>MINA</strong>
+
+ </a>
+ |
+ <a href="./../../../asyncweb-project/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../../../ftpserver-project/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../../../sshd-project/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../../../vysper-project/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > \
.headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > \
.elementid-permalink { visibility: visible }</style> +<div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../../../mina-project/downloads_2_0.html">Mina \
2.0.20</a></li> + <li><a \
href="./../../../mina-project/downloads_2_1.html">Mina 2.1.0</a></li> + <li><a \
href="./../../../mina-project/downloads_old.html">Mina old versions</a></li> + \
</ul> + <h5>Documentation</h5>
+ <ul>
+ <li><a href="./../../../mina-project/documentation.html" class="external-link" \
rel="nofollow">Base documentation</a></li> + <li><a \
href="./../../../mina-project/userguide/user-guide-toc.html" class="external-link" \
rel="nofollow">User guide</a></li> + <li><a \
href="./../../../mina-project/2.1-vs-2.0.html" class="external-link" \
rel="nofollow">2.1 vs 2.0</a></li> + <li><a \
href="./../../../mina-project/features.html" class="external-link" \
rel="nofollow">Features</a></li> + <li><a \
href="./../../../mina-project/road-map.html" class="external-link" \
rel="nofollow">Road Map</a></li> + <li><a \
href="./../../../mina-project/quick-start-guide.html" class="external-link" \
rel="nofollow">Quick Start Guide</a></li> + <li><a \
href="./../../../mina-project/faq.html" class="external-link" \
rel="nofollow">FAQ</a></li> + </ul>
+ <h5>Resources</h5>
+ <ul>
+ <li><a href="./../../../mina-project/mailing-lists.html" class="external-link" \
rel="nofollow">Mailing lists & IRC</a></li> + <li><a \
href="./../../../mina-project/issue-tracking.html" class="external-link" \
rel="nofollow">Issue tracking</a></li> + <li><a \
href="./../../../mina-project/sources.html" class="external-link" \
rel="nofollow">Sources</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.0/apidocs/index.html" \
class="external-link" rel="nofollow">API Javadoc 2.0.20</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.1/apidocs/index.html" \
class="external-link" rel="nofollow">API Javadoc 2.1.0</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.0/xref/index.html" \
class="external-link" rel="nofollow">API xref 2.0.20</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.1/xref/index.html" \
class="external-link" rel="nofollow">API xref 2.1.0</a></li> + <li><a \
href="./../../../mina-project/performances.html" class="external-link" \
rel="nofollow">Performances</a></li> + <li><a \
href="./../../../mina-project/testimonials.html" class="external-link" \
rel="nofollow">Testimonials</a></li> + <li><a \
href="./../../../mina-project/conferences.html" class="external-link" \
rel="nofollow">Conferences</a></li> + <li><a \
href="./../../../mina-project/developer-guide.html" class="external-link" \
rel="nofollow">Developers Guide</a></li> + <li><a \
href="./../../../mina-project/related-projects.html" class="external-link" \
rel="nofollow">Related Projects</a></li> + <li><a \
href="https://people.apache.org/~vgritsenko/stats/projects/mina.html" \
class="external-link" rel="nofollow">Statistics</a></li> + </ul>
+
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="https://www.apache.org/foundation/contributing.html" \
class="external-link" rel="nofollow">Contributing</a></li> + <li><a \
href="./../../../contributors.html" class="external-link" \
rel="nofollow">Team</a></li> + <li><a href="./../../../special-thanks.html" \
class="external-link" rel="nofollow">Special Thanks</a></li> + <li><a \
href="https://www.apache.org/security/" class="external-link" \
rel="nofollow">Security</a></li> + </ul>
+
+
+ <h5>About Apache</h5>
+ <ul>
+ <li><a href="https://www.apache.org" class="external-link" \
rel="nofollow">Apache main site</a></li> + <li><a \
href="https://www.apache.org/licenses/" class="external-link" \
rel="nofollow">License</a></li> + <li><a \
href="https://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship \
program" class="external-link" rel="nofollow">Sponsorship program</a></li> + \
<li><a href="https://www.apache.org/foundation/thanks.html" class="external-link" \
rel="nofollow">Thanks</a></li> + </ul>
+
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+ <ul>
+ <li>No event</li>
+ </ul>
+
+</div>
+
+<!-- navigation -->
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+ <div class="nav">
+ <div class="nav_prev">
+
+ <a href="ch1.3- features.html">1.3 - Features</a>
+
+ </div>
+ <div class="nav_up">
+
+ <a href="ch1-getting-started.html">Chapter 1 - Getting Started</a>
+
+ </div>
+ <div class="nav_next">
+
+ <a href="ch1.5-summary.html">1.5 - Summary</a>
+
+ </div>
+ <div class="clearfix"></div>
+ </div>
+
+
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > \
.headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > \
.elementid-permalink { visibility: visible }</style> +<h1 id="first-steps">First \
Steps<a class="headerlink" href="#first-steps" title="Permanent link">¶</a></h1> \
+<p>We will show you how easy it is to use MINA, running a very simple example \
provided with the <strong>MINA</strong> package. </p> +<p>The first thing you have to \
do is to setup your evnvironment when you want to use <strong>MINA</strong> in your \
application. We will describe what you need to install and how to run a \
<strong>MINA</strong> program. Nothing fancy, just a first taste of \
<strong>MINA</strong>...</p> +<h2 id="download">Download<a class="headerlink" \
href="#download" title="Permanent link">¶</a></h2> +<p>First, you have to \
download the latest <strong>MINA</strong> release from <a \
href="../../downloads_2_0.html">MINA 2.0 Downloads Section</a> or <a \
href="../../downloads_2_1.html">MINA 2.1 Downloads Section</a>. Just take the latest \
version, unless you have very good reasons not to do so...</p> +<p>Generally \
speaking, if you are going to use <strong>Maven</strong> to build your project, you \
won't even have to download anything, as soon as you will depend on a repository \
which already contains the <strong>MINA</strong> libraries : you just tell your \
<strong>Maven</strong> poms that you want to use the <strong>MINA</strong> jars you \
need.</p> +<h2 id="whats-inside">What's inside<a class="headerlink" \
href="#whats-inside" title="Permanent link">¶</a></h2> +<p>After the download is \
complete, extract the content of <em>tar.gz</em> or <em>zip</em> file to local hard \
drive. The downloaded compressed file has following contents</p> +<p>On UNIX system, \
type :</p> +<div class="codehilite"><pre>$ <span class="n">tar</span> <span \
class="n">xzpf</span> <span class="n">apache</span><span class="o">-</span><span \
class="n">mina</span><span class="o">-</span>2<span class="p">.</span>0<span \
class="p">.</span>7<span class="o">-</span><span class="n">tar</span><span \
class="p">.</span><span class="n">gz</span> +</pre></div>
+
+
+<p>In the <em>apache-mina-2.0.7</em> directory, you will get :</p>
+<div class="codehilite"><pre> <span class="o">|</span>
+ <span class="o">+-</span> <span class="n">dist</span>
+ <span class="o">+-</span> <span class="n">docs</span>
+ <span class="o">+-</span> <span class="n">lib</span>
+ <span class="o">+-</span> <span class="n">src</span>
+ <span class="o">+-</span> <span class="n">LICENSE</span><span \
class="p">.</span><span class="n">txt</span> + <span class="o">+-</span> <span \
class="n">LICENSE</span><span class="p">.</span><span class="n">jzlib</span><span \
class="p">.</span><span class="n">txt</span> + <span class="o">+-</span> <span \
class="n">LICENSE</span><span class="p">.</span><span class="n">ognl</span><span \
class="p">.</span><span class="n">txt</span> + <span class="o">+-</span> <span \
class="n">LICENSE</span><span class="p">.</span><span class="n">slf4j</span><span \
class="p">.</span><span class="n">txt</span> + <span class="o">+-</span> <span \
class="n">LICENSE</span><span class="p">.</span><span \
class="n">springframework</span><span class="p">.</span><span class="n">txt</span> + \
<span class="o">+-</span> <span class="n">NOTICE</span><span class="p">.</span><span \
class="n">txt</span> +</pre></div>
+
+
+<h2 id="content-details">Content Details<a class="headerlink" \
href="#content-details" title="Permanent link">¶</a></h2> +<ul>
+<li><em>dist</em> - Contains jars for the <strong>MINA</strong> library code</li>
+<li><em>docs</em> - Contains API docs and Code xrefs</li>
+<li><em>lib</em> - Contains all needed jars for all the libraries needed for using \
<strong>MINA</strong></li> +</ul>
+<p>Additional to these, the base directory has couple of license and notice \
files</p> +<h1 id="running-your-first-mina-program">Running your first MINA program<a \
class="headerlink" href="#running-your-first-mina-program" title="Permanent \
link">¶</a></h1> +<p>Well, we have downloaded the release, let's run our first \
<strong>MINA</strong> example, shipped with the release.</p> +<p>Put the following \
jars in the classpath</p> +<ul>
+<li>mina-core-2.0.7.jar</li>
+<li>mina-example-2.0.7.jar</li>
+<li>slf4j-api-1.6.6.jar</li>
+<li>slf4j-log4j12-1.6.6.jar</li>
+<li>log4j-1.2.17.jar</li>
+</ul>
+<DIV class="tip" markdown="1">
+<strong>Logging Tip</string>
+
+<UL>
+ <LI>Log4J 1.2 users: slf4j-api.jar, slf4j-log4j12.jar, and Log4J 1.2.x</LI>
+ <LI>Log4J 1.3 users: slf4j-api.jar, slf4j-log4j13.jar, and Log4J 1.3.x</LI>
+ <LI>java.util.logging users: slf4j-api.jar and slf4j-jdk14.jar</LI>
+</UL>
+
+<strong>IMPORTANT:<strong> Please make sure you are using the right \
<em>slf4j-*.jar</em> that matches to your logging framework. +For instance, \
<em>slf4j-log4j12.jar</em> and <em>log4j-1.3.x.jar</em> can not be used together, and \
will malfunction. +If you don't need a logging framework you can use \
<em>slf4j-nop.jar</em> for no logging or <em>slf4j-simple.jar</em> for +very basic \
logging. +</DIV>
+
+<p>On the command prompt, issue the following command :</p>
+<div class="codehilite"><pre>$ <span class="n">java</span> <span \
class="n">org</span><span class="p">.</span><span class="n">apache</span><span \
class="p">.</span><span class="n">mina</span><span class="p">.</span><span \
class="n">example</span><span class="p">.</span><span \
class="n">gettingstarted</span><span class="p">.</span><span \
class="n">timeserver</span><span class="p">.</span><span \
class="n">MinaTimeServer</span> +</pre></div>
+
+
+<p>This shall start the server. Now telnet and see the program in action</p>
+<p>Issue following command to telnet</p>
+<div class="codehilite"><pre><span class="n">telnet</span> 127<span \
class="p">.</span>0<span class="p">.</span>0<span class="p">.</span>1 9123 \
+</pre></div> +
+
+<p>Well, we have run our first <strong>MINA</strong> program. Please try other \
sample programs shipped with <strong>MINA</strong> as examples.</p> +
+
+ <div class="nav">
+ <div class="nav_prev">
+
+ <a href="ch1.3- features.html">1.3 - Features</a>
+
+ </div>
+ <div class="nav_up">
+
+ <a href="ch1-getting-started.html">Chapter 1 - Getting Started</a>
+
+ </div>
+ <div class="nav_next">
+
+ <a href="ch1.5-summary.html">1.5 - Summary</a>
+
+ </div>
+ <div class="clearfix"></div>
+ </div>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2019, <a href="https://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 -->
+ <script type="text/javascript">
+
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-11074178-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>
+ </body>
+</html>
+
Added: websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.5-summary.html
==============================================================================
--- websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.5-summary.html \
(added)
+++ websites/staging/mina/trunk/content/mina-project/userguide/ch1-getting-started/ch1.5-summary.html \
Wed Mar 27 05:50:09 2019 @@ -0,0 +1,236 @@
+<!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>1.5 - Summary — Apache MINA</title>
+
+ <link href="./../../../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../../../css/mina.css" rel="stylesheet" type="text/css">
+
+
+ <link rel="shortcut icon" \
href="./../../../staticresources/images/mina-icon_16x16.png"/> +
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../../../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../../../mina-project/index.html">
+
+ <strong>MINA</strong>
+
+ </a>
+ |
+ <a href="./../../../asyncweb-project/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../../../ftpserver-project/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../../../sshd-project/index.html">
+
+ SSHD
+
+ </a>
+ |
+ <a href="./../../../vysper-project/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > \
.headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > \
.elementid-permalink { visibility: visible }</style> +<div id="navigation">
+
+ <h5>Latest Downloads</h5>
+ <ul>
+ <li><a href="./../../../mina-project/downloads_2_0.html">Mina \
2.0.20</a></li> + <li><a \
href="./../../../mina-project/downloads_2_1.html">Mina 2.1.0</a></li> + <li><a \
href="./../../../mina-project/downloads_old.html">Mina old versions</a></li> + \
</ul> + <h5>Documentation</h5>
+ <ul>
+ <li><a href="./../../../mina-project/documentation.html" class="external-link" \
rel="nofollow">Base documentation</a></li> + <li><a \
href="./../../../mina-project/userguide/user-guide-toc.html" class="external-link" \
rel="nofollow">User guide</a></li> + <li><a \
href="./../../../mina-project/2.1-vs-2.0.html" class="external-link" \
rel="nofollow">2.1 vs 2.0</a></li> + <li><a \
href="./../../../mina-project/features.html" class="external-link" \
rel="nofollow">Features</a></li> + <li><a \
href="./../../../mina-project/road-map.html" class="external-link" \
rel="nofollow">Road Map</a></li> + <li><a \
href="./../../../mina-project/quick-start-guide.html" class="external-link" \
rel="nofollow">Quick Start Guide</a></li> + <li><a \
href="./../../../mina-project/faq.html" class="external-link" \
rel="nofollow">FAQ</a></li> + </ul>
+ <h5>Resources</h5>
+ <ul>
+ <li><a href="./../../../mina-project/mailing-lists.html" class="external-link" \
rel="nofollow">Mailing lists & IRC</a></li> + <li><a \
href="./../../../mina-project/issue-tracking.html" class="external-link" \
rel="nofollow">Issue tracking</a></li> + <li><a \
href="./../../../mina-project/sources.html" class="external-link" \
rel="nofollow">Sources</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.0/apidocs/index.html" \
class="external-link" rel="nofollow">API Javadoc 2.0.20</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.1/apidocs/index.html" \
class="external-link" rel="nofollow">API Javadoc 2.1.0</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.0/xref/index.html" \
class="external-link" rel="nofollow">API xref 2.0.20</a></li> + <li><a \
href="./../../../mina-project/gen-docs/latest-2.1/xref/index.html" \
class="external-link" rel="nofollow">API xref 2.1.0</a></li> + <li><a \
href="./../../../mina-project/performances.html" class="external-link" \
rel="nofollow">Performances</a></li> + <li><a \
href="./../../../mina-project/testimonials.html" class="external-link" \
rel="nofollow">Testimonials</a></li> + <li><a \
href="./../../../mina-project/conferences.html" class="external-link" \
rel="nofollow">Conferences</a></li> + <li><a \
href="./../../../mina-project/developer-guide.html" class="external-link" \
rel="nofollow">Developers Guide</a></li> + <li><a \
href="./../../../mina-project/related-projects.html" class="external-link" \
rel="nofollow">Related Projects</a></li> + <li><a \
href="https://people.apache.org/~vgritsenko/stats/projects/mina.html" \
class="external-link" rel="nofollow">Statistics</a></li> + </ul>
+
+
+ <h5>Community</h5>
+ <ul>
+ <li><a href="https://www.apache.org/foundation/contributing.html" \
class="external-link" rel="nofollow">Contributing</a></li> + <li><a \
href="./../../../contributors.html" class="external-link" \
rel="nofollow">Team</a></li> + <li><a href="./../../../special-thanks.html" \
class="external-link" rel="nofollow">Special Thanks</a></li> + <li><a \
href="https://www.apache.org/security/" class="external-link" \
rel="nofollow">Security</a></li> + </ul>
+
+
+ <h5>About Apache</h5>
+ <ul>
+ <li><a href="https://www.apache.org" class="external-link" \
rel="nofollow">Apache main site</a></li> + <li><a \
href="https://www.apache.org/licenses/" class="external-link" \
rel="nofollow">License</a></li> + <li><a \
href="https://www.apache.org/foundation/sponsorship.html" title="The ASF sponsorship \
program" class="external-link" rel="nofollow">Sponsorship program</a></li> + \
<li><a href="https://www.apache.org/foundation/thanks.html" class="external-link" \
rel="nofollow">Thanks</a></li> + </ul>
+
+
+ <h3><a name="Navigation-Upcoming"></a>Upcoming</h3>
+ <ul>
+ <li>No event</li>
+ </ul>
+
+</div>
+
+<!-- navigation -->
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+
+ <div class="nav">
+ <div class="nav_prev">
+
+ <a href="ch1.4-first-steps.html">1.4 - First Steps</a>
+
+ </div>
+ <div class="nav_up">
+
+ <a href="ch1-getting-started.html">Chapter 1 - Getting Started</a>
+
+ </div>
+ <div class="nav_next">
+
+
+
+ </div>
+ <div class="clearfix"></div>
+ </div>
+
+
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > \
.headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > \
.elementid-permalink { visibility: visible }</style> +<h1 id="summary">Summary<a \
class="headerlink" href="#summary" title="Permanent link">¶</a></h1> +<p>In this \
chapter, we looked at MINA based Application Architecture, for Client as well as \
Server. We also touched upon the implementation of Sample TCP Server/Client, and UDP \
Server and Client.</p> +<p>In the chapters to come we shall discuss about MINA Core \
constructs and advanced topics</p> +
+
+ <div class="nav">
+ <div class="nav_prev">
+
+ <a href="ch1.4-first-steps.html">1.4 - First Steps</a>
+
+ </div>
+ <div class="nav_up">
+
+ <a href="ch1-getting-started.html">Chapter 1 - Getting Started</a>
+
+ </div>
+ <div class="nav_next">
+
+
+
+ </div>
+ <div class="clearfix"></div>
+ </div>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2019, <a href="https://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 -->
+ <script type="text/javascript">
+
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-11074178-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>
+ </body>
+</html>
+
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic