Mailing-List: contact cxf-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: cxf-dev@incubator.apache.org
Received-SPF: pass (nike.apache.org: domain of jeff.yu@iona.com designates
 12.170.54.180 as permitted sender)
Message-ID: <46DE1937.40605@iona.com>
Date: Wed, 05 Sep 2007 10:49:27 +0800
From: "Jeff.Yu" <jeff.yu@iona.com>
User-Agent: Thunderbird 2.0.0.6 (Windows/20070728)
MIME-Version: 1.0
To: cxf-dev@incubator.apache.org
Subject: Re: To attract more committers, write more architecture doc?
References: <9A4696F35B459043970EE4A85A317390066925@amer-ems1.IONAGLOBAL.COM>
In-Reply-To: <9A4696F35B459043970EE4A85A317390066925@amer-ems1.IONAGLOBAL.COM>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

When it comes to the Interceptor, actually I'd like we can have 
class-level comment for interceptors, now in the CXF, we are having lots 
of interceptors, but very small of them have class-level comment. I 
think it would be very helpful for people to know better what this 
interceptor does if we have class-level comment, the comment doesn't 
need to be verbose.

Thanks
Jeff

Liu, Jervis wrote:
> 5). how to write an interceptor. We've already had a sample to show how to write a stream intercetor, but this information is not enough for a CXF committer. I would like to see more documents on the interceptor's phase(addBefore/addAfter), stateless interceptor VS stateful interceptor, how intercetors are contributed from bus/endpoint/service, sub-interceptor chain (ending interceptors), how fault handing works in the interceptor chain(how to properly throw exceptions from interceptors, faultChain) etc. 
>
> Oh, by the way, I think I can do this part, though it does not sound like a very easy job. ;-)
>
> Cheers,
> Jervis
>
>   
>> -----Original Message-----
>> From: Daniel Kulp [mailto:dkulp@apache.org]
>> Sent: 2007?9?4? 23:33
>> To: cxf-dev@incubator.apache.org
>> Subject: Re: To attract more committers, write more architecture doc?
>>
>>
>>
>>
>> My big one:
>> 4) How to right a new data binding (and then get someone to do the 
>> xmlbeans and jbix stuff).    :-)
>>
>> Dan
>>
>>
>> On Tuesday 04 September 2007, Dan Diephouse wrote:
>>     
>>> Benson Margulies wrote:
>>>       
>>>> http://cwiki.apache.org/CXF20DOC/cxf-architecture.html could get
>>>> bigger.
>>>>         
>>> IMO, It'd probably be really good to add a couple focused guides:
>>> 1. How to write a conduit/destination
>>> 2. How to write a new binding
>>> 3. How to add more WS-* support
>>>
>>> Anyone want to help with that? :-)
>>>
>>> - Dan
>>>       
>>
>> -- 
>> J. Daniel Kulp
>> Principal Engineer
>> IONA
>> P: 781-902-8727    C: 508-380-7194
>> daniel.kulp@iona.com
>> http://www.dankulp.com/blog
>>
>>     
>
> ----------------------------
> IONA Technologies PLC (registered in Ireland)
> Registered Number: 171387
> Registered Address: The IONA Building, Shelbourne Road, Dublin 4, Ireland
>
>