Przykład: tworzenie aplikacji SCA na poziomie biznesowym za pomocą skryptów (nieaktualne)

Do aplikacji na poziomie biznesowym można dodać wiele różnych typów artefaktów. Na przykład można dodać aplikacje lub moduły, archiwa Java™ (pliki JAR), dane w skompresowanych plikach i inne aplikacje na poziomie biznesowym. W tym przykładzie opisano sposób tworzenia pustej aplikacji na poziomie biznesowym, a następnie dodanie do aplikacji pliku JAR architektury Service Component Architecture (SCA) za pomocą skryptów.

Nieaktualne funkcje: 8.5.5.19 lub nowsza

Model programistyczny architektury SCA (Service Component Architecture) i przykłady są nieaktualne i zostaną usunięte w przyszłej wersji. Nie można wdrożyć nowych aplikacji na poziomie biznesowym architektury SCA. Jeśli chcesz nadal korzystać z architektury SCA jako części strategii długoterminowej, należy rozważyć udostępnianie aplikacji w produkcie IBM Business Process Manager.

Przed rozpoczęciem

W przypadku instalacji produktu sprawdź, czy serwer docelowy jest skonfigurowany. W ramach konfigurowania serwera należy określić, czy pliki aplikacji mogą być uruchamiane w miejscu docelowym wdrażania. Zasoby aplikacyjne kompozytu SCA aplikacji na poziomie biznesowym należy wdrożyć na serwerze (docelowym) w wersji 8.0 lub nowszej albo w miejscu docelowym w wersji 7.0 , które jest włączone dla pakietu składników Feature Pack for SCA.

Pobierz przykładowy plik SCA helloworld-ws-asynch.jar z serwisu pobierania produktu:

Przejdź do dokumentacji produktu Przykłady, wersja 8.5 .
Na karcie Downloads (Zasoby do pobrania) kliknij opcję FTP lub HTTP w sekcji Service Component Architecture (Architektura Service Component Architecture).
W oknie uwierzytelniania kliknij przycisk OK.
W skompresowanym pliku SCA.zip przejdź do katalogu SCA/installableApps i pobierz plik helloworld-ws-asynch.jar .

Informacje o tej czynności

W tym przykładzie należy użyć skryptów wsadmin w języku Jython lub Jacl, aby utworzyć aplikację na poziomie biznesowym o nazwie HelloWorldAsync, która ma plik JAR SCA helloworld-ws-asynch.jarjako zasób aplikacyjny.

Procedura

Uruchom narzędzie skryptowe wsadmin.
Utwórz pustą aplikację na poziomie biznesowym o nazwie HelloWorldAsync.
Aby utworzyć aplikację na poziomie biznesowym, należy użyć komendy createEmptyBLA .
Używając Jython:
```
AdminTask.createEmptyBLA('-name HelloWorldAsync')
```
Używając Jacl:
```
$AdminTask createEmptyBLA {-name HelloWorldAsync}
```
Po uruchomieniu komendy w oknie komend zostaną wyświetlone dane wyjściowe komendy blaID :
```
WebSphere:blaname=HelloWorldAsync
```
Komendę listBLAs można uruchomić w celu wyświetlenia listy wszystkich aplikacji na poziomie biznesowym w komórce oraz potwierdzenia, że istnieje aplikacja HelloWorldAsync na poziomie biznesowym.
Używając Jython:
```
AdminTask.listBLAs()
```
Aby wyświetlić bardziej czytelną listę aplikacji na poziomie biznesowym, należy spróbować print przed komendą:
```
print AdminTask.listBLAs()
```
Używając Jacl:
```
$AdminTask listBLAs
```
Zaimportuj zasób aplikacyjny JAR SCA.
Użyj komendy importAsset , aby zaimportować plik JAR do repozytorium konfiguracji produktu.
Używając Jython:
```
AdminTask.importAsset('-source app_server_root/installableApps/helloworld-ws-asynch.jar')
```
Używając Jacl:
```
$AdminTask importAsset {-source app_server_root/installableApps/helloworld-ws-asynch.jar}
```
Po uruchomieniu komendy w oknie komend zostaną wyświetlone dane wyjściowe assetID :
```
WebSphere:assetname=helloworld-ws-asynch.jar
```
Komendę listAssets można uruchomić w celu wyświetlenia listy wszystkich zasobów w komórce i potwierdzenia, że zasób helloworld-ws-asynch.jar istnieje:
Używając Jython:
```
AdminTask.listAssets()
```
Aby wyświetlić bardziej czytelną listę zasobów aplikacyjnych, należy spróbować print przed komendą:
```
print AdminTask.listAssets()
```
Używając Jacl:
```
$AdminTask listAssets
```
Dodaj zasób aplikacyjny JAR SCA jako jednostkę kompozycji dla aplikacji na poziomie biznesowym.
Aby dodać zasób aplikacyjny do aplikacji na poziomie biznesowym, należy użyć komendy addCompUnit .
Używając Jython:
```
AdminTask.addCompUnit('[-blaID HelloWorldAsync -cuSourceID helloworld-ws-asynch.jar -MapTargets [[ .* SCA_server_name ]] ]') 
```
Używając Jacl:
```
$AdminTask addCompUnit {-blaID HelloWorldAsync -cuSourceID helloworld-ws-asynch.jar -MapTargets {{ .* SCA_server_name }} }
```
Zmienna nazwa_serwera_SCA jest nazwą elementu docelowego, na przykład server1. Element docelowy musi obsługiwać kompozyty SCA. Jako element docelowy należy określić tylko jeden serwer, a nie można odwzorować jednostki kompozycji SCA na wiele elementów docelowych.

