Security Identifier

Domain model and utility methods for representation of securities identification on exchange

License	The MIT License (MIT)
Categories	IDE Development Tools Security
GroupId	com.github.kelebra
ArtifactId	security-identifier
Last Version	0.2
Release Date	May 16, 2016
Type	jar
Description	Security Identifier Domain model and utility methods for representation of securities identification on exchange
Project URL	https://github.com/kelebra/security-identifier
Source Code Management	https://github.com/kelebra/security-identifier.git

Download security-identifier

Filename	Size
security-identifier-0.2.pom
security-identifier-0.2.jar	21 KB
security-identifier-0.2-sources.jar	11 KB
security-identifier-0.2-javadoc.jar	85 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.kelebra/security-identifier/ -->
<dependency>
    <groupId>com.github.kelebra</groupId>
    <artifactId>security-identifier</artifactId>
    <version>0.2</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.kelebra/security-identifier/
implementation 'com.github.kelebra:security-identifier:0.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.kelebra/security-identifier/
implementation ("com.github.kelebra:security-identifier:0.2")

Apache Buildr

'com.github.kelebra:security-identifier:jar:0.2'

Apache Ivy

<dependency org="com.github.kelebra" name="security-identifier" rev="0.2">
  <artifact name="security-identifier" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.kelebra', module='security-identifier', version='0.2')
)

Scala SBT

libraryDependencies += "com.github.kelebra" % "security-identifier" % "0.2"

Leiningen

[com.github.kelebra/security-identifier "0.2"]

Dependencies

test (3)

Group / Artifact	Type	Version
junit : junit	jar	4.11
org.assertj : assertj-core	jar	2.3.0
org.apache.pdfbox : pdfbox	jar	2.0.0

Project Modules

There are no modules declared in this project.

security-identifier

The main intention for creation of this library is to have standart domain model across financial institutions for representing security identifiers and their validations.

Currently supported security identifiers:

• ISIN
• CUSIP
• SEDOL

Quick start

<dependency>
  <groupId>com.github.kelebra</groupId>
  <artifactId>security-identifier</artifactId>
  <version>0.2</version>
</dependency>

Classes representing security identifiers

Security identifier	Class
ISIN	com.github.kelebra.security.identifier.Isin
CUSIP	com.github.kelebra.security.identifier.Cusip
SEDOL	com.github.kelebra.security.identifier.Sedol

All of them are successors of SecurityIdentifier class which is intendent to be used in case when you want to have generic representation and do not worry about actual underlying type.

Create particular security identifier:

Isin isin = Isin.from("US0378331005");
Sedol sedol = Sedol.from("0263494");
Cusip cusip = Cusip.from("037833100");

Parse any security identifier:

SecurityIdentifierFactory.from("US0378331005"); // creates Isin instance
SecurityIdentifierFactory.from("0263494"); // creates Sedol instance
SecurityIdentifierFactory.from("037833100"); // creates Cusip instance

Defining security identifier type:

SecurityIdentifierFactory.getType("US0378331005"); // returns SecurityIdentifierType.ISIN
SecurityIdentifierFactory.getType("0263494"); // returns SecurityIdentifierType.SEDOL
SecurityIdentifierFactory.getType("037833100"); // returns SecurityIdentifierType.CUSIP

Validations applied when creating an instance of security identifier:

Security identifier	Must have country code	Is alpha numeric	Required length	Check digit validation algorithm	Additional requirements
ISIN	+	+	12	Luhn's algorithm
CUSIP	-	+	9	Modulo 10 hashing algorithm
SEDOL	-	+	7	Modulo 10 hashing algorithm	GB country code for ISIN conversion

Create security identifier without check digit check:

new IsinBuilder().withoutCheckOfCheckDigit().build("US0378331006"); // creates Isin instance
new SedolBuilder().withoutCheckOfCheckDigit().build("0263497"); // creates Sedol instance
new CusipBuilder().withoutCheckOfCheckDigit().build("037833101"); // creates Cusip instance

Versions

Version
0.2 May 16, 2016
0.1 Apr 26, 2016