User Guide for 3.1 updated - please comment!

[yanky young]

Hi, trustin:

The updated user guide is pretty clear. Just one thing I am a bit confused.
It is about upstream and downstream concept. I have read ChannelPipeline
document. I can generally understand what's upstream and downstream about,
but not very clear.

the diagram is good for understanding, but I think it is about how the two
kinds of events flow in the pipeline and in which order they are processed
by handlers. The problem is why? why would the upstream event be processed
from the first handler to the last handler? and why would the downstream
event be processed in a reverse order? The essence is, when receiving
protocol message, we usually decode raw bytes into frames, and then decode
frames into string or other protocol object, and then process protocol
object(application level); and when sending protocol message, we firstly
build new protocol object(application level), and then encode into string or
whatever protocol format, and finally encode into raw bytes. So, I wonder if
the upstream and downstream naming will be clear here. How about
ChannelInboundHandler/ChannelOutboundHandler? Just my thoughts. It would be
better to make netty API more clear or more intuitive.

Another question is, why FrameDecoder extends SimpleChannelHandler?
SimpleChannelHandler process both downstream and upstream events, but
FrameEncoder seems just process upstream events, right?


regards,

yanky

2009/4/16 Trustin Lee <tlee at redhat.com>

> Hi Bob,
>
> It's great to hear that Netty is doing its job very well in your work.
>
> I think your idea about documentation could be realized by adding a
> diagram for each section of the first chapter.  At every step, a new
> component appears and the whole diagram is constructed at the end of
> the chapter.  Or.. should I add a dedicated chapter?  WDYT?
>
> Thanks,
>
> — Trustin Lee, http://gleamynode.net/
>
> On Mon, Apr 13, 2009 at 9:28 PM, Bob Buffone <bbuffone at rockstarapps.com>
> wrote:
> > Trustin,
> >
> > I am relatively new to the framework but have had great success using it
> so
> > far.  The one area that I link would be really useful is a chapter on the
> > overall structure of the framework.
> >
> > Clients & Servers
> > ChannelFactories
> > Handlers
> > ChannelPipelineFactories
> > Codexs
> >
> > and how they all fit together in the framework.  Once I figured this out
> > everything fits together extremely nicely, but it does take a while to
> > understand. Chapter one does have someone of this but maybe a nice
> opening
> > section would help.
> >
> > Bob (Buffone)
> >
> >
> > On Mon, Apr 13, 2009 at 5:10 AM, Ashish <paliwalashish at gmail.com> wrote:
> >>
> >> Trustin,
> >>
> >> The documentation is coming up really nice. After having a brief look,
> >> found it quite informative and shall help in a wider adaptation of the
> >> framework.
> >>
> >> Good Luck
> >>
> >> - ashish
> >>
> >> On Fri, Apr 10, 2009 at 7:24 PM, Trustin Lee <tlee at redhat.com> wrote:
> >> > Hi folks,
> >> >
> >> > I've just uploaded the latest revision of the Netty user guide.
> >> > Please check it out in the documentation page:
> >> >
> >> >  * http://www.jboss.org/netty/documentation.html
> >> >
> >> > Please feel free to give me feed back such as questions and comments
> >> > so that I can make this incomplete guide book more complete! :)
> >> >
> >> > Cheers,
> >> >
> >> > — Trustin Lee, http://gleamynode.net/
> >> >
> >> > _______________________________________________
> >> > netty-users mailing list
> >> > netty-users at lists.jboss.org
> >> > https://lists.jboss.org/mailman/listinfo/netty-users
> >> >
> >>
> >>
> >>
> >> --
> >> thanks
> >> ashish
> >>
> >> Blog: http://www.ashishpaliwal.com/blog
> >> My Photo Galleries: http://www.pbase.com/ashishpaliwal
> >>
> >> _______________________________________________
> >> netty-users mailing list
> >> netty-users at lists.jboss.org
> >> https://lists.jboss.org/mailman/listinfo/netty-users
> >
> >
> > _______________________________________________
> > netty-users mailing list
> > netty-users at lists.jboss.org
> > https://lists.jboss.org/mailman/listinfo/netty-users
> >
> >
>
> _______________________________________________
> netty-users mailing list
> netty-users at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/netty-users
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/netty-users/attachments/20090416/628d7a6a/attachment.html