Implementowanie niestandardowego algorytmu zabezpieczeń

/**
* ***************************************************************
* IBM - poufne
* 
* © Copyright IBM Corporation. 2008. Wszelkie prawa zastrzeżone.
* 
* Tajemnice handlowe zawarte w kodzie źródłowym tego programu nie zostały ujawnione
* przez jego publikację ani w żaden inny sposób, bez względu na informacje
* przechowywane w urzędzie patentowym Stanów Zjednoczonych (US Copyright Office).
* *************************************************************** 
* 
*/

package com.ibm.rational.test.lt.models.wscore.datamodel.security.xmlsec;

import java.util.Properties;
import org.w3c.dom.Document;


public interface ICustomSecurityAlgorithm {
	
	/**
	 * Następujące metody mogą zostać użyte w obu przypadkach:
	 * Wykonanie w środowisku roboczym i wykonanie testu.
	 */
	
	
	/**
	 * Wywoływane w celu przetworzenia dokumentu wysyłanego w transporcie.
	 * @param subject
	 */
	void process(Document subject);
	/**
	 * Wywoływane w celu przetworzenia wstecznego dokumentu odebranego z serwera.
	 * @param subject
	 */
	void unProcess(Document subject);
	
	/**
	 * Właściwości zdefiniowane w interfejsie użytkownika CustomSecurityAlgorithm.
	 * @param map
	 */
	void setProperties(Properties map);
	
	/**
	 * Następujące metody mogą być używane tylko w kontekście rzutowania na interfejs usług testowych,
	 * lub uzyskiwania dostępu do wcześniejszych informacji XML, gdy plik jar zawierający
	 * niestandardowy algorytm zabezpieczeń jest wdrażany w projekcie testu wydajności. W
	 * takim przypadku nie można używać algorytmu bezpośrednio w obszarze roboczym.
	 */
	
	/**
	 * Ten obiekt odpowiada obiektowi ITestExecutionService.
	 * Ma to zastosowanie tylko w przypadku algorytmu, który musi łączyć się z wykonaniem testu.
	 * Jeśli jest planowane użycie tego obiektu, konieczne będzie wdrożenie pliku jar zawierającego
	 * implementację w projekcie testu wydajności, a nie bezpośrednio w środowisku JRE.
	 * 
	 * W przypadku gdy potrzebny jest wcześniejszy dokument xml otrzymany na etapie wykonania, można 
	 * uzyskać wartość za pomocą wywołania:
	 * IDataArea area = ((ITestExecutionService)executionObject).findDataArea(IDataArea.VIRTUALUSER);
	 *String previousXML = (String) area.get("PREVIOUS_XML"); //$NON-NLS-1$
	 * 
	 */
	void setExecutionContext(Object executionObject);

Metoda process modyfikuje kod XML przed wysłaniem go na serwer.

Metoda unprocess modyfikuje kod XML po jego odebraniu z serwera.

Metoda setProperties pobiera dowolne właściwości zdefiniowane w edytorze zabezpieczeń dla tego niestandardowego interfejsu zabezpieczeń.

Metoda setExecutionContext jest wywoływana w czasie testu z obiektem ITestExecutionServices odpowiadającym komunikatowi za pomocą niestandardowego interfejsu zabezpieczeń.

• W przypadku testowania usług WWW opartych na protokole WSDL należy kliknąć prawym przyciskiem myszy plik WSDL w nawigatorze testów lub eksploratorze projektów w celu otwarcia edytora zabezpieczeń WSDL, wybrać stronę Algorytmy zabezpieczeń, a następnie w obszarze Szczegóły wybranego stosu algorytmów zabezpieczeń kliknąć opcję Dodaj > Niestandardowy algorytm zabezpieczeń.
• W przypadku testowania wywołania XML należy otworzyć element wywołania XML w edytorze testu, wybrać kartę Lokalne zabezpieczenia XML, a następnie kliknąć opcję Dodaj > Niestandardowy algorytm zabezpieczeń.