JarCasting
JarCasting JarCasting

JNanoId

A unique string ID generator for Java.

License

License
Categories

Categories

JNA Development Tools Native
GroupId

GroupId

com.aventrix.jnanoid
ArtifactId

ArtifactId

jnanoid
Last Version

Last Version

2.0.0
Release Date

Release Date
Type

Type

jar
Description

Description

JNanoId
A unique string ID generator for Java.
Project URL

Project URL

https://github.com/aventrix/jnanoid
Project Organization

Project Organization

Aventrix
Source Code Management

Source Code Management

https://github.com/aventrix/jnanoid

Download jnanoid

Filename Size
jnanoid-2.0.0.pom
jnanoid-2.0.0.jar 4 KB
jnanoid-2.0.0-sources.jar 2 KB
jnanoid-2.0.0-javadoc.jar 24 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.aventrix.jnanoid/jnanoid/ -->
<dependency>
    <groupId>com.aventrix.jnanoid</groupId>
    <artifactId>jnanoid</artifactId>
    <version>2.0.0</version>
</dependency>
// https://jarcasting.com/artifacts/com.aventrix.jnanoid/jnanoid/
implementation 'com.aventrix.jnanoid:jnanoid:2.0.0'
// https://jarcasting.com/artifacts/com.aventrix.jnanoid/jnanoid/
implementation ("com.aventrix.jnanoid:jnanoid:2.0.0")
'com.aventrix.jnanoid:jnanoid:jar:2.0.0'
<dependency org="com.aventrix.jnanoid" name="jnanoid" rev="2.0.0">
  <artifact name="jnanoid" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.aventrix.jnanoid', module='jnanoid', version='2.0.0')
)
libraryDependencies += "com.aventrix.jnanoid" % "jnanoid" % "2.0.0"
[com.aventrix.jnanoid/jnanoid "2.0.0"]

Dependencies

test (2)

Group / Artifact Type Version
junit : junit jar 4.11
org.hamcrest : hamcrest-junit jar 2.0.0.0

Project Modules

There are no modules declared in this project.

JNanoId

Build Status Maven Central

A unique string ID generator for Java.

Secure

JNanoID uses Java’s SecureRandom to generate cryptographically strong random IDs with a proper distribution of characters.

Compact

JNanoID generates compact IDs with just 21 characters. By using a larger alphabet than UUID, JNanoID can generate a greater number of unique IDs, when compared to UUID, with fewer characters (21 versus 36).

URL-Friendly

JNanoID uses URL-friendly characters (A-Za-z0-9_-). Perfect for unique identifiers in web applications.

Customizable

JNanoID is fully customizable. All default options may be overridden. Supply your own Random Number Generator, alphabet, or size.

Tested

JNanoID is thoroughly tested with JUnit.

Latest Release

The most recent release is JNanoId 2.0.0.

Maven

<dependency>
  <groupId>com.aventrix.jnanoid</groupId>
  <artifactId>jnanoid</artifactId>
  <version>2.0.0</version>
</dependency>

Gradle

compile 'com.aventrix.jnanoid:jnanoid:2.0.0'

Usage

JNanoId provides one easy-to-use utility class (NanoIdUtils) with two methods to generate IDs.

Standard IDs - randomNanoId()

The default method creates secure, url-friendly, unique ids. It uses a url-friendly alphabet (A-Za-z0-9_-), a secure random number generator, and generates a unique ID with 21 characters.

String id = NanoIdUtils.randomNanoId(); // "ku-qLNv1wDmIS5_EcT3j7"

Custom IDs - NanoIdUtils.randomNanoId(random, alphabet, size);

An additional method allows you to generate custom IDs by specifying your own random number generator, alphabet, or size.

// Use a faster, but non-secure, random generator
Random random = new Random();

// Use a custom alphabet containing only a, b, and c
char[] alphabet = {'a','b','c'};

// Make IDs 10 characters long
int size = 10;

String id = NanoIdUtils.randomNanoId(random, alphabet, 10); // "babbcaabcb"

Copyright and license

Code copyright 2017 The JNanoID Authors, Aventrix LLC, and Andrey Sitnik. Code released under the MIT License.

Based on the original NanoId for JavaScript by Andrey Sitnik.

Other Programming Languages

Also, a CLI tool is available to generate IDs from the command line.

com.aventrix.jnanoid

Aventrix

Aventrix helps people discover and share fun activities, events, and products.

Versions

Version
2.0.0
1.0.1