org.xbib.standardnumber

Class ISSN

java.lang.Object

org.xbib.standardnumber.AbstractStandardNumber

org.xbib.standardnumber.ISSN

All Implemented Interfaces:

Comparable<ISSN>, StandardNumber

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

ISO 3297 International Standard Serial Number (ISSN) Z39.50 BIB-1 Use Attribute 8 The International Standard Serial Number (ISSN) is a unique eight-digit number used to identify a print or electronic periodical publication. The ISSN system was adopted as international standard ISO 3297 in 1975. The ISO subcommittee TC 46/SC 9 is responsible for the standard. Quoted from http://www.issn.org/2-22636-All-about-ISSN.php The ISSN (International Standard Serial Number) is an eight-digit number which identifies periodical publications as such, including electronic serials. The ISSN is a numeric code which is used as an identifier: it has no signification in itself and does not contain in itself any information referring to the origin or contents of the publication. The ISSN takes the form of the acronym ISSN followed by two groups of four digits, separated by a hyphen. The eighth character is a control digit calculated according to a modulo 11 algorithm on the basis of the 7 preceding digits; this eighth control character may be an "X" if the result of the computing is equal to "10", in order to avoid any ambiguity. The ISSN is linked to a standardized form of the title of the identified serial, known as the "key title", which repeats the title of the publication, qualifying it with additional elements in order to distinguish it from other publications having identical titles. If the title of the publication changes in any significant way, a new ISSN must be assigned in order to correspond to this new form of title and avoid any confusion. A serial publication whose title is modified several times in the course of its existence will be assigned each time a new ISSN, thus allowing precise identification of each form of the title : in fact it is then considered that they are different publications even if there is a logical link between them. Contrary to other types of publications, the world of serial publications is particularly changeable and complex : the lifetime of a title may be extremely short; many publications may be part of a complex set of relationships, etc. These particularities themselves necessitated the introduction of the ISSN.

Constructor Summary

Constructors

Constructor and Description
ISSN()

Method Summary

Methods

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

ISSN

public ISSN()

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(ISSN issn)

Specified by:

compareTo in interface Comparable<ISSN>

set

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

Returns the value representation of the standard number

Specified by:

normalizedValue in interface StandardNumber

Returns:

value

format

public String format()

Format this number

Specified by:

format in interface StandardNumber

Returns:

the formatted number

reset

public ISSN reset()

Specified by:

reset in interface StandardNumber

toGTIN

public GTIN toGTIN()
            throws NumberFormatException

Throws:

NumberFormatException

toGTIN

public GTIN toGTIN(String additionalCode)
            throws NumberFormatException

Throws:

NumberFormatException