ineter

Fast Java library for working with IP addresses, ranges, and subnets

License	Mozilla Public License 2.0
Categories	Net
GroupId	com.github.maltalex
ArtifactId	ineter
Last Version	0.3.0
Release Date	Dec 24, 2020
Type	jar
Description	ineter Fast Java library for working with IP addresses, ranges, and subnets
Project URL	https://github.com/maltalex/Ineter
Source Code Management	https://github.com/maltalex/Ineter

Download ineter

Filename	Size
ineter-0.3.0.pom
ineter-0.3.0.jar	43 KB
ineter-0.3.0-sources.jar	23 KB
ineter-0.3.0-javadoc.jar	487 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.maltalex/ineter/ -->
<dependency>
    <groupId>com.github.maltalex</groupId>
    <artifactId>ineter</artifactId>
    <version>0.3.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.maltalex/ineter/
implementation 'com.github.maltalex:ineter:0.3.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.maltalex/ineter/
implementation ("com.github.maltalex:ineter:0.3.0")

Apache Buildr

'com.github.maltalex:ineter:jar:0.3.0'

Apache Ivy

<dependency org="com.github.maltalex" name="ineter" rev="0.3.0">
  <artifact name="ineter" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.maltalex', module='ineter', version='0.3.0')
)

Scala SBT

libraryDependencies += "com.github.maltalex" % "ineter" % "0.3.0"

Leiningen

[com.github.maltalex/ineter "0.3.0"]

Dependencies

test (4)

Group / Artifact	Type	Version
com.google.guava : guava	jar	30.1-jre
org.junit.platform : junit-platform-runner	jar	1.7.0
org.junit.jupiter : junit-jupiter-engine	jar	5.7.0
org.junit.jupiter : junit-jupiter-params	jar	5.7.0

Project Modules

There are no modules declared in this project.

ineter

What?

ineter (pronounced "Eye-netter") is a tiny Java library for working with:

• Individual IP addresses - IPv4Address, IPv6Address/ZonedIPv6Address
• IP address ranges - IPv4Range, IPv6Range
• IP subnets - IPv4Subnet, IPv6Subnet

Why?

• Low memory (and GC) footprint: ineter uses primitive types to represent addresses - an int for IPv4, two long fields for IPv6. For comparison, Java's InetAddress uses an InetAddressHolder with two String fields and two int fields just for IPv4
• Immutability: ineter is immutable and thread-safe by default
• Speed: ineter is written with performance in mind
• Rich set of supported operations
• MPL-2.0 license, allowing commercial use as well as re-licensing under GNU

Where?

Maven:

<dependency>
	<groupId>com.github.maltalex</groupId>
	<artifactId>ineter</artifactId>
	<version>0.2.0</version>
</dependency>

Gradle:

compile 'com.github.maltalex:ineter:0.2.0'

How?

Individual IPv4/IPv6 addresses

IPv4Address ipv4 = IPv4Address.of("10.0.0.1");
IPv6Address ipv6 = IPv6Address.of("2001::1234:4321");

ipv4.isPrivate(); // true
ipv4.isMulticast(); // false
ipv6.isGlobalUnicast(); // true
ipv4.compareTo(IPv4Address.of(0x0a000001)); // addresses are comparable
ipv6.toInetAddress(); // addresses can be converted to other forms
ipv6.toSubnet(); // IPv6Address as a single /128 subnet
ipv4.plus(5); // 10.0.0.6
ipv4.distanceTo(IPv4Address.of("10.0.0.100")); // 99
ipv4.previous(); // 10.0.0.0

Arbitrary address ranges

IPv4Range ipv4Range = IPv4Range.parse("192.168.100.0-192.168.101.127");
IPv6Range ipv6Range = IPv6Range.of("2001::","2001::1000"); //Build using first and last address
IPv6Range singletonRange = IPv6Range.parse("2002::"); // A single address in range form

ipv6Range.contains(IPv6Address.of("2001::1000")); //true
ipv4Range.overlaps(IPv4Range.of("10.0.0.1", "10.0.0.10")); //false
ipv4Range.toSubnets(); // Returns the list of subnets that make up the range
ipv4Range.withLast(IPv4Address.of("192.168.102.0")); //range with different last address
ipv6Range.length(); //4097
IPv6Range.merge(ipv6Range, singletonRange); //ranges can be merged

Subnets

IPv4Subnet ipv4Subnet = IPv4Subnet.of("192.168.0.0/16");
IPv6Range ipv6Subnet = IPv6Range.parse("2001::/64"); // subnets are ranges too!

ipv4Subnet.getNetworkMask(); //255.255.0.0
ipv4Subnet.getNetworkBitCount(); //16

Versions

Version
0.3.0 Dec 24, 2020
0.2.0 Jan 17, 2020
0.1.2 Jul 3, 2019
0.1.1 Jul 1, 2019
0.1.0 May 27, 2018