Bryan
These are instructions for using the Eclipse IDE to develop on Apache Beehive.
1. Requirements --------------- In order to install Beehive on Eclipse, you must first obtain the following software: - Eclipse 3.1 M4 - Java 5 SDK installed in JAVA_HOME - Apache Ant 1.6.2 installed in ANT_HOME - Apache Beehive source installed in BEEHIVE_HOME 2. Initial Eclipse Setup ------------------------ You must first setup Eclipse 3.1 to use Java 5: - Start Eclipse with a Java 5 JVM. - Set Eclipse to use Java 5 compiler settings. You can do this by going to Windows->Preferences->Java->Compiler->Compiler compliance level and setting it to "5.0." You may also want to create a "beehive" workspace specifically for working with Beehive. 3. Beehive Projects Setup ------------------------- You will need to create three projects: - controls - netui - wsm Each of these projects will have certain source paths, project dependencies, and library dependencies that you need to setup. 3.1. Handling XMLBeans Because Eclipse 3.1 M4 does not have any native or plugin support for Apache XMLBeans, you will need to generate a couple jars from Beehive XML Schemas. First, download the patch for generating these jars from http://issues.apache.org/jira/browse/BEEHIVE-147 Then, apply the patch and run the following: $ ant -f $BEEHIVE_HOME/netui/ant/build-schema.xml $ ant -f $BEEHIVE_HOME/wsm/build-schema.xml This will generate two jar files, netui-schema.jar and wsm-schema.jar for use with Eclipse. Any time that Beehive's XML schemas are updated, you will need to re-generate these jar files. 3.2. Project Setup Create the projects, controls, netui, and wsm. For each of the projects, setup the following properties: ***Controls Project*** Controls Project rooted at $BEEHIVE_HOME/controls Source: - src/api - src/runtime - src/spi Libraries: - $ANT_HOME/lib/ant.jar - $BEEHIVE_HOME/external/servlet/servlet-api-2.4.jar - $JAVA_HOME/lib/tools.jar - $BEEHIVE_HOME/external/velocity/velocity-1.4.jar Project Dependencies: - none ***Netui Project*** Netui Project rooted at $BEEHIVE_HOME/netui Source: - src/bootstrap - src/compiler - src/javascript - src/pageflow - src/scoping - src/tags-databinding - src/tags-html - src/tags-template - src/tomcat-common/5x - src/tomcat-webapp/5x - src/util - src/webapp-template Project Dependencies: - controls project Libraries: - $ANT_HOME/lib/ant.jar - $BEEHIVE_HOME/external/xmlbeans/apache-xbean.jar - $BEEHIVE_HOME/external/commons-codec/commons-codec-1.3.jar - $BEEHIVE_HOME/external/servlet/jsp-api-2.0.jar - $BEEHIVE_HOME/installed/jsr173/jsr173_1.0_api.jar - $BEEHIVE_HOME/external/log4j/log4j-1.2.8.jar - $BEEHIVE_HOME/external/servlet/servlet-api-2.4.jar - $JAVA_HOME/lib/tools.jar - external/struts/commons-beanutils.jar - external/struts/commons-collections.jar - external/struts/commons-digestor.jar - external/commons-el/commons-el.jar - external/struts/commons-fileupload.jar - external/struts/commons-logging.jar - external/struts/commons-validator.jar - external/struts/jakarta-oro.jar - external/struts/jdbc2_0-stdext.jar - external/jstl/jstl.jar - external/jsf/myfaces.jar - external/jstl/standard.jar - external/struts/struts.jar - external/xdoclet/xdoclet-1.2b4.jar - external/xdoclet/xdoclet-web-module-1.2b4.jar - external/xdoclet/xjavadoc-1.1-j5-v3.jar - netui-schema.jar: Make sure that you add the netui-schema.jar which you generated earlier. ***Wsm Project*** Netui Project rooted at $BEEHIVE_HOME/wsm Source: - src/api - src/runtime Project Dependencies: - controls project Libraries: - $BEEHIVE_HOME/external/xmlbeans/apache-xbean.jar - $BEEHIVE_HOME/external/commons-codec/commons-codec-1.3.jar - $BEEHIVE_HOME/installed/jsr173/jsr173_1.0_api.jar - $BEEHIVE_HOME/external/junit/junit.jar - $JAVA_HOME/lib/tools.jar - external/axis.jar - external/axis-ant.jar - external/commons-discovery.jar - external/commons-logging.jar - external/jaxrpc.jar - external/saaj.jar - external/wsdl4j.jar - lib/wsdltypes.jar - wsm-schema.jar: Make sure that you add the wsm-schema.jar which you generated earlier. 3.3. JSF Support To add JSF support, add the following jars to your library paths: - $JSF_HOME/lib/jsf-api.jar - $JSF_HOME/lib/jsf-impl.jar 4. Conclusion ------------- You should now be able to develop Beehive using Eclipse. ****** Bryan Che [EMAIL PROTECTED] last updated 2005-01-04
