Plik deskryptora wdrażania protokołu Java Network programu uruchamiającego aplikację kliencką

Plik deskryptora wdrażania jest głównym plikiem deskryptora Java™ Network Launcher Protocol (JNLP) dla aplikacji klienckiej.

Położenie

Aplikacja kliencka ma zależność środowiska wykonawczego klientów aplikacji, która udostępnia następujące informacje:
  • Środowisko wykonawcze programów Java SE z programu IBM®
  • Właściwości wykonawcze klientów aplikacji
  • Plik kluczy SSL i plik zaufanych certyfikatów
  • Pliki JAR bibliotek środowiska wykonawczego klientów aplikacji (opcjonalne dla aplikacji klienckich cienkiego aplikacji)
Jeśli zależność środowiska wykonawczego klientów aplikacji nie jest spełniona, jest ona pobierana i instalowana w środowisku Java Web Start (JWS) zgodnie z opisem w pliku deskryptora JNLP instalatora środowiska wykonawczego klienta aplikacji. Na przykład:
<j2se version="1.6" href="http://your_server.com/jws/wasappclient/download.jnlp"/>

Uwagi dotyczące używania

Aplikacja kliencka musi także zawierać plik WebSphereClientLauncher.jar , który zawiera klasę programu uruchamiającego com.ibm.websphere.client.launcher.ClientLauncher, które wykonuje jedno z następujących działań:
  • Jeśli jest to aplikacja kliencka Java Platform, Enterprise Edition (Java EE) Application (to znaczy zasoby aplikacji zawierają plik EAR z aplikacją kliencką), plik EAR musi zostać określony jako zasób JAR, dzięki czemu będzie mógł zostać pobrany do programu JWS i określony we właściwości systemowej com.ibm.websphere.client.launcher.ear. Przykład można znaleźć w sekcji Plik deskryptora JNLP dla aplikacji klienckiej aplikacji Java EE .
  • Jeśli jest to aplikacja kliencka cienkiego aplikacji, plik JAR aplikacji cienkiego aplikacji musi być określony jako zasób JAR, tak aby można go było pobrać do JWS, a nazwa klasy zawierającej główny punkt wejścia metody została określona we właściwości systemowej com.ibm.websphere.launcher.main. Przykład można znaleźć w sekcji Plik deskryptora JNLP dla aplikacji cienkiego klienta aplikacji .

Specyfikacja JNLP wymaga, aby wszystkie pliki zasobów (JAR lub EAR) użyte w pliku JNLP były podpisane.

Argumenty -CC zdefiniowane w narzędziu launchClient dla aplikacji klienckiej aplikacji J2EE Application Client można określić w sekcji argumentów aplikacji w plikach deskryptora JNLP. Jednak tylko -CCD jest obsługiwane przez aplikację kliencką cienkiego aplikacji w celu zdefiniowania właściwości systemowych, a znacznik JNLP < właściwość> może być również używany do definiowania właściwości systemowych. Szczegółowe informacje można znaleźć w następującym przykładzie:
<property name="java.naming.provider.url" value="corbaloc:iiop:myserver.com:9089"/>
W przypadku aplikacji klienckiej J2EE aplikacji należy określić następujące argumenty aplikacji zdefiniowane w pliku JNLP.
  1. Podaj adres URL dostawcy serwera docelowego, tak jak pokazano to w poniższym przykładzie:
    <argument> >-CCDjava.naming.provider.url =corbaloc:iiop:myserver.mydomain.com:9080 </argument>
  2. Określ plik kluczy SSL i położenie pliku zaufanych certyfikatów SSL. Pliki te powinny być dostępne na komputerze klienckim. Aby użyć zależności środowiska wykonawczego klientów aplikacji zainstalowanych w pamięci podręcznej JWS, należy określić następujące argumenty aplikacji:
    <argument> -CCDcom.ibm.ssl.keyStore=${WAS_ROOT}/etc/key.p12 </argument>
<argument> -CCDcom.ibm.ssl.trustStore=${WAS_ROOT}/etc/trust.p12 </argument>
  3. Określ początkowy czynnik kontekstu nazewnictwa, tak jak przedstawiono to w poniższym przykładzie:
    <argument>-CCDjava.naming.factory.initial=com.ibm.websphere.naming.WsnInitialContextFactory </argument>
    W przypadku aplikacji klienckiej cienkiej aplikacji należy również określić rzeczywiste położenie plików sas.client.props i ssl.client.props znajdujących się w zależnościach środowiska wykonawczego klientów aplikacji, które są zainstalowane w pamięci podręcznej JWS.
    <argument>-CCDcom.ibm.CORBA.ConfigURL=file:${WAS_ROOT}/properties/sas.client.props </argument>
<argument>-CCDcom.ibm.SSL.ConfigURL=file:${WAS_ROOT}/properties/ssl.client.props </argument>
    Jeśli jakiekolwiek ustawienia domyślne w pliku sas.client.props i sas.client.props wymagają modyfikacji, należy użyć -CCD, aby zmienić ustawienia za pomocą właściwości systemowych, tak jak pokazano to w poniższym przykładzie:
    <argument>-CCDjavacom.ibm.CORBA.securityEnabled=false </argument>
    Ważne: Znacznik ${WAS_ROOT} używany w pliku JNLP jest zastępowany przez klasę programu uruchamiającego, com.ibm.websphere.client.launcher.ClientLauncher, do rzeczywistej lokalizacji instalacji zależności środowiska wykonawczego klientów aplikacji w pamięci podręcznej JWS. Jeśli do dynamicznego tworzenia tego pliku opisu JNLP używana jest strona JSP, należy usunąć ten znacznik, ponieważ ma on inne znaczenie w kodzie JSP 2.0. Szczegółowe informacje można znaleźć w następującym przykładzie:
    <argument>-CCDcom.ibm.ssl.keyStore=\${WAS_ROOT}/etc/key.p12 </argument>
<argument>-CCDcom.ibm.ssl.trustStore=\${WAS_ROOT}/etc/trust.p12 </argument>