Создание богатых клиентов с JacpFX и JavaFX2

JacpFX

Проект JacpFX (Java Asynchronous Client Platform) — это платформа для создания Rich Client (Desktop и / или Web) в стиле MVC с использованием JavaFX 2 , Spring и Actor-подобного подхода. Он предоставляет простой API для создания рабочего пространства, перспектив и компонентов; общаться со всеми частями и легко составить клиентское приложение.

Что JacpFX предлагает вам?

• Реализовать масштабирование и адаптировать Rich Client к небольшому и простому API (~ 120 Кб) в Java
• Полностью интегрирован с Spring и JavaFX 2
• Добавить / переместить / удалить определенные компоненты во время выполнения в вашем пользовательском интерфейсе
• Создайте базовый макет в перспективе и определите «заполнители» для пользовательского интерфейса компонента.
• Обработка компонентов вне потока приложения FX
• Методы «handle» выполняются в рабочем потоке, а метод «posthandle» выполняется потоком приложения FX
• Компоненты обратного вызова без учета состояния и состояния
• Аутсорсинг длительных процессов и вычислений
• Легко обрабатывать асинхронные процессы
• Нет необходимости в явных потоках или таких вещах, как Runtime.invoke ()
• Общаться через асинхронные сообщения
• Нет общих данных между компонентами
• Неизменные сообщения

Следующая статья даст вам краткое введение в JacpFX и о том, как создавать с его помощью Rich Clients на основе JavaFX 2. Показанный здесь пример клиента — это (псевдо) менеджер контактов, который вы можете попробовать здесь: http://developer.ahcp.de/demo/JACPFX2Demo.html ; Полный исходный код вы можете скачать здесь: http://code.google.com/p/jacp/downloads/list

Предварительно требования :

Для запуска демонстрационного приложения должна быть установлена ​​допустимая среда выполнения JavaFX2 (в настоящее время доступна только для Windows). Для компиляции прилагаемого демонстрационного кода предполагается установить JavaFX2 SDK (также доступный для Mac и Linux) и Apache Maven. Смотрите подробные инструкции в конце этой статьи:

Изображение 1: Выберите категорию в первый раз, и клиент попросит вас создать 250 000 контактов. Хотя эти контакты создаются и постепенно добавляются в представление таблицы, вы можете выбрать следующую категорию, перейти к следующей странице таблицы, просмотреть данные диаграммы потребителей или просто отредактировать контакт. Имейте в виду, что в коде демо-клиента не использовались явные потоки

Приложение — Структура

Приложение JacpFX состоит из модуля запуска приложений, рабочей среды, минимум одной перспективы и хотя бы одного компонента. В примере клиента используются три компонента UI и три компонента без обратного вызова (обратный вызов) для создания данных и имитации доступа к тяжелым данным.

Приложение — Launcher (AFX2SpringLauncher)

Приложение — средство запуска — это основной класс вашего приложения, в котором вы определяете контекст Spring. JacpFX-приложение использует декларацию xml для определения иерархии приложения и всех метаданных, таких как «идентификатор компонента» и «цель выполнения». Spring main.xml находится в каталоге ресурсов и будет объявлен в конструкторе средств запуска:

Листинг 1: средство запуска приложений

Приложение — Workbench (AFX2Workbench)

Рабочая среда является корневым узлом пользовательского интерфейса приложения JacpFX. Здесь вы настраиваете приложение, устанавливаете разрешение, определяете панели инструментов, меню и имеете ссылку на стадию JavaFX.

Листинг 2: Рабочая среда

Перспектива (AFX2Perspective)

Задача перспективы состоит в том, чтобы предоставить компоновку текущего представления и зарегистрировать корневой и все конечные узлы представления. Конечные узлы являются «целью выполнения» (контейнером) для всех компонентов, связанных (внедренных) с этой перспективой. Демо-перспектива в основном определяет две SplitPanes и регистрирует их как «target-target» для отображения содержимого ContactTreeView слева; ContactTableView вверху справа и ContactChartView внизу справа.

Рисунок 2: Три цели, определенные перспективой в демонстрации

Листинг 3: Перспектива

UI-Компоненты (AFX2Component)

AFX2Components — это фактические компоненты пользовательского интерфейса в приложении JacpFX, которые отображаются как компоненты JavaFX. Демонстрация определяет левый ( ContactTreeView ), главный-верхний ( ContactTableView ) и главный-нижний ( ContactDemoChartView ) AFX2Component . Компонент JacpFX имеет четыре метода для реализации; «OnStartComponent» и «onTearDownComponent», а также «handleAction» и «postHandleAction». Пока «handleAction» выполняется в рабочем потоке, «postHandle» запускается в потоке приложения FX .

Изображение 3: Компонентный жизненный цикл компонента AFX2

Вы можете использовать ленивую инициализацию компонентов и выключить или перезапустить компоненты, если хотите.

