ORBADA - Dokumentacja
Author: Andrzej Kałuża, ORBADA
Description: Organizer Bazy Danych, Db Pages

2016-12-06 08:15
ORBADA » Dokumentacja po Polsku » Dokumentacja wtyczek » BeanShell

### 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:

Właściwość | Opis
--- | ---
self | Stała oznaczająca obiekt klasy `Interpreter` biblioteki BeanShell
database | Jeśli dostępne jest połączenie z bazą danych, w tej stałej znajduje się obiekt klasy `Database` biblioteki UseDB
application | Pozwala uzyskać dostęp do właściwości aplikacji poprzez funkcje interfejsu `IApplication` programu ORBADA

### 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:

Właściwość | Opis
--- | ---
self | Stała oznaczająca obiekt klasy `Interpreter` biblioteki BeanShell
application | Pozwala uzyskać dostęp do właściwości aplikacji poprzez funkcje interfejsu `IApplication` programu ORBADA

### 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:

Właściwość | Opis
--- | ---
self | Stała oznaczająca obiekt klasy `Interpreter` biblioteki BeanShell
application | Pozwala uzyskać dostęp do właściwości aplikacji poprzez funkcje interfejsu `IApplication` programu ORBADA

### 5.A.1.5. Konfiguracja akcji

• Uzyskanie informacji o "kluczu" i "komponencie" akcji • Konfiguracja • Dostępność elementów programu w skrypcie BeanShell • Sprawdzenie działania 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

• Widok BeanShell dla perspektyw z połączeniem do bazy danych • Widok BeanShell • Uruchomienie programu • Akcje BeanShell • Zakładka zapytań SQL •

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

ORBADA » Dokumentacja po Polsku » Dokumentacja wtyczek » BeanShell
• © 2007–2016 • Andrzej Kałuża • Powered By DBPAGES • Hostet at •