Line 17: |
|
====Exploded Installation====
|
|
====Exploded Installation====
|
|
|
|
|
- |
After downloading one of the distribution archives, all a developer needs to do is extract the contents of the archive into the root of your web context.
|
+ |
After downloading one of the distribution archives, all a developer needs to do is extract the contents of the archive into the root of his web application directory.
|
|
|
|
|
|
====JAR file Installation====
|
|
====JAR file Installation====
|
Line 30: |
|
==Get Started with SynapticFaces==
|
|
==Get Started with SynapticFaces==
|
|
|
|
|
- |
In this get started section we assume that you already know about J2EE web applications and are familiar with JSF. The SynapticFaces product works and has been tested to work on all major JSF implementations.
|
+ |
In this get started section we assume that you already know about J2EE web applications and are familiar with Java Server Faces. The SynapticFaces product has been tested to work on all major JSF implementations.
|
|
|
|
|
|
|
+ |
SynapticFaces requires Java [http://java.sun.com/javase/downloads/index_jdk5.jsp JDK1.5] or later, sorry no 1.4 and earlier.
|
|
|
+ |
|
|
===Library Dependencies===
|
|
===Library Dependencies===
|
|
|
|
|
|
|
+ |
* jsxtoolkit-x.x.x.jar
|
|
* jsf-api.jar
|
|
* jsf-api.jar
|
|
* jsp-api.jar
|
|
* jsp-api.jar
|
Line 39: |
- |
* JSX
|
+ |
* log4j.jar
|
|
|
+ |
* dom4j.jar
|
|
|
|
|
- |
===Installation===
|
+ |
If you don't know where to get above libraries, download the showcase application [http://synapticpath.dyndns.org:8080/main/products_download.html SynapticShowcase.war], it contains all of the libraries and can be used as a reference.
|
|
|
|
|
- |
This section assumes that you have already installed a web server such as Apache Tomcat, or an application server such as JBOSS. An installed server will generally give you access, with the exception of JSF to all prerequisite libraries. JBOSS has the MyFaces implementation of JSF included.
|
|
|
- |
|
|
|
- |
* Complete JSX installation as stated in steps above.
|
|
|
- |
* Place the synapticfaces-x.x.x.jar library into the WEB-INF/lib directory.
|
|
|
- |
|
|
|
- |
If you are using an IDE such as Eclipse to develop your application, some helpful pointers can be found [[GetStartedWithEclipse|here]].
|
|
|
- |
|
|
|
- |
==Get Started with SynapticAjax Faces Components==
|
|
|
- |
|
|
|
- |
SynapticAjax JSF components are built on top of the foundation of SynapticFaces and JSX. As with SynapticFaces components we assume that you do have some basic understanding of the JSF framework.
|
|
|
- |
|
|
|
- |
===Library Dependencies===
|
|
|
- |
|
|
|
- |
* jsxtoolkit-x.x.x.jar
|
|
|
- |
* synapticfaces-x.x.x.jar
|
|
|
- |
* log4j
|
|
|
- |
* dom4j
|
|
|
- |
|
|
|
- |
NOTE: Fully installing SynapticFaces will satisfy all other dependencies, therefore those dependencies are not mentioned here.
|
|
|
- |
|
|
|
|
===Installation===
|
|
===Installation===
|
|
|
|
|
- |
The installation of SynapticAjax is not any different from the installation of SynapticFaces.
|
+ |
This section assumes that you have already installed a web server such as Apache Tomcat, or an application server such as JBOSS. An installed server will generally give you access, with the exception of JSF, to most prerequisite libraries. JBOSS has the MyFaces implementation of JSF included.
|
|
|
|
|
- |
* unless it is already a part of your web server, download log4j at
|
+ |
* Download and install Java Server Faces implementation such as the Apache [http://myfaces.apache.org/download.html MyFaces].
|
- |
* download and install dom4j at
|
+ |
* Download the JSX [http://synapticpath.dyndns.org:8080/main/products_download.html jsxtoolkit-x.x.x.jar].
|
- |
* install JSX following steps above
|
+ |
* Download [http://synapticpath.dyndns.org:8080/main/products_download.html synapticfaces-x.x.x.jar].
|
- |
* install SynapticFaces following above guide
|
+ |
* Download dom4j.jar and other prerequisite libraries as needed.
|
- |
* copy synapticajaxfaces-x.x.x.jar into WEB-INF/lib directory
|
+ |
* Place the synapticfaces-x.x.x.jar and jsxtoolkit-x.x.x.jar libraries and all prerequisite libraries into the WEB-INF/lib directory.
|
|
|
|
|
|
|
+ |
NOTE: If you are unsure where to obtain prerequisite libraries, you can download the showcase application [http://synapticpath.dyndns.org:8080/main/products_download.html SynapticShowcase.war] and extract the libraries already in it.
|
|
|
|
|
|
|
+ |
If you are using an IDE such as Eclipse to develop your application, some helpful pointers can be found [[GetStartedWithEclipse|here]].
|
|
|
|
|
|
==Other Considerations==
|
|
==Other Considerations==
|
Line 77: |
- |
The installation instructions for the most part merely show where in your web application to place the library files. Most of the time you will need to develop your application first and will need to adapt the installation steps to your specific development environment and build process.
|
+ |
The installation instructions show where in your web application to place the library files. Most of the time you will need to adapt the installation steps to your specific development environment and build process.
|