Barcode | Barcode Reader | Purchase | Services | Company


BarcodeLib.com Home > Products > Barcode for Java > Barcode Planet

PLANET Barcode for Java, J2EE, JasperReports

This Symbology is also known as USPS PLANET Barcode, USPS Confirm Service Barcode

Quick Navigate

Barcode Introduction
Encoding Data Scope
How to Generate Barcode Image in Standalone Applications?
How to Generate Barcode Image in Web Applications?
How to Generate Barcode Image in JasperReports?
How to Save Barcode Image?
Barcode Property Settings

For trial version only, we will randomly print message BarcodeLib.com or Trial on the generated barcode image.

1. Barcode Introduction

USPS Confirm service allows mailers to uniquely identify and track mail by placing an additional barcode, known as a PLANET Code, on the front of letter and flat mailpieces. The PLANET Code is a 12 -or 14- digit barcode - a ?wo-state?barcode similar in structure to the POSTNET Code address barcode used by mail processing equipment to sort the mail.

PLANET Codes consist of a series of tall and short bars. PLANET Code digit Symbology is the inverse of POSTNET Code digit Symbology; each POSTNET Code digit uses a combination of two tall and three short bars; each PLANET Code digit uses three tall and two short bars. PLANET Codes must begin and end with one long "framing bar".

All PLANET Codes include a check-sum digit or correction character. This digit must always be the single-digit number (i.e., 0?) which, when added to the sum of the other digits in the barcode, results in a whole number that is a multiple of 10.

Depending on the type of Confirm mail, mailers must choose the appropriate PLANET Code format:

Destination Confirm to track outgoing mailings. PLANET Codes can be used to identify mail sent to customers
Origin Confirm to track incoming mail. PLANET Codes can be used to identify reply mail that customers send back

Destination Confirm PLANET Code Format

The Destination Confirm PLANET Code consists of the following elements:

Service Type ID: The first 2 digits represent the service (i.e., Destination Confirm) and the class/shape of the mail. Destination Confirm Service Type IDs are listed below
Subscriber ID: The next 5 digits identify the subscriber (assigned by the Postal Service)
Mailing ID: The next 4 or 6 digits are available to the mailer to use for their own identification purposes (e.g., mailings, clients, etc.)
Check-Sum Digit: The 12th or 14th digit is a check-sum digit that helps the Postal Service to detect errors

Mailers should use the PLANET Code in combination with the delivery point POSTNET Code to identify mailpieces uniquely.

Service Type IDs for Destination Confirm service:

40 - First-Class Mail letters
41 - First-Class Mail flats
42 - Standard Mail letters
43 - Standard Mail flats
44 - Periodicals letters
45 - Periodicals flats
46 - First-Class Mail cards
47 - Standard Mail cards
22 - Residual Mail items

Origin Confirm PLANET Code Format

The Origin Confirm PLANET Code consists of the following elements:

Service Type ID: The first 2 digits represent the service (i.e., Origin Confirm) and the class/shape of the mail. Origin Confirm Service Type IDs are listed below
Customer ID: The next 9 or 11 digits are available to the subscriber to help identify the customer (i.e., mailer of reply mailpiece) or the reply mailpiece itself
Check-Sum Digit: The 12th or 14th digit is a check-sum digit that helps the Postal Service to detect errors

For Origin Confirm service, the Postal Service identifies the Confirm subscriber by the POSTNET Code preprinted on the reply mailpiece.

Service Type IDs for Origin Confirm service:

50 - Courtesy reply letters
51 - Courtesy reply flats
52 - Business reply letters
53 - Business reply flats
54 - Business reply cards
56 - QBRM letters
57 - QBRM cards
58 - Courtesy reply cards
21 - Miscellaneous items

2. Encoding Data Scope

Planet Barcode for Java supports.

0, 1, 2, 3, 4, 5, 6, 7, 8, 9

3. How to Generate Barcode Image in Standalone Applications?

The following code illustrates how to create a barcode in a Java class

1            Barcode barcode = new Barcode(); 
2            barcode.setData("123456789"); 
3            barcode.setType(Barcode.CODE39); 
4            barcode.createBarcodeImage("c:/code39.gif");

Create a Barcode object (line 1)
set Barcode object properties (line 2 - 3)
save into gif file (line 4)

4. How to Generate Barcode Image in Web Applications?

There are two ways to create barcode images in your Java web applications.

This is the simplest way to stream barcode image using our provided barcode servlet classes.

And it will not save barcode images in your server side.
- Under demo package, copy barcode folder to your java servlet container like tomcat.
- To test your installation, goto http://YourDomain:Port/barcode/barcode?Data=123456789&Type=CODE39
- To create barcode image in your JSP page, you can pass the url to IMG tag src value. For example, <img src="http://YourDomain:Port/barcode/barcode?Data=123456789&Type=CODE39" />

