Thursday, January 9, 2020

Drombler FX: Version 1.0 released

I've recently released the version v1.0 of Drombler FX - the modular application framework for JavaFX.

With this release I changed the version policy. I'm using now the major version part as well to make it easier to distinguish between major requirement changes such as the Java version:
  • v1.x: Java SE 8 and JavaFX 8 based
  • v2.x (future): Java SE 11 and JavaFX 11 based (likely)
The released JARs contain the Automatic-Module-Name Manifest entry to make the transition to Java SE 11 smoother.

For this v1.0 release I've added Javadoc to all published classes and members of  Drombler FX, Drombler ACP (except the generated JAXB classes) and Drombler Commons. 

There's now also a new Extensions tutorial trail.

Some APIs were fixed and some clean-ups were added as well.

Because some code has been moved, please note that some of the packages and Maven dependencies changed, too.

Please note especially, that localized texts are now expected in a separate properties file in the same package and with the same name as the annotated classes by default, and not in the package Bundle.properties file anymore (this can be configured per annotated class, though).
This makes it easier to move annotated classes to other packages and to see which texts are still in use.

With this v1.0 release out I will now start the work to migrate Drombler FX to Java SE 11 and JavaFX 11.

Additional Information

Projects like this one need to be build by a community working together to be really successful. There are several ways how you can contribute to this project. Contributions are highly welcome! See the "How to Contribute"-page for more information.

You can find the complete list of fixed issues here: https://github.com/Drombler/drombler-fx/issues?q=milestone%3A1.0


There's a Getting Started page which explains how to create, build and run a Drombler FX sample application with a few simple steps.


The following table provides you an overview of the different Drombler components, links to the modules, which are available from Maven Central, and links to the Javadocs.
  


Name Modules
(incl. Maven Coordinates)
Javadoc Description
Drombler FX Modules Javadoc Drombler FX, the modular application framework for JavaFX based on:
Drombler ACP Modules Javadoc Drombler Abstract Client Platform (ACP) is an abstract, GUI-toolkit agnostic, modular Rich Client Platform based on:
Drombler Commons Modules Javadoc Drombler Commons is a collection of reusable libraries and frameworks. They ship with OSGi meta data but don't require an OSGi environment.


If you find issues or have enhancement requests, you can file a ticket here: https://github.com/Drombler/drombler-fx/issues.
 

Sunday, July 7, 2019

Why apps should not render identity provider web sites in-app

Nowadays there are several public identity providers (IdP) such as Google accounts, Facebook accounts, GitHub accounts or SwissId accounts, just to name a few.

More and more mobile apps are starting to accept one or more of these IdPs as a replacement or as an addition to app specific user accounts to authenticate their users.

A common protocol to accomplish this is the OAuth 2.0 / OpenId Connect 1.0 protocol. In simple terms, here is how this protocol works:

  1. The app or web site, which needs to authenticate a user, provides a button/ link to the web site of the IdP and adds a redirect link to the request.
  2. When the user clicks the button/ link, the web site of the IdP gets opened.
  3. As the users know and trust the IdP, they will enter their user names and passwords on that site. The original app will never see their passwords.
  4. On completion of the IdP process, (simplified) the IdP will send a token to the redirect link the original app/ web site passed as parameter to the authentication request link.
  5. The app / web site can then use this token to e.g. check the rights (roles) of the user (authorization).

