Building and Running ICEfaces with Ant

compared with
Current by Deryk Sinotte
on Nov 02, 2012 21:06.


 
Key
These lines were removed. This word was removed.
These lines were added. This word was added.

View page history


There are 2 changes. View first change.

 h2. Building ICEfaces
  
 If you have [downloaded|http://www.icefaces.org/main/downloads/os-downloads.iface] the Source distribution bundle of ICEfaces, you will need to compile and build the ICEfaces libraries before using them.
  
 {tip}The ICEfaces Binary distribution bundle comes with prebuilt ICEfaces libraries so building is not necessary.{tip}To build ICEfaces, open a console or shell and navigate to the "icefaces" directory where you unzipped the ICEfaces distribution. Then, in the console, type the following and press Enter:
  
 {code}
 ant allclean world{code}
 This builds all of the ICEfaces libraries and sample applications suitable for deployment to any JEE 6 Servlet Profile platform, such as Tomcat 6/7 and Jetty 7. If you'd like to build specific pieces of the distribution, type:
  
 {code}
 ant -p{code}
 to get a list of the available targets (e.g. ant core). It's recommended that you build everything the first time to ensure all the required libraries are created.
  
  
 h2. Building the Sample Applications
  
 The ICEfaces distribution comes with example applications that illustrate the key features of ICEfaces as well as providing source code and guidance about configuration and library dependencies.
  
 The default build target, "ant ", is mapped to the "servlet-profile" build target, which builds a version of the sample application suitable for deployment to any Servlet Profile platform, such as Tomcat 6/7 and Jetty 7, and includes both the icefaces.jar and the icepush.jar for Ajax Push support.
  
 The default build behavior can be modified using either the convenience targets in the build file or the properties as follows:
  
 {code}
 ant servlet-profile{code}
 This includes jsf-*.jar files, icefaces.jar and icepush.jar.
  
 {code}
 ant web-profile{code}
 This includes icefaces.jar and icepush.jar.
  
 Properties can also be used with the ant command to exclude the related .jar files from the .war file:
  
 By default, the Mojarra JSF library is included when the "servlet-profile" is specified. To include the Apache MyFaces JSF libraries instead, include the "-Dmyfaces=''" property:
 {code}
 ant -Dmyfaces='' servlet-profile{code}
  
 In addition, The "no-icefaces" property excludes all ICEfaces and ICEpush related .jar files where the "no-icepush" property only excludes the ICEpush related .jar file.
  
 {code}
 ant -Dno-icefaces='' -Dno-icepush=''{code}
  
 [!icefaces-services-wiki.png|align=center!|http://www.icesoft.org/java/services/icefaces-professional-services.jsf]
  
 h3. ICEfaces Showcase
  
 The sample applications under the \[icefaces.install.dir\]/icefaces/sample/showcase directory demonstrate key ICEfaces features, including extensive demos for both the [ACE Components] and the [ICE Components].
  
 To build the showcase example, open a console or shell and navigate to the directory (e.g. \[icefaces.install.dir]\/icefaces/samples/showcase/showcase), and type:
 {code}
 ant -p{code}
 And press Enter. This displays a list of build targets for various platforms.
  
  
 h3. Standard JSF with Core ICEfaces Framework and ICEpush
  
 The sample applications under \[icefaces.install.dir]\/icefaces/samples/core use only standard JSF components enhanced with the core ICEfaces framework. As such, they require fewer library dependencies.
  
 The main example is Auction - an online auction simulator implemented using JSF standard components, the ICEfaces core framework, and Ajax Push. This sample demonstrates how ICEfaces can provide automated-ajax and push update capabilities to standard JSF applications with minimal changes.
  
 To run any of the core samples, open a console or shell and navigate to the directory (e.g. \[icefaces.install.dir]\/icefaces/samples/core/auction), type:
 {code}
 ant -p{code}
 And press Enter. This displays a list of build targets for various platforms.
  
  
 h3. Auction Monitor featuring the ICEfaces Components
  
 The example under the \[icefaces.install.dir\]/icefaces/compat/samples/auctionMonitor directory provides a simulated online auction application using the core ICEfaces library, the ICEpush library, and features the ICEfaces Components.
  
 The AuctionMonitor example builds the same way as the ICEfaces Showcase example above.
  
  
 h3. Portlet Samples
  
 There are portlet versions of several of the sample applications. They exist in the same directory as the non-portlet example but are named by appending "-portlet" to the directory name. These include:
  
 {code}
 icefaces/samples/showcase/showcase-portlet
 icefaces/samples/core/chat-portlet
 {code}
 Each sample application can build in the same manner as noted of the none-porlet versions.
  
 You can find more information on Portlets and the examples under [Portlet Development].
  You can find more information on Portlets and the examples under [Portlet Development]. For specific instructions on how to use Ant to build the portlet examples and include the appropriate portlet bridge, see the section titled [Sample Portlet Applications].

© Copyright 2018 ICEsoft Technologies Canada Corp.