BBj 11.x Classpath Overview

 

BBj 11.0 includes the following jars.

New JAR Sets

New or updated

 

Jar Name

Function

activation.jar

Redistributable Java WSDP component

asm-all-3.1.jar

BBj code generation

axiom-api-1.2.8.jar

XML manipulation

axiom-impl-1.2.8.jar

XML manipulation

axis2-adb-1.5.jar

Web services

axis2-kernel-1.5.jar

Web services

axis2-transport-http-1.5.jar

Web services

axis2-transport-local-1.5.jar

Web services

BasisHttpServerProvider.jar

Embedded Jetty web server

BasisInstall.jar

Installation and Admin Utility Application

BBj.jar

Core server-side BBj components

BBjAdminAPI.jar

API used to talk to the Admin server for BBjServices

BBjBootstrap.jar

Used to validate ClientObject jars

BBjEM.jar

Components for BBj Enterprise Manager application

BBjFilesystem.jar

File system components

BBjIndex.jar

Main jar - indexes all other BBj jars

BBjJDBC.jar

JDBC API

BBjPlugin.jar

Sample file system plug-ins

BBjPortID.jar

BBj port information

BBjServer.jar

BBjServer.jar

BBjSql.jar

SQL API

BBjThinClient.jar

BBj client-side components

BBjUtil.jar

Core client and server components

bcel.jar

BBj code generation

bcmail-jdk16-144.jar

PDF signing

bcprov-jdk16-144.jar

PDF signing

bus.jar

BASIS Update Service

ChileCompanyWebService.jar

Chile Company Web Service demo

comm.jar

 

commons-beanutils-1.7.jar

JasperReports (BBJasper)

commons-cli-1.2.jar

Web services API

commons-codec-1.3.jar

Web services coder/decoder

commons-collections-3.2.1.jar

JasperReports (BBJasper)

commons-digester-1.7.jar

JasperReports (BBJasper)

commons-fileupload-1.2.2.jar

 

commons-httpclient-3.1.jar

Web service client

commons-io-1.4.jar

 

commons-javaflow-20060411.jar

JasperReports (BBJasper)

commons-logging-1.1.1.jar

JasperReports (BBJasper)

ConfiguratorHelp.jar

Help for BBj Configurator Application

CustomIDE.jar

Custom images and files for the BASIS IDE

CustomLookAndFeel.jar

Custom skinning

data-calendar-2.0.jar

Google Docs

DemoClientFiles.jar

BBj demo images

examples.jar

BBj demo package

ExamplesProperties.jar

BBj demo property files

ExtIndex.jar

Index on non-BASIS jars

ExtUtil.jar

BBJasper and LaunchDock

Fax.jar

Faxing capabilities

FedExWebServiceClient.jar

FedEx Web Service demo

FontChooser.jar

Font chooser feature jar

gdata-calendar-2.0.jar

Google Docs

gdata-calendar-meta-2.0.jar

Google Docs

gdata-client-1.0.jar

Google Docs

gdata-client-meta-1.0.jar

Google Docs

gdata-core-1.0.jar

Google Docs

gdata-docs-3.0.jar

Google Docs

gdata-docs-meta-3.0.jar

Google Docs

gdata-media-1.0.jar

Google Docs

gdata-sites-2.0.jar

Google Docs

gdata-sites-meta-2.0.jar

Google Docs

gdata-spreadsheet-3.0.jar

Google Docs

gdata-spreadsheet-meta-3.0.jar

Google Docs

groovy-all-1.7.5.jar

Groovy language (BBJasper)

GuiBuilderHelp.jar

Help for BBj GuiBuilder Application

gwt-user-2.0.3.jar

Google Web Toolkit

HelpAll.jar

Contains all third party help

httpcore-4.0.jar

Web Service transport components

InterFaxClient.jar

Faxing capabilities

iText-2.1.7.jar

PDF library

JarRegistrationServiceClient.jar

Registering ClientObject jars

JarRegistrationServiceClientLib.jar

Registering ClientObject jars

jasperreports-4.0.2.jar

