Use Java Web Start

This topic provides the steps and prerequisites necessary to use Java Web start. Before you begin this task, see the following topics to understand Java Web Start technology and its components:

• Java Web Start architecture for deploying application clients

• Client application Java Network Launcher Protocol deployment descriptor file

• ClientLauncher class

Note: You can use the following:

• Java Web Start on Java 2 Standard Edition Developer Kits that IBM provides, packaged in the Application Client for WebSphere Application Server

Procedure

1. Prepare the Application Clients run-time dependency component for JWS.

2. Prepare the Application Clients run-time library component for JWS.

3. Installing JWS.

4. Optional: Run the Java Web Start sample.

   Problem: When you run Web services clients from Java Web Start using a Mozilla browser, you might get errors if the client argument contains quotations in the jnlp.jsp file. For example, the following argument results in an error:

   <argument>-url="wsejb:/com.ibm.wssvt.tc.pli.ejb.WSMultiProtocolHome?jndiName=com/ibm/wssvt/tc
   /pli/ejb/WSMultiProtocolHome&"</argument>

   Error: The following errors display in the Java Web Start console:

   If using the EJB protocol, the following error is displayed:

   Client caught exception getting the InsuranceWebServicesPort
   using the URL
   "wsejb:/com.ibm.wssvt.tc.pli.ejb.WSMultiProtocolHome?jndiName=com/ibm/wssvt/tc
   /pli/ejb/WSMultiProtocolHome&"
   java.net.MalformedURLException: no protocol:
   "wsejb:/com.ibm.wssvt.tc.pli.ejb.WSMultiProtocolHome?jndiName=com/ibm/wssvt/tc
   /pli/ejb/WSMultiProtocolHome&"
    at java.net.URL.<init>(URL.java(Compiled Code))
    at java.net.URL.<init>(URL.java(Compiled Code))
    at java.net.URL.<init>(URL.java:411)
    at com.ibm.wssvt.tc.pli.webservice.InsuranceWebServicesClient
   .getInsuranceServicesClientURL(InsuranceWebServicesClient.java:231)
    at com.ibm.wssvt.tc.pli.webservice.InsuranceWebServicesClient
   .main(InsuranceWebServicesClient.java:748)
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:85)
    at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:58)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:60)
    at java.lang.reflect.Method.invoke(Method.java:391)
    at com.ibm.websphere.client.applicationclient.launchClient.
   createContainerAndLaunchApp(launchClient.java:649)
   

   If using the HTTP protocol, the following error is displayed:

   Client caught exception getting the InsruanceWebServicesPort
   using the URL
   "http://svtlnx1:9081/WebSvcsInsSession20EJB/services/WSMultiProtocol"
   java.net.MalformedURLException: no protocol: 
   "http://svtlnx1:9081/WebSvcsInsSession20EJB/services/WSMultiProtocol"

   If using the JMS protocol, the following error is displayed:

   Client caught exception getting the InsruanceWebServicesPort
   using the URL
   "jms:/queue?destination=jms/MultiProtocol_Q&connectionFactory=jms/InsuranceServices_Q
   
   CF&targetService=WSMultiProtocolJMS&jndiProviderURL=IIOP://svtlnx1.austin.ibm.com:981
   1"
   java.net.MalformedURLException: no protocol: 
   "jms:/queue?destination=jms/MultiProtocol_Q&connectionFactory=jms/InsuranceServices_Q
   
   CF&targetService=WSMultiProtocolJMS&jndiProviderURL=IIOP://svtlnx1.austin.ibm.com:981
   1"
          at java.net.URL.<init> (URL.java(Compiled Code))
   Making calls to methods in WSMultiprotocolWebServicesBean ...
   

   Solution: To resolve the problem, update the jnlp.jsp file to remove the quotations (" ") from the argument.

   For the EJB protocol, use the following example argument to correct the errors:

   <argument>-url=wsejb:/com.ibm.wssvt.tc.pli.ejb.WSMultiProtocolHome?jndiName=com/ibm/wssvt/tc
   /pli/ejb/WSMultiProtocolHome&</argument>

   For the HTTP protocol, use the following argument to correct the errors:

   <argument>-url=http://svtaix23:9081/WebSvcsInsSession20EJB/services/WSMultiProtocol</argument>

   For the JMS protocol, use the following argument to correct the errors:

   <argument>-url=jms:/queue?destination=jms/MultiProtocol_Q&connectionFactory=
   jms/InsuranceServices_QCF&targetService=
   WSMultiProtocolJMS&jndiProviderURL=IIOP://svtaix23.austin.ibm.com:9811</argument>

   Now, rerun the client from Java Web Start.