Java Adapter Example

Overview

The following repo contains examples for OpenFin's Java adapter.

Guidelines

Run the example of connecting to OpenFin and creating applications

1. Clone this repository

2. Go to release directory and start run.bat

3. Once the java app starts, click on Start button, which should start OpenFin Runtime. The java app will wait and try to connect to OpenFin Runtime.

4. Once OpenFin Runtime is started and Java app connects successfully, "Create Application" button is enabled. You can click on the button to bring up a dialog for entering configuration of any HTML5 app. By default, the dialog is pre-populated with configuration for Hello OpenFin demo app.

5. You can use buttons in Window Control section to move and re-size HTML5 window of Hello OpenFin app.

6. Click "Create Application" button, which should start a dialog with all the fields pre-populated for our Hello OpenFin demo HTML5 application. Just click on "Create" button.

7. After Hello OpenFin starts, you can use the buttons under Window Control of Java app to control Hello OpenFin window.

Source Code Review

Source code for the example is located in /src/main/java/com/openfin/desktop/demo/OpenFinDesktopDemo.java. The followings overview of how it communicates with OpenFin Runtime with API calls supported by the Java adapter:

1. Create connection object:

this.desktopConnection = newDesktopConnection("OpenFinDesktopDemo");

This code just creates an instance of DesktopConnection and it does not try to connect to runtime.

2. Launch and connect to stable version of OpenFin runtime:

// create an instance of RuntimeConfiguration and configure Runtime by setting properties in RuntimeConfigurationthis.runtimeConfiguration = newRuntimeConfiguration();
// launch and connect to OpenFin RuntimedesktopConnection.connect(this.runtimeConfiguration, listener, 10000);

listener is an instance of DesktopStateListener which provides callback on status of connections to runtime.

3. Create new application when clicking on Create App:

Applicationapp = newApplication(options, desktopConnection, newAckListener() {
@OverridepublicvoidonSuccess(Ackack) {
Applicationapplication = (Application) ack.getSource();
application.run(); // run the app
}
@OverridepublicvoidonError(Ackack) {
}
});

options is an instance of ApplicationOptions, which is populated from App Create dialog. AckListener interface provides callback for the operation.

Once the application is created successfully, you can take actions on its window:

4. Change opacity:

WindowOptionsoptions = newWindowOptions();
options.setOpacity(newOpacityValue);
application.getWindow().updateOptions(options, null);

5. Change Window size

application.getWindow().resizeBy(10, 10, "top-left");

6. Publishes messages to a topic with InterApplicationBus

org.json.JSONObjectmessage = createSomeJsonMessage();
desktopConnection.getInterApplicationBus().publish("someTopic", message);

7. Subscribes to a topic with InterApplicationBus

desktopConnection.getInterApplicationBus().subscribe("*", "someTopic", newBusListener() {
publicvoidonMessageReceived(StringsourceUuid, Stringtopic, Objectpayload) {
JSONObjectmessage = (JSONObject) payload;
}
});

Run the example of embedding HTML5 application into a Java Swing window

1. Clone this repository

2. Go to release directory and start embed.bat ( the default embedded url is https://openfin.co. Pass the url you wish to load if you want something different e.g. embed.bat https://www.mydomain.com )

3. Once the java app starts, click on "Launch OpenFin" button, which should start OpenFin Runtime and embed the OpenFin application that points to https://openfin.co (or your custom url if you specified one)

4. Click "Shutdown OpenFin" button to close HTML5 application and the Java Swing window

If there is a problem rendering the url please check your windows display settings to see ensure scaling is set to 100%.

Source Code Review for embedded OpenFin application

Source code for the example is located in /src/main/java/com/openfin/desktop/demo/WindowEmbedDemo.java

1. create a canvas and place it where the HTML5 application should be embedded.

embedCanvas = newjava.awt.Canvas();
panel.add(embedCanvas, BorderLayout.CENTER);

2. listen to the canvas resize event, and resize embedded HTML5 application accordingly.

embedCanvas.addComponentListener(newComponentAdapter() {
@OverridepublicvoidcomponentResized(ComponentEventevent) {
super.componentResized(event);
DimensionnewSize = event.getComponent().getSize();
try {
if (startupHtml5app != null) {
startupHtml5app.getWindow().embedComponentSizeChange((int)newSize.getWidth(), (int)newSize.getHeight());
}
} catch (Exceptione) {
e.printStackTrace();
}
}
});

3. launch and connect to OpenFin runtime

this.desktopConnection = newDesktopConnection(appUuid);
DesktopStateListenerlistener = newDesktopStateListener() {...};
RuntimeConfigurationconfiguration = newRuntimeConfiguration();
configuration.setRuntimeVersion(desktopVersion);
desktopConnection.connect(configuration, listener, 60);

4. create HTML5 application

ApplicationOptionsoptions = newApplicationOptions(startupUuid, startupUuid, openfin_app_url);
WindowOptionsmainWindowOptions = newWindowOptions();
options.setMainWindowOptions(mainWindowOptions);
DemoUtils.runApplication(options, this.desktopConnection, newAckListener() {...});

5. embed HTML5 application into the canvas

startupHtml5app = Application.wrap(this.startupUuid, this.desktopConnection);
Windowhtml5Wnd = startupHtml5app.getWindow();
longparentHWndId = Native.getComponentID(this.embedCanvas);
html5Wnd.embedInto(parentHWndId, this.embedCanvas.getWidth(), this.embedCanvas.getHeight(), newAckListener() {...});

More Info

More information and API documentation can be found at https://openfin.co/java-api/

Disclaimers

• This is a starter example and intended to demonstrate to app providers a sample of how to approach an implementation. There are potentially other ways to approach it and alternatives could be considered.
• Its possible that the repo is not actively maintained.

License

MIT

The code in this repository is covered by the included license.

However, if you run this code, it may call on the OpenFin RVM or OpenFin Runtime, which are covered by OpenFin’s Developer, Community, and Enterprise licenses. You can learn more about OpenFin licensing at the links listed below or just email us at support@openfin.co with questions.

https://openfin.co/developer-agreement/
https://openfin.co/licensing/

Support

Please enter an issue in the repo for any questions or problems.
Alternatively, please contact us at support@openfin.co