Home

  

Product

  

Buy

  

Support

  

News

  

Press

  

Downloads

  

Contact

  

Company

  

Partners

  

Resources

 
 
 
EVALUATION GUIDE

  INDEX


Overview

Prerequisites

Sample applications

Sample database

System requirements

Limitations

Common issues

  Overview To top of page


 The JCodeBox evaluation provides you with a fully configured J2EE development and runtime environment consisting of:

    • JCodeBox evaluation version
    • JBoss Java application server (for J2EE applications)
    • Apache Tomcat Java servlet container (for Web applications)
    • HSQLDB Java SQL database

This environment allows you to start using JCodeBox immediately without having to download and configure other products. There are some sample applications provided with the evaluation version that demonstrate the power of JCodeBox. An uninstaller is also provided so that once you have completed your evaluation, you can easily remove everything from your system. A full documentation set is also provided including the user manual, tutorials and FAQs.

Details on how to install the JCodeBox evaluation version including the required licence key are sent separately by email to the email address entered on the download evaluation version form.

Please see the product pages for further details on JCodeBox.

  Prerequisites To top of page


  The only prerequisite is that you have a Java 2 SDK (also known as JDK) installed on your system. The version must be 1.3.1 or higher. You can download one from Sun's Java web site.

  Sample applications To top of page


  The sample applications illustrate how easy it is to build J2EE enterprise applications using JCodeBox. Features include:

    • Visually creating business tier components directly from an existing database
    • Automatically creating web tier components (termed viewsets in JCodeBox) to access the business components
    • Applying individual J2EE design patterns to components
    • Applying J2EE design patterns to all of the components in a tier
    • Visual creation of CMP relationships (CMR) and BMP relationships
    • Automatic build, package and deployment of the application. It can then be run directly from your web browser
    • Session beans and Message beans
    • Building custom JSPs and java classes

To open a sample application select File/Open on the JCodeBox menu. Then navigate to the apps/saved subdirectory and select the appropriate .jcb file. To build and deploy the application simply click the create button to bring up the create dialog, select the compile, package and deploy options and then click the OK button.

 Sample database To top of page


  A sample database is provided in the HSQLDB SQL database server. The model is shown below:

 System requirements To top of page

    • As mentioned in the prerequisites section, you need to have already installed a Java 2 SDK version 1.3.1 or higher.
    • The evaluation download is approximately 54MB and requires 90MB of disk space.

    • The commercial downloads of JCodeBox are significantly smaller than this (5MB without JVM and 13MB with JVM) as the additional products are not bundled with the distributions.
    • JCodeBox can run in 128MB of memory but we recommend 512MB
    • We recommend a minimum screen size of 1024 x 768 or higher
    • JCodeBox is a visual application and you will need a pointing device with at least two buttons (i.e. left and right mouse clicks)

 Limitations To top of page


  The evaluation version of JCodeBox has had some of its functionality restricted and some removed. These restrictions include:

    • It has been designed to only work with the database (hsqldb) and application servers (JBoss and Tomcat) supplied
    • Support for other application servers and databases has been removed
    • Support for manual applications (defined in the JCodeBox GUI as opposed to being based on an existing database) has been removed
    • Support for saving new applications has been removed.
    • Support for building and deploying J2EE 1.2 applications is not available. Support for J2EE 1.3 applications in JBoss is available
    • Many of the code templates are not available for editing.

 Common issues To top of page


  Common issues encountered when running the evaluation version of JCodeBox include:

    • When you run the installer (setup.exe) you get an error saying the magic number did not match. Please get another copy of the installer and try again

    • This error can occur if the download of the installer (setup.exe) was incomplete. Try downloading the installer again. When the download is complete, check that the installer is the correct size (approx. 53.8MB)

    • The additional products do not run correctly

    • Start JCodeBox evaluation version. This will result in the additional tools being correctly configured for your environment

    • Unable to compile applications in JCodeBox/additional products not behaving as expected

    • Uninstall then re-install JCodeBox evaluation version. When asked to select a Java Virtual Machine (JVM) make sure to select the java.exe that is in the bin directory of your Java 2 SDK (JDK) i.e. JAVA_HOME\bin\java.exe

    • Getting Initialization failed (javax.management.InstanceAlreadyExistsException) errors in JBoss when deploying an application

    • This occurs when you try and deploy a business component/EJB (as part of an application) but the JNDI name you have given to the component is the same as the JNDI name for another component that has already been deployed. Either change the JNDI name for the component you are trying to deploy or remove the previously deployed component with the same name (you can remove a deployed application by deleting it from the JBoss deploy directory).

Copyright Michael Campbell Associates Ltd. 1999-2003. All Rights Reserved