From adffaces-user-return-25-apmail-incubator-adffaces-user-archive=incubator.apache.org@incubator.apache.org Fri Mar 31 20:44:20 2006 Return-Path: Delivered-To: apmail-incubator-adffaces-user-archive@locus.apache.org Received: (qmail 56601 invoked from network); 31 Mar 2006 20:44:20 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 31 Mar 2006 20:44:20 -0000 Received: (qmail 88324 invoked by uid 500); 31 Mar 2006 20:44:20 -0000 Delivered-To: apmail-incubator-adffaces-user-archive@incubator.apache.org Received: (qmail 88299 invoked by uid 500); 31 Mar 2006 20:44:19 -0000 Mailing-List: contact adffaces-user-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: adffaces-user@incubator.apache.org Delivered-To: mailing list adffaces-user@incubator.apache.org Received: (qmail 88285 invoked by uid 99); 31 Mar 2006 20:44:19 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 31 Mar 2006 12:44:19 -0800 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests= X-Spam-Check-By: apache.org Received-SPF: pass (asf.osuosl.org: local policy) Received: from [193.41.232.142] (HELO gw.cpb-software.ag) (193.41.232.142) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 31 Mar 2006 12:44:18 -0800 X-SEF-Processed: 5_0_0_816__2006_03_31_22_43_55 X-SEF-B4648323-12F0-40B2-A116-698324A7B2DA: 1 Received: from Unknown [192.168.22.144] by gw.cpb-software.ag - SurfControl E-mail Filter (5.0.1); Fri, 31 Mar 2006 22:43:55 +0200 X-MimeOLE: Produced By Microsoft Exchange V6.0.6603.0 content-class: urn:content-classes:message MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Subject: RE: API Documentation for "oracle.adfinternal.view.faces" package Date: Fri, 31 Mar 2006 22:43:52 +0200 Message-ID: <73B9C5C17D425D45B5CAA354C4E66C4A012B1431@cpbs-mxs1.cpbs.at> X-MS-Has-Attach: X-MS-TNEF-Correlator: Thread-Topic: API Documentation for "oracle.adfinternal.view.faces" package Thread-Index: AcZU9JZB9K1wEpPpRiSq0vOqb17pbgABZyVw From: "arti" To: X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Hi Adam, Thanks for details. I have few queries. If the queries are out of your scope, can you please direct me to concerned person please? It is critical for us to make a decision for using ADF or not. 1. Can you elaborate what do you mean by "not part of Public API", when ADF is declared as donated to Apache under Apache 2.0 lisence?=20 2. If the entire source code for "adfinternal" package is already made available, why not just API docs? 3. Will future versions of ADF Faces NOT be backward-compatible with the current "early access release" available? 4. Surprisingly this fact is not clearly mentioned on Oracle ADF website, neither on Apache incubation website.=20 5. Due to project urgency, if we are forced to use currnet version of ADF, we have high risk in upgrading to future versions. What is Oracle's suggestion for minimizing such upgradation-risk?=20 6. When will the entire APIs be "public" with complete API documentation? Thanks, Arti=20 -----Original Message----- From: Adam Winer [mailto:awiner@gmail.com]=20 Sent: Friday, March 31, 2006 8:54 PM To: adffaces-user@incubator.apache.org Subject: Re: API Documentation for "oracle.adfinternal.view.faces" package Arti, We don't generate docs for adfinternal because it is explicitly not part of our public API - these classes are subject to arbitrary change and are therefore considered "off-limits" for extension. For example, everything under: oracle.adfinternal.view.faces.ui and oracle.adfinternal.view.faces.uinode ... is code that needs to be rewritten inside of: oracle.adfinternal.view.faces.renderkit ... and then deleted. One of the planned projects is extracting a public API out of the renderkit package (e.g., the AdfRenderingContext and CoreRenderer classes), and moving them to the public API as part of oracle.adf.view.faces (or, rather, whatever org.apache package we end up in), at which point they're publicly supported and documented. In the meantime, you're free to subclass or use anything inside oracle.adfinternal, but only on the understanding that your code *will* break at some point; features you were relying on might just disappear without any replacement, etc. -- Adam On 3/31/06, arti wrote: > Hi, > > ADF Faces API documentation does not include=20 > "oracle.adfinternal.view.faces" package classes. I checked the online=20 > version also. > I need it for writing custom components & renderers. > > Does anyone know why? Where should we get it from? > > Thanks, > Arti > >