org.xbib.standardnumber

Class ISTC

java.lang.Object

org.xbib.standardnumber.StandardNumber

org.xbib.standardnumber.ISTC

All Implemented Interfaces:

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

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

ISO 21047 International Standard Text Code (ISTC).

The International Standard Text Code (ISTC) is a numbering system for the unique identification of text-based works; the term “work” can refer to any content appearing in conventional printed books, audio-books, static e-books or enhanced digital books, as well as content which might appear in a newspaper or journal.

The ISTC provides sales analysis systems, retail websites, library catalogs and other bibliographic systems with a method of automatically linking together publications of the “same content” and/or “related content”, thus improving discoverability of products and efficiencies.

An ISTC number is the link between a user’s search for a piece of content and the ultimate sale or loan of a publication.

The standard was formally published in March 2009.

Checksum algorithm is ISO 7064 MOD 16/3.

Field Summary

Fields inherited from class org.xbib.standardnumber.StandardNumber

type, value

Constructor Summary

Constructors

Constructor and Description
ISTC()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	clone() Returns a clone if the implementation is cloneable.
int	compareTo(ISTC istc)
ISTC	createChecksum(boolean createWithChecksum) Indicate that a correct check sum should be computed.
boolean	equals(java.lang.Object object)
java.lang.String	format() Return a formatted value of this standard number This is best for human-readable representation, but is not necessarily a format for computation.
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	isValid() Check this number for validity.
ISTC	normalize() Normalize the value by removing all unwanted characters or replacing characters with the ones required for verification.
java.lang.String	normalizedValue() Return normalized value of this standard number.
ISTC	reset()
ISTC	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

ISTC

public ISTC()

Method Detail

compareTo

public int compareTo(ISTC istc)

Specified by:

compareTo in interface java.lang.Comparable<ISTC>

createChecksum

public ISTC 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

normalize

public ISTC 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()

Description copied from class: StandardNumber

Check this number for validity.

Specified by:

isValid in class StandardNumber

Returns:

true if valid, false otherwise

verify

public ISTC 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()

Description copied from class: StandardNumber

Return normalized value of this standard number. In most cases, this is also the canonical form of the standard number. This is a representation without unneccessary characters, useful for computation purposes, like comparing for equivalence.

Specified by:

normalizedValue in class StandardNumber

Returns:

the normalized value

format

public java.lang.String format()

Description copied from class: StandardNumber

Return a formatted value of this standard number This is best for human-readable representation, but is not necessarily a format for computation.

Specified by:

format in class StandardNumber

Returns:

a formatted value

reset

public ISTC reset()

Specified by:

reset in class StandardNumber

getTypedVariants

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

Specified by:

getTypedVariants in class StandardNumber

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