Introduction
JDIC consists of a collection of Java packages (JDIC API), all with the package name prefix
org.jdesktop.jdic
, and a JNLP application packaging tool (JDIC Packager).
- JDIC API is composed of below Java packages:
org.jdesktop.jdic.desktop
: APIs to automate native applications, including the document viewer applications associated with a particular file type, the system browser and the system mailer.
org.jdesktop.jdic.filetypes
: APIs to associate document viewer applications with filetypes.
org.jdesktop.jdic.browser
: Provides an AWT component to enable the embedding of the desktop's web browsing component,which only Mozilla and IE be supported at present, into Java applications and applets. The APIs support URL navigation, a basic history mechanism and progress notification.
org.jdesktop.jdic.tray
: APIs to to create tray icons on the desktop (in the System Tray Area for Windows platforms, and in the Notification Area for Unix platforms). A tray icon can have a caption (text), an icon, and a menu associated with it. It can also have a tool tip that is displayed when the mouse hovers over the tray icon. To get animation in the notification tray, use an animated GIF for the icon. Tray menus are Swing menus, which enables them to contain icons (unlike Windows and Gnome tray menus) and have either a cross-platform look and feel or the system look and feel.
- JDIC Packager is a tool for putting JNLP applications into installable packages of the standard Windows, Linux, and Solaris formats — MSI, RPM and PKG, respectively.
System Requirements
JDIC API:
- Supported platforms
- WinME/NT/2000/XP/2003, Sun Java Desktop System (JDS) Release 1 or later, SuSE Linux 7.1 or later, RedHat Linux 8 or later, Solaris 8 or later (package
org.jdesktop.jdic.tray requires
Solaris JDS 3).- Additional software
- Windows: Internet Explorer 5 or later, or Mozilla 1.4 or later.
- Linux/Solaris: Gnome 2.0, Ximian Evolution 1.4 or later, Mozilla 1.4 or later.
- J2SE v1.4.2 or later.
JDIC Packager:
- Supported platforms
- WinME/NT/2000/XP/2003, Sun Java Desktop System (JDS) Release 1 or later, SuSE Linux 7.1 or later, RedHat Linux 8 or later, Solaris 8 or later.
- Additional software
- Windows Developers need to download and install windows MSI SDK 1.5 to generate MSI packages.
- End user using Windows98/NT needs MSI service package to install MSI packages. Download the following executable and install.
Windows NT4 MSI Service Package, Windows 9x MSI Service Package- Linux: rpm-build package.
- J2SE v1.5.0 or later.
Installation
To run the downloadable or built JDIC binaries, following below installation instructions(only Mozilla and IE be supported at present):JDIC API:
- Add
jdic.jar
toCLASSPATH
.- Note: With earlier releases, on Windows, Browser component copies the bundled
MozEmbed.exe
file to the Mozilla binary path to work. Since 0.8.8, that file is not copied. While using the Browser component, BE SURE to remove theMozEmbed.exe
file if it locates at the Mozilla binary path.- Below steps are ONLY necessary if the native library or executable files locate at a different location from jdic.jar. If a JDIC release (
jdic-<version>-bin-<os>.zip
) is unzipped, these files locate at the same location asjdic.jar
and so below steps are unnecessary:
- Add the path of native library files .dll to
PATH
(for Windows), or .so toLD_LIBRARY_PATH
(for Linux/Unix).- Add the path of native executable files .exe (for Windows) or
mozembed-<os>-gtk*
(for Linux/Unix) toPATH
.Notes for earlier JDIC releases:
- for JDIC release 0.8.6.*, additional setting to use package
org.jdesktop.jdic.tray:
- Set the environment variable
JAVA_HOME
to the J2SDK/J2RE installation path.- for JDIC release 0.8.5 or later, additional setting to use package
org.jdesktop.jdic.browser:
- On Windows, set the environment variable
JAVA_HOME
to the J2SDK/J2RE installation path.- for JDIC release 0.8.4.*, additional settings to use package
org.jdesktop.jdic.browser:
- Windows
- Add<J2SDK HOME>/jre/bin
or<J2RE HOME>/bin
toPATH
.
- Add the path of native executable files (*.exe) toPATH
.
- The system default browser (Mozilla or Internet Explorer) is embedded. If Mozilla is the embedded browser:
* Set the environment variableMOZILLA_FIVE_HOME
to the absolute path of the Mozilla 1.4 (or later) executable file.
* CopyMozEmbed.exe
file to theMOZILLA_FIVE_HOME
directory.
* AddMOZILLA_FIVE_HOME
to PATH.- Linux/Solaris
- Add the path of native executable files (mozembed-linux-gtk*
ormozembed-solaris-gtk*
) toPATH
.
- Set the environment variableMOZILLA_FIVE_HOME
to the absolute path of the Mozilla 1.4 (or later) executable file.
- AddMOZILLA_FIVE_HOME
toLD_LIBRARY_PATH
.
JDIC Packager:
- Add
packager.jar
toCLASSPATH
.- Add native library (*.dll) path to
PATH
(for Windows).- J2SDK/J2RE version 1.5 or later is required to be installed. Make sure
java
command is under PATH, or setJDIC_PACKAGER_JAVAHOME
to the home directory of J2SDK/J2RE to override the PATH setting.- Add
deploy.jar
andjavaws.jar
in J2SDK/J2RE 1.5 or later to CLASSPATH. For J2SDK, the path is<J2SDK HOME>/jre/lib
; For J2RE, it's<J2RE HOME>/lib
.- Run the command line tool
jnlp2msi
(for Windows),jnlp2rpm
(for Linux), orjnlp2pkg
(for Solaris).