Mailing-List: contact dev-help@directory.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Apache Directory Developers List" <dev@directory.apache.org>
Received-SPF: pass (hermes.apache.org: domain of trustin@gmail.com designates
 64.233.184.201 as permitted sender)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
        s=beta; d=gmail.com;
        h=received:message-id:date:from:reply-to:to:subject:mime-version:content-type:content-transfer-encoding:content-disposition;
        b=ovn2nvcIH3SXjHMDreznBi10vhzd54hCwAGBmnaOQCopgU3pzsySASsAbVypSk6LfpoeLR+uqA1THdpEdTWa+CMzRmpKndduNC2Xd6hxQhs0DiTyu+PManfaonoTZxnvvLlBinEB7XuwMrdr4ZJdwLNRu+Qkl6kLtTCnOyrwRU4=
Message-ID: <768dcb2e0504210503a3ee74d@mail.gmail.com>
Date: Thu, 21 Apr 2005 21:03:06 +0900
From: Trustin Lee <trustin@gmail.com>
Reply-To: Trustin Lee <trustin@gmail.com>
To: Apache Directory Developers List <dev@directory.apache.org>
Subject: [mina] Summary of today's changes
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline

Hi,

1) I extracted common methods of IoSession and ProtocolSession to a
new class, Session, and added BaseSession that implements Session.=20
Now most session types extend it.

Session also introduces new feature: user-defined attributes.  It is
similar to attachment, but you can have as many attributes as you
want.  Attachment is redefined as a user-defined attribute whose key
is "" (empty string) still retaining backward compatibility.

We could also use user-defined attributes as a way to interact with
filters.  For example, a user could disable some filters for some
sessions.

But what if user wants to set default attributes?  We cannot simply
place setAttribute methods in sessionOpened() because the timing
becomes an issue when thread pool filter is in the chain. So....

2) SessionInitializer is introduced.

You can specify your SessionInitializer implementation as a parameter
of bind(...) and connect(...) methods so that SessionInitializer is
invoked before MINA starts to manage the session.  You could adjust
default socket parameters and set up default attributes there.

3) SessionManager is a top-level interface that all acceptors and
connectors implements now.

For now, there are only getter and setter of exceptionManager
property, but we could also add more common functionality in the
future.  How about getter of the number of active sessions?

The change is big, but it still retains API.  Any feedbacks are welcome.

Thanks,
Trustin
--=20
what we call human nature is actually human habit
--
http://gleamynode.net/