Specifying icon and splash images for Java Web Start launches of app clients

This has been a recurring enhancement request for the GlassFish feature for launching app clients using Java Web Start: let the developer have control over the JNLP document that's generated. 

We hope to provide a general solution to this that lets developers specify almost any JNLP content.  Until then, though, we have taken a small step in that direction, responding to some specific requests by allowing the developer to choose files in the app client that Java Web Start will use for the icon and splash images. 

Ever since the Java Web Start launch feature first appeared, developers could specify the text used in the "vendor" display on the Java Web Start screen during launch by adding something like this to the sun-application-client.xml descriptor for the app client:

<java-web-start-access>
<vendor>MyCorp, Inc.</vendor>
</java-web-start-access>

As an interim solution until we provide a more general JNLP customization approach, you can use the <vendor> element to point to the icon image, the splash screen image, both, or neither, as well as the vendor text.

The general format for the vendor text is now this:

[icon-image-URI::][splash-screen-image-URI::]vendor-text

The separator is a double-colon.  The URIs are the relative paths, within the app client module, to the image files.  If only one image is specified it will be used at the icon image, not the splash image. 

Examples:

images/icon.jpg::otherDir/splash.jpg::MyCorp, Inc.

GlassFish will specify that Java Web Start use icon.jpg in the images/ directory for the icon image and splash.jpg in the otherDir directory for the splash screen.


myImage.jpg::MyCorp, Inc.

The file myImage.jpg at the top-level of the app client module will be the icon image, and Java Web Start will provide its default splash screen image.


::images/splash.jpg::MyCorp, Inc.

Java Web Start will use its default image for the icon and will use images/splash.jpg as the splash screen image.


MyCorp, Inc.

<<>>Java Web Start will use the default icon and splash screen images.
>


Comments:

Thx for these infos. From which version glassfish start to have the feature you describe here.? I'm currently using the latest SUN AS9. best regards Ghislain

Posted by Ghislain N on March 22, 2007 at 02:07 PM CDT #

Great to see continued work on this Tim. I'll have to try it out in our little manufacturing app to see how the shop floor employees like it.

Posted by Dave Staelens on April 04, 2007 at 03:20 AM CDT #

Great work Tim. It is good to see that the feedback on GlassFish community forums/mailing lists is being addressed promptly.

Posted by Abhijit Kumar on April 05, 2007 at 07:34 PM CDT #

Hi, This is not a comment, it´s a question. How can I change the name of the host? I mean, I want that the URL in the JNLP has the IP address, not the name of the Host. May I do this? And how. Thank you.

Posted by Gleyverg Berrios on August 23, 2007 at 03:05 AM CDT #

The URL in the JNLP is generated by GlassFish and is based on the URL in the initial incoming request. You can try specifying the numeric IP address in the request that launches the app client and see if that does what you want.

You might also find it useful to post questions like this in the GlassFish forum at http://forums.java.net/jive/forum.jspa?forumID=56&start=0

- Tim

Posted by Tim Quinn on August 23, 2007 at 04:06 AM CDT #

Would it be possible for you to post a full application-client.xml? I am trying to do this with Netbeans 6.0.1 and the Glassfish version that comes with it and I keep getting deployment exceptions thrown.

Posted by David D on March 17, 2008 at 05:39 AM CDT #

Hi, David.

Can you either post the exceptions you are getting or e-mail them to me directly at tim dot quinn at sun dot com?

That might be the fastest way for us to resolve whatever you are running into.

Thanks.

- Tim

Posted by Tim Quinn on March 17, 2008 at 08:57 AM CDT #

Post a Comment:
  • HTML Syntax: NOT allowed
About

News and musings on the technology I work on at Oracle.

The views expressed on this blog are my own and do not necessarily reflect the views of Oracle.

Search

Categories
Archives
« April 2014
SunMonTueWedThuFriSat
  
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
   
       
Today