org.xbib.standardnumber

Class ISBN

java.lang.Object

org.xbib.standardnumber.AbstractStandardNumber

org.xbib.standardnumber.ISBN

All Implemented Interfaces:

Comparable<ISBN>, StandardNumber

public class ISBN
extends AbstractStandardNumber
implements Comparable<ISBN>, StandardNumber

ISO 2108 International Standard Book Number (ISBN) Z39.50 BIB-1 Use Attribute 7 The International Standard Book Number is a 13-digit number that uniquely identifies books and book-like products published internationally. The purpose of the ISBN is to establish and identify one title or edition of a title from one specific publisher and is unique to that edition, allowing for more efficient marketing of products by booksellers, libraries, universities, wholesalers and distributors. Every ISBN consists of thirteen digits and whenever it is printed it is preceded by the letters ISBN. The thirteen-digit number is divided into four parts of variable length, each part separated by a hyphen. This class is based upon the ISBN converter and formatter class Copyright 2000-2005 by Openly Informatics, Inc. http://www.openly.com/

See Also:

The ISBN Users' Manual, The IETF URN Charter, The IANA URN assignments, ISBN prefix list

Constructor Summary

Constructors

Constructor and Description
ISBN()

Method Summary

Methods

Modifier and Type	Method and Description
int	compareTo(ISBN isbn)
ISBN	createChecksum(boolean createWithChecksum) Indicate that a correct check sum should be computed.
ISBN	ean(boolean preferEAN) Prefer European Article Number (EAN, ISBN-13)
String	format() Get printable representation of this standard book number
String	getCountryAndPublisherCode() Get country and publisher code
boolean	isEAN()
boolean	isValid() Check for this ISBN number validity
ISBN	normalize() Normalize the value by removing all unwanted characters or replacing characters with the ones required for verification.
String	normalizedValue() Get the normalized value of this standard book number
ISBN	reset()
ISBN	set(CharSequence value) Set ISBN value
String	type() Return the type of this standard number
ISBN	verify() Verify the number.

Methods inherited from class org.xbib.standardnumber.AbstractStandardNumber

getTypedVariants

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.xbib.standardnumber.StandardNumber

getTypedVariants

Constructor Detail

ISBN

public ISBN()

Method Detail

type

public String type()

Description copied from interface: StandardNumber

Return the type of this standard number

Specified by:

type in interface StandardNumber

Returns:

the type

set

public ISBN set(CharSequence value)

Set ISBN value

Specified by:

set in interface StandardNumber

Parameters:

value - the ISBN candidate string

Returns:

this standard number

createChecksum

public ISBN createChecksum(boolean createWithChecksum)

Description copied from interface: StandardNumber

Indicate that a correct check sum should be computed.

Specified by:

createChecksum in interface StandardNumber

Returns:

this standard number

compareTo

public int compareTo(ISBN isbn)

Specified by:

compareTo in interface Comparable<ISBN>

normalize

public ISBN normalize()

Description copied from interface: StandardNumber

Normalize the value by removing all unwanted characters or replacing characters with the ones required for verification.

Specified by:

normalize in interface StandardNumber

Returns:

this standard number

isValid

public boolean isValid()
                throws NumberFormatException

Check for this ISBN number validity

Specified by:

isValid in interface StandardNumber

Returns:

true if valid, false otherwise

Throws:

NumberFormatException

verify

public ISBN verify()
            throws NumberFormatException

Description copied from interface: StandardNumber

Verify the number.

Specified by:

verify in interface StandardNumber

Returns:

this standard number if verification was successful

Throws:

NumberFormatException - if verification failed

normalizedValue

public String normalizedValue()

Get the normalized value of this standard book number

Specified by:

normalizedValue in interface StandardNumber

Returns:

the value of this standard book number

format

public String format()

Get printable representation of this standard book number

Specified by:

format in interface StandardNumber

Returns:

ISBN-13, with (fixed) check digit

reset

public ISBN reset()

Specified by:

reset in interface StandardNumber

isEAN

public boolean isEAN()

ean

public ISBN ean(boolean preferEAN)

Prefer European Article Number (EAN, ISBN-13)

getCountryAndPublisherCode

public String getCountryAndPublisherCode()

Get country and publisher code

Returns:

the country/publisher code from ISBN