Tworzenie niestandardowego kodu Java

Kod niestandardowy używa odwołań w teście jako danych wejściowych i zwraca zmodyfikowane wartości do testu. Interfejs ICustomCode2 służy do tworzenia kodu niestandardowego, a interfejs ITestExecutionServices służy do rozszerzania wykonania testu. Te interfejsy znajdują się w pakiecie com.ibm.rational.test.lt.kernel.services.

O tym zadaniu

Uwaga: W przypadku używania interfejsu ITestExecutionServices w kodzie niestandardowym do raportowania wyników testu wyniki dla kodu niestandardowego będą widoczne w dzienniku testu. W przypadku rejestrowania wyników niestandardowego punktu weryfikacji będą one znajdowały odzwierciedlenie w ogólnym wyniku harmonogramu.

Wartości wejściowe kodu niestandardowego mogą znajdować się w odwołaniach lub odwołaniach do pól. Do kodu niestandardowego można również przekazać łańcuch tekstowy jako argument. Odwołania używane jako dane wejściowe kodu niestandardowego należy uwzględnić w tym samym teście, w którym uwzględniono kod niestandardowy. W teście odwołanie musi znajdować się przed kodem, na który ma ono wpływ. Należy sprawdzić, czy test zawiera odwołania wymagane na potrzeby niestandardowych danych wejściowych do kodu. Szczegółowe informacje na temat tworzenia odwołań i odwołań do pól zawiera sekcja Tworzenie odwołania lub odwołania do pola.

Jeśli kod niestandardowy korzysta z zewnętrznych plików JAR, może być konieczna zmiana ścieżki budowania kodu Java™. W niektórych przypadkach można uniknąć konieczności ręcznej zmiany ścieżki budowania, uruchamiając test przed dodaniem do niego kodu niestandardowego. Przy pierwszym uruchomieniu testu klasy i biblioteki wymagane na potrzeby kompilacji są dodawane do ścieżki budowania. Można na przykład zaimportować klasy platformy TPTP (Test and Performance Tools Platform) wymagane na potrzeby tworzenia zdarzeń niestandardowych w dzienniku testu, jeśli test, do którego dodano kod niestandardowy, został wcześniej uruchomiony. Jeśli jednak test nie został jeszcze nigdy uruchomiony, wystąpią błędy importowania, ponieważ klasy zostaną określone w ścieżce budowania projektu dopiero po uruchomieniu testu.

Jeśli kod korzysta z zasobów zewnętrznych, na przykład z bazy danych SQL lub z produktu służącego do zarządzania relacjami z klientami, należy skonfigurować kod niestandardowy tak, aby działał na każdym komputerze, na którym test będzie uruchamiany.

Kod niestandardowy jest zapisywany w folderze src projektu zawierającego test, który wywołuje kod. Domyślnie kod niestandardowy znajduje się w folderze src w pakiecie o nazwie test.

Pakiet kodu niestandardowego można ponownie wykorzystywać w testach, które znajdują się w wielu projektach. Projekty muszą znajdować się w jednym obszarze roboczym. Aby móc ponownie wykorzystać kod niestandardowy w różnych projektach, należy dodać nazwę projektu przed pakietem kodu niestandardowego. Przykład: Pole nazwy klasy..

W poniższym przykładzie przedstawiono standardowy widok nawigatora z widocznymi dwoma klasami kodu niestandardowego. W nawigatorze testów nie są wyświetlane pliki źródłowe Java.

Widok nawigatora z widocznymi klasami ReplaceCC.java i VerifyUserID.java

Jeśli do testu dodano klasy kodu niestandardowego ReplaceCC.java i VerifyUserID.java i wartość jest zwracana do testu, te dwie klasy będą wyświetlane po kliknięciu opcji Podstaw.

Pakiet testów zawiera również wygenerowany kod Java dla testów w projekcie.

Kod niestandardowy można umieścić w innym pakiecie, na przykład custom. Kod niestandardowy należy oddzielić od wygenerowanego zwłaszcza wtedy, gdy używany jest system kontroli kodu źródłowego.

Procedura

Aby dodać kod niestandardowy:

  1. Otwórz test i wybierz element testowy.
  2. Kliknij opcję Dodaj lub Wstaw i wybierz opcję Kod niestandardowy. Opcja Dodaj umożliwia dodanie kodu niestandardowego poniżej wybranego elementu testowego. Opcja Wstaw umożliwia dodanie kodu niestandardowego powyżej wybranego elementu testowego.
    Uwaga: Po dodaniu lub wstawieniu kodu niestandardowego w widoku Problemy zostanie wyświetlony błąd informujący o tym, że nowy element kodu niestandardowego nie ma pliku Java. Ten komunikat o błędzie zniknie dopiero po kliknięciu opcji Wyświetl kod lub Generuj kod. Przypomina on o tym, że element testowy kodu niestandardowego nie został jeszcze powiązany z żadnym kodem Java.
  3. Sprawdź pole Nazwa klasy i wykonaj jeden z poniższych kroków:
    • Jeśli kod do wywołania już istnieje, zmień nazwę klasy tak, aby dopasować ją do jego nazwy. Kliknij opcję Wyświetl kod, aby otworzyć kod w edytorze kodu Java.
    • Jeśli kod nie istnieje, zmień nazwę klasy, aby opisać przeznaczenie kodu. Kliknij opcję Generuj kod, aby wygenerować klasę z szablonu na potrzeby rejestrowania wyników, a następnie otwórz ją w edytorze kodu Java. Jeśli klasa o tej nazwie istnieje, użytkownik jest ostrzegany o tym, że zostanie ona zastąpiona.
  4. W polu Argumenty kliknij przycisk Dodaj.
  5. W oknie Kod niestandardowy wybierz wszystkie dane wejściowe wymagane w kodzie. W oknie Kod niestandardowy wyświetlane są wszystkie wartości w teście, których można użyć jako danych wejściowych w kodzie (odwołania lub odwołania do pól w teście poprzedzające kod).
  6. Kliknij przycisk OK. Okno zostanie zamknięte, a wybrane odwołania zostaną dodane do pola Argumenty.
  7. Opcjonalne: Aby dodać łańcuchy tekstowe jako dane wejściowe do kodu niestandardowego, kliknij opcję Tekst, a następnie wpisz łańcuch tekstowy, który ma zostać użyty.
  8. W teście, po kodzie niestandardowym, znajdź wartość zwracaną przez kod do testu.
  9. Podświetl wartość.
  10. Kliknij prawym przyciskiem myszy podświetloną wartość, kliknij opcję Podstaw i wybierz nazwę klasy kodu niestandardowego. Zostaną wyświetlone dodane klasy kodu niestandardowego. Po dokonaniu wyboru wartość zwracana do testu zostanie podświetlona na pomarańczowo, a tabela Używany przez zostanie zaktualizowana o te informacje.

Co dalej

Kod niestandardowy nie jest wyświetlany w widoku Nawigator testów. Aby wyświetlić kod niestandardowy, należy otworzyć widok Eksplorator pakietów i użyć narzędzi Java w celu zidentyfikowania dodanego kodu niestandardowego.

Opinia