KELP Compiling and Installation - JBuilder


Table of Contents

1. Instructions
2. Building Kelp classes using JBuilder
Compiling and creating Toolbox archive file
Compile AddinCore files
Compiling and creating KelpAddin archive file
3. Building Kelp classes using jakarta-ant
Building Toolbox archive file
4. Implemeting KELP in JBuilder
Specify j2sdk1.4.x for JBuilder 6 and 7
Preparing jar archives
Changing JBuilder configuration file

Chapter 1. Instructions

To compile and install KELP in JBuilder 5, JBuilder 6 or JBuilder 7 there have to be done:

  • Compile and create Toolbox archive file toolbox.jar,

  • Compile AddinCore files and

  • Compile and create KelpAddin archive file KelpAddinJBuilder6.jar or KelpAddinJBuilder7.jar.

  • Implemeting KELP in JBuilder

Chapter 2. Building Kelp classes using JBuilder

Compiling and creating Toolbox archive file

In <Kelp source root>\modules\Toolbox directory is Toolbox.jpr project file. Required libraries for compiling Toolbox project are xmlc.jar and xerces.jar. Compile files in this project and build java classes (in \modules\Toolbox\classees directory). To create Toolbox archive file you have to run bulid_Toolbox.bat (in \modules\Toolbox\classees directory).

Compile AddinCore files

In <Kelp source root>\modules\AddinCore directory is AddinCore.jpx project file. Required libraries for compiling AddinCore project are: xmlc.jar, xerces.jar, and toolbox.jar.

Compiling and creating KelpAddin archive file

In <Kelp source root>\modules\AddinJBuilder directory is AddinJBuilder.jpx project file. Required libraries for compiling AddinJBuilder project are: xmlc.jar and toolbox.jar, path to AddinCore output files and JBuilder archive files JBuilder.jar and help.jar (its location is in <JBuilder root>\lib directory). To create KelpAddin archive file you have to rebuild KelpAddinJBuilder.jar file in AddinJBuilder project.

Chapter 3. Building Kelp classes using jakarta-ant

Building of Kelp jar files (toolbox and KelpAddinJBuilder) is ant based process. To compile and build jars (in <Kelp source root>/lib directory), just start

build_kelp_JBuilder_with_ant.bat
or
build_kelp_JBuilder_with_ant.sh
script files (depending on OS - Windows or Linux).

Before that, you have to set JDK_HOME variable (directory of your JDK installation) in build_kelp_with_ant.bat:

set JDK_HOME=c:\jdk1.4 
and enhydra.root (root directory of Enhydra installation) and jbuilder.root(root directory of jBuilder installation) in kelp.properties file:
enhydra.root=/Enhydra5.1
jbuilder.root=/jbuilder6

Ant build process creates two archive (jar) files in <Kelp source root>/lib; directory: toolbox.jar and KelpAddinBuilder.jar.
All required jar files for build using jakarta-ant are situated in <Kelp source root> directory.

Building Toolbox archive file

If you want to generate only toolbox classes and archive files (not AddinKelp.jar), just start build_toolbox_with_ant.bat file in <Kelp source root>\modules\Toolbox directory. Before that, you have to set JDK_HOME variable (directory of your JDK installation) in build_toolbox_with_ant.bat:

set JDK_HOME=c:\jdk1.4  
and enhydra.root (root directory of Enhydra installation) in kelp.properties file:
enhydra.root=/Enhydra5.1

Ant build process creates archive (jar) file in <Kelp source root>/lib; directory: toolbox.jar.
All required jar files for build using jakarta-ant are situated in <Kelp source root> directory.

Chapter 4. Implemeting KELP in JBuilder

Specify j2sdk1.4.x for JBuilder 6 and 7

For installing KELP in JBuilder (this is not neccesary for version 8 and upper (default java is 1.4)) it is necessery to configure JBuilder default java to be 1.4.x. You need to copy your j2sdk1.4.x (e.g. j2sdk1.4.1) into {JBuilder root} directory and edit {JBuilder root}/bin/jdk.config file to point to j2sdk1.4.x:

  • javapath ../j2sdk1.4.1/jre/bin/server/jvm.dll

  • addpath ../j2sdk1.4.1/lib/tools.jar

Preparing jar archives

For installing KELP in JBuilder it is necessery to have these jars: toolbox.jar, KelpAddin.jar, enhydra.jar, xmlc.jar. xerces.jar, tomcat.jar, core.jar, xhtml.jar and wireless.jar.
Copy these jar files into your hard drive:

  • The location of toolbox.jar file is <Enhydra5.1 root>\lib\build directory and it could be for examle: C:\Enhydra5.1\lib\build

  • The location of KelpAddinJBuilder.jar is not strictly determined too and it could be for example: C:\jbuilder5\kelp5\lib

  • The location of enhydra.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of xmlc.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of xerces.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of xhtml.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of wireless.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of tomcat.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of core.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of log4j.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\build

  • The location of ejen.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib\build

  • The location of dods.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib\build

  • The location of dods-runtime.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of xalan.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib\tools\Xalan

Changing JBuilder configuration file

For installing KELP in JBuilder, JBuilder configuration file has to be changed. That configuration file is: JBuilder.config file and it's location is in <JBuilder root> \bin directory

These lines have to be added there:

C:\jbuilder5\kelp5\lib\KelpAddinJBuilder.jar 
C:\Enhydra5.1\lib\build\toolbox.jar 

These lines have to be added before...
# Add all JAR files located in the patch, lib and lib/ext directory addjars

../patch addjars 
../lib addjars 
../lib/ext 
...lines. 

Copy Enhydra.library file into JBuilder/lib directory. Modify path of enhydra.jar file if necessary.

After this it is necessary to restart JBuilder.