![]() |
|
|||||
![]() |
![]() |
![]() |
||||
IntroductionThe Kelp add-in makes it easy to use the Enhydra XML Compiler (XMLC) and the Enhydra Application Server (EAS) within an integrated development environment. Kelp 4 supports Borland JBuilder, Sun Forte, and Oracle JDeveloper. Refer to Using Kelp with an IDE for information on how to use a Kelp add-in to develop web applications with XMLC. This document supplements the Lutris donated documentation for Kelp tools and add-ins. The Lutris documentation covers the feature set supported in the Enhydra Application Server Suite. This document describes modules that part of the Kelp project but are not in the Lutris product line such as the Oracle JDeveloper add-in and the Windows installer. You'll also find an overview of the open source CVS modules at the end of this document. If you are working with a commercial release of Kelp such as the one bundled with Lutris EAS 4, you may have additional documentation or features that are not described here. You will find the latest version of this document at the Enhydra Kelp project web site along with FAQs (Frequently Asked Questions) and information on checking out the source from the CVS repository. For information on building Kelp, refer to the README.BUILD that is included in the root of the Kelp project source tree. This documentation assumes a basic understanding of a Java IDE and the servlet programming model. For information on JBuilder, visit the Borland website. You can find out more about Oracle JDeveloper from the Oracle Technology Network. The Sun Microsystems website provides information Forte for Java. If you are new to EAS, be sure to review the Getting Started Guide that can be found at the Lutris Enhydra Evaluation Documentation page. The add-in provides wizards and tools to help you develop applications for EAS. The add-in will add the Kelp application wizards to your IDE's File menu. You only need to use an application wizard when starting a new project. If you have an existing application that uses the Enhydra 3 make system, you can import it into an IDE project file using the Enhydra Import wizard. Once you have a project, you can use the XML Compiler and Enhydra Deployer to build and deploy your application. The XML Compiler and Enhydra Deployer are added to the IDE's Tools menu. These tools give you access to EAS features from within your IDE. Using the JBuilder integrated build feature, you can invoke these same processes directly within the project builder without opening either wizard. Each tool also has a set of project and node property pages that you can access from your project navigation tree. The general usage model for building web applications with the Kelp add-in:
The general usage model for building Enhydra services with the Kelp add-in:
The Kelp Project Web SiteThe Kelp project web site, http://kelp.enhydra.org is dedicated to making Enhydra technologies easier to use through the use of tools such as application wizards and Java IDE add-ons. The site serves as the repository for downloads, documentation and mail list archives. It also acts as a gateway to the CVS repository for the open source modules. You can use the project mail list, kelp@enhydra.org to post questions or suggestions regarding any of the Kelp modules. View the mail list archive to get information on recent releases and tips on how to make the most of Kelp.You are invited to participate in the Kelp project. We welcome contributions in many forms, including documentation, patches and additional IDE implementations. Installing the add-in from kelp.enhydra.orgBefore installing the add-in, you should already have installed a supported Java IDE and the Enhydra Application Server. Lutris provides an installation guide for EAS at the Lutris Enhydra Evaluation Documentation page. System Requirements
The Forte add-in requires Lutris EAS 4 and Forte for Java 2. The Forte add-in does not support Lutris Enhydra 3.5.2, Enhydra 3.1.1 or NetBeans. Kelp 4 requires the Kelp add-in jar, the Kelp toolbox jar and Enhydra XMLC classes to be in the IDE class path. Note that Kelp 4 will not work with Enhydra 3.1 and may not function correctly with the daily builds of Enhydra Enterprise. It is recommended that you go through each step listed in the installation guide so you can run the Enhydra administration console. If you install your Java IDE prior to installing Enhydra, you can skip the step about downloading Java. You can configure the application server to work with the Java 2 files that come with the IDE.
Install OptionsKelp add-ins are available in the following packages:
Upgrading from Kelp 2 or Enhydra 3.xIf you have configured your IDE for use with earlier releases of Kelp or the Enhydra application server, you should uninstall and remove all references to those releases. This is particularly important if you plan to use a configure script or the Windows installer to configure your IDE. The following items provide steps that should be taken prior to installing Kelp 4.
Configuring your IDEYou will need to modify some IDE configuration files to enable the Kelp add-in. The configuration process depends on what IDE you are running. Refer to the steps for your IDE. After configuring your IDE, you can to create an Enhydra library to use with your Enhydra projects. The library should include the Enhydra classes required to compile the source files generated by XMLC. The add-in includes a configure script that automates the configuration process when installing with Lutris EAS. The script does not support Enhydra 3.1.1. You'll find the configure script in the kelp4 directory. The script will modify the jbuilder.config file and create an Enhydra library. There is a configure batch file for Windows and a configure shell script for Linux/Solaris. For usage information run the configure script without any parameters from the kelp4 directory. Follow the steps below when running with Enhydra 3.1.1 or if the add-in does not appear to be functioning properly after using the Windows installer or the configure script.
If you want to use the XML Compiler with non-HTML document types on Linux, you will also need to comment out the You can check to see if you have installed the tools correctly by starting JBuilder and looking for the XML Compiler in the Tools menu. If the menu does not appear, check the IDE class path setting from the Info tab of the JBuilder about box. Setting up JDeveloperThe add-in does not include a configure script for automating the JDeveloper configuration process. Follow the steps below if the add-in does not appear to be functioning properly after using the Windows installer. Kelp 4 requires that you run the JDeveloper IDE under JDK 1.2.2 or higher. The Kelp configuration may cause problems when running JDeveloper under JDK 1.1.8. Be sure you shutdown JDeveloper before editing jdeveloper.ini, gallery.ini or jdeveloper.properties.
Oracle JDeveloper comes bundled with an older implementation of the org.wc3.dom classes that are not compatible with XMLC. The enhydra.jar file contains updated org.wc3.dom classes. To allow the XMLC to run successfully, the setup program places the enhydra.jar at the start of the IDE class path. Under JDK 1.1.8 the enhydra.jar will cause conflicts with the dacfdtd.zip, jbodt.zip and xmlparserv2.jar files. If you need to run JDeveloper under 1.1.8, you should remove those jar files from the IDE class path. This will disable some of JDeveloper's HTML tag support. If you want to use the HTML tag wizards, you will need to restore the Oracle files back into the IDE class path and remove Kelp. The add-in includes a configure script that automates the configuration process when installing with Lutris EAS and Forte. You'll find the configure script in the kelp4 directory. The script will create a runideForte startup script. It will not modify your existing runide scripts. There is a configure batch file for Windows and a configure shell script for Linux/Solaris. For usage information run the configure script without any parameters from the kelp4 directory. Follow the steps below if the add-in does not appear to be functioning properly after using the configure script. Note that when manually configuring Forte, you will be modifying your existing runide start script instead of using the Kelp provided runideForte script.
You should now be able to view Kelp add-in menu items. To check for proper installation, look for the Enhydra Application Wizard in the File menu. The add-in does not come with predefined sample projects for Forte. Refer to Using Kelp with an IDE for information on creating Forte projects for the Kelp samples.Defining a project class pathForte projects automatically include all jar files that are in the IDE class path. You can mount individual jar files and add them to your project if they are not already in the IDE class path, In both JBuilder and JDeveloper, the project class path is independent of the IDE class path. Both IDEs also allow you to define sets of jars as libraries. Libraries may be shared between projects. The following jars are required to successfully compile and run projects that use the servlet, Enhydra service, Enhydra XMLC or Enhydra Application Framework APIs.
ToolBox properties
The IDE add-in uses wizards within the ToolBox library. The ToolBox persists user settings in a toolbox.properties file. This file is created in an
/home/toni/.enhydra/toolbox.properties
If you experience any problems using the application wizards, verify that you have rights to create files and directories within your home directory. There are two properties you may need to modify in the toolbox.properties file. They are browser and eas.root. The browser property refers to the HTML browser that will be used to open help from Kelp tools launched from outside of an IDE or from within JDeveloper. The JBuilder and Forte add-ins use the IDE's native help system.
browser=C\:/Program\ Files/Internet\ Explorer/IEXPLORE.EXE
Using the open source Windows installerIf you are running on Windows with JBuilder or JDeveloper, you can use the open source Windows installer to install Kelp add-in files and configure your IDE. This installer does not support Forte, Linux or Solaris. This section describes the open source InstallShield setup program that is available from kelp.enhydra.org. Refer to the Lutris documentation if you are installing Kelp from a commercial release of Lutris EAS. Before running the open source installer, close any open instances of the IDE and note where your IDE and Enhydra files reside. You will need to tell the setup program what version of the IDE you are running. Open the IDE's About box to view the version number that you are currently running. The setup program will look up your Java IDE home directory in the Windows registry. If you have installed more than one supported IDE, you may need to click on Browse in the Choose IDE directory step to select the location of the IDE you want to use with Enhydra. The sample projects, documentation and libraries will be installed in a kelp4 directory within the Java IDE's home directory. After selecting the Java IDE root directory to use for installing, you need to tell the setup program where your EAS root directory is located. The setup program will look for a lib directory containing one or more EAS jar files within your EAS root directory. The setup program will check the Windows registry and common locations to determine a default such as: c:\usr\local\enhydra4 Enter the correct location or use Browse to navigate to your EAS root directory. The Enhydra XMLC jar files will be added to the IDE class path. The setup program also creates an Enhydra library for use with your projects. The toolbox.jar will also be installed. Note: If you have previously installed Kelp with a different version of EAS, you may need to modify the IDE class path to ensure that it only references a single installation of EAS. See the section on configuring your IDE for more information. The setup program provides you with three types of installations: Typical, Compact and Custom. Typical installs the libraries, documentation and the sample projects. Compact installs only the library files. Use custom to select any combination of components. After selecting the type of installation you want, setup prompts you for the program group and lists all your selections for confirmation. When you confirm the settings, the installer will copy files into a kelp4 directory within the IDE home directory. The installer also copies the toolbox.jar to <eas_root>/tool/lib. The installer modifies IDE configuration files. Some of the modifications will not be reversed if you uninstall Kelp. To allow you to restore your original configuration, the setup program creates a backup of each of the modified files and copies the backups to the kelp4 directory. JBuilder automatically detects and loads add-ins from the jar files that are listed in the IDE class path. It checks the manifest of each jar in the IDE class path to see if it contains a loadable add-in. If you want to know more about what the installer does to update your IDE configuration, refer to the section configuring your IDE. Using the JDeveloper add-inThis section describes difference between the JDeveloper add-in and what is described in Using Kelp with and IDE. JDeveloper may lockup if you task switch while the XML Compiler or Kelp Deployer tools are open. Kelp tools may not work correctly with projects generated through the new Project wizard. Before using Kelp, use the File | New Empty Project option. Once you have an empty project, you can generate a web application, Enhydra application or an Enhydra service with Kelp. The add-in does not auto-detect the <eas_root> directory. The application wizards uses the <eas_root> to generate command line support files and the Kelp Deployer uses the <eas_root> when determining the default auto-deploy directory. You can set the <eas_root> from the first step of an application wizard or by editing the toolbox properties file. When you invoke help from a Kelp dialog, the add-in loads help using an external browser instead of using the JDeveloper help system. The first time you open help, you will be asked to select a browser. You can modify your browser selection, by editing the toolbox properties file. JDeveloper 3.2 runs under JDK 1.2.2. To run projects with Lutris EAS 4, you will need to set the project's Target JDK version to 1.3. You can set the Target JDK through the project's paths property page. Using Kelp with Enhydra 3.xKelp 4 provides limited support for Enhydra 3.1.1 and Lutris Enhydra 3.5.2. It does not support earlier versions including Enhydra 3.1 or Lutris Enhydra 3.5. The following Kelp features will not function properly when running with Enhydra 3.x:
CVS modulesThe source files for the Kelp ToolBox and add-in modules are available from the CVS page of the Kelp project web site. Each module contains an Ant build.xml file. Some of the modules also contain JBuilder projects that you can use to view, debug and build the source. Kelp includes the following modules.
Each module can be built with Jakarta Ant 1.2 provided that you have setup the class paths in each modules lib.properties file. Below is a listing of external dependencies.
Visit the following news groups for information about the developing add-ins and using the JBuilder OpenTools API:
borland.public.jbuilder.opentools Visit the NetBeans site for information about the developing add-ins for Forte using the NetBeans OpenIDE API: Copyright 2000-2001 Lutris Technologies, Inc. JDeveloper is a trademark or registered trademark of Oracle Corporation. Forte and NetBeans are trademarks or registered trademarks of Sun Microsystems, Inc. InstallShield is a registered trademark of InstallShield Corporation. |
||||||
![]() |