Листинг 4: ContactTreeView (вид слева)

Метод handleAction в листинге 4 используется для инициализации пользовательского интерфейса компонента. В акции «postHandle» демо были добавлены новые контакты; contactList привязан к существующему TreeView, поэтому вы не можете обновить его вне потока приложения FX и поэтому должны использовать метод «postHandle».

Компоненты обратного вызова

Компоненты обратного вызова JacpFX не являются компонентами UI / службы. Подобно AFX2Component , у них есть метод с именем «handle», который выполняется в рабочем потоке. Результатом может быть объект любого типа, и он будет автоматически доставлен обратно в вызывающий компонент или перенаправлен в любой другой компонент.

В этих типах компонентов вы выполняете долгосрочные задачи, вызываете сервисные вызовы или просто извлекаете данные из хранилища. JacpFX предоставляет два типа компонентов обратного вызова: « AStatelessCallbackComponent » и (с сохранением состояния) « ACallbackComponent ». Демо-клиент использует компонент « ACallbackComponent » для генерации случайных данных диаграммы для выбранного контакта в таблице.

Для генерации большого количества контактов задействованы два « AStatelessCallbackComponents ». Один компонент делит общую сумму на куски, а второй просто создает контакты. Результат будет отправлен непосредственно в компонент пользовательского интерфейса и добавлен в таблицу.

обмен сообщениями

Обмен сообщениями является основой JacpFX Framework. JacpFX использует асинхронный обмен сообщениями для уведомления компонентов и перспектив вашего приложения.

Поток сообщений для создания начального объема данных для категории в демонстрационном приложении выглядит следующим образом:

Рисунок 4: Поток сообщений для создания начального объема данных в демонстрационном приложении

Состояние компонента JacpFX всегда изменяется сообщениями. Если задача должна быть обработана в фоновом потоке, вы просто отправляете сообщение компоненту и обрабатываете работу методом «handle». Результат может быть отправлен обратно в компонент вызывающей стороны или обработан потоком приложения FX в методе «postHandle» (в случае компонентов пользовательского интерфейса). Вы всегда должны избегать выполнения длительных задач в потоке приложения FX; вместо этого вызовите вашу сервисную или DB-операцию внутри метода «handle».

JacpFX отличается между двумя типами сообщений: локальным и глобальным .

Локальные сообщения

Для запуска локального сообщения просто получите прослушиватель

только с одним аргументом — само сообщение. Этот слушатель может быть назначен любому JavaFX eventHandler (например, onMouseEvent и т. Д.) Или его можно запустить, вызвав

Глобальные сообщения

С глобальными сообщениями вы общаетесь с другими зарегистрированными компонентами. Компоненты обратного вызова отвечают на сообщение по умолчанию, поэтому вам не нужно явно создавать ответное сообщение — вы также можете это сделать. Обмен сообщениями является предпочтительным способом обмена данными между компонентами и запуска задач. Подобно локальным сообщениям, вы создаете экземпляр слушателя, но с явным идентификатором цели:

Создайте демонстрационное приложение из исходного кода

Зарегистрируйте JavaFX в вашем локальном репозитории Maven

Все JacpFX-проекты являются проектами Maven и требуют JavaFX 2 (jfxrt.jar). Некоторые включают JavaFX 2 в качестве системной зависимости, но мы предпочли зарегистрировать jfxrt.jar в локальном репозитории. Для создания развертываемых файлов (jnlp и html) вам дополнительно необходимо зарегистрировать Java-задачи Ant-Tasks (ant-javafx.jar). Для этого перейдите в $ {SDK-home} / rt / lib и введите:

Затем скопируйте каталог «bin» (в linux i386) в вашу папку .m2 \ repository \ com \ oracle \ javafx-runtime . Затем перейдите в каталог $ {SDK-home} / tools и введите:

Построить проект

Чтобы собрать проект, просто разархивируйте папку проекта и введите mvn package . Файлы jar, jnlp и html создаются в каталоге $ {projectHome} / target / deploy . Чтобы создать проект Eclipse, просто введите mvn eclipse: eclipse .

Что будет дальше?

JacpFX в настоящее время в версии 1.0; после многих лет создания прототипов с Echo3 и Swing, JacpFX является первым стабильным выпуском, основанным на JavaFX 2 и определенным планом выпуска. Вы можете найти подробную документацию на вики-странице проектов ( http://code.google.com/p/jacp/wiki/Documentation ). Наш план выпуска (также расположенный на вики) определяет версию 1.1 в июне этого года. Основными изменениями будут поддержка аннотаций и официальная поддержка FXML (также вы уже можете использовать FXML). Обратная связь всегда приветствуется, поэтому не стесняйтесь обращаться к нам.

Справка: Создание богатых клиентов с помощью JacpFX и JavaFX2 от нашего партнера по W4G Энди Мончека .