Po uruchomieniu komendy dane wyjściowe identyfikatora jednostki kompozycji są wyświetlane w oknie komend:
```
WebSphere:cuname=helloworldws
```
Podczas wdrażania jednostki kompozycji można wyświetlić identyfikator URI (Uniform Resource Identifier) dla usługi na poziomie złożonym niektórych powiązań wraz z nazwą usługi i typem powiązania. Tylko identyfikator URI jest edytowalny. Produkt nie sprawdza poprawności identyfikatora URI.

Komendę listCompUnits można uruchomić w celu wyświetlenia listy wszystkich jednostek kompozycji w określonej aplikacji na poziomie biznesowym oraz potwierdzenia, że jednostka kompozycji helloworldws istnieje w programie HelloWorldAsync.
Używając Jython:
```
AdminTask.listCompUnits('-blaID HelloWorldAsync')
```
Używając Jacl:
```
$AdminTask listCompUnits {-blaID HelloWorldAsync}
```
Zapisz zmiany w konfiguracji.
Używając Jython:
```
AdminConfig.save()
```
Używając Jacl:
```
$AdminConfig save
```
Uruchom aplikację HelloWorldAsync na poziomie biznesowym.
Aby uruchomić aplikację, należy użyć komendy startBLA .
Używając Jython:
```
AdminTask.startBLA('-blaID HelloWorldAsync')
```
Używając Jacl:
```
$AdminTask startBLA {-blaID HelloWorldAsync}
```
Sprawdź, czy został wyświetlony następujący komunikat wskazujący, że aplikacja została pomyślnie uruchomiona:
```
CWWMH0196I: Aplikacja na poziomie biznesowym "WebSphere:blaname=HelloWorldAsync" została pomyślnie uruchomiona.
```
Opcjonalnie można wysłać zapytanie o status, aby sprawdzić, czy aplikacja jest uruchomiona za pomocą komendy getBLAStatus .
Używając Jython:
```
AdminTask.getBLAStatus('-blaID HelloWorldAsync')
```
Używając Jacl:
```
$AdminTask getBLAStatus {-blaID HelloWorldAsync}
```
Następujący komunikat wskazuje, że aplikacja została uruchomiona:
```
BLA: WebSphere:blaname=HelloWorldAsync Status of business-level application "WebSphere:blaname=HelloWorldAsync" is "ExecutionState.STARTED".
```
Wyjdź z powłoki komend wsadmin.
```
exit
```

Następne czynności do wykonania

Opcjonalnie można sprawdzić, i ewentualnie użyć w aplikacjach, innych przykładowych plików SCA w katalogu SCA/installableApps pobranych przykładów SCA.

Jeśli aplikacja na poziomie biznesowym nie zostanie uruchomiona, należy sprawdzić, czy docelowe miejsce wdrożenia, na które odwzorowywana jest aplikacja, działa, i spróbować uruchomić aplikację ponownie. Jeśli zasoby aplikacyjne kompozytu SCA nie zostaną uruchomione, należy sprawdzić, czy każdy zasób aplikacyjny został odwzorowany na miejsce docelowe wdrażania, które obsługuje kompozyty SCA.

Jeśli jednostka kompozycji zasobu aplikacyjnego korzysta z powiązania komponentu EJB (Enterprise JavaBeans ) i nie jest uruchomiona, ponieważ ma non-WebSphere target of "null", należy usunąć jednostkę kompozycji zasobu aplikacyjnego i dodać ją ponownie do aplikacji na poziomie biznesowym. Określ kapelusz docelowy, który obsługuje kompozyty SCA podczas dodawania zasobu aplikacyjnego do aplikacji na poziomie biznesowym. Nie można zmieniać elementu docelowego po wdrożeniu.

Jeśli aplikacja SCA korzysta z zabezpieczeń, miejsce docelowe musi znajdować się w globalnej domenie zabezpieczeń.