Package com.gluonhq.cloudlink.client.media

Class MediaClient

java.lang.Object

com.gluonhq.cloudlink.client.media.MediaClient

public class MediaClient
extends java.lang.Object

The MediaClient is used for loading media resources from Gluon CloudLink into the client application.

Constructor Summary

Constructors

Constructor	Description
MediaClient()

Method Summary

Modifier and Type	Method	Description
javafx.scene.image.Image	loadImage(java.lang.String name)	A convenience method to directly load a media resource with the provided name into a JavaFX Image object.
java.io.InputStream	loadMedia(java.lang.String name)	Load the media resource with the provided name into an InputStream.
java.util.ResourceBundle	loadResourceBundle(java.lang.String bundleName, java.util.Locale locale)	Loads the resource bundle with the provided bundle name and locale from Gluon CloudLink.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MediaClient

public MediaClient()

Method Detail

loadMedia

public java.io.InputStream loadMedia(java.lang.String name)
                              throws java.io.IOException

Load the media resource with the provided name into an InputStream. The caller of this method is responsible for closing the returned InputStream when it is no longer needed.

Parameters:

name - the name of the media resource to load

Returns:

an InputStream that can be used for reading the media resource

Throws:

java.io.IOException - if an I/O error occurs while loading the media resource.

loadImage

public javafx.scene.image.Image loadImage(java.lang.String name)
                                   throws java.io.IOException

A convenience method to directly load a media resource with the provided name into a JavaFX Image object. You can check Image.errorProperty() to see whether the returned image contains a valid image or not.

Parameters:

name - the name of the media resource to load

Returns:

an Image that can be used in an ImageView.

Throws:

java.io.IOException - if an I/O error occurs while loading the media resource.

loadResourceBundle

public java.util.ResourceBundle loadResourceBundle(java.lang.String bundleName,
                                                   java.util.Locale locale)
                                            throws java.io.IOException

Loads the resource bundle with the provided bundle name and locale from Gluon CloudLink. Gluon CloudLink will try to find the best matching resource bundle for the given locale, as explained in ResourceBundle#getBundle. When no match could be found, null will be returned instead.

Parameters:

bundleName - the name of the resource bundle

locale - the locale of the resource bundle

Returns:

the resource bundle that matches the given bundle name and locale

Throws:

java.io.IOException - if an I/O error occurs while loading the resource bundle.