KELP Compiling and Installation - JDeveloper

To compile and install KELP in JDeveloper 3.2.3 there have to be done:

  1. Compile and create Toolbox archive file toolbox.jar,

  2. Compile AddinCore files and

  3. Compile and create KelpAddinJDeveloper archive file KelpAddinJDeveloper.jar.

  4. Implemeting KELP in JDeveloper


 

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 is 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 KelpAddinJDeveloper archive file

In <Kelp source root>\modules\AddinJDeveloper directory is AddinJDeveloper.jpx project file. Required libraries for compiling AddinJDeveloper project are: xmlc.jar and toolbox.jar, path to AddinCore output files and JDeveloper archive files jdeveloper.jar and jbcl2.0.zip (its location is in <JDeveloper root>\lib directory). To create KelpAddinJDeveloper archive file you have to rebuild KelpAddinJDeveloper.jar file in AddinJDeveloper project.


Building Kelp classes using jakarta-ant

In <Kelp source root> directory is build_JDeveloper.xml file. This file is used by ant for compiling and creating archive files. All that you have to do is to start this building process is to call build_kelp_JDeveloper_with_ant.bat file in <Kelp source root> directory.

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.3.1

and enhydra.root (root directory of Enhydra installation) and jdeveloper.root
(root directory of JDeveloper installation) in kelp.properties file:

enhydra.root=/aonyx5.0
jbuilder.root=/jbuilder6

jdeveloper.root=/jdeveloper

Ant build process creates two archive (jar) files in <Kelp source root>/lib; directory: toolbox.jar and KelpAddinJDeveloper.jar.
All required jar files for build using jakarta-ant is 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.3.1

and enhydra.root (root directory of Enhydra installation) in kelp.properties file:

enhydra.root=/aonyx5.0

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

Implemeting KELP in JDeveloper

Preparing jar archives

For installing KELP in JDeveloper it is necessery to have these jars: toolbox.jar, KelpAddinJDeveloper.jar, enhydra.jar, xmlc.jar. xerces.jar, tomcat.jar, jtidy.jar, gnu-regexp-1.1.4.jar and core.jar.
Copy these jar files into your hard drive:
The location of toolbox.jar file is <aonyx5.0 root>\tool\lib directory and it could be for examle: C:\aonyx5.0\lib\build
The location of KelpAddinJDeveloper.jar is not strictly determined too and it could be for example: C:\jdeveloper\kelp5\lib
The location of enhydra.jar file have to be in Enhydra directory and it is for example: C:\aonyx5.0\lib
The location of xmlc.jar file have to be in Enhydra directory and it is for example: C:\aonyx5.0\lib
The location of xerces.jar file have to be in Enhydra directory and it is for example: C:\aonyx5.0\lib
The location of tomcat.jar file have to be in Enhydra directory and it is for example: C:\aonyx5.0\lib
The location of core.jar file have to be in Enhydra directory and it is for example: C:\aonyx5.0\lib

The location of jtidy.jar file have to be in Enhydra directory and it is for example: C:\aonyx5.0\lib
The location of gnu-regexp-1.1.4.jar file have to be in Enhydra directory and it is for example: C:\aonyx5.0\lib


Changing JDeveloper configuration file

For installing KELP in JDeveloper, JDeveloper configuration file have to be changed. These configuration files are: jdeveloper.ini, galery.ini, library.ini files, there's location is in \bin directory and jdeveloper.properties file in \lib directory.

In jdeveloper.ini have to be added these line:
PREBCP=-Xbootclasspath/p:..\Kelp5.0\lib\KelpAddinJDeveloper.jar;C:\enhydra5.0\lib\enhydra.jar;C:\enhydra5.0\lib\xmlc.jar;
C:\enhydra5.0\lib\xerces.jar;C:\enhydra5.0\lib\jtidy.jar;C:\enhydra5.0\lib\gnu-regexp-1.1.4.jar;C:\enhydra5.0\lib\build\toolbox.jar;..\lib\jdeveloper.zip;
..\aurora\lib\vbjorb.jar;..\aurora\lib\aurora_client.jar;..\aurora\lib\jasper.zip;..\aurora\lib\vbjtools.jar;..\aurora\lib\vbjorb.jar;..\aurora\lib\vbjapp.jar;
..\aurora\lib\vbj30ssl.jar;..\aurora\lib\aurora.zip;..\sqlj\lib\runtime12.zip

In galery.ini have to be added these lines:
in
[Gallery_Pages]
line
Page6=Enhydra
at the end of file
[Gallery_Page6] wizard=Web Application=org.enhydra.kelp.jdeveloper.wizard.WebAppWizard wizard=Enhydra Application=org.enhydra.kelp.jdeveloper.wizard.Enhydra3AppWizard

In library.ini have to be added these lines:
[Library_Enhydra] Classpath=..\..\..\..\enhydra5.0\lib\enhydra.jar;..\..\..\..\enhydra5.0\lib\xmlc.jar;..\..\..\..\enhydra5.0\lib\xerces.jar;..\..\..\..\enhydra5.0\lib\tomcat.jar;..\..\..\..\enhydra5.0\lib\core.jar

[Library_SunTools]
Classpath=..\java1.2\lib\tools.jar

[Library_Toolbox]
Classpath=..\..\..\..\enhydra5.0\lib\build\toolbox.jar

In jdeveloper.properties have to be added these lines:
jdeveloper.addin.91=org.enhydra.kelp.jdeveloper.tool.XMLCTool
jdeveloper.addin.92=org.enhydra.kelp.jdeveloper.tool.DeployTool
jdeveloper.addin.93=org.enhydra.kelp.jdeveloper.wizard.ImportWizard
jdeveloper.addin.94=org.enhydra.kelp.jdeveloper.wizard.WebAppWizard
jdeveloper.addin.95=org.enhydra.kelp.jdeveloper.wizard.Enhydra3AppWizard

After this it is necessary to restart JDeveloper.