Hi, trustin:<br><br>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. <br>
<br>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.<br>
<br>Another question is, why FrameDecoder extends SimpleChannelHandler? SimpleChannelHandler process both downstream and upstream events, but FrameEncoder seems just process upstream events, right?<br><br><br>regards,<br>
<br>yanky<br><br><div class="gmail_quote">2009/4/16 Trustin Lee <span dir="ltr"><<a href="mailto:tlee@redhat.com">tlee@redhat.com</a>></span><br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Hi Bob,<br>
<br>
It's great to hear that Netty is doing its job very well in your work.<br>
<br>
I think your idea about documentation could be realized by adding a<br>
diagram for each section of the first chapter. At every step, a new<br>
component appears and the whole diagram is constructed at the end of<br>
the chapter. Or.. should I add a dedicated chapter? WDYT?<br>
<br>
Thanks,<br>
<div class="im"><br>
— Trustin Lee, <a href="http://gleamynode.net/" target="_blank">http://gleamynode.net/</a><br>
<br>
</div><div><div></div><div class="h5">On Mon, Apr 13, 2009 at 9:28 PM, Bob Buffone <<a href="mailto:bbuffone@rockstarapps.com">bbuffone@rockstarapps.com</a>> wrote:<br>
> Trustin,<br>
><br>
> I am relatively new to the framework but have had great success using it so<br>
> far. The one area that I link would be really useful is a chapter on the<br>
> overall structure of the framework.<br>
><br>
> Clients & Servers<br>
> ChannelFactories<br>
> Handlers<br>
> ChannelPipelineFactories<br>
> Codexs<br>
><br>
> and how they all fit together in the framework. Once I figured this out<br>
> everything fits together extremely nicely, but it does take a while to<br>
> understand. Chapter one does have someone of this but maybe a nice opening<br>
> section would help.<br>
><br>
> Bob (Buffone)<br>
><br>
><br>
> On Mon, Apr 13, 2009 at 5:10 AM, Ashish <<a href="mailto:paliwalashish@gmail.com">paliwalashish@gmail.com</a>> wrote:<br>
>><br>
>> Trustin,<br>
>><br>
>> The documentation is coming up really nice. After having a brief look,<br>
>> found it quite informative and shall help in a wider adaptation of the<br>
>> framework.<br>
>><br>
>> Good Luck<br>
>><br>
>> - ashish<br>
>><br>
>> On Fri, Apr 10, 2009 at 7:24 PM, Trustin Lee <<a href="mailto:tlee@redhat.com">tlee@redhat.com</a>> wrote:<br>
>> > Hi folks,<br>
>> ><br>
>> > I've just uploaded the latest revision of the Netty user guide.<br>
>> > Please check it out in the documentation page:<br>
>> ><br>
>> > * <a href="http://www.jboss.org/netty/documentation.html" target="_blank">http://www.jboss.org/netty/documentation.html</a><br>
>> ><br>
>> > Please feel free to give me feed back such as questions and comments<br>
>> > so that I can make this incomplete guide book more complete! :)<br>
>> ><br>
>> > Cheers,<br>
>> ><br>
>> > — Trustin Lee, <a href="http://gleamynode.net/" target="_blank">http://gleamynode.net/</a><br>
>> ><br>
>> > _______________________________________________<br>
>> > netty-users mailing list<br>
>> > <a href="mailto:netty-users@lists.jboss.org">netty-users@lists.jboss.org</a><br>
>> > <a href="https://lists.jboss.org/mailman/listinfo/netty-users" target="_blank">https://lists.jboss.org/mailman/listinfo/netty-users</a><br>
>> ><br>
>><br>
>><br>
>><br>
>> --<br>
>> thanks<br>
>> ashish<br>
>><br>
>> Blog: <a href="http://www.ashishpaliwal.com/blog" target="_blank">http://www.ashishpaliwal.com/blog</a><br>
>> My Photo Galleries: <a href="http://www.pbase.com/ashishpaliwal" target="_blank">http://www.pbase.com/ashishpaliwal</a><br>
>><br>
>> _______________________________________________<br>
>> netty-users mailing list<br>
>> <a href="mailto:netty-users@lists.jboss.org">netty-users@lists.jboss.org</a><br>
>> <a href="https://lists.jboss.org/mailman/listinfo/netty-users" target="_blank">https://lists.jboss.org/mailman/listinfo/netty-users</a><br>
><br>
><br>
> _______________________________________________<br>
> netty-users mailing list<br>
> <a href="mailto:netty-users@lists.jboss.org">netty-users@lists.jboss.org</a><br>
> <a href="https://lists.jboss.org/mailman/listinfo/netty-users" target="_blank">https://lists.jboss.org/mailman/listinfo/netty-users</a><br>
><br>
><br>
<br>
_______________________________________________<br>
netty-users mailing list<br>
<a href="mailto:netty-users@lists.jboss.org">netty-users@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/netty-users" target="_blank">https://lists.jboss.org/mailman/listinfo/netty-users</a><br>
</div></div></blockquote></div><br>