Пакет java.net

Обеспечивает классы для того, чтобы они реализовали объединяющиеся в сеть приложения.

См.: Описание

Сводка интерфейса

Интерфейс	Описание
ContentHandlerFactory	Этот интерфейс определяет фабрику для обработчиков содержимого.
CookiePolicy	Реализации CookiePolicy решают, какие cookie должны быть приняты и который должен быть отклонен.
CookieStore	Объект CookieStore представляет хранение для cookie.
DatagramSocketImplFactory	Этот интерфейс определяет фабрику для реализаций сокета дейтаграммы.
FileNameMap	Простой интерфейс, который обеспечивает механизм, чтобы отобразиться между именем файла и строкой типа MIME.
ProtocolFamily	Представляет семейство протоколов связи.
SocketImplFactory	Этот интерфейс определяет фабрику для реализаций сокета.
SocketOption <T>	Опция сокета связалась с сокетом.
SocketOptions	Интерфейс методов, чтобы получить/установить опции сокета.
URLStreamHandlerFactory	Этот интерфейс определяет фабрику для URL потоковые обработчики протокола.

Сводка класса

Класс	Описание
Аутентификатор	Аутентификатор class представляет объект, который знает, как получить аутентификацию для сетевого соединения.
CacheRequest	Представляет каналы для того, чтобы сохранить ресурсы в ResponseCache.
CacheResponse	Представьте каналы для того, чтобы получить ресурсы от ResponseCache.
ContentHandler	Абстрактный class ContentHandler суперкласс всех классов, которые читают Object от a URLConnection.
CookieHandler	Объект CookieHandler обеспечивает механизм обратного вызова, чтобы поднять трубку реализацию политики управления состоянием HTTP в обработчик протокола HTTP.
CookieManager	CookieManager обеспечивает конкретную реализацию CookieHandler, который разделяет хранение cookie от окружения политики принимающие и отклоняющие cookie.
DatagramPacket	Этот class представляет пакет дейтаграммы.
DatagramSocket	Этот class представляет сокет для отправки и получения пакетов дейтаграммы.
DatagramSocketImpl	Абстрактная дейтаграмма и многоадресная реализация сокета базируют class.
HttpCookie	Объект HttpCookie представляет cookie HTTP, который переносит информацию о состоянии между сервером и агентом пользователя.
HttpURLConnection	URLConnection с поддержкой специфичных для HTTP функций.
HttpURLPermission	Представляет разрешение, чтобы получить доступ к ресурсу или набору ресурсов, определенных данным http или https url, и для данного набора устанавливаемых пользователем методов запроса и заголовков запроса.
IDN	Обеспечивает методы, чтобы преобразовать интернационализировавшие доменные имена (IDNs) между нормальным представлением Unicode и ASCII Совместимое Кодирование (ACE) представление.
Inet4Address	Этот class представляет интернет-версию 4 Протокола (IPv4) адрес.
Inet6Address	Этот class представляет интернет-версию 6 Протокола (IPv6) адрес.
InetAddress	Этот class представляет интернет-Протокол (IP) адрес.
InetSocketAddress	Этот class реализует Адрес Сокета IP (IP-адрес + номер порта), Это может также быть пара (имя узла + номер порта), когда попытка будет предпринята, чтобы разрешить имя узла.
InterfaceAddress	Этот class представляет адрес Сетевого интерфейса.
JarURLConnection	Соединение URL с Архивом Java (JAR) файл или запись в файле JAR.
MulticastSocket	Многоадресный сокет дейтаграммы class полезен для отправки и получения многоадресных пакетов IP.
NetPermission	Этот class для различных сетевых полномочий.
NetworkInterface	Этот class представляет Сетевой интерфейс, составленный из имени, и списка IP-адресов, присвоенных этому интерфейсу.
PasswordAuthentication	PasswordAuthentication class является держателем данных, который используется Аутентификатором.
Прокси	Этот class представляет установку прокси, обычно тип (http, носки) и адрес сокета.
ProxySelector	Выбирает прокси-сервер, чтобы использовать, если таковые вообще имеются, соединяясь с сетевым ресурсом, на который ссылается URL.
ResponseCache	Представляет реализации кэшей URLConnection.
SecureCacheResponse	Представляет ответ кэша, первоначально полученный через безопасные средства, такие как TLS.
ServerSocket	Этот class реализует сокеты сервера.
Сокет	Этот class реализует клиентские сокеты (также вызванный, только "снабжает сокетом").
SocketAddress	Этот class представляет Адрес Сокета без присоединения протокола.
SocketImpl	Абстрактный class SocketImpl общий суперкласс всех классов, которые фактически реализуют сокеты.
SocketPermission	Этот class представляет доступ к сети через сокеты.
StandardSocketOptions	Определяет стандартные опции сокета.
URI	Представляет Универсальный Идентификатор ресурса (URI) ссылка.
URL	Класс URL представляет Универсальный Локатор Ресурса, указатель на "ресурс" во всемирной паутине.
URLClassLoader	Этот загрузчик class используется, чтобы загрузить классы и ресурсы от пути поиска URL, обращающихся к файлам JAR и к каталогам.
URLConnection	Абстрактный class URLConnection суперкласс всех классов, которые представляют линию связи между приложением и URL.
URLDecoder	Служебный class для декодирования HTML-формы.
URLEncoder	Служебный class для кодирования HTML-формы.
URLStreamHandler	Абстрактный class URLStreamHandler общий суперкласс для всех потоковых обработчиков протокола.

Перечислимая Сводка

Перечисление	Описание
Аутентификатор. RequestorType	Тип аутентификации запроса объекта.
Прокси. Ввести	Представляет тип прокси.
StandardProtocolFamily	Определяет стандартные семейства протоколов связи.

Сводка исключения

Исключение	Описание
BindException	Сигналы, что ошибка произошла, пытаясь связать сокет с локальным адресом и портом.
ConnectException	Сигналы, что ошибка произошла, пытаясь соединить сокет с удаленным адресом и портом.
HttpRetryException	Брошенный, чтобы указать, что запрос HTTP потребности, которые будут повторены, но, не может быть повторен автоматически, из-за включаемого потокового режима.
MalformedURLException	Брошенный, чтобы указать, что произошел уродливый URL.
NoRouteToHostException	Сигналы, что ошибка произошла, пытаясь соединить сокет с удаленным адресом и портом.
PortUnreachableException	Сигналы, что Порт ICMP Недостижимое сообщение был получен на соединенной дейтаграмме.
ProtocolException	Брошенный, чтобы указать, что есть ошибка в базовом протоколе, таком как ошибка TCP.
SocketException	Брошенный, чтобы указать, что есть ошибка, создавая или получая доступ к Сокету.
SocketTimeoutException	Сигналы, что тайм-аут произошел на чтении сокета или принимает.
UnknownHostException	Брошенный, чтобы указать, что IP-адрес узла не мог быть определен.
UnknownServiceException	Брошенный, чтобы указать, что произошло неизвестное исключение службы.
URISyntaxException	Проверенное исключение, выданное, чтобы указать, что строка не могла быть проанализирована как ссылка URI.

Пакет java.net Описание

Обеспечивает классы для того, чтобы они реализовали объединяющиеся в сеть приложения.

java.net пакет может быть примерно разделен на два раздела:

• Низкоуровневый API, который имеет дело со следующими абстракциями:

  • Адреса, которые объединяют идентификаторы в сеть, как IP-адреса.

  • Сокеты, которые являются основными двунаправленными механизмами передачи данных.

  • Интерфейсы, которые описывают сетевые интерфейсы.

• Высокоуровневый API, который имеет дело со следующими абстракциями:

  • URI, которые представляют Универсальные Идентификаторы ресурсов.

  • URL, которые представляют Универсальные Локаторы Ресурса.

  • Соединения, который представляет соединения с ресурсом, на который указывают URL.

Адреса

Адреса используются повсюду java.net API или как идентификаторы хостов, или снабжают идентификаторы конечной точки сокетом.

InetAddress class является абстракцией, представляющей IP (интернет-Протокол) адрес. У этого есть два подкласса:

• Inet4Address для адресов IPv4.
• Inet6Address для адресов IPv6.

Но в большинстве случаев нет никакой потребности иметь дело непосредственно с подклассами, поскольку абстракция InetAddress должна покрыть большую часть необходимой функциональности.

О IPv6

Не у всех систем есть поддержка протокола IPv6, и в то время как сетевой стек Java попытается обнаружить это и использовать это прозрачно когда доступный, также возможно отключить свое использование с системным свойством. В случае, где IPv6 не доступен, или явно отключенный, Inet6Address не являются допустимыми параметрами за большинство объединяющихся в сеть операций больше. В то время как методы как InetAddress.getByName(java.lang.String) как гарантируют, не возвратят Inet6Address, ища имена хоста, это возможно, передавая литералы, чтобы создать такой объект. Когда, большинство методов, когда вызвано с Inet6Address выдаст Исключение.

Сокеты

Сокеты являются средствами установить линию связи между машинами по сети. java.net пакет обеспечивает 4 вида Сокетов:

• Socket клиентский API TCP, и будет обычно использоваться, чтобы соединиться с удаленным узлом.
• ServerSocket API сервера TCP, и будет обычно принимать соединения от клиентских сокетов.
• DatagramSocket API конечной точки UDP и используется, чтобы передаться и получить пакеты дейтаграммы.
• MulticastSocket подкласс DatagramSocket используемый, имея дело с многоадресными группами.

Отправка и получение с сокетами TCP делаются через InputStreams и OutputStreams, который может быть получен через Socket.getInputStream() и Socket.getOutputStream() методы.

Интерфейсы

NetworkInterface class обеспечивает API, чтобы просмотреть и запросить все объединяющиеся в сеть интерфейсы (например, соединение Ethernet или конечная точка PPP) локальной машины. Именно через то, который class можно проверить, конфигурируется ли какой-либо из локальных интерфейсов, чтобы поддерживать IPv6.

Отметьте, все реализации приспосабливания должны поддерживать по крайней мере один NetworkInterface объект, который должен или быть соединен с сетью, или быть "петлевым" интерфейсом, который может только связаться с объектами на той же самой машине.

Высокоуровневый API

Много классов в java.net пакете действительно предусматривают много более высокого уровня абстракции и учитывают легкий доступ к ресурсам на сети. Классы:

• URI class, представляющий Универсальный Идентификатор ресурса, как определено в RFC 2396. Как имя указывает, это - только Идентификатор и не обеспечивает непосредственно средства получить доступ к ресурсу.
• URL class, представляющий Универсальный Локатор Ресурса, который является и более старым понятием для URI и средством получить доступ к ресурсам.
• URLConnection создается из URL и линия связи, используемая, чтобы получить доступ к ресурсу, на который указывает URL. Этот абстрактный class делегирует большую часть работы к базовым обработчикам протокола как http или https.
• HttpURLConnection подкласс URLConnection и обеспечивает некоторую дополнительную функциональность, определенную для протокола HTTP.

Рекомендуемое использование должно использовать URI чтобы идентифицировать ресурсы, затем преобразуйте это в a URL когда пора получить доступ к ресурсу. От того, который URL, можно или получить URLConnection для точной регулировки, или получают непосредственно InputStream.

Вот пример:

URI uri = new URI("http://java.sun.com/");
URL url = uri.toURL();
InputStream in = url.openStream();

Обработчики протокола

Как упомянуто, URL и URLConnection полагаются на обработчики протокола, которые должны присутствовать, иначе Исключение выдается. Это - существенное различие для URI, которые только идентифицируют ресурсы, и поэтому не должны иметь доступа к обработчику протокола. Так, в то время как возможно создать URI с любым видом схемы протокола (например. myproto://myhost.mydomain/resource/), подобный URL попытается инстанцировать обработчика для указанного протокола; если это не будет существовать, то исключение будет выдано.

По умолчанию обработчики протокола загружаются динамически из расположения значения по умолчанию., однако, возможно добавить к пути поиска, устанавливая java.protocol.handler.pkgs системное свойство. Например, если это устанавливается в myapp.protocols, тогда код URL попытается, в случае http, сначала загрузиться myapp.protocols.http.Handler, тогда, если это перестало работать, http.Handler от расположения значения по умолчанию.

Отметьте, что Обработчик class должен быть подклассом абстрактного class URLStreamHandler.

Дополнительная Спецификация

• Сети Системных Свойств

##### FILL IN ANY SPECS NEEDED BY JAVA COMPATIBILITY KIT #####

• ##### REFER TO ANY FRAMEMAKER SPECIFICATION HERE #####

Related Documentation

For overviews, tutorials, examples, guides, and tool documentation, please see:

• ##### REFER TO NON-SPEC DOCUMENTATION HERE #####

-->

С тех пор:

JDK1.0