org.xbib.standardnumber

Class ISMN

java.lang.Object

org.xbib.standardnumber.StandardNumber

org.xbib.standardnumber.ISMN

All Implemented Interfaces:

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

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

ISO 10957 International Standard Music Number (ISMN), Z39.50 BIB-1 Use Attribute 1092.

The International Standard Music Number (ISMN) is a thirteen-character alphanumeric identifier for printed music developed by ISO. The original proposal for an ISMN was made by the UK Branch of IAML (International Association of Music Libraries, Archives and Documentation Centres).

The original format comprised four elements: a distinguishing prefix M, a publisher ID, an item ID and a check digit, typically looking like M-2306-7118-7.

From 1 January 2008 the ISMN was defined as a thirteen digit identifier beginning 979-0 where the zero replaced M in the old-style number. The resulting number is identical with its EAN-13 number as encoded in the item’s barcode.

See ISMN Manual 2008

Field Summary

Fields inherited from class org.xbib.standardnumber.StandardNumber

type, value

Constructor Summary

Constructors

Constructor and Description
ISMN()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	clone() Returns a clone if the implementation is cloneable.
int	compareTo(ISMN ismn)
ISMN	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.
ISMN	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.
ISMN	reset()
GTIN	toGTIN()
ISMN	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

ISMN

public ISMN()

Method Detail

compareTo

public int compareTo(ISMN ismn)

Specified by:

compareTo in interface java.lang.Comparable<ISMN>

createChecksum

public ISMN 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 ISMN 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 ISMN 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 ISMN reset()

Specified by:

reset in class StandardNumber

getTypedVariants

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

Specified by:

getTypedVariants in class StandardNumber

toGTIN

public GTIN toGTIN()
            throws NoSuchStandardNumberException,
                   java.lang.NumberFormatException

Throws:

NoSuchStandardNumberException

java.lang.NumberFormatException

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