Spec-Zone .ru
спецификации, руководства, описания, API
|
public class InetAddress extends Object implements Serializable
IP-адрес является или 32-разрядным или 128-разрядным числом без знака, используемым IP, протоколом низшего уровня, на котором создаются протоколы как UDP и TCP. Архитектура IP-адреса определяется
одноадресная передача Идентификатор для единственного интерфейса. Пакет, отправленный одноадресному адресу, поставляется интерфейсу, идентифицированному тем адресом. Неуказанный Адрес - Также названный anylocal или подстановочным адресом. Это никогда не должно присваиваться никакому узлу. Это указывает на отсутствие адреса. Один пример его использования - поскольку цель связывает, который позволяет серверу принимать клиентское соединение в любом интерфейсе, в случае, если у узла сервера есть многократные интерфейсы.
Неуказанный адрес не должен использоваться в качестве адреса получателя пакета IP.
Петлевые Адреса - Это - адрес, присвоенный петлевому интерфейсу. Что-либо отправленное этому IP-адресу циклы вокруг и становится вводом IP на локальном узле. Этот адрес часто используется, тестируя клиент.
многоадресная передача Идентификатор для ряда интерфейсов (обычно принадлежащий различным узлам). Пакет, отправленный многоадресному адресу, поставляется всем интерфейсам, идентифицированным тем адресом.
Локальные для ссылки адреса разрабатываются, чтобы использоваться для того, чтобы адресоваться на единственной ссылке в целях, таких как конфигурация автоадреса, соседнее открытие, или когда никакие маршрутизаторы не присутствуют.
Локальные для сайта адреса разрабатываются, чтобы использоваться для того, чтобы адресоваться в сайте без потребности в глобальном префиксе.
Глобальные адреса уникальны через Интернет.
Для формата адреса IPv4, пожалуйста, обратитесь к Inet4Address#format; Для формата адреса IPv6, пожалуйста, обратитесь к Inet6Address#format.
Есть несколько Системных влияний Свойств, как IPv4 и адреса IPv6 используются.
Обратное разрешение имени означает, что для любого IP-адреса, узел, связанный с IP-адресом, возвращается.
InetAddress class обеспечивает методы, чтобы разрешить имена хоста к их IP-адресам и наоборот.
По умолчанию, когда менеджер безопасности устанавливается, чтобы защитить от атак спуфинга DNS, результат положительных разрешений имени хоста кэшируются навсегда. Когда менеджер безопасности не устанавливается, поведение значения по умолчанию должно кэшировать записи в течение конечного (зависящего от реализации) промежутка времени. Результат неудачного разрешения имени хоста кэшируется в течение очень короткого периода времени (10 секунд), чтобы улучшить производительность.
Если поведение значения по умолчанию не требуется, то свойство безопасности Java может быть установлено в различное Время-к-живому (TTL) значение для положительного кэширования. Аналогично, системный администратор может сконфигурировать различное отрицательное значение TTL кэширования при необходимости.
Два свойства безопасности Java управляют значениями TTL, используемыми для положительного и отрицательного кэширования разрешения имени хоста:
- networkaddress.cache.ttl
- Указывает на кэширующуюся политику для успешных поисков имени от службы имен. Значение определяется как как целое число, чтобы указать на число секунд, чтобы кэшировать успешный поиск. Настройка по умолчанию должна кэшировать для реализации определенный промежуток времени.
Значение-1 указывает "на кэш навсегда".
- networkaddress.cache.negative.ttl (значение по умолчанию: 10)
- Указывает на кэширующуюся политику для неудачных поисков имени от службы имен. Значение определяется как как целое число, чтобы указать на число секунд, чтобы кэшировать отказ для неудачных поисков.
Значение 0 не указывает "никогда на кэш". Значение-1 указывает "на кэш навсегда".
getByAddress(byte[])
, getByAddress(java.lang.String, byte[])
, getAllByName(java.lang.String)
, getByName(java.lang.String)
, getLocalHost()
, Сериализированная ФормаМодификатор и Тип | Метод и Описание |
---|---|
boolean |
equals(Object obj)
Сравнивает этот объект с указанным объектом.
|
byte[] |
getAddress()
Возвращает необработанный IP-адрес этого
InetAddress объект. |
static InetAddress[] |
getAllByName(String host)
Учитывая имя узла, возвращает массив его IP-адресов, основанных на сконфигурированной службе имен на системе.
|
static InetAddress |
getByAddress(byte[] addr)
Возвраты
InetAddress возразите данный необработанный IP-адрес. |
static InetAddress |
getByAddress(String host, byte[] addr)
Создает InetAddress, основанный на обеспеченном имени хоста и IP-адресе.
|
static InetAddress |
getByName(String host)
Определяет IP-адрес узла, учитывая имя узла.
|
Строка |
getCanonicalHostName()
Получает полностью определенное доменное имя для этого IP-адреса.
|
Строка |
getHostAddress()
Возвращает строку IP-адреса в текстовом представлении.
|
Строка |
getHostName()
Получает имя хоста для этого IP-адреса.
|
static InetAddress |
getLocalHost()
Возвращает адрес локального узла.
|
static InetAddress |
getLoopbackAddress()
Возвращает петлевой адрес.
|
int |
hashCode()
Возвращает хэш-код для этого IP-адреса.
|
boolean |
isAnyLocalAddress()
Служебная подпрограмма, чтобы проверить, если InetAddress в подстановочный адрес.
|
boolean |
isLinkLocalAddress()
Служебная подпрограмма, чтобы проверить, является ли InetAddress ссылкой локальный адрес.
|
boolean |
isLoopbackAddress()
Служебная подпрограмма, чтобы проверить, является ли InetAddress петлевым адресом.
|
boolean |
isMCGlobal()
Служебная подпрограмма, чтобы проверить, есть ли у многоадресного адреса глобальная область видимости.
|
boolean |
isMCLinkLocal()
Служебная подпрограмма, чтобы проверить, есть ли у многоадресного адреса контекст ссылки.
|
boolean |
isMCNodeLocal()
Служебная подпрограмма, чтобы проверить, есть ли у многоадресного адреса контекст узла.
|
boolean |
isMCOrgLocal()
Служебная подпрограмма, чтобы проверить, есть ли у многоадресного адреса организационный контекст.
|
boolean |
isMCSiteLocal()
Служебная подпрограмма, чтобы проверить, есть ли у многоадресного адреса контекст сайта.
|
boolean |
isMulticastAddress()
Служебная подпрограмма, чтобы проверить, является ли InetAddress многоадресным адресом IP.
|
boolean |
isReachable(int timeout)
Тест, достижим ли тот адрес.
|
boolean |
isReachable(NetworkInterface netif, int ttl, int timeout)
Тест, достижим ли тот адрес.
|
boolean |
isSiteLocalAddress()
Служебная подпрограмма, чтобы проверить, является ли InetAddress сайтом локальный адрес.
|
Строка |
toString()
Преобразовывает этот IP-адрес в a
String . |
public boolean isMulticastAddress()
boolean
указание, является ли InetAddress многоадресным адресом IPpublic boolean isAnyLocalAddress()
boolean
указание, является ли Inetaddress подстановочным адресом.public boolean isLoopbackAddress()
boolean
указание, является ли InetAddress петлевым адресом; или ложь иначе.public boolean isLinkLocalAddress()
boolean
указание, является ли InetAddress ссылкой локальный адрес; или ложь, если адрес не является ссылкой локальный одноадресный адрес.public boolean isSiteLocalAddress()
boolean
указание, является ли InetAddress сайтом локальный адрес; или ложь, если адрес не является сайтом локальный одноадресный адрес.public boolean isMCGlobal()
boolean
указание, если адрес имеет, является многоадресным адресом глобальной области видимости, ложь, если это не имеет глобальной области видимости или это не многоадресный адресpublic boolean isMCNodeLocal()
boolean
указание, если адрес имеет, является многоадресным адресом локального для узла контекста, ложь, если это не имеет локального для узла контекста или это не многоадресный адресpublic boolean isMCLinkLocal()
boolean
указание, если адрес имеет, является многоадресным адресом локального для ссылки контекста, ложь, если это не имеет локального для ссылки контекста или это не многоадресный адресpublic boolean isMCSiteLocal()
boolean
указание, если адрес имеет, является многоадресным адресом локального для сайта контекста, ложь, если это не имеет локального для сайта контекста или это не многоадресный адресpublic boolean isMCOrgLocal()
boolean
указание, если адрес имеет, является многоадресным адресом локального для организации контекста, ложь, если это не имеет локального для организации контекста или это не многоадресный адресpublic boolean isReachable(int timeout) throws IOException
Значение тайм-аута, в миллисекундах, указывает на максимальное количество времени, которое должна занять попытка. Если времена работы прежде, чем получить ответ, узел считают недостижимым. Отрицательная величина приведет к бросаемому IllegalArgumentException.
timeout
- время, в миллисекундах, перед аварийными прекращениями работы вызоваboolean
указание, достижим ли адрес.IOException
- если сетевая ошибка происходитIllegalArgumentException
- если timeout
отрицательно.public boolean isReachable(NetworkInterface netif, int ttl, int timeout) throws IOException
network interface
и ttl
параметры, которым позволяют вызывающая сторона определить, который сетевой интерфейс тест пройдет через и максимальное количество транзитных участков пакеты, должны пройти через. Отрицательная величина для ttl
приведет к бросаемому IllegalArgumentException.
Значение тайм-аута, в миллисекундах, указывает на максимальное количество времени, которое должна занять попытка. Если времена работы прежде, чем получить ответ, узел считают недостижимым. Отрицательная величина приведет к бросаемому IllegalArgumentException.
netif
- NetworkInterface, через который тест будет сделан, или нуль для любого интерфейсаttl
- максимальные количества транзитных участков, чтобы попробовать или 0 за значение по умолчаниюtimeout
- время, в миллисекундах, перед аварийными прекращениями работы вызоваboolean
указание, достижим ли адрес.IllegalArgumentException
- если также timeout
или ttl
отрицательны.IOException
- если сетевая ошибка происходитpublic String getHostName()
Если этот InetAddress создавался с именем хоста, это имя хоста будут помнить и возвращено; иначе, обратный поиск имени будет выполняться, и результат будет возвращен основанный на системе сконфигурированная служба поиска имени. Если поиск службы имен требуется, вызвать getCanonicalHostName
.
Если есть менеджер безопасности, checkConnect
метод сначала вызывают с именем узла и -1
как его параметры, чтобы видеть, позволяется ли работа. Если работа не будет позволена, то она возвратит текстовое представление IP-адреса.
getCanonicalHostName()
, SecurityManager.checkConnect(java.lang.String, int)
public String getCanonicalHostName()
Если есть менеджер безопасности, этот метод первые вызовы checkConnect
метод с именем узла и -1
как его параметры, чтобы видеть, позволяют ли коду вызова знать имя узла для этого IP-адреса, то есть, соединиться с узлом. Если работа не будет позволена, то она возвратит текстовое представление IP-адреса.
SecurityManager.checkConnect(java.lang.String, int)
public byte[] getAddress()
InetAddress
объект. Результат находится в сетевом порядке байтов: самый высокий байт порядка адреса находится в getAddress()[0]
.public String getHostAddress()
public int hashCode()
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public boolean equals(Object obj)
true
если и только если параметр не null
и это представляет тот же самый IP-адрес как этот объект. Два экземпляра InetAddress
представьте тот же самый IP-адрес если длина байтовых массивов, возвращенных getAddress
то же самое для обоих, и каждый из компонентов массива является тем же самым для байтовых массивов.
equals
в class Object
obj
- объект сравниться с.true
если объекты являются тем же самым; false
иначе.getAddress()
public String toString()
String
. Возвращенная строка имеет форму: имя узла / литеральный IP-адрес. Если имя хоста неразрешается, никакой обратный поиск службы имен не выполняется. Часть имени узла будет представлена пустой строкой.public static InetAddress getByAddress(String host, byte[] addr) throws UnknownHostException
Имя хоста может или быть машинным именем, такой как"java.sun.com
", или текстовое представление его IP-адреса.
Никакая проверка законности не делается на имени хоста также.
Если addr определит, что IPv4 адресуется, то экземпляр Inet4Address будет возвращен; иначе, экземпляр Inet6Address будет возвращен.
Массив адресного байта IPv4 должен быть 4 байта длиной, и байтовый массив IPv6 должен быть 16 байтов длиной
host
- указанный узелaddr
- необработанный IP-адрес в сетевом порядке байтовUnknownHostException
- если IP-адрес имеет недопустимую длинуpublic static InetAddress getByName(String host) throws UnknownHostException
Имя хоста может или быть машинным именем, такой как"java.sun.com
", или текстовое представление его IP-адреса. Если литеральный IP-адрес предоставляется, только законность формата адреса проверяется.
Для host
определенный в литеральном адресе IPv6, или форма, определенная в RFC 2732 или литеральный формат адреса IPv6, определенный в RFC 2373, принимаются. IPv6 определяющие контекст адреса также поддерживается. См. здесь для описания IPv6 определяющие контекст адреса.
Если узлом является null тогда, InetAddress, представляющий адрес петлевого интерфейса, возвращается. См. раздел
host
- указанный узел, или null
.UnknownHostException
- если никакой IP-адрес для host
мог быть найден, или если scope_id был определен для глобального адреса IPv6.SecurityException
- если менеджер безопасности существует, и его checkConnect метод не позволяет работуpublic static InetAddress[] getAllByName(String host) throws UnknownHostException
Имя хоста может или быть машинным именем, такой как"java.sun.com
", или текстовое представление его IP-адреса. Если литеральный IP-адрес предоставляется, только законность формата адреса проверяется.
Для host
определенный в литеральном адресе IPv6, или форма, определенная в RFC 2732 или литеральный формат адреса IPv6, определенный в RFC 2373, принимаются. Литеральный адрес IPv6 может также быть квалифицирован, добавляя определяющий контекст зональный идентификатор или scope_id. Синтаксис и использование scope_ids описываются здесь.
Если узлом является null тогда, InetAddress, представляющий адрес петлевого интерфейса, возвращается. См. раздел
Если есть менеджер безопасности и host
не нуль и host.length()
не равно нулю, менеджер безопасности checkConnect
метод вызывают с именем узла и -1
как его параметры, чтобы видеть, позволяется ли работа.
host
- имя узла, или null
.UnknownHostException
- если никакой IP-адрес для host
мог быть найден, или если scope_id был определен для глобального адреса IPv6.SecurityException
- если менеджер безопасности существует и checkConnect
метод не позволяет работу.SecurityManager.checkConnect(java.lang.String, int)
public static InetAddress getLoopbackAddress()
InetAddress возвратился, представит петлевой адрес IPv4, 127.0.0.1, или петлевой адрес IPv6:: 1. Петлевой возвращенный адрес IPv4 является только одним из многих в форме 127.*.*.*
public static InetAddress getByAddress(byte[] addr) throws UnknownHostException
InetAddress
возразите данный необработанный IP-адрес. Параметр находится в сетевом порядке байтов: самый высокий байт порядка адреса находится в getAddress()[0]
. Этот метод не блокирует, то есть никакой обратный поиск службы имен не выполняется.
Массив адресного байта IPv4 должен быть 4 байта длиной, и байтовый массив IPv6 должен быть 16 байтов длиной
addr
- необработанный IP-адрес в сетевом порядке байтовUnknownHostException
- если IP-адрес имеет недопустимую длинуpublic static InetAddress getLocalHost() throws UnknownHostException
InetAddress
. Отметьте: разрешенный адрес может кэшироваться в течение короткого периода времени.
Если есть менеджер безопасности, checkConnect
метод вызывают с локальным именем хоста и -1
как его параметры, чтобы видеть, позволяется ли работа. Если работа не позволяется, InetAddress, представляющий петлевой адрес, возвращается.
UnknownHostException
- если локальное имя хоста не могло бы быть разрешено в адрес.SecurityManager.checkConnect(java.lang.String, int)
, getByName(java.lang.String)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92