org.xbib.standardnumber

Class ISAN

java.lang.Object

org.xbib.standardnumber.AbstractStandardNumber

org.xbib.standardnumber.ISAN

All Implemented Interfaces:

Comparable<ISAN>, StandardNumber

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

ISO 15706 International Standard Audiovisual Number (ISAN) The International Standard Audiovisual Number (ISAN) is a unique identifier for audiovisual works and related versions, similar to ISBN for books. It was developed within an ISO (International Organisation for Standardisation) TC46/SC9 working group. ISAN is managed and run by ISAN-IA. The ISAN standard (ISO standard 15706:2002 & ISO 15706-2) is recommended or required as the audiovisual identifier of choice for producers, studios, broadcasters, Internet media providers and video games publishers who need to encode, track, and distribute video in a variety of formats. It provides a unique, internationally recognized and permanent reference number for each audiovisual work and related versions registered in the ISAN system. ISAN identifies works throughout their entire life cycle from conception, to production, to distribution and consumption. ISANs can be incorporated in both digital and physical media, such as theatrical release prints, DVDs, publications, advertising, marketing materials and packaging, as well as licensing contracts to uniquely identify works. The ISAN identifier is incorporated in many draft and final standards such as AACS, DCI, MPEG, DVB, and ATSC.

Constructor Summary

Constructors

Constructor and Description
ISAN()

Method Summary

Methods

Modifier and Type	Method and Description
int	compareTo(ISAN isan)
ISAN	createChecksum(boolean createWithChecksum) Indicate that a correct check sum should be computed.
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.
boolean	isValid() Check this number for validity.
ISAN	normalize() Normalize the value by removing all unwanted characters or replacing characters with the ones required for verification.
String	normalizedValue() Return normalized value of this standard number.
ISAN	reset()
ISAN	set(CharSequence value) Set the input value of this standard number.
String	type() Return the type of this standard number
ISAN	verify() Verify the number.
ISAN	versioned()

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

ISAN

public ISAN()

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

compareTo

public int compareTo(ISAN isan)

Specified by:

compareTo in interface Comparable<ISAN>

set

public ISAN set(CharSequence value)

Description copied from interface: StandardNumber

Set the input value of this standard number. The input must be normalized and verified before being accepted as valid.

Specified by:

set in interface StandardNumber

Parameters:

value - the raw input value

Returns:

this standard number

createChecksum

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

normalize

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

Description copied from interface: StandardNumber

Check this number for validity.

Specified by:

isValid in interface StandardNumber

Returns:

true if valid, false otherwise

verify

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

Description copied from interface: 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 interface StandardNumber

Returns:

the normalized value

format

public String format()

Description copied from interface: 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 interface StandardNumber

Returns:

a formatted value

versioned

public ISAN versioned()

reset

public ISAN reset()

Specified by:

reset in interface StandardNumber