User guide

User Guide
The MINA 2.0 User Guide can be found here : User Guide

Presentation Materials

These presentation materials will help you understand the overall architecture and core constructs of MINA

Versions & References

There are currently three branches in MINA:

JavaDoc Source Code Description
2.0.x main, test The officially recommended production-ready branch.
1.0.x main, test The old branch, not any more maintained.
1.1.x main, test The old branch Java 5 port of 1.0 without any new feature addition.

You might also want to read the frequently asked questions and learn how to contact us before getting started.

Tutorials

The tutorials are provided for two branches, 1.x and 2.x, due to the backward incompatibilities between the APIs.

Version 1.x - Hard-Boiled Wonderland and the End of the World Version 2.x - Norweigian Wood
  • MINA v1.x Quick Start Guide - Creating your first MINA based program
  • Logging Configuration - Configuring your MINA-based application for logging
  • Transport-specific Configuration
    • UDP Tutorial - Writing a User Datagram Protocol (UDP) client and server using MINA
  • Advanced Topic
  • Coming soon! (not written yet)
    • Overall Architecture
    • Basic Constructs
      • IoBuffer
      • IoService
      • IoHandler
      • IoFilter
      • IoFuture
    • Advanced Topic
      • Unit-testing
      • Performance Tips

For Developers

Examples

You can browse all examples here.

Name Feature it demonstrates Side
Reverser Text protocol based on a protocol codec Server
SumUp server Complex binary protocol based on a protocol codec Both
Echo server Low-level I/O and SSL Server
NetCat Client programming Client
HTTP server Stream-based synchronous I/O Server
Tennis In-VM pipe communication Both
Chat server Spring integration Both
Proxy Resending received bytes on another session. Both

Other Resources

Older Presentation Materials