org.xbib.standardnumber

Class ISBN

java.lang.Object

org.xbib.standardnumber.StandardNumber

org.xbib.standardnumber.ISBN

All Implemented Interfaces:

java.lang.Cloneable, java.lang.Comparable<ISBN>

public class ISBN
extends StandardNumber
implements java.lang.Cloneable, java.lang.Comparable<ISBN>

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 by Openly Informatics, Inc.

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

Field Summary

Fields inherited from class org.xbib.standardnumber.StandardNumber

type, value

Constructor Summary

Constructors

Constructor and Description
ISBN()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	clone() Returns a clone if the implementation is cloneable.
int	compareTo(ISBN isbn)
ISBN	createChecksum(boolean createWithChecksum) Indicate that a correct check sum should be computed.
ISBN	ean(boolean eanPreferred) Prefer European Article Number (EAN, ISBN-13).
boolean	equals(java.lang.Object object)
java.lang.String	format() Get printable representation of this standard book number.
java.lang.String	getCountryAndPublisherCode() Get country and publisher code.
static StandardNumber	getInstance(java.lang.Package thePackage, java.lang.ClassLoader classLoader, java.lang.String type)
static StandardNumber	getInstance(java.lang.String type)
java.util.Collection<java.lang.String>	getTypedVariants()
int	hashCode()
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.
java.lang.String	normalizedValue() Get the normalized value of this standard book number.
ISBN	reset()
ISBN	verify() Verify the number.

Methods inherited from class org.xbib.standardnumber.StandardNumber

set, type

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ISBN

public ISBN()

Method Detail

createChecksum

public ISBN createChecksum(boolean createWithChecksum)

Description copied from class: StandardNumber

Indicate that a correct check sum should be computed.

Specified by:

createChecksum in class StandardNumber

Parameters:

createWithChecksum - if checksum is included

Returns:

this standard number

compareTo

public int compareTo(ISBN isbn)

Specified by:

compareTo in interface java.lang.Comparable<ISBN>

normalize

public ISBN normalize()

Description copied from class: StandardNumber

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

Specified by:

normalize in class StandardNumber

Returns:

this standard number

isValid

public boolean isValid()

Check for this ISBN number validity.

Specified by:

isValid in class StandardNumber

Returns:

true if valid, false otherwise

verify

public ISBN verify()

Description copied from class: StandardNumber

Verify the number.

Specified by:

verify in class StandardNumber

Returns:

this standard number if verification was successful

normalizedValue

public java.lang.String normalizedValue()

Get the normalized value of this standard book number.

Specified by:

normalizedValue in class StandardNumber

Returns:

the value of this standard book number

format

public java.lang.String format()

Get printable representation of this standard book number.

Specified by:

format in class StandardNumber

Returns:

ISBN-13, with (fixed) check digit

reset

public ISBN reset()

Specified by:

reset in class StandardNumber

getTypedVariants

public java.util.Collection<java.lang.String> getTypedVariants()

Specified by:

getTypedVariants in class StandardNumber

isEAN

public boolean isEAN()

ean

public ISBN ean(boolean eanPreferred)

Prefer European Article Number (EAN, ISBN-13).

Parameters:

eanPreferred - true if EAN should be preferred

Returns:

this ISBN object

getCountryAndPublisherCode

public java.lang.String getCountryAndPublisherCode()

Get country and publisher code.

Returns:

the country/publisher code from ISBN

equals

public boolean equals(java.lang.Object object)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

Returns a clone if the implementation is cloneable.

Returns:

a clone if the implementation is cloneable.

Throws:

java.lang.CloneNotSupportedException - if this is called on an implementation that does not support `Cloneable`

getInstance

public static StandardNumber getInstance(java.lang.String type)
                                  throws NoSuchStandardNumberException

Throws:

NoSuchStandardNumberException

getInstance

public static StandardNumber getInstance(java.lang.Package thePackage,
                                         java.lang.ClassLoader classLoader,
                                         java.lang.String type)
                                  throws NoSuchStandardNumberException

Throws:

NoSuchStandardNumberException