JasperReports (BBJasper)

java_cup.jar

BBj language grammar

jcommon-1.0.16.jar

Jfree charts

JDBCPooling-internal.jar

Connection to third party JDBC databases

JDBCPooling.jar

Connection to third party JDBC databases

jdic.jar

Native desktop facilities

jdic_native_applet.jar

Native desktop facilities

jdt-compiler-3.1.1.jar

JasperReports (BBJasper)

jetty-6.1.14.jar

Embedded Jetty web server

jetty-util-6.1.14.jar

Embedded Jetty web server

JettyHttpServerProvider-6.1.14.jar

Embedded Jetty web server

jfreechart-1.0.13.jar

Jfree charts

jfreechart-experimental.jar

Jfree charts

mail.jar

Redistributable Java WSDP component

neethi-2.0.4.jar

Web Service framework

outline.jar

Online copy interface in Enterprise Manager

PDFRenderer.jar

Generating PDF files

poi-3.6-20091214.jar

JasperReports (BBJasper)

rfaxCOMM.jar

 

rfaxRXTX.jar

 

RXTXcomm.jar

Serial devices (Linux)

RXTXcomm_win.jar

Serial devices (Windows)

servlet-api-2.5-6.1.14.jar

Embedded Jetty web server

SpellChecker.jar

Spell checker feature jar

swingx-1.0.jar

Swing layout extensions

TimingFramework.jar

Timing framework

Translator.jar

Demo translation resource bundle

unboundid-ldapsdk-se.jar

LDAP API

wsdl4j-1.6.2.jar

Web Services toolkit

XmlSchema-1.4.3.jar

XML creation/manipulation

Table 1. Core BBj Jar Files


Table 2. below lists nine SpellCheckerDictionary-xx.jar files that provide spell checker dictionaries in various languages and dialects.

Because the language dictionaries are rather large and because most applications do not use all languages, the dictionary files are not included in the standard thin-client jar configuration. When deploying a client application that uses spell checking, be sure to add the required dictionary files to the cache archive.

 

 Language

Spell Check Language File(s)

Dutch

SpellCheckerDictionary-du.jar

English – American

SpellCheckerDictionary-en.jar
SpellCheckerDictionary-am.jar

English – British

SpellCheckerDictionary-en.jar
SpellCheckerDictionary-br.jar

English – Canadian

SpellCheckerDictionary-en.jar
SpellCheckerDictionary-ca.jar

French

SpellCheckerDictionary-fr.jar

German

SpellCheckerDictionary-ge.jar

Italian

SpellCheckerDictionary-it.jar

Spanish

SpellCheckerDictionary-sp.jar

Swedish

SpellCheckerDictionary-sw.jar

Table 2. SpellChecker Dictionary Jar Files
 

How JAR Changes Affect Web Start

In previous revisions of BBj, the ThirdParty.jar was a key jar element listed in the JNLP file. The ThirdParty.jar was deprecated in BBj 8.0, so it is recommended to change the ThirdParty.jar JNLP element to list BBjUtil.jar instead.

Note: In order to minimize the initial impact of this change, the ThirdParty.jar is a copy of BBjUtil.jar; this will allow most Web start applications to continue to work without a change in BBj 10.0. However, note the change that the ThirdParty.jar will be removed in future revisions of BBj.

The BBj code generation jar, asm-all-3.1.jar, is a required element in BBj 9.0. The BBjBootstrap.jar plays a  significant role in BBj 11.0 and is a mandatory element in the JNLP file.

Note: Web start applications can list the BBjIndex.jar as an element to load classes from such unlisted jars as those mentioned above, including the BBjBootstrap.jar and asm-all-3.1.jar. However, these two conditions must be met:

1. The Web start JNLP file must contain a BBjThinClient.jar element and a BBjUtil.jar element. The BBjThinClient.jar must be listed before the BBjIndex.jar element in the application JNLP.

2. Both the server and client systems must have JDK (Java Development Kit) installed.

One possible drawback to jar indexing in a Web start environment is the lack of caching of the indexed jars on the client. If caching is needed for certain jar files, use the 'lazy' attribute. When used in conjunction with the BBjIndex.jar, the 'lazy' attribute will download the jar on demand, and keep the jar in the client cache. See sample JNLP file below:

<?xml version="1.0" encoding="UTF-8"?>
 <jnlp spec="1.0+"
    codebase="http://www.test.com/jnlp"
    href="indexed.jnlp">
    <information>
       <title>Sample Index JNLP</title>
       <vendor>BASIS International Ltd.</vendor>
       <icon href="myicon.gif"/>
       <description>Sample JNLP With Index and Lazy Elements</description>
      <offline-allowed/>
    </information>
    <security>
        <all-permissions/>
    </security>
    <resources>
    <j2se version="1.6+" inital-heap-size="48m" max-heap-size="48m"/>
    <jar
 href="BBjThinClient.jar"/>
    <jar href="BBjUtil.jar"/>

    <jar href="BBjBootstrap.jar"/>

    <jar href="BBjIndex.jar"/>
    <jar href="CustomClientObject.jar" download="lazy"/>
    <jar href="Charts.jar" download="lazy"/>
    <jar
 href="SpellChecker.jar" download="lazy"/>
    <jar
 href="SpellCheckerDictionary-en.jar" download="lazy"/
   
    ... </jnlp>

How JAR Changes Affect Applets

In previous revisions of BBj, the ThirdParty.jar was a key jar element loaded in the applet HTML file or Java Script. The ThirdParty.jar was deprecated in BBj 8.0 so change the ThirdParty.jar element to list BBjUtil.jar instead.

Note: In order to minimize the initial impact of this change, the ThirdParty.jar is a copy of BBjUtil.jar to allow most applets to continue to work with no change. However, note the change since the ThirdParty.jar will not exist in future revisions of BBj.

The BBj code generation jar, asm-all-3.1.jar, is a required element in BBj 9.0. The BBjBootstrap.jar plays a significant role in BBj 10.0 and isa mandatory element in applet HTMLl or Java script files.

Note: Applet html or .js files can list the BBjIndex.jar as an element to load classes from such unlisted jars as those mentioned above, including the BBjBootstrap.jar and asm-all-3.1.jar. However, these two conditions must be met:

1. The applet file must contain a BBjThinClient.jar element and a BBjUtil.jar element.

2. Both the server and client systems must have JDK (Java Development Kit) installed.

Here is a sample Java script with BBjIndex.jar:

string = '';

string += '<object classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93" codebase="http://java.sun.com/update/1.6.0/jinstall-6-windows-i586.cab#Version=1,4,0,mn" height="800" width="800">\n';

string += '    \n';

string += '    <param name="type" value="application/x-java-applet;version=1.6+">\n';

string += '    <param name="scriptable" value="false">\n';

string += '    <param name="CODE" value="com.basis.bbj.client.bbjapplet.BBjApplet">\n';

string += '    <param name="cache_archive" value="../../lib/BBjThinClient.jar,../../lib/BBjUtil.jar, ../../lib/BBjBootstrap.jar,../../lib/BBjIndex.jar">\n';

string += '    <param name="cache_option" value="Plugin">\n';

string += '<param name="cache_version" value="1.0.0.0,1.0.0.0,1.0.0.0,1.0.0.0">\n';

 

How JAR Changes Affect the Installation

The BBj 11.0 installation will check for and remove any pre-existing BBj jars in the bbjhome/lib directory of the target installation directory. It is important to note that BBj 11.0 must be uninstalled prior to installing an older version of BBj (prior to BBj 10.x) in the same directory. Jar and configuration files new to BBj 11.0 will cause unpredictable behavior in older versions of BBj (prior to BBj 10.x).

See Also

For earlier versions of BBj, see

   BBj 7.x Classpath Overview

   BBj 8.x Classpath Overview

   BBj 9.x Classpath Overview

   BBj 10.x Classpath Overview






______________________________________________________________________________________

Copyright BASIS International Ltd. BBj®, Visual PRO/5®, PRO/5®, and BBx® are registered trademarks.