The second method is similar with the way to generate barcode in Java applications.

Create a barcode image in server side

1            Barcode barcode = new Barcode(); 
2            barcode.setData("123456789"); 
3            barcode.setType(Barcode.CODE39); 
4            barcode.createBarcodeImage("C:/Tools/Tomcat 5.5/webapps/YourWebApp/bimages/code39.gif");

In your JSP page, you can using IMG tag to display generated image, like <img src="http://YourDomain:Port/YourWebApp/bimages/code39.gif" />

5. How to Generate Barcode Image in JasperReports?

The following jasper xml content illustrates how to insert a barcode into JasperReports

<import value="com.barcodelib.barcode.BarcodeFactory"/>

Import class BarcodeFactory to report.

<image scaleImage="Clip" hAlign="Center"> 
    <reportElement x="50" y="110" width="515" height="120"/> 
    <graphicElement/> 
    <imageExpression class="net.sf.jasperreports.engine.JRRenderable">
     <![CDATA[new com.barcodelib.barcode.BarcodeJasperRenderer(BarcodeFactory.createLinear(13, "0470821632"))]]></imageExpression> 
</image>

Please go to class BarcodeFactory in Java doc for all methods to create linear barcode.

Developers also can extend BarcodeFactory class to meet their own requirements. Complete BarcodeFactory.java Source Code

6. How to Save Barcode Image?

Just call Barcode object method createBarcodeImage, e.g. barcode.createBarcodeImage("c:/code39.gif");

7. Barcode Property Settings

Category	Attribute/Method	Servlet Attribute	Default Value	Description
Basic Settings
	type	Type	CODE128 (22)	View all supported barcode types and values. Use the number value for the java bean class and the number or text value for the servlet. For example, the servlet query url should include: Type=CODE128 or Type=22
	data	Data	""	This is the barcode text to be encoded. The type is String. EAN 8: User should only provide 7 digits, and DO NOT include last digit checksum character. EAN 13: User should only provide 12 digits, and DO NOT include last digit checksum character. UPCA: User should only provide 11 digits, and DO NOT include last digit checksum character. UPCE: User should only provide 6 digits, and DO NOT include last digit checksum character.
	sData	SData	""	Supplement data for ISBN, ISSN, EAN 8, EAN 13, UPCA, UPCE only. The type is String.
	addCheckSum	AddCheckSum	true	Valid values are true and false. If barcode type check sum is compulsory or not applied, addCheckSum will not work. Please check each barcode symbologies to get more details.
	processTilde	ProcessTilde	true	For barcode Code 128 only. Set the ProcessTilde property to true, if you want use the tilde character "~" to specify special characters in the input data. Default is true. ~NNN: is used to represent the ASCII character with the value of NNN.
Codabar
	codabarStartChar	CodabarStartChar	A	One of four possible start characters (A, B, C, or D).
	codabarStopChar	CodabarStopChar	A	One of four possible stop characters (A, B, C, or D).
UPC-E
	UPCENumberSystem	UPCENumberSystem	0	Valid values are 0 and 1. The default is 0. UPC-E may only be used if the number system is 0 or 1. The characters encoded are encoded with odd and even parity from the left-hand columns of the EAN-13 character formats in the table previously provided. The parity used for each character depends on the number system (0 or 1) and the check digit from the original UPC-A barcode.
Barcode Image Style
	uom	UOM	0 (pixel)	Unit of measure for barcode size settings, type is float, default is 0 (pixel). Valid values are 0 (pixel), 1 (CM), 2 (Inch)
	resolution	Resolution	96	Image resolution. Default is 96 DPI.
	barWidth	BarWidth	0	Bar cell width, type is float. Its unit of measure is decided by uom.
	leftMargin	LeftMargin	0	The left margin. Its unit of measure is decided by uom.
	rightMargin	RightMargin	0	The right margin. Its unit of measure is decided by uom.
	topMargin	TopMargin	0	The top margin. Its unit of measure is decided by uom.
	bottomMargin	BottomMargin	0	The bottom margin. Its unit of measure is decided by uom.
	showText	ShowText	true	If this value is true (T in servlet), barcode data will be displayed with the barcode. The servlet convert "T" to true and "F" to false.
	textFont	TextFont	Arial	The font used to display text in barcode image. To change the font, use the following format: Font font = new Font("Arial", Font.BOLD, 13); barcode.setTextFont(font); and to change the font in the servlet, use this format: &TextFont=Arial\|Bold\|13
	imageFormat	ImageFormat	gif	Valid values are "gif" and "jpeg". This setting is only valid in Servlet not in bean class.
	rotate	Rotate	0	If you want to rotate barcode image. Value can be 0 (Image Bottom Facing Down), 1 (Image Bottom Facing Left), 2 (Image Bottom Facing Up), 3 (Image Bottom Facing Right)