Installation and System Requirements

The only requirement is that you run Java v1.2 or higher.

Runtime Files

The only file is easybar.jar. You'll also need BarcodeServlet.class if you use Barcode/Java on web servers.

There's no special requirement for using the files. Below are instructions for those who are relatively new to Java or to Java servlet environments.

Standalone Applications

When using Barcode/Java in standalone applications, you only need the easybar.jar file, which must be in the Java CLASSPATH. You add it there by doing the following prior to running the application.

On Windows,

    set CLASSPATH=%CLASSPATH%;...\easybar.jar

On Unix (Bourne Shell),

    CLASSPATH=$CLASSPATH:.../easybar.jar; export CLASSPATH

(Replace ... by the actual path of the file.)

Web Servers

If you use the servlet file (BarcodeServlet.class) that we provide, it assumes that your web server supports Java servlets (for example Apache Tomcat). You'll also need the easybar.jar file. In general, you need to refer to your web server or application server's documentation for how to add a servlet and a jar file.

As a general rule, the jar file should go into the jar directory of the server, and the servlet file a specific application directory; you may need to map the servlet path such that it is accessible. The below instructions apply to Apache Tomcat.

You need a web application directory (typically WEB-INF); or, you can use the root application directory.
Copy the easybar.jar file to the lib sub-directory.
Copy BarcodeServlet.class to the classes sub-directory.

Edit the application configuration file web.xml by adding the lines,

    <servlet>
        <servlet-name>BarcodeServlet</servlet-name>
        <servlet-class>BarcodeServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>BarcodeServlet</servlet-name>
        <url-pattern>/BarcodeServlet</url-pattern>
    </servlet-mapping>

Troubleshooting

To troubleshoot your web setup, just type the BarcodeServlet URL directly in your browser address field and any error will be reported back in the browser main page. Do not use an HTML file with <img>, as you would only see an image box with an X in it.