voyent
[IceFaces 2.0] Where is the reference documentation for implementation of components in 2.0?  XML
Forum Index -> Components
Author Message
Grunt2000

Joined: 02/Jun/2010 23:13:10
Messages: 6
Offline


Hello,


I want to use a menu bar with IceFaces 2.0-Alpha 3.

I saw the demonstration on icefaces web site and its related source code.
To do a dynamic menu, this one ask to import a:
com.icesoft.faces.component.menubar.MenuItem

I do not have this class in my icefaces.jar or icepush.jar 2.0.3 files --> Then, I understand that I am in front of samples of IceFaces 1.x.

Where is the 2.0.0 equivalent demo with the source code to use with IceFaces 2.0 components?

Maybe Menu bar is not yet handled with Icefaces 2, or only in compatibility mode (then I won't be able to use it), but where will I find the PDF documentation of IceFaces 2.0? I searched for it, but wasn't able to find it.

I am not looking for the Getting Started documentation, but the full explanation of its use, component per component, for 2.0.

Rather than the samples/auction/src directory content that doesn't help me a lot, its a documentation like the one Primefaces wrote for 2.0 and have 350 pages. Where is this reference documentation for Icefaces 2?


Regards,

Grunt.
tobias.karzewski

Joined: 21/Jul/2009 00:00:00
Messages: 17
Offline


I think, you have to import icefaces-compat.jar and icefaces-compat-components.jar to use these components.
The API and Taglib Documentation can be found here
Grunt2000

Joined: 02/Jun/2010 23:13:10
Messages: 6
Offline


The 1.8.2 does not interest me at all. Even for compatibility.

Currently comparing faces against others, to demonstrate their benefits to an enterprise, people are asking me this way: "and Richfaces? and Primefaces? and .. ?".
I can't make a demonstration of IceFaces abilities by arguing it relies on JSF 1.x! I need to use only components of the 2.0.


1) I am not able to say what components are supported by 2.0 because there is no complete list published today?
Is there twenty, ten or five components really 2.0 ? Who are they? I will only use them. Even if I don't use the Menubar in my samples, eventually.

2) I can't show the PDF reference documentation equivalent to the one Primefaces already has.

3) The Javadoc of Icefaces 2.0 mainly show no packages, classes or methods comments. I can't figure how to use it.
ken.fyten

Joined: 26/Oct/2004 00:00:00
Messages: 1337
Offline


Hi,

There seems to be some confusion here. ICEfaces 2.0 Alpha 3 includes the ICEfaces Component Suite components (from ICEfaces 1.x) in a "Compatibility" library (icefaces-compat.jar and icefaces-compat-comps.jar). The purpose of the Compatibility library is two-fold:

1. Provide key ICEfaces 1.x APIs on top of ICEfaces 2.0 to make porting existing ICEfaces 1.x applications easier. ICEfaces 2.0 uses different packaging and APIs than 1.x and is not directly backwards compatible. The Compatibility APIs basically provide key 1.x APIs as wrappers for the new 2.0 APIs.

2. Provide the ICEfaces 1.x Component Suite for use on ICEfaces 2.0. Since the ICEfaces 1.x Components also rely on many of the ICEfaces 1.x APIs internally, they also require using the Compatibility APIs to function on ICEfaces 2.0.

Note that there is nothing JSF 1.2 about the Compatibility APIs and Components, they are meant to run only on JSF 2.0 on top of ICEfaces 2.0.

There is also a new generation of ICEfaces components under development, based on a new Component Development Platform, for ICEfaces 2.0. These components will be delivered gradually, with the initial set of 5 - 10 components arriving by the time that ICEfaces 2.0 ships final in the fall. More new components will be delivered after that in 2.1, etc. Eventually, the goal is to provide replacement component functionality for virtually the complete ICEfaces 1.x Component Suite (not necessarily in a one-to-one relationship with existing components), but this is going to take some time to achieve. In the meantime, using the ICEfaces 1.x Components alongside std. JSF components and the new ICEfaces 2.0 Components is recommended.

The initial set of new components will include new File Upload, DateTimePicker, Tabset components. The initial release of these new components will occur in August, so you won't have access to them until then. In the meantime, I encourage you to evaluate with the Compat. Components. Keep in mind that ICEfaces 2.0 provides many framework level-features that are of benefit regardless of the component-set being used (see here).

As for the documentation issues, well, we're only in Alpha 3 stage, so docs are still rough. We're working hard to deliver ICEfaces 2.0 Beta soon, and you can expect documentation to improve over the course of the next couple releases prior to 2.0 final.

Regards,
Ken

Ken Fyten
VP Product Development
ICEsoft Technologies, Inc.
Grunt2000

Joined: 02/Jun/2010 23:13:10
Messages: 6
Offline


I think I was mislead by the mention I red in the release notes, telling that the IceFaces 2.0 components would not work in ViewScope.

I understand that I shall wait for the new components and documentation coming.
I will re-evaluate IceFaces in Q2/2011. I have enough work with JSF 2 and the other faces to convince others that they can replace JSF 1.x.

Every components involved: Glassfish v3.0.1, JSF 2.0.2, Icefaces 2.0-Alpha 3 are all in their early stages. I only have to be patient.

Regards,

Grunt.
 
Forum Index -> Components
Go to:   
Powered by JForum 2.1.7ice © JForum Team