commons-network

IP network related classes

License	Apache License 2.0
Categories	Net
GroupId	com.oneandone
ArtifactId	network-commons
Last Version	0.9.1
Release Date	Apr 25, 2020
Type	jar
Description	commons-network IP network related classes
Project URL	https://github.com/1and1/commons-network
Project Organization	1&1 Ionos SE
Source Code Management	https://github.com/1and1/commons-network

Download network-commons

Filename	Size
network-commons-0.9.1.pom
network-commons-0.9.1.jar	38 KB
network-commons-0.9.1-sources.jar	27 KB
network-commons-0.9.1-javadoc.jar	458 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.oneandone/network-commons/ -->
<dependency>
    <groupId>com.oneandone</groupId>
    <artifactId>network-commons</artifactId>
    <version>0.9.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.oneandone/network-commons/
implementation 'com.oneandone:network-commons:0.9.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.oneandone/network-commons/
implementation ("com.oneandone:network-commons:0.9.1")

Apache Buildr

'com.oneandone:network-commons:jar:0.9.1'

Apache Ivy

<dependency org="com.oneandone" name="network-commons" rev="0.9.1">
  <artifact name="network-commons" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.oneandone', module='network-commons', version='0.9.1')
)

Scala SBT

libraryDependencies += "com.oneandone" % "network-commons" % "0.9.1"

Leiningen

[com.oneandone/network-commons "0.9.1"]

Dependencies

test (2)

Group / Artifact	Type	Version
org.junit.jupiter : junit-jupiter-engine	jar	5.6.2
org.sonarsource.java : sonar-jacoco-listeners	jar	5.14.0.18788

Project Modules

There are no modules declared in this project.

Commons Network

A library of IP network representation classes, like

• IP address (IPv4, IPv6),
• MAC address,
• IP network using the CIDR method (Classless Inter-Domain Routing).

Prerequisites

• Java 8 or later
• Maven 3.6 or later

Design Goals

The following are the key design goals:

• Test-coverage: Have well-tested classes. Test coverage is at the moment at 95% line-coverage.
• Immutability: Have immutable classes where possible to support usage in a multi-threaded environment.
• Performance: Have simple, well-performing implementations.
• Simplicity: Have simple implementations where possible.
• No dependencies: Do not require dependencies for the core cases.
• Fail-fast: If you enter illegal data, you'll get an exception. The invariant of all objects is to contain no illegal or null data.
• No I/O: In contrast to the InetAddress class in JDK, these classes are just model classes.

Usage

You can include commons-network as a Maven dependency from Maven Central.

Maven dependency

<dependency>
    <groupId>com.oneandone</groupId>
    <artifactId>commons-network</artifactId>
    <version>0.14.0</version>
</dependency>

Documentation of provided classes and methods

The JavaDoc documentation can be found here.

Version schema

The version numbers are chosen according to the semantic versioning schema. Especially major version changes come with breaking API changes.

1&1

Open Source by 1&1 Group.

Versions

Version
0.9.1 Apr 25, 2020
0.9.0 Apr 24, 2020