cxf-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Liguori (JIRA)" <>
Subject [jira] Commented: (CXF-3038) Update online CXF Architecture Document
Date Sun, 10 Oct 2010 23:30:31 GMT


Robert Liguori commented on CXF-3038:

I'm trying to learn from the existing CXF documentation.  As I find issues with the material,
I believe that I am acting responsibly by raising the issue flag.   As I am not a CXF expert
at this time, I cannot comfortably add and/or refine technical content.   However, once my
skills mature, I may be able to contribute on nights and weekends.  I did apply for wiki access,
so once I get it, I'll make quick and easy refinements as I go along the learning trail. 

> Update online CXF Architecture Document
> ---------------------------------------
>                 Key: CXF-3038
>                 URL:
>             Project: CXF
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Robert Liguori
>            Priority: Minor
>   Original Estimate: 2h
>  Remaining Estimate: 2h
> The CXF Architecture Guide ( needs to
be updated.
> Some strong suggestions:
> (1) The "Frontends" section has only one sub-section, and it's empty.  The "Frontends"
section should discuss JAX-WS, JAX-RS, Simple Frontend and Javascript.  Link to and/or update
this page:
> (2) It would be nice if the "Data Bindings" section referenced supported data bindings
(e.g., JAXB, XMLBeans, Aegis (2.1), Aegis (2.0.x), MTOM Attachments with JAXB, Service Data
Objects (SDO) and SXC*.  Note; Link to and/or update this page:
> (3) The "Bindings" section should be renamed to "Protocol Bindings".  There are currently
two sections, one on SOAP bindings and an empty on on XML bindings.  Consider sub-sections
on SOAP 1.1/1.2 bindings, HTTP 1.1 bindings, Pure XML bindings and CORBA bindings.
> (4) Consider adding notes on supported transports to the "Transports" section; SOAP over
HTTP, SOAP over JMS, XML over HTTP, XML over JMS, CORBA, Servlet, In-VM, SMTP/POP3 via Camel
Transport for CXF, TCP via Camel Transport for CXF and Jabber (Experimental) via Camel Transport
for CXF.  Note: Also, link to and/or update this page:
> (5) The book "Apache CXF Web Service Development" by Naveen Balani and Rajeev Hathi (Packt
Publishing) has a nice "CXF Architecture" section; pages 39-49.  This book should be references
and/or compared to the document for alignment purposes (since the  section headers are nearly
> Note: Since this is an 'architecture' document, perhaps specific implementation details
and related products is outside of scope (e.g., listing specific data binding APIs), but it
would still be nice to see.  At a minimum though... the empty, place holder sections of this
document should be completed by someone.

This message is automatically generated by JIRA.
You can reply to this email to add a comment to the issue online.

View raw message