Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface Worker<V>
Рабочий является объектом, который выполняет некоторую работу в одном или более фоновых потоках, и кто состояние, заметно и доступен приложениям JavaFX и применим от основного потока Приложения JavaFX. Этот интерфейс прежде всего реализуется обоими Task
и Service
, обеспечение общего API и среди классов, который облегчает для библиотек и платформ предоставлять рабочим, которые работают хорошо, разрабатывая пользовательские интерфейсы.
Рабочий может, или, возможно, не является допускающим повторное использование, в зависимости от реализации. A Task
, например, не является допускающим повторное использование в то время как a Service
.
У Рабочего есть четко определенный жизненный цикл. Каждый Рабочий начинает в Worker.State.READY
состояние. Когда Рабочий был запланирован для работы (например, когда Служба Service.start()
метод вызывают), он переходится к Worker.State.SCHEDULED
. Даже Рабочие, которые технически не планируются, но сразу запускаются (такой как с FutureTask.run()
) перейдет через Worker.State.SCHEDULED
продвигающийся к Worker.State.RUNNING
состояние.
Когда Рабочий фактически выполнит его работу, состояние перейдется к Worker.State.RUNNING
. Если Рабочий будет обычно завершаться, то это закончится в Worker.State.SUCCEEDED
состояние, и результат Рабочего будут установлены как value
свойство. Если однако Исключение произойдет во время выполнения Рабочего, то состояние будет установлено в Worker.State.FAILED
и exception
свойство будет установлено в Исключение, которое произошло.
В любое время до заключения Рабочего (то есть, если состояние уже не Worker.State.SUCCEEDED
или Worker.State.FAILED
) разработчик может вызвать cancel()
метод. Если вызвано, Рабочий прекратит выполнение (если возможный, включая использование Thread.interrupt) и состояние, измененное на Worker.State.CANCELLED
.
Единственное допустимое состояние начала для Рабочего Worker.State.READY
, и допустимые конечные состояния Worker.State.CANCELLED
, Worker.State.SUCCEEDED
, и Worker.State.FAILED
. running
свойство устанавливается в истину, когда состояние также Worker.State.SCHEDULED
или Worker.State.RUNNING
.
Продвижение Рабочего может контролироваться через три различных свойства, totalWork
, workDone
, и progress
. Эти свойства устанавливаются фактической реализацией интерфейса Рабочего, но могут наблюдаться любым. workDone
число между-1 (значение неопределенного продвижения) и totalWork
, включительно. Когда workDone == totalWork
progress
будут 100 % (или 1). totalWork
будет число между-1 и Лонг. MAX_VALUE, включительно. Продвижение будет любой-1 (значение неопределенного), или значение между 0 и 1, включительно, представляя 0 % через 100 %.
Рабочий, который находится в Worker.State.READY
или Worker.State.SCHEDULED
состояния будут всегда иметь workDone
и progress
набор к-1. Рабочий, который находится в Worker.State.SUCCEEDED
состояние будет всегда иметь workDone == totalWork
и progress == 1
. В любом другом состоянии значения для этих свойств могут быть любым значением в своих соответствующих допустимых диапазонах.
Ввести | Свойство и Описание |
---|---|
ReadOnlyObjectProperty<java.lang.Throwable> |
исключение
Получает ReadOnlyObjectProperty, представляющий любое исключение, которое произошло.
|
ReadOnlyStringProperty |
сообщение
Получает ReadOnlyStringProperty, представляющий сообщение.
|
ReadOnlyDoubleProperty |
продвижение
Получает ReadOnlyLongProperty, представляющий продвижение.
|
ReadOnlyBooleanProperty |
выполнение
Получает представление ReadOnlyBooleanProperty, работает ли Рабочий.
|
ReadOnlyObjectProperty<Worker.State> |
состояние
Получает ReadOnlyObjectProperty, представляющий текущее состояние.
|
ReadOnlyStringProperty |
title
Получает ReadOnlyStringProperty, представляющий title.
|
ReadOnlyDoubleProperty |
totalWork
Получает ReadOnlyLongProperty, представляющий максимальный объем работы, который должен быть сделан.
|
ReadOnlyObjectProperty<V> |
значение
Получает ReadOnlyObjectProperty, представляющий значение.
|
ReadOnlyDoubleProperty |
workDone
Получает ReadOnlyLongProperty, представляющий текущее продвижение.
|
Модификатор и Тип | Интерфейс и Описание |
---|---|
static class |
Рабочий. Государство
Состояние Рабочего.
|
Модификатор и Тип | Метод и Описание |
---|---|
boolean |
cancel()
Завершает выполнение этого Рабочего.
|
ReadOnlyObjectProperty<java.lang.Throwable> |
exceptionProperty()
Получает ReadOnlyObjectProperty, представляющий любое исключение, которое произошло.
|
java.lang.Throwable |
getException()
Указывает на исключение, которое произошло, в то время как Рабочий работал, если любой.
|
java.lang.String |
getMessage()
Связали сообщение с текущим состоянием этого Рабочего.
|
double |
getProgress()
Указывает на текущее продвижение этого Рабочего с точки зрения полного процента.
|
Рабочий. Государство |
getState()
Определяет текущее состояние этого Рабочего.
|
java.lang.String |
getTitle()
Дополнительный title, который должен быть связан с этим Рабочим.
|
double |
getTotalWork()
Указывает на максимальное значение для
workDoneProperty() свойство. |
V |
getValue()
Определяет значение, или результат, этого Рабочего.
|
double |
getWorkDone()
Указывает на текущий объем работы, который был завершен.
|
boolean |
isRunning()
Истина, если состояние или ПЛАНИРУЕТСЯ или ВЫПОЛНЕНИЕ.
|
ReadOnlyStringProperty |
messageProperty()
Получает ReadOnlyStringProperty, представляющий сообщение.
|
ReadOnlyDoubleProperty |
progressProperty()
Получает ReadOnlyLongProperty, представляющий продвижение.
|
ReadOnlyBooleanProperty |
runningProperty()
Получает представление ReadOnlyBooleanProperty, работает ли Рабочий.
|
ReadOnlyObjectProperty<Worker.State> |
stateProperty()
Получает ReadOnlyObjectProperty, представляющий текущее состояние.
|
ReadOnlyStringProperty |
titleProperty()
Получает ReadOnlyStringProperty, представляющий title.
|
ReadOnlyDoubleProperty |
totalWorkProperty()
Получает ReadOnlyLongProperty, представляющий максимальный объем работы, который должен быть сделан.
|
ReadOnlyObjectProperty<V> |
valueProperty()
Получает ReadOnlyObjectProperty, представляющий значение.
|
ReadOnlyDoubleProperty |
workDoneProperty()
Получает ReadOnlyLongProperty, представляющий текущее продвижение.
|
getState()
getValue()
getException()
getWorkDone()
getTotalWork()
getProgress()
isRunning()
getMessage()
getTitle()
Worker.State getState()
ReadOnlyObjectProperty<Worker.State> stateProperty()
getState()
V getValue()
ReadOnlyObjectProperty<V> valueProperty()
getValue()
java.lang.Throwable getException()
null
, нет никакого известного исключения, даже если состояние является ОТКАЗАВШИМ. Если это свойство не null
, это будет наиболее вероятно содержать исключение, которое описывает причину отказа.ReadOnlyObjectProperty<java.lang.Throwable> exceptionProperty()
getException()
double getWorkDone()
totalWorkProperty()
, progressProperty()
ReadOnlyDoubleProperty workDoneProperty()
getWorkDone()
double getTotalWork()
workDoneProperty()
свойство. totalWork или будет-1 (указание, что объем работы, чтобы сделать неопределенен), или это будет ненулевое значение, меньше чем или равное Лонгу. MAX_VALUE.workDoneProperty()
, progressProperty()
ReadOnlyDoubleProperty totalWorkProperty()
getTotalWork()
double getProgress()
workDoneProperty()
, totalWorkProperty()
ReadOnlyDoubleProperty progressProperty()
getProgress()
boolean isRunning()
ProgressIndicator
, Вы будете обычно связывать видимость ProgressIndicator к рабочему свойству Рабочего, и продвижение ProgressIndicator к свойству продвижения Рабочего.ReadOnlyBooleanProperty runningProperty()
isRunning()
java.lang.String getMessage()
ReadOnlyStringProperty messageProperty()
getMessage()
java.lang.String getTitle()
ReadOnlyStringProperty titleProperty()
getTitle()
boolean cancel()
Copyright (c) 2008, 2011, Oracle и/или его филиалы. Все права защищены. Использование подвергается