Barcode

Since Camel 2.14

The Barcode data format is based on the zxing library. The goal of this component is to create a barcode image from a String (marshal) and a String from a barcode image (unmarshal). You’re free to use all features that zxing offers.

Dependencies

To use the barcode data format in your camel routes, you need to add a dependency on camel-barcode which implements this data format.

If you use maven, you could just add the following to your pom.xml, substituting the version number for the latest & greatest release (see the download page for the latest versions).

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-barcode</artifactId>
  <version>x.x.x</version>
</dependency>

Barcode Options

The Barcode dataformat supports 4 options, which are listed below.

Name Default Java Type Description

barcodeFormat

String

Barcode format such as QR-Code.

imageType

String

Image type of the barcode such as png.

width

Integer

Width of the barcode.

height

Integer

Height of the barcode.

Using the Java DSL

First, you have to initialize the barcode data format class. You can use the default constructor, or one of parameterized (see JavaDoc). The default values are:

Parameter Default Value

image type (BarcodeImageType)

PNG

width

100 px

height

100 px

encoding

UTF-8

barcode format (BarcodeFormat)

QR-Code

// QR-Code default
DataFormat code = new BarcodeDataFormat();

If you want to use zxing hints, you can use the 'addToHintMap' method of your BarcodeDataFormat instance:

code.addToHintMap(DecodeHintType.TRY_HARDER, Boolean.true);

For possible hints, please consult the xzing documentation.

Marshalling

from("direct://code")
  .marshal(code)
  .to("file://barcode_out");

You can call the route from a test class with:

template.sendBody("direct://code", "This is a testmessage!");

You should find inside the 'barcode_out' folder this image:

image

Unmarshalling

The unmarshaller is generic. For unmarshalling, you can use any BarcodeDataFormat instance. If you’ve two instances, one for (generating) QR-Code and one for PDF417, it doesn’t matter which one will be used.

from("file://barcode_in?noop=true")
  .unmarshal(code) // for unmarshalling, the instance doesn't matter
  .to("mock:out");

If you’ll paste the QR-Code image above into the 'barcode_in' folder, you should find `This is a testmessage!` inside the mock. You can find the barcode data format as header variable:

Name Type Description

BarcodeFormat

String

Value of com.google.zxing.BarcodeFormat.

If you’ll paste the code 39 barcode that is rotated some degrees into the 'barcode_in' folder, You can find the ORIENTATION as header variable:

Name Type Description

ORIENTATION

Integer

rotate value in degrees .

Spring Boot Auto-Configuration

When using barcode with Spring Boot make sure to use the following Maven dependency to have support for auto configuration:

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-barcode-starter</artifactId>
  <version>x.x.x</version>
  <!-- use the same version as your Camel core version -->
</dependency>

The component supports 5 options, which are listed below.

Name Description Default Type

camel.dataformat.barcode.barcode-format

Barcode format such as QR-Code.

String

camel.dataformat.barcode.enabled

Whether to enable auto configuration of the barcode data format. This is enabled by default.

Boolean

camel.dataformat.barcode.height

Height of the barcode.

Integer

camel.dataformat.barcode.image-type

Image type of the barcode such as png.

String

camel.dataformat.barcode.width

Width of the barcode.

Integer