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