Now, unfortunately, there are several apps which open the IdP web sites (step 2) "in-app", using a web view like component to render the IdP web site directly inside their apps (mostly for user experience reasons, I guess, so the user doesn't have to leave their app).

While this technically works, there is now no way for the user at step 3 to tell if the request for authentication is genuine or if this is a phishing attack by the app. There is also no way for the user to tell, if a developer wanted to do something "clever", which accidentally compromises the sensitive password. It breaks the OAuth 2.0 / OpenId Connect 1.0 concept that the original app will never see the users' passwords.

It doesn't help that the rendered web site shows the correct name of the IdP and it doesn't help either to show the URL e.g. at the top the app, as this is what a phishing app would do, too, wouldn't it?

As long as the request for authentication is processed in the original app, the user cannot tell if the request is genuine.

So by trying to increase the user experience by using an in-app web view component, you take away any possibilty for the user to check who actually sees the entered password.

Bottom line:

Dear app developers: please, never use an in-app web view component for authentication requests to third party IdPs. Use the browser or the IdP app instead, so the user has a chance to check the genuineness of the request.


There are already many companies and organizations who try to sensibilize users how they can detect phishing attacks, and checking the URL in the browser is one of the most effective detection mechanisms.

So please don't dilute these campaigns by excluding options for the users to perform these checks.

I think especially apps from the big companies should set a good example here, which at the time of writing, unfortunately, is not always the case.

And I guess it also would be good if review processes (e.g. such as the one from Apple to accept an application for their app store) would check that these kind of authentication don't take place "in-app".

Sunday, February 10, 2019

News from the Software Smithy: Version 2.0 released

SoftSmithy news: after the release v1.1.1 last year (I didn't blog about it), I've recently released the version v2.0 of the SoftSmithy Utility Library and the SoftSmithy Development Utility Library.

As announced in the blog post about the release v1.0, v2.0 is still based on Java SE 8, but requires JUnit 5 when working with the JUnit helper classes.

This release also introduces an intitial version of the new Context Property Framework, which allows to access properties in a type-safe way accross mulitple map-like contexts.

The newly added ThreadLocalStorage allows to store properties in a ThreadLocal storage and can be used together with the new Context Property Framework.


This very small framework is especially useful when you have to pass around properties e.g. from / to filters and interceptors which use different APIs to manage context properties.

Note that for easier version management the version of the SoftSmithy Development Utility Library is aligned with the version of the SoftSmithy Utility Library. As the SoftSmithy Development Utility Library has a dependency on the SoftSmithy Utility Library it's recommended to use the same version of both libraries!


You can find the latest Javadoc here: Javadoc

I deployed the artifacts (including the source and javadoc artifacts) to Maven Central.

Monday, November 5, 2018

News from the Software Smithy: Version 1.0 released

SoftSmithy news: after the releases v0.8 and v0.9 last year (I didn't blog about those), I've recently released the version v1.0 of the SoftSmithy Utility Library and the SoftSmithy Development Utility Library.

With this release I changed the version policy. I'm using now the major version part as well to make it easier to distinguish between major requirement changes such as the Java version and the JUnit version (required by the JUnit helper classes):
  • v1.x: Java SE 8 and JUnit 4 based
  • v2.x (future): Java SE 8 and JUnit 5 based (likely)
  • v3.x (future): Java SE 11 and JUnit 5 based (likely)
The released JARs contain the Automatic-Module-Name Manifest entry to make the transition to Java SE 11 smoother.

Note that for easier version management the version of the SoftSmithy Development Utility Library is aligned with the version of the SoftSmithy Utility Library. As the SoftSmithy Development Utility Library has a dependency on the SoftSmithy Utility Library it's recommended to use the same version of both libraries!

You can find the lates Javadoc here: Javadoc

I deployed the artifacts (including the source and javadoc artifacts) to Maven Central.

Monday, October 15, 2018

Drombler FX: Version 0.12 and 0.13 released

Since introducing a modular StatusBar and ProgressMonitor earlier this year, I've released v0.12 and v.013 of Drombler FX - the modular application framework for JavaFX.

In this releases some of the Drombler FX/ ACP start-up code has been moved to Drombler Commons.
This allows also non-Drombler FX/ ACP applications, such as the Drombler JStore Client Agent, to reuse start-up code such as:
Because the code has been moved, please note that some of the packages and Maven dependencies changed as well.

Please also note that org.drombler.commons.fx.scene.GraphicFactory moved to org.drombler.commons.client.graphic.GraphicFactory with these releases.

 

Small Enhancements

There are small enhancements to work with directories, data handlers, collection bindings and TreeViews. 

Please check the documentation to learn more about them.


Additional Information

Projects like this one need to be build by a community working together to be really successful. There are several ways how you can contribute to this project. Contributions are highly welcome! See the "How to Contribute"-page for more information.

You can find the complete list of fixed issues here: https://github.com/Drombler/drombler-fx/issues?q=milestone%3A0.13


There's a Getting Started page which explains how to create, build and run a Drombler FX sample application with a few simple steps.


The following table provides you an overview of the different Drombler components, links to the modules, which are available from Maven Central, and links to the Javadocs.
  


Name Modules
(incl. Maven Coordinates)
Javadoc Description
Drombler FX Modules Javadoc Drombler FX, the modular application framework for JavaFX based on:
Drombler ACP Modules Javadoc Drombler Abstract Client Platform (ACP) is an abstract, GUI-toolkit agnostic, modular Rich Client Platform based on:
Drombler Commons Modules Javadoc Drombler Commons is a collection of reusable libraries and frameworks. They ship with OSGi meta data but don't require an OSGi environment.


If you find issues or have enhancement requests, you can file a ticket here: https://github.com/Drombler/drombler-fx/issues.
 

Monday, September 24, 2018

Drombler JStore News: JRE REST service and JAP packaging

The work on the Drombler JStore, the next generation of Java application deployments, goes on.

The way an application is identitfied has been changed to reuse the Maven GA(V) coordinates: groupId + artifactId
The packaging format is fixed (currently it's called "jap") and together with a version an application package can be uniquely identified.

There are now 4 REST services:
  • search for application updates (currently uses mock data)
  • new: download an application (currently mocked)
  • new: search for JRE updates (all recent versions of Oracle Java SE 8 and 10 supported!)
  • new: download a JRE (Swagger does not work yet here, but the service can successfully be called by the Drombler JStore Client Agent)
The search services already get called by the Drombler JStore Client (JavaFX based rich client).

The Drombler JStore backend service is now open sourced, too. This allows to discuss how we want to implement things and opens up for contributions.

The following JSON shows how we could manage JRE versions:



You can find the complete file here. There is also a JSON Schema.

Also work has gone on with the application desriptor specification. 
Here is a sample:


You can find the accordant JSON Schema here.

The JAP Maven Plugin can generate an application descriptor for you. You can find the Maven Plugin documentation here.

The project is moving forward and contributions are highly welcome! The current code base is not very complex. You should be able to get started quickly. Please don't hesitate to ask me, if you have any questions.

We can use your inputs especially in the following areas:

  • What should the platform-independent application packaging format and meta data look like to support your applications? What information is needed by the agent? What information is only needed by the discovery feature of the rich client?
  • Help us to make sure the agents have the necessary native OS integration to support your applications.
  • Help us to create a great user experience with the rich client (some UX and JavaFX skills required)
  • Help translate the texts of the rich client to different languages (i18n/ l10n)
  • Help us to get the basic features of the agent right
  • File enhancement requests for the various components
  • Join the discussions in the issues or on Gitter.
  • Help with the documentation (GitHub Pages, README files)

Since the proposed solution requires a backend, this will also require some resources to run the service. Any donations are welcome!

Saturday, June 16, 2018

The next generation of Java application deployments

A lot is going on in the Java world. So let's first have a look at where we currently are.

Oracle discontinues Java Web Start with Java 11

After discontinuing the Applet technology, which required browser plug-ins, Oracle now announced that they will also discontinue the Java Web Start technoloy.

Java Web Start, however, was a great way to easily deploy Java applications. It made sure Java application deployments don't fall too far behind the instant deployment feature of web applications - a point which already let many companies to choose web applications over Java based applications.

With Java Web Start gone, it will become harder again to compete with web applications, if we don't find a good alternative (please read on).

Oracle changed to a biannual major Java release cadence

Every 6 month there will be now a new "major" Java version, though the term "major" likely won't be used anymore and differences will be smaller than with the 2-3 year cadence (see Java 8 -> Java 9 vs Java 9 -> Java 10).

With every "major" release the support of the previous release seems to be discontinued.

Every 3 years there will be a LTS (Long Term Support) version, starting with Java 11 targeted for September 2018 (there is a small video and a FAQ about this from Oracle).

As far as I understand (please correct me if I'm wrong) you will need to buy this LTS. If you don't, then it's recommended to upgrade to the next major version or find another distributor which provides updates (more on this see below).

Interestingly and to some surprise, the long awaited Java SE 9 release with the new module system didn't become a LTS version and already has been superseded by Java SE 10.

Oracle also mentions that developers often package the JRE with their applications nowadays. End users should not need to install a JRE anymore.

Oracle and OpenJDK binaries

While Sun started to open source the JDK with the OpenJDK project back in 2006 and Oracle continued this process, there are still some differences between the OpenJDK builds and the Oracle Java builds.

Now Oracle plans to ship OpenJDK binaries for non-LTS releases and with this shift they also plan to finally close those technical differences, which currently still exist.

Once these differences are closed, this will make projects such as AdoptOpenJDK much more appealing, as it seems they will provide free updates for LTS versions in the future.

Modular JRE and JLink

Together with the JPMS (Java Platform Module System), which modularizes the JRE and can be used to modularize applications, Java 9 introduced a new tool called JLink.

JLink allows you to create custom runtime images which only consists of your application modules and those JRE modules which your application requires.

The result is likely a smaller runtime image which uses less resources than using a default JRE.

This should also make Java more appealing to IoT devices.

JavaFX

Since JavaFX 2.2 and Java SE 7 update 6, JavaFX has been included in Oracle's JDK. With JavaFX 8 and Java SE 8 the version has been aligned and JavaFX has become available on the default classpath.

Now Oracle announced (see the link at the top) that with Java SE 11 JavaFX will be removed again from the JDK.

With a modularized JRE it might be more natural to let feature modules have their own cycles.

But since JavaFX also includes native parts, it seems to me WORA (Write Once, Run Anywhere) will become a bit trickier - at least the packaging part of JavaFX applications.

Please read on for a possible solution.

The Java Packager Tool

JavaFX also introduced a new tool to create platform-specific native packages with an embedded JRE. With JavaFX 8 the tool has been added to the JDK as the javapackager tool.

Since Java SE 9 the javapackager tool integrates with the jlink tool.

In Java SE 11 the javapackager tool will be removed again from the JDK along with JavaFX.

There is a JEP request (JDK Enhancement Proposal) for a new jpackager tool, however.

While I think we do need a tool such as javapackager/ jpackager, javapackager and the proposed jpackager also have some major drawbacks:
  • no cross-compilation support: You have to create the native packages on the target platforms, e.g. msi-packages on Windows, deb-packages on Linux. Creating a one-click release pipeline is non-trivial.
  • platform specific configurations: Each native package has slightly different requirements.
  • no automatic security updates: The users have to rely on the application vendors to ship a new application version which contains a JRE with the latest security fixes (though not all security bugs might affect all applications in the same way).
  • expensive managed deployments: In heavily managed enterprises, where the average users don't have local admin rights and can't install applications themselves, the processes of application deployments tend to get very expensive (up to several thousand CHF per deployment). This is another reason why enterprises nowadays tend to either Java Web Start or to web applications.
  • slow managed deployments: In these heavily managed enterprises, deployments also tend to be slow and can take up to several weeks until the application is deployed to the user machine. This also makes it hard to coordinate frontend deployments with backend deployments and is definitely not DevOps-friendly. This is yet another reason why enterprises nowadays tend to either Java Web Start or to web applications.

Drombler JStore


Given the above mentioned issues with tools such as  javapackager/ jpackager, which create application packages with an embedded JRE, I don't think this is the solution for the majority of Java applications.

On the other hand, I too think that we should not require anymore from end-users to pre-install a JRE, which likely doesn't fit for all applications anyway.

It's however unlikely that Oracle will provide another solution than the jpackager.

If we need something different then it will have to be community driven.

So I'm proposing here a new deployment model with the working title (likely to change): Drombler JStore

At the core of this deployment model is a new application store with first class support for Java applications.

In general, most applications should be able to define a platform-independent package which also describes the dependencies to some managed native components such as the JRE.

The tooling will then make sure that the required native components are available on the end-user machine. The tooling will also configure the environment for the process which starts the application.

The currently proposed solution consists of 4 major software parts.
I've already written a PoC (Proof of Concept) for each of those, which I think can serve as a starting point. Please note that everything is still subject to change.
  • Drombler JStore Client Agent:
    • Current goals:
      • headless background service
      • targets: end-user devices (desktops, NAS, IoT devices,...)
      • download and update applications from Drombler JStore
      • download and update applications using a JNLP-like file
      • download and update native components:
        • JREs (supporting multiple parallel major version installations)
        • custom runtimes created by JLink (supporting multiple parallel major version installations)
        • JavaFX native components?
        • Other native components, e.g. SWT?
      • support Security Manager
      • start applications in a configured environment
      • OS integration: 
        • desktop shortcuts
        • URL protocol registration
        • run as native OS service/ deamon
    • PoC:
      • Access a first Drombler JStore REST service
      • Download a JRE from Oracle
    • GitHub: https://github.com/Drombler/drombler-jstore-client-agent
  • Drombler JStore:
    • Current goals:
      • a free service (backend) run by Drombler
      • Provide access to applications / application updates
      • Provide access to native components and updates (JREs etc.)
      • Search applications
      • Rate applications
      • Comment on applications
      • Register vendors
      • Provide vendor contact options
    • PoC:
      • a first deployed REST service is available (likely to change)
    • Swagger: http://drombler-jstore-staging.us-east-1.elasticbeanstalk.com/swagger-ui.html
  • Drombler JStore Client: 
    • Current goals:
      • JavaFX-based rich client
      • Remote management of multiple Drombler JStore Client Agents
      • Discover applications on Drombler JStore
      • Rate applications on Drombler JStore
      • Comment on applications on Drombler JStore
      • Register vendors
    • PoC:
      • Drombler FX-based rich client
      • Initial multiple Drombler JStore Client Agent management support
      • Plugable feature support
      • Connect to the Drombler JStore REST service
    • GitHub: https://github.com/Drombler/drombler-jstore-client
  • JAP Maven Plugin
    • Current goals:
      • Define a platform-independent application packaging format and meta data
      • Provide Maven tooling
    • PoC
      • Creates a ZIP-based package, which contains the application in a nested ZIP-file. 
    • GitHub: https://github.com/Drombler/jap-maven-plugin 
    • in the future there could be similar solutions for other build tools such as Gradle

Call to the Community

As mentioned above, if we need a different deployment model then it will have to be community driven.

What do think about this proposed solution?
Do you have a need for an alternative deployment model?
Do you think we're running in the right direction with this proposed solution or did we miss something?

Contributions and Donations 

Even for a MVP (Minimal Viable Product) there is quite some work to do.
Contributions are highly welcome! The current code base is not very complex. You should be able to get started quickly. Please don't hesitate to ask me, if you have any questions.

We can use your inputs especially in the following areas:
  • What should the platform-independent application packaging format and meta data look like to support your applications? What information is needed by the agent? What information is only needed by the discovery feature of the rich client?
  • Help us to make sure the agents have the necessary native OS integration to support your applications.
  • Help us to create a great user experience with the rich client (some UX and JavaFX skills required)
  • Help translate the texts of the rich client to different languages (i18n/ l10n)
  • Help us to get the basic features of the agent right
  • File enhancement requests for the various components
  • Join the discussions in the issues or on Gitter.
  • Help with the documentation (GitHub Pages, README files)

Since the proposed solution requires a backend, this will also require some resources to run the service. Any donations are welcome!

Further Readings

Here are some further blog posts about similar topics:

Conclusion

A lot is going on in the Java world. But these changes also provide opportunities for new solutions.

Join and help to shape the next generation of Java application deployments!

Saturday, February 17, 2018

Drombler FX v0.11: modular StatusBar and ProgressMonitor

I recently released v0.11 of Drombler FX - the modular application framework for JavaFX.

This release comes with the integration of two new JavaFX controls.

StatusBar

The first is a rather simple one: a StatusBar. It maintains three lists of elements: leftElements, centerElements and rightElements. The elements are layed out accordingly.
The control is Skinnable and Styleable and can also be used in non-OSGi JavaFX applications. As you might guess, the main intention of this control is to show the user additional information at the bottom of your application.

Drombler FX provides declarative, modular integration of this StatusBar:

The annotated Node sub-class will be added to the according StatusBar elements list at the specified position.

If two adjacent StatusBar elements are positioned in different thousand groups (e.g. position = 910 and position = 1120), a Separator gets automatically registered between them.

For more information see the new StatusBar tutorial trail.

ProgressMonitor

The second new JavaFX control is ProgressMonitor.
This control allows to monitor any number of running, cancelable Workers.

ProgressMonitor

[1] a label bound to Worker#titleProperty
[2] a label bound to Worker#messageProperty
[3] a progress bar bound to Worker#progressProperty
[4] a button to execute Worker#cancel
[5] an indicator if there are additional workers being monitored
[6] a popup showing all monitored workers

The control is Skinnable and Styleable and can also be used in non-OSGi JavaFX applications. The main intention of this control is to be added to a StatusBar.

Here is a small sample application showing the ProgressMonitor and the StatusBar in action:



You can find the sample application also here.

Drombler FX provides out-of-the-box support for ProgressMonitor (as an optional feature). It registers a StatusBar element and provides a loosely-coupled notification mechanism via the Context Framework.

For more information see the new ProgressBar tutorial trail.


Application Layout

As there is no one-size-fits-all solution, the application layout of a Drombler FX application is pluggable so you can provide your own implementation tailored to your needs. This allows you to get the most out of Drombler FX and JavaFX.

While this feature is available for some time, there is now a new tutorial trail explaining it in more detail.


API Changes

Please note that some APIs have changed, especially the following ones:

Additional Information

Projects like this one need to be build by a community working together to be really successful. There are several ways how you can contribute to this project. Contributions are highly welcome! See the "How to Contribute"-page for more information.

You can find the complete list of fixed issues here: https://github.com/Drombler/drombler-fx/issues?q=milestone%3A0.11


There's a Getting Started page which explains how to create, build and run a Drombler FX sample application with a few simple steps.


The following table provides you an overview of the different Drombler components, links to the modules, which are available from Maven Central, and links to the Javadocs.
  


Name Modules
(incl. Maven Coordinates)
Javadoc Description
Drombler FX Modules Javadoc Drombler FX, the modular application framework for JavaFX based on:
Drombler ACP Modules Javadoc Drombler Abstract Client Platform (ACP) is an abstract, GUI-toolkit agnostic, modular Rich Client Platform based on:
Drombler Commons Modules Javadoc Drombler Commons is a collection of reusable libraries and frameworks. They ship with OSGi meta data but don't require an OSGi environment.


If you find issues or have enhancement requests, you can file a ticket here: https://github.com/Drombler/drombler-fx/issues.

Wednesday, July 12, 2017

Drombler FX: Version 0.10 released

I recently released v0.10 of Drombler FX - the modular application framework for JavaFX.

This version is mainly a bug fix release and especially fixes some issues on Macs.

Please note that the Drombler FX Maven Plugin has been rewritten. The tasks have been split up into several goals, which are bound to the relevant phase of the default lifecycle. The plugin documentation will be updated in the next version.

The project now provides a "How to Contribute"-page. Projects like this one need to be build by a community working together to be really successful. There are several ways how you can contribute to this project.
Contributions are highly welcome!

You can find the complete list of fixed issues here: https://github.com/Drombler/drombler-fx/issues?q=milestone%3A0.10


There's a Getting Started page which explains how to create, build and run a Drombler FX sample application with a few simple steps.


The following table provides you an overview of the different Drombler components, links to the modules, which are available from Maven Central, and links to the Javadocs.
  


Name Modules
(incl. Maven Coordinates)
Javadoc Description
Drombler FX Modules Javadoc Drombler FX, the modular application framework for JavaFX based on:
Drombler ACP Modules Javadoc Drombler Abstract Client Platform (ACP) is an abstract, GUI-toolkit agnostic, modular Rich Client Platform based on:
Drombler Commons Modules Javadoc Drombler Commons is a collection of reusable libraries and frameworks. They ship with OSGi meta data but don't require an OSGi environment.


If you find issues or have enhancement requests, you can file a ticket here: https://github.com/Drombler/drombler-fx/issues.

Friday, June 30, 2017

News from the Software Smithy: Version 0.7 released

SoftSmithy news: I've recently released the version v0.7 of the SoftSmithy Utility Library and the SoftSmithy Development Utility Library.

This release consists mainly of some small additions.

Note that for easier version management the version of the SoftSmithy Development Utility Library is aligned with the version of the SoftSmithy Utility Library. As the SoftSmithy Development Utility Library has a dependency on the SoftSmithy Utility Library it's recommended to use the same version of both libraries until the APIs are stable!

You can find the lates Javadoc here: Javadoc

I deployed the artifacts (including the source and javadoc artifacts) to Maven Central.

Wednesday, January 11, 2017

Drombler FX: Version 0.9 released

I recently released v0.9 of Drombler FX - the modular application framework for JavaFX.

This version is mainly a maintenance release but also provides a new hook for a custom menu item sorting strategy, which can be used for programmatically registered menus.

You can find the complete list of fixed issues here: https://github.com/Drombler/drombler-fx/issues?q=milestone%3A0.9


There's a Getting Started page which explains how to create, build and run a Drombler FX sample application with a few simple steps.


The following table provides you an overview of the different Drombler components, links to the modules, which are available from Maven Central, and links to the Javadocs.
  


Name Modules
(incl. Maven Coordinates)
Javadoc Description
Drombler FX Modules Javadoc Drombler FX, the modular application framework for JavaFX based on:
Drombler ACP Modules Javadoc Drombler Abstract Client Platform (ACP) is an abstract, GUI-toolkit agnostic, modular Rich Client Platform based on:
Drombler Commons Modules Javadoc Drombler Commons is a collection of reusable libraries and frameworks. They ship with OSGi meta data but don't require an OSGi environment.


If you find issues or have enhancement requests, you can file a ticket here: https://github.com/Drombler/drombler-fx/issues.

Wednesday, October 26, 2016

Drombler FX: Version 0.8 released

I recently released v0.8 of Drombler FX - the modular application framework for JavaFX.

This version comes with two new major features: Single Instance Application and an initial version of a Data Framework which integrates with the Docking Framework.

Single Instance Application

Single Instance Application is an optional feature, which ensures that there is only one instance of your application running, even if the user starts the application several times.

This feature is provided out-of-the-box. It is disabled by default, however, but can be enabled by simply specifying the defaultSingleInstancePort property of the Drombler FX Maven Plugin.



If this feature is enabled and one instance is aleady running, each other application start will pass all its unnamed parameters to the first instance and shuts itself then down. Drombler FX will register a new instance of AdditionalArgumentsProvider for every application start notification.

Read more about Single Instance Application in the new tutorial trail.

Data Framework

This version introduces an initial version of a Data Framework which integrates with the Docking Framework.

At the core of the Data Framework is the concept of Data Handlers. A Data Handler wraps an instance of a particular kind of data and usually knows how to read, save etc. this particular kind of data.

To register a Data Handler for a business object, which e.g. has been obtained from a web service call, use the @BusinessObjectHandler annotation:



To register a Data Handler for a document use the @DocumentHandler annotation:


To associate some file extensions with a MIME type you can register the file extensions using the @FileExtension annotation:



Read more about the Data Framework in the new tutorial trail.

Docking Framework changes and enhancements

This version comes with some changes and several enhancements of the Docking Framework, especially also to integrate the Docking Framework with the newly introduced Data Framework.

One of the biggest changes is how you register and open an Editor:

A Dockable Pane can still be registered as an Editor by using the @EditorDocking annotation, but this annotation now specifies the contentType:



The annotated Editor is required to have a constructor with a single parameter of type contentType().

This contentType is usually a Data Handler registered either with @BusinessObjectHandler or with @DocumentHandler. The icon of the Data Handler will be used in the tabs of the Editors. You also don't specify the Docking Area for Editors anymore.

The standard "center" Docking Area has been renamed to "editor" and is the default Docking Area for Editors if you're using the standard Docking Areas.

There are several ways to open an Editor for a Data Handler:
Apart from the integration with the Data Framework, the Docking Framework comes with the following enhancements:
  • If the framework detects that there's already an Editor open for the provided content, the existing Editor gets selected rather than a new one opened.
     
  • If you close an unsaved Editor or if you close the window/ application while there are still unsaved Editors open, the Docking Framework detects this and provides an according dialog.


Putting all together

The enhancements provided by the Data Framework, Docking Framework and Single Instance Application support allow you for instance to create Single Instance Applications where the user can pass a file path argument to the application and the according Editor will be opened/ selected in the first (single) instance of the application.

Please note that several packages have changed.

Several refactorings have been done, which moved classes to different packages.
If a class isn't found anymore try to delete the import statement and re-import the class again using your IDE of choice. Also have a look at the available Maven Coordinates by following the links in the table below and have a look at the provided sample application.

Concluding remarks

You can find the complete list of fixed issues here: https://github.com/Drombler/drombler-fx/issues?q=milestone%3A0.8


There's a Getting Started page which explains how to create, build and run a Drombler FX sample application with a few simple steps.


The following table provides you an overview of the different Drombler components, links to the modules, which are available from Maven Central, and links to the Javadocs.
  


Name Modules
(incl. Maven Coordinates)
Javadoc Description
Drombler FX Modules Javadoc Drombler FX, the modular application framework for JavaFX based on:
Drombler ACP Modules Javadoc Drombler Abstract Client Platform (ACP) is an abstract, GUI-toolkit agnostic, modular Rich Client Platform based on:
Drombler Commons Modules Javadoc Drombler Commons is a collection of reusable libraries and frameworks. They ship with OSGi meta data but don't require an OSGi environment.


If you find issues or have enhancement requests, you can file a ticket here: https://github.com/Drombler/drombler-fx/issues.

Saturday, September 17, 2016

News from the Software Smithy: Version 0.6 released

SoftSmithy news: I recently released a new version of the SoftSmithy Utility Library and the SoftSmithy Development Utility Library.

It has been a while since the last release but a lot of work has been undertaken.

SoftSmithy moved from SourceForge.net to GitHub.
This includes:
  • You can find all SoftSmithy repositories on the SoftSmithy GitHub organization site.
  • All SoftSmithy repositories have been migrated from Mercurial to Git
  • The Gitflow has been configured for all repositories. You can find the current development in the develop branches (default branch) and the released versions in the master branch.
  • The static pages as well as the Wiki pages haven been migrated to GitHub Pages.
Java SE 8
All modules require now at least Java SE 8.

In addition some small additions, fixes and clean-ups have been added.
Note that for easier version management the version of the SoftSmithy Development Utility Library is aligned with the version of the SoftSmithy Utility Library. As the SoftSmithy Development Utility Library has a dependency on the SoftSmithy Utility Library it's recommended to use the same version of both libraries until the APIs are stable!

You can find the lates Javadoc here: Javadoc

I deployed the artifacts (including the source and javadoc artifacts) to Maven Central.

Monday, November 23, 2015

Drombler FX: Version 0.7 released

I recently released v0.7 of Drombler FX - the modular application framework for JavaFX.

It has been a while since the last release but a lot of work has been undertaken.

Drombler moved from SourceForge.net to GitHub.
This includes:
  • You can find all Drombler repositories on the Drombler GitHub organization site.
  • All Drombler repositories have been migrated from Mercurial to Git
  • The Gitflow has been configured for all repositories. You can find the current development in the develop branches (default branch) and the released versions in the master branch.
  • The static pages as well as the Wiki pages haven been migrated to GitHub Pages.
  • The tutorial has been migrated from the Wiki pages to Asciidoc files which are also published to the GitHub Pages. The Asciidoc files allow to
    • compile the included samples first, to make sure the correct version of the API is used and that there is no typo
    • keep different versions of the tutorial for different releases
    • publish the tutorial in different formats
    • easily style the tutorial 
  • The issues have been migrated to the issue system provided by GitHub.

Experiments with CDI & OSGi

A lot of work has been done in experiments to integrate CDI and OSGi.

Unfortunately, among several issues
  • the fact that at the time of writing the specification how CDI should work in an OSGi environment is still not final yet
  • the major difference between the dynamic nature of OSGi services and the static nature of CDI bean discovery at startup, which are hard to overcome
  • issues when trying to integrate CDI providers with OSGi Dynamic Services
put an end to these experiments for now.

Please join the discussion here how CDI still could be integrated into a future version of Drombler FX.

Dockable selection notification

There are now 2 new method-level annotations: @Select and @Deselect.

The annotated methods get called, if present, when the currently selected Dockable (eg. represented as a Tab) of a Docking Area (eg. represented as a TabPane) changes.

(Every non-empty Docking Area has one selected Dockable - the one which is visible.)

 

Modified Dockables

FXDockableData has a new modified-property to indicate if the data represented by the Dockable has been modified.

The behavior of the default skin is to add/ remove the CSS style class "dockable-modified" to/ from the tab representing the Dockable whenever this flag changes.

The default CSS changes the tab font to bold.

The DockableDataModifiedManager listens for Savable in the local contexts of the Dockables and synchronizes the modified-property of FXDockableData accordingly.

Drombler FX configures this manager out-of-the-box.

The effect is that whenever you add a Savable to the local context of a Dockable, the font of the tab will change to bold indicating that the content of the tab has changed and hasn't been saved yet. Since the "Save" action and the "Save All" actions also listen for Savable in the active/ application context, they get enabled accordingly. When you click on one of these save buttons/ menu items, then they call the according save method of the Savable, which should remove itself from the local context again and thus disable the save actions and changing the tab font back to default.

All this works in a loosely coupled way thanks to the Context Framework. All you have to do is to add/ remove the Savable to/ from the local context of the Dockable.

To inform the application framework that the Dockable provides a local context, the Dockable needs to implement the LocalContextProvider interface eg. by using a SimpleContext.

The save method of the Savable then can be implemented to store the content to a file, to a DB, call an EJB or a webservice, send a JMS message or whatever your application has to do for this kind of data.

Pluggable application layout

The application layout is now pluggable!

Add the following dependency to use a classic desktop application layout with a menubar, a toolbar and a content area as the content of the JavaFX application.

You can replace this dependency with your own implementation of MainSceneRootProvider, which needs to be registered as an OSGi service.

By providing your own implementation you can make your application look completely different.

Please note that the content of the content area of the default application layout is pluggable, too!

Add the following dependency to use the Docking Framework for the content area.


This dependency also configures the Docking Framework to integrate with the Context Framework.

You can replace this dependency with your own implementation of ApplicationContentProvider, which needs to be registered as an OSGi service.

By providing your own implementation you can make the content area look completely different while keeping the classic desktop application layout, which uses the Action Framework to register menu items and toolbar buttons with annotations.

Please note that several packages have changed.

Several refactorings have been done, which moved classes to different packages.
If a class isn't found anymore try to delete the import statement and re-import the class again using your IDE of choice. Also have a look at the available Maven Coordinates by following the links in the table below.


Concluding remarks

You can find the complete list of fixed issues here: https://github.com/Drombler/drombler-fx/issues?q=milestone%3A0.7


There's a Getting Started page which explains how to create, build and run a Drombler FX sample application with a few simple steps.


The following table provides you an overview of the different Drombler components, links to the modules, which are available from Maven Central, and links to the Javadocs.
  


Name Modules
(incl. Maven Coordinates)
Javadoc Description
Drombler FX Modules Javadoc Drombler FX, the modular application framework for JavaFX based on:
Drombler ACP Modules Javadoc Drombler Abstract Client Platform (ACP) is an abstract, GUI-toolkit agnostic, modular Rich Client Platform based on:
Drombler Commons Modules Javadoc Drombler Commons is a collection of reusable libraries and frameworks. They ship with OSGi meta data but don't require an OSGi environment.


If you find issues or have enhancement requests, you can file a ticket here: https://github.com/Drombler/drombler-fx/issues.