Пакет java.net

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

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

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

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

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

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

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

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

• URI класс, представляющий Универсальный Идентификатор ресурса, как определено в RFC 2396. Как имя указывает, это - только Идентификатор и не обеспечивает непосредственно средства получить доступ к ресурсу.
• URL класс, представляющий Универсальный Локатор Ресурса, который является и более старым понятием для URI и средством получить доступ к ресурсам.
• URLConnection создается из URL и линия связи, используемая, чтобы получить доступ к ресурсу, на который указывает URL. Этот абстрактный класс делегирует большую часть работы к базовым обработчикам протокола как http или протокол передачи файлов.
• 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 от расположения по умолчанию.

Отметьте, что класс Обработчика должен быть подклассом абстрактного класса 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