JasperReports Code 39 Generator Library

How to Generate Code 39 Barcode in JasperReport?

Top

1. Create a new report, and add barcode.jar to report classpath from the downloaded trial package
2. Drag an image item in Palette to report
3. Click "Cancel" button, in "Select an image file" window
4. Right click on the image and edit its "Properties", and set property "Expression Class" to "net.sf.jasperreports.engine.JRRenderable";
5. To input Code 39 barcode data manually, set property "Image Expression" to "new com.onbarcode.barcode.jasper.JasperRenderer(
   com.onbarcode.barcode.jasper.BarcodeGenerator.draw(2, "12345", "", "X=2&Y=60"))"
6. To print Code 39 with data from database, please set property "Image Expression" to "new com.onbarcode.barcode.jasper.JasperRenderer(
   com.onbarcode.barcode.jasper.BarcodeGenerator.draw(2, $F{data field} + "", "", "X=2&Y=60"))";
   
   BarcodeGenerator.draw method accepts 4 parameters:
   the second is the barcode data to encode, in String,
   the last is the barcode settings String. More details about barcode settings string, please check the Code 39 property table below

Code 39 Standard Mode

Code 39 Standard Mode supports 43 characters, making it ideal for basic alphanumeric encoding. Here's how to configure it in your JasperReport report:

Supported characters in Standard Mode:

• Numeric digits: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
• Uppercase letters (A - Z)
• Special characters: - (Dash), $ (Dollar), % (Percentage), (Space), . (Point), / (Slash), + (Plus)
• Start/Stop character (asterisk *—automatically added by the JasperReports Library)

Configuration steps:

• Select the Code 39 Barcode Component in your JRXML template.
• Open the Report Item Property panel and set the "Barcode Type" to "CODE39" (this enables Standard Mode).
• Enter the data to encode in the "Data" field (static text or dynamic Expression referencing a Field/Parameter).
• Save the JRXML template to apply the settings.

Example configuration:

• Barcode Type: CODE39
• Data: "ABC-12345" (static) or $F{StandardCode39Data} (dynamic)

Note: Do not include the start/stop character (*) in the "Data" field. The JasperReports Barcode Library automatically adds it to ensure scannability.

Code 39 Full ASCII Mode

Code 39 Full ASCII Mode supports the full 128-character ASCII set (per ISO 646 IRV), including lowercase letters, additional special characters, and control characters. This mode is ideal for advanced encoding needs. Here's how to configure it:

Configuration steps:

• Select the Code 39 Barcode Component in your JRXML template.
• Open the Report Item Property panel and set the "Barcode Type" to "CODE39EX" (this enables Full ASCII Mode).
• Enter the data to encode in the "Data" field—this can include lowercase letters (e.g., "abc-12345") and other ASCII characters.
• Save the JRXML template to apply the settings.

Example configuration:

• Barcode Type: CODE39EX
• Data: "abc-12345" (static) or $F{FullAsciiCode39Data} (dynamic)

Note: Ensure your barcode scanner supports Full ASCII Mode to correctly decode the data. Some older scanners may only support Standard Mode.

Code 39 Barcode Check Digit

Code 39 does not include a check digit by default. However, for enhanced data security, you can enable a modulo 43 (MOD43) check digit. This setting is configured in the Report Item Property panel:

To enable the check digit:

• Select the Code 39 Barcode Component and open the Report Item Property panel.
• Locate the "AddCheckSum" property and set it to "true".
• Save the JRXML template. The JasperReport Barcode Library will automatically calculate and append the MOD43 check digit.

Example configuration:

• Barcode Type: CODE39
• Data: "ABC-123"
• AddCheckSum: true

Note: The check digit is calculated based on the input data and is not part of the original "Data" field. It is added automatically by the JasperReport Barcode Library.

Hide Code 39 Check Digit in HRI

You can enable the check digit while hiding it from the Human Readable Interpretation (HRI). The text displayed below/above the barcode. This is configured in the Report Item Property panel:

Steps to hide the check digit in HRI:

• Ensure "AddCheckSum" is set to "true" (as shown in Section 2.3).
• Locate the "ShowCheckSumChar" property in the Report Item Property panel and set it to "false".
• Save the JRXML template. The check digit will be encoded in the barcode but not displayed in the HRI text.

Note: Hiding the check digit in HRI is useful for maintaining a clean report design while still ensuring data integrity via the check digit.

Code 39 Barcode Start/Stop Characters

Code 39 uses the asterisk (*) as its start and stop characters. These characters are required for scanning but should not be included in the "Data" field. You can control their visibility in the HRI text via the Report Item Property panel:

• The start/stop characters (*) are automatically added by the JasperReport Barcode Library. Do not include them in the "Data" field.
• To show or hide the start/stop characters in the HRI text, use the "ShowStartStopInText" property.

Note: Hiding the start/stop characters in HRI is recommended for most report designs, as the asterisks are not part of the actual data and can clutter the layout.

You can fully customize the dimension size of Code 39 barcodes in JasperReport reports, including unit of measure, bar width, height, wide/narrow ratio, intercharacter gap, and margins.

The following settings are available in the Report Item Property panel to customize Code 39 dimensions.

• UOM (Unit of Measure): Select the unit for dimension settings: PIXEL, CM, or INCH. Default is PIXEL.
• X: Width of the narrow bar module (the smallest unit of the barcode). The minimum width is defined by your application’s specifications.
• Y: Height of the barcode module (the vertical length of the bars).
• N: Wide/narrow bar ratio. Valid values range from 2.0 to 3.0 (inclusive). Default is 2.0.
• I: Width of the intercharacter gap (space between two barcode characters).
  
  Minimum gap is equal to X (narrow bar width).
  
  Maximum gap: For X < 0.287mm, it is 5.3X; for X ≥ 0.287mm, it is 1.52mm or 3X (whichever is greater).
• LeftMargin, RightMargin: Quiet zone (empty space) around the Code 39. The minimum width of each margin is 10X (10 times the narrow bar width X).
• TopMargin, BottomMargin: Vertical spacing around the barcode (optional, but recommended to avoid overlapping with other report elements).

Code 39 Wide Bar vs Narrow Bar Ratio (N)

The ratio (N) defines the relationship between the width of wide bars and narrow bars. This setting directly impacts barcode scannability and appearance:

• Valid values: 2.0 to 3.0 (inclusive). Default is 2.0.
• A ratio of 2.0 means wide bars are twice as wide as narrow bars.
• A ratio of 3.0 means wide bars are three times as wide as narrow bars.

Note: Choose a ratio based on your scanning environment. A higher ratio (e.g., 3.0) is more readable for low-resolution printers or scanners.

Code 39 Intercharacter Space (I)

The intercharacter space (I) is the gap between two consecutive barcode characters. It is a multiple of the narrow bar width (X) and impacts barcode readability:

• Default value: 1.0f (gap equals the narrow bar width X).
• The gap must be at least X (minimum) and follow the maximum gap rules outlined in Section 3.1.

Note: Increasing the intercharacter gap (I) can improve readability but will increase the overall width of the barcode. Ensure the barcode fits within your report's layout.

JasperReport Barcode Code39 Generator - Property Settings

Top