|
Spec-Zone .ru
спецификации, руководства, описания, API
|
@FunctionalInterface public interface AutoCloseable
| Модификатор и Тип | Метод и Описание |
|---|---|
void |
close()
Завершения этот ресурс, оставляя любые базовые ресурсы.
|
void close()
throws Exception
try- оператор с ресурсами. В то время как этот метод интерфейса, как объявляют, бросает Exception, разработчики строго поощряются объявить конкретные реализации close метод, чтобы выдать более определенные исключения, или выдать исключение вообще, если операция закрытия не может перестать работать.
Случаи, где операция закрытия может перестать работать, требуют внимательного отношения разработчиками. Строго советуют оставить базовые ресурсы и внутренне отметить ресурс как закрыто до выдачи исключения. close метод вряд ли будет вызван не раз и таким образом, это гарантирует, что средства высвобождаются своевременно. Кроме того это уменьшает проблемы, которые могли возникнуть, когда ресурс переносится, или обертывается другим ресурсом.
Разработчикам этого интерфейса также строго советуют не иметь close бросок метода InterruptedException. Это исключение взаимодействует с прерванным состоянием потока, и проступок времени выполнения, вероятно, произойдет если InterruptedException подавляется. Более широко, если это заставило бы проблемы для исключения быть подавленными, AutoCloseable.close метод не должен бросить это.
Отметьте это в отличие от этого close метод Closeable, это close метод не обязан быть идемпотентом. Другими словами, вызов этого close у метода не раз может быть некоторый видимый побочный эффект в отличие от этого Closeable.close который обязан не иметь никакого эффекта если вызвано не раз. Однако, разработчики этого интерфейса строго поощряются сделать их close идемпотент методов.
Exception - если этот ресурс не может быть закрыт
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92