5.A.1.1. Wstęp

Wtyczka BeanShell udostępnia język skryptowy zgodny z językiem Java.

Dokładną specyfikację można znaleźć na stronie BeanShell

Wtyczka podpina się w wielu miejscach programu ORBADA. Udostępnia język skryptowy by lepiej i łatwiej wykorzystać możliwości programu.
Poniżej miejsca w których można użyć języka skryptowego:

• Widok BeanShell dostępny z menu Widok
• Skrypt wykonywany przy otwarciu i zamknięciu programu
• W widoku zapytań SQL poprzez użycie bloku beanshell { ... }
• Skrypty akcji podpinane wszędzie tam gdzie użyty jest uniwersalny mechanizm akcji

5.A.1.2. Widok BeanShell

Widok BeanShell dostępny jest poprzez wybranie pozycji z menu Widok->Edytor BeanShell
Widok dostępny jest zarówno dla perspektyw z połączeniem do bazy danych jak i perspektywy narzędziowej.

W edytorze BeanShell dostępne są wszelkie klasy Java oraz obiekty programu. Zdefiniowane są również stałe:

5.A.1.3. Rozpoczęcie i zakończenie działania programu ORBADA

Konfiguracja skryptów rozpoczęcia i zakończenia dostępna jest w Program->Ustawienia->Ustawienia wtyczek->BeanShell->Start i zakończenie"

Skrypty będą wykonane odpowiednio zaraz po uruchomieniu programu oraz tuż przed jego zamknięciem.

W skryptach BeanShell dostępne są wszelkie klasy Java oraz obiekty programu. Zdefiniowane są również stałe:

5.A.1.4. Widok zapytań SQL

W widoku zapytań SQL można użyć skryptu BeanShell na dwa sposoby:

1. Wpisując pomiędzy beanshell {, a } skrypt języka
   np. beanshell { 2 +2 *2; }
   Po uruchomieniu na ekranie w okienku pojawi się wynik wykonania skryptu.
2. W poleceniach SQL wpisując pomiędzy beanshell {, a } skrypt języka np.:
   
   1. select beanshell { 2 +2 *2; } from dual
      Po uruchomieniu zapytania na liście wyników pojawi się wiersz z wartością "6"
   2. select 'beanshell { new pl.mpak.util.id.VersionID(1, 0, 0, 150) }' value from dual
      Po uruchomieniu zapytania na liście wyników pojawi się tekstowa reprezentacja wersji '1.0.0.150'
   Uwaga
   W tym przypadku skrypt zostanie wykonany przed wykonaniem polecenia SQL, a jego wynik zostanie wtawiony w miejsce skryptu jako ciąg znaków

W skrypcie BeanShell dostępne są wszelkie klasy Java oraz obiekty programu. Zdefiniowane są również stałe:

5.A.1.5. Konfiguracja akcji

Opis czynności jakie należy wykonać by podpiąć kod BeanShell do akcji programu.

5.A.1.6. Predefiniowane funkcje BeanShell

Biblioteka BeanShell udostępnia predefiniowane polecenia, które znajdują się w katalogu bsh-2.0b4.jar\bsh\commands
Oprócz tego sama wtyczka udostępnia parę poleceń przydających się podczas tworzenia oprogramowania. Znajdują się one w katalogu orbada-beanshell.jar\pl\mpak\orbada\beanshell\commands

5.A.1.7. Przykłady

Kilka przykładów pokazujących w jaki sposób można pisać skrypty BeanShell i gdzie można je wykorzystać.