suid-java

Java implementation of Scoped Unique IDs

Suids are distributed, Scoped, Unique IDs that are short and sweet.

See the main project for details.

Download

• suid-java-0.12.0.jar (signature)
• suid-java-0.12.0-sources.jar (signature)
• suid-java-0.12.0-javadoc.jar (signature)

Maven coordinates:

<dependency>
	<groupId>ws.suid</groupId>
	<artifactId>suid-java</artifactId>
	<version>0.12.0</version>
</dependency>

Import

import ws.suid.Suid;

Usage

• Create a Suid from a long
• Create a Suid from a string
• Get a Suid's underlying value
• Convert a Suid to a Long
• Convert a Suid to a String
• Convert a Suid list to a Long list
• Convert a Suid list to a String List
• Convert a Long list to a Suid list
• Convert a String list to a Suid list

Create a Suid from a long

Suid id = new Suid(1903154L);
System.out.println(id); // 14she

Create a Suid from a string

Suid id = new Suid("14she");
System.out.println(id); // 14she

Get a Suid's underlying value

Suid id = new Suid("14she");
System.out.println(id.longValue()); // 1903154

Convert a Suid to a Long

Suid id = new Suid("14she");
Long val = id.toLong();
System.out.println(val); // 1903154

Convert a Suid to a String

Suid id = new Suid("14she");
String val = id.toString();
System.out.println(val); // 14she

Convert a Suid list to a Long list

List<Suid> ids = Arrays.asList(new Suid[]{new Suid(1903154), new Suid(1903155), new Suid(1903156)});
System.out.println(ids);  // [14she, 14shf, 14shg]
List<Long> vals = Suid.toLong(ids);
System.out.println(vals); // [1903154, 1903155, 1903156]

Convert a Suid list to a String list

List<Suid> ids = Arrays.asList(new Suid[]{new Suid(1903154), new Suid(1903155), new Suid(1903156)});
System.out.println(ids);  // [14she, 14shf, 14shg]
List<String> vals = Suid.toString(ids);
System.out.println(vals); // [14she, 14shf, 14shg]

Convert a Long list to a Suid list

List<Long> vals = Arrays.asList(new Long[]{Long.valueOf(1903154), Long.valueOf(1903155), Long.valueOf(1903156)});
System.out.println(vals); // [1903154, 1903155, 1903156]
List<Suid> ids = Suid.fromLong(vals);
System.out.println(ids);  // [14she, 14shf, 14shg]

Convert a String list to a Suid list

List<String> vals = Arrays.asList(new String[]{"14she", "14shf", "14shg"});
System.out.println(vals); // [14she, 14shf, 14shg]
List<Suid> ids = Suid.fromString(vals);
System.out.println(ids);  // [14she, 14shf, 14shg]

Copyright

Copyright (c) 2017 by Stijn de Witt. Some rights reserved.

License

Creative Commons Attribution 4.0 International (CC BY 4.0) https://creativecommons.org/licenses/by/4.0/