convenient phone library

A convenient phone library helping to work with phone numbers.

License	The MIT License
GroupId	com.github.javadev
ArtifactId	phone-utils
Last Version	1.0
Release Date	Feb 6, 2019
Type	jar
Description	convenient phone library A convenient phone library helping to work with phone numbers.
Project URL	https://github.com/javadev/phone-utils
Source Code Management	https://github.com/javadev/phone-utils

Download phone-utils

Filename	Size
phone-utils-1.0.pom
phone-utils-1.0.jar	10 KB
phone-utils-1.0-test-sources.jar	5 KB
phone-utils-1.0-test-javadoc.jar	30 KB
phone-utils-1.0-sources.jar	5 KB
phone-utils-1.0-javadoc.jar	38 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.javadev/phone-utils/ -->
<dependency>
    <groupId>com.github.javadev</groupId>
    <artifactId>phone-utils</artifactId>
    <version>1.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.javadev/phone-utils/
implementation 'com.github.javadev:phone-utils:1.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.javadev/phone-utils/
implementation ("com.github.javadev:phone-utils:1.0")

Apache Buildr

'com.github.javadev:phone-utils:jar:1.0'

Apache Ivy

<dependency org="com.github.javadev" name="phone-utils" rev="1.0">
  <artifact name="phone-utils" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.javadev', module='phone-utils', version='1.0')
)

Scala SBT

libraryDependencies += "com.github.javadev" % "phone-utils" % "1.0"

Leiningen

[com.github.javadev/phone-utils "1.0"]

Dependencies

compile (2)

Group / Artifact	Type	Version
com.googlecode.libphonenumber : libphonenumber	jar	8.10.4
org.slf4j : slf4j-api	jar	1.7.25

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

phone-utils

A convenient phone library helping to work with phone numbers.

Requirements

Java 1.8 and later.

Installation

Include the following in your pom.xml for Maven:

<dependencies>
  <dependency>
    <groupId>com.github.javadev</groupId>
    <artifactId>phone-utils</artifactId>
    <version>1.0</version>
  </dependency>
  ...
</dependencies>

Gradle:

compile 'com.github.javadev:phone-utils:1.0'

Definitions

Definitions of vocabulary used in project

• Country code - Integer. Examples: 380, 47, 46, etc
• National number - String. ([phone], ([phone]
• Full phone number: + Country code and national number
• Valid phone number: means that Google library says that this is real number according to Telecom rules
• Possible number: semantically incorrect, but syntactically correct numbers.

Examples

Check if number is valid

$ isValidPhoneNumber("+47", "45 45 45 45") => true
$ isValidPhoneNumber("+47", "85 45 45 45") => false

Check if possible number

$ isPossibleFullPhoneNumber("[phone]") => true
$ isPossibleFullPhoneNumber("[phone]fdsd4") => false

Normalize number

$ normalizePhoneNumber("+1 (650) - 713 (9923)") => [phone]

Check if number has given country code (for example: Norway)

$ hasCountryCode(47, "[phone]") => true
$ hasCountryCode(46, "[phone]") => false
$ hasCountryCode(47, "[phone]") => false (not possible number)

Check valid norwegian number

$ isValidNorwegianPhoneNumber("45037118") => true
$ isValidNorwegianPhoneNumber("906 (30) 185") => true
$ isValidNorwegianPhoneNumber("+47 906 (30) 185") => true
$ isValidNorwegianPhoneNumber("[phone]") => true
 
$ isValidNorwegianPhoneNumber("800185") => false
$ isValidNorwegianPhoneNumber("80630185") => false
$ isValidNorwegianPhoneNumber("[phone]") => false

Generate valid full norwegian number

$ generateFullNorwegianPhoneNumber("45037118") => [phone]
$ generateFullNorwegianPhoneNumber("906 (30) 185") => [phone]
$ generateFullNorwegianPhoneNumber("+47 906 (30) 185") => [phone]

Versions

Version
1.0 Feb 6, 2019