66 lines
2.3 KiB
Java
66 lines
2.3 KiB
Java
|
/*
|
||
|
|
* Copyright (C) 2018 The Android Open Source Project
|
||
|
|
*
|
||
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
* you may not use this file except in compliance with the License.
|
||
|
|
* You may obtain a copy of the License at
|
||
|
|
*
|
||
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
*
|
||
|
|
* Unless required by applicable law or agreed to in writing, software
|
||
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
* See the License for the specific language governing permissions and
|
||
|
|
* limitations under the License.
|
||
|
|
*/
|
||
|
|
|
||
|
|
package android.net;
|
||
|
|
|
||
|
|
import android.annotation.NonNull;
|
||
|
|
|
||
|
|
import libcore.net.InetAddressUtils;
|
||
|
|
|
||
|
|
import java.net.InetAddress;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Utility methods for {@link InetAddress} implementations.
|
||
|
|
*/
|
||
|
|
public class InetAddresses {
|
||
|
|
|
||
|
|
private InetAddresses() {}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Checks to see if the {@code address} is a numeric address (such as {@code "192.0.2.1"} or
|
||
|
|
* {@code "2001:db8::1:2"}).
|
||
|
|
*
|
||
|
|
* <p>A numeric address is either an IPv4 address containing exactly 4 decimal numbers or an
|
||
|
|
* IPv6 numeric address. IPv4 addresses that consist of either hexadecimal or octal digits or
|
||
|
|
* do not have exactly 4 numbers are not treated as numeric.
|
||
|
|
*
|
||
|
|
* <p>This method will never do a DNS lookup.
|
||
|
|
*
|
||
|
|
* @param address the address to parse.
|
||
|
|
* @return true if the supplied address is numeric, false otherwise.
|
||
|
|
*/
|
||
|
|
public static boolean isNumericAddress(@NonNull String address) {
|
||
|
|
return InetAddressUtils.isNumericAddress(address);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns an InetAddress corresponding to the given numeric address (such
|
||
|
|
* as {@code "192.168.0.1"} or {@code "2001:4860:800d::68"}).
|
||
|
|
*
|
||
|
|
* <p>See {@link #isNumericAddress(String)} (String)} for a definition as to what constitutes a
|
||
|
|
* numeric address.
|
||
|
|
*
|
||
|
|
* <p>This method will never do a DNS lookup.
|
||
|
|
*
|
||
|
|
* @param address the address to parse, must be numeric.
|
||
|
|
* @return an {@link InetAddress} instance corresponding to the address.
|
||
|
|
* @throws IllegalArgumentException if {@code address} is not a numeric address.
|
||
|
|
*/
|
||
|
|
public static @NonNull InetAddress parseNumericAddress(@NonNull String address) {
|
||
|
|
return InetAddressUtils.parseNumericAddress(address);
|
||
|
|
}
|
||
|
|
}
|