com.basis.utilities.jarreg.client

Class JarRegistrar

java.lang.Object

JarValidation

com.basis.utilities.jarreg.client.JarRegistrar

public class JarRegistrar
extends JarValidation

Registers jar archives of Java classes so that BBj users can instantiate and use ClientObjects. When BBj creates a ClientObject from a class contained in a jar file, BBj will expect to find the file meta-inf\Basis.key in that jar. If BBj does not find Basis.key in the jar file, it will nag the user with a message indicating that the jar has not been registered. The JarRegistrar class can be used to register a non-registered jar or to re-register an already registered jar. The Basis.key file contains two types of information: the BASIS License version that was current at the time the jar was registered and index values that BBj uses to determine whether the jar has been modified since it was registered. If a registered Jar is modified by adding, removing or modifying any of the files in the jar then the registration will no longer be valid and the Jar should be re-registered.
When BBj creates a ClientObject from a class file found in a registered Jar, it checks the Basis.key information in the Jar and compares the license version of BBjServices with the license version found in the registered Jar. If the major version found in Basis.key is greater than the major license version for BBjServices then the registration is considered to be invalid and the user will receive a nag message. For example, if a jar has been registered for an 8.0 license then that registration will be valid for all future versions of BBj. But if a jar has been registered for a 9.0 license then that jar would be valid for BBjServices running with a 9.0 or later license but would not be valid for a BBjServices running with an 8.0 license.
The JarRegistrar connects to a WebService that is published by BASIS in order to create the Basis.key file. For this reason, JarRegistrar must be able to access the internet in order to register a Jar. The BASIS JarRegistration WebService will place the current license version from Basis in the Basis.key file.

Since:

BBj 8.0

Constructor Summary

Constructors

Constructor and Description
JarRegistrar()

Method Summary

Modifier and Type	Method and Description
static void	main(java.lang.String[] args) Allows commandline invocation of JarRegistrar.
static java.lang.String	registerJar(java.lang.String p_sourceJarName, java.lang.String p_destinationJarName) Creates a new Jar file with the name outputJarName that contains the same manifest and the same set of files as are found in inputJarFile but that also contains the file meta-inf\Basis.key.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JarRegistrar

public JarRegistrar()

Method Detail

registerJar

public static java.lang.String registerJar(java.lang.String p_sourceJarName,
                                           java.lang.String p_destinationJarName)
                                    throws java.lang.reflect.InvocationTargetException,
                                           BBjException

Creates a new Jar file with the name outputJarName that contains the same manifest and the same set of files as are found in inputJarFile but that also contains the file meta-inf\Basis.key. In order to create the output file, the registerJar method must be able to access the internet and connect to the BASIS WebService.

Parameters:

p_sourceJarName - The path to a Jar file which is to be registered. This name should be an absolute path to the Jar since any relative path will be relative to the working directory of the JVM and not relative to the working directory set by CHDIR.

p_destinationJarName - The path to the output file which will be a registered copy of the input Jar. For the same reasons as specified for inputJarName, the user should use an absolute path for outputJarName. Specifying the same path for outputJar as InputJar will result in the following IOException.

Throws:

java.lang.reflect.InvocationTargetException

BBjException

main

public static void main(java.lang.String[] args)
                 throws java.lang.reflect.InvocationTargetException,
                        BBjException

Allows commandline invocation of JarRegistrar. At the commandline, main will accept 2 arguments, which are paths to jar files that this document will refer to as outputJarName and inputJarFile, and are the first and second arguments respectively. main creates a new jar file with the name outputJarName that contains the same manifest and the same set of files as are found in inputJarFile but that also contains the file meta-inf\Basis.key. In order to create the output file, the main method must be able to access the internet and connect to the BASIS WebService.The following jars must be in Java's classpath: BBjBootstrap.jar, BBjUtil.jar, and jwsdp.jar, which are located at <BBj Install Path>/lib.

Throws:

java.lang.reflect.InvocationTargetException

BBjException