ISSN (standardnumber 1.0.0 API)

java.lang.Object
- org.xbib.standardnumber.StandardNumberSpi
- - org.xbib.standardnumber.StandardNumber
  - - org.xbib.standardnumber.ISSN

All Implemented Interfaces:

java.lang.Cloneable, java.lang.Comparable<ISSN>
```
class ISSN
extends StandardNumber
implements java.lang.Cloneable, java.lang.Comparable<ISSN>
```
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 "All about ISSN":

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.

Field Summary

Fields
Modifier and Type Field and Description

private boolean createWithChecksum

private java.lang.String formatted

private static java.util.regex.Pattern PATTERN
- Fields inherited from class org.xbib.standardnumber.StandardNumber
  type, value

Fields
Modifier and Type	Field and Description
`private boolean`	`createWithChecksum`
`private java.lang.String`	`formatted`
`private static java.util.regex.Pattern`	`PATTERN`

Constructor Summary

Constructors
Modifier Constructor and Description

protected ISSN()

Constructors
Modifier	Constructor and Description
`protected`	`ISSN()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private boolean`	`check()`
`java.lang.Object`	`clone()` Returns a clone if the implementation is cloneable.
`int`	`compareTo(ISSN issn)`
`ISSN`	`createChecksum(boolean createWithChecksum)` Indicate that a correct check sum should be computed.
`private java.lang.String`	`dehyphenate(java.lang.String isbn)`
`boolean`	`equals(java.lang.Object object)`
`java.lang.String`	`format()` Format this number.
`java.util.Collection<java.lang.String>`	`getTypedVariants()`
`int`	`hashCode()`
`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.
`java.lang.String`	`normalizedValue()` Returns the value representation of the standard number.
`ISSN`	`reset()`
`GTIN`	`toGTIN()`
`GTIN`	`toGTIN(java.lang.String additionalCode)`
`ISSN`	`verify()` Verify the number.

Methods inherited from class org.xbib.standardnumber.StandardNumber
set, type

Methods inherited from class org.xbib.standardnumber.StandardNumberSpi
getInstance, getInstance

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - PATTERN
```
private static final java.util.regex.Pattern PATTERN
```
  - formatted
```
private java.lang.String formatted
```
  - createWithChecksum
```
private boolean createWithChecksum
```
- Constructor Detail
  - ISSN
```
protected ISSN()
```
- Method Detail
  - compareTo
```
public int compareTo(ISSN issn)
```
    Specified by:
    
    compareTo in interface java.lang.Comparable<ISSN>
  - createChecksum
```
public ISSN 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 ISSN 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 ISSN 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()
```
    Returns the value representation of the standard number.
    
    Specified by:
    
    normalizedValue in class StandardNumber
    
    Returns:
    
    value
  - format
```
public java.lang.String format()
```
    Format this number.
    
    Specified by:
    
    format in class StandardNumber
    
    Returns:
    
    the formatted number
  - reset
```
public ISSN 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 java.lang.NumberFormatException,
                   NoSuchStandardNumberException
```
    Throws:
    
    java.lang.NumberFormatException
    
    NoSuchStandardNumberException
  - toGTIN
```
public GTIN toGTIN(java.lang.String additionalCode)
            throws java.lang.NumberFormatException,
                   NoSuchStandardNumberException
```
    Throws:
    
    java.lang.NumberFormatException
    
    NoSuchStandardNumberException
  - check
```
private boolean check()
```
  - dehyphenate
```
private java.lang.String dehyphenate(java.lang.String 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
```
    Description copied from class: StandardNumberSpi
    
    Returns a clone if the implementation is cloneable.
    
    Overrides:
    
    clone in class StandardNumberSpi
    
    Returns:
    
    a clone if the implementation is cloneable.
    
    Throws:
    
    java.lang.CloneNotSupportedException - if this is called on an implementation that does not support Cloneable

Class ISSN

Field Summary

Fields inherited from class org.xbib.standardnumber.StandardNumber

Constructor Summary

Method Summary

Methods inherited from class org.xbib.standardnumber.StandardNumber

Methods inherited from class org.xbib.standardnumber.StandardNumberSpi

Methods inherited from class java.lang.Object

Field Detail

PATTERN

formatted

createWithChecksum

Constructor Detail

ISSN

Method Detail

compareTo

createChecksum

normalize

isValid

verify

normalizedValue

format

reset

getTypedVariants

toGTIN

toGTIN

check

dehyphenate

equals

hashCode

clone