longmapper

A family of bijective mappings for 64-bit integers.

License	Apache License, Version 2.0
GroupId	com.codahale
ArtifactId	longmapper
Last Version	0.1.1
Release Date	Sep 27, 2018
Type	jar
Description	longmapper A family of bijective mappings for 64-bit integers.
Project URL	https://github.com/codahale/longmapper
Source Code Management	https://github.com/codahale/longmapper

Download longmapper

Filename	Size
longmapper-0.1.1.pom
longmapper-0.1.1.jar	5 KB
longmapper-0.1.1-sources.jar	5 KB
longmapper-0.1.1-javadoc.jar	23 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.codahale/longmapper/ -->
<dependency>
    <groupId>com.codahale</groupId>
    <artifactId>longmapper</artifactId>
    <version>0.1.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.codahale/longmapper/
implementation 'com.codahale:longmapper:0.1.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.codahale/longmapper/
implementation ("com.codahale:longmapper:0.1.1")

Apache Buildr

'com.codahale:longmapper:jar:0.1.1'

Apache Ivy

<dependency org="com.codahale" name="longmapper" rev="0.1.1">
  <artifact name="longmapper" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.codahale', module='longmapper', version='0.1.1')
)

Scala SBT

libraryDependencies += "com.codahale" % "longmapper" % "0.1.1"

Leiningen

[com.codahale/longmapper "0.1.1"]

Dependencies

test (8)

Group / Artifact	Type	Version
org.junit.jupiter : junit-jupiter-api	jar	5.3.1
org.junit.jupiter : junit-jupiter-engine	jar	5.3.1
org.junit.jupiter : junit-jupiter-params	jar	5.3.1
org.assertj : assertj-core	jar	3.11.1
org.quicktheories : quicktheories	jar	0.25
org.mockito : mockito-core	jar	2.22.0
org.openjdk.jmh : jmh-core	jar	1.21
org.openjdk.jmh : jmh-generator-annprocess	jar	1.21

Project Modules

There are no modules declared in this project.

LongMapper

Add to your project

<dependency>
  <groupId>com.codahale</groupId>
  <artifactId>longmapper</artifactId>
  <version>0.1.1</version>
</dependency>

Note: module name for Java 9+ is com.codahale.longmapper.

Use the thing

import static java.nio.charset.StandardCharsets.UTF_8;
import com.codahale.longmapper.LongMapper;

class Example {
  public static void main(String... args) {
    final LongMapper mapper = new LongMapper("ayellowsubmarine".getBytes(UTF_8));

    System.out.printf("Mapped %d to %d\n", 200, mapper.map(200));
    System.out.printf("Unmapped %d to %d\n", mapper.map(200), mapper.unmap(mapper.map(200)));
  }
}

How it works

It encrypts each long as a 64-bit Blowfish block.

Performance

It's fast. Plenty fast.

Benchmark         Mode  Cnt    Score   Error  Units
Benchmarks.map    avgt   20  102.132 ± 8.190  ns/op
Benchmarks.unmap  avgt   20  115.311 ± 1.092  ns/op

License

Copyright © 2018 Coda Hale

Distributed under the Apache License 2.0.

Versions

Version
0.1.1 Sep 27, 2018
0.1.0 May 2, 2018