Preferencje usług WWW

Przed rozpoczęciem programowania usług lub klientów WWW można zoptymalizować środowisko robocze pod kątem tworzenia usług WWW, ustawiając różne preferencje.

Aby ustawić dowolne preferencje dla usług WWW, wykonaj następujące czynności:
  1. Kliknij kolejno opcje Okno > Preferencje, aby otworzyć notatnik Preferencje.
  2. Rozwiń pozycję Usługi WWW lub WWW i XML, a następnie kliknij kategorię preferencji, którą chcesz ustawić.
  3. Zaznacz pola wyboru, które mają być domyślnie ustawione podczas tworzenia usługi WWW.
  4. Kliknij przycisk OK, aby zastosować zmiany i zamknąć notatnik Preferencje.
Aby uzyskać więcej informacji na temat dowolnej opcji, wybierz ją i naciśnij klawisz F1.

Narzędzia do tworzenia usług WWW umożliwiają zdefiniowanie następujących preferencji.

Emiter Axis
Ta strona umożliwia ustawienie następujących preferencji służących do tworzenia usług WWW Axis lub korzystania z nich.
WSDL2Java
  • Generuj kod dla wszystkich elementów: domyślnie WSDL2Java generuje kod tylko dla tych elementów w pliku WSDL, do których istnieją odwołania. Informacje dodatkowe dotyczące działania odwołań zawiera podręcznik Axis: http://ws.apache.org/axis/java/reference.html
  • Emituj osobne klasy pomocnicze dla metadanych: po wybraniu tej opcji środowisko WSDL2Java utworzy oddzielną klasę pomocniczą, która zawiera metadane, zamiast włączać ją do szkieletu.
  • Preferuje tworzenie komponentów Bean do prostych tablic dla typów opakowanych tablic XML: domyślnym zachowaniem jest odwzorowanie tej konstrukcji XML:
    <element name="tablica">
     <complexType>
      <sequence>
       <element name="element" type="xs:string"/>
      </sequence>
     </complexType>
    </element>
    na tablicę łańcuchów Java (String[]). Jeśli użytkownik woli generowanie konkretnej klasy JavaBean (ArrayOfString) dla tych typów schematów, powinien wybrać tę opcję.
  • Dodaj zasięg do pliku deploy.wsdd: wskazuje to, jak ma być wdrażana implementacja serwera. Aplikacja powoduje zastosowanie jednej instancji klasy implementacji dla wszystkich żądań. Żądanie powoduje utworzenie nowej instancji klasy implementacji dla każdego żądania. Sesja powoduje utworzenie nowej instancji klasy implementacji dla każdej sesji.
  • Limit czasu w sekundach: domyślnie 45. Wartość -1 wyłącza limit czasu.
Java2WSDL
  • Szukaj dozwolonych metod w klasach dziedziczonych: jeśli użyto tej opcji, to analizator składni Java2WSDL będzie szukał metod potrzebnych do wyeksportowania do pliku WSDL rónież w klasach rozszerzonych.
  • Analizuj klasę usługi pod kątem zgodności ze specyfikacją JAX-RPC przed generowaniem kodu: wybranie tej opcji powoduje, że klasa usługi Java i jej typy wartości będą analizowane przez narzędzia w celu określenia, czy spełnia ona ważne wymagania specyfikacji JAX-RPC.
Wybór wywoływanego okna dialogowego
Preferencje z grupy Okna dialogowe umożliwiają określenie, które okna dialogowe mają być wyświetlane podczas uruchamiania akcji podręcznych. Jeśli dowolne okno dialogowe zostało wyłączone poprzez wybranie opcji "Nie pokazuj więcej tego okna dialogowego" na pierwszej stronie kreatora usług WWW, to można wycofać tę zmianę, usuwając zaznaczenie pola wyboru obok okna dialogowego, które zostało ukryte.
Sprawdzanie poprawności i zgodności profilu
Preferencje zgodności ze specyfikacją WS-I umożliwiają wybranie poziomu zgodności z profilem Simple SOAP Binding Profile (SSBP) WS-I i Attachement Profile (AP) WS-I. Uwaga: zmiana poziomu zgodności ze specyfikacją WS-I w momencie, gdy w widoku Zadanie wyświetlona jest lista niezgodności WS-I, nie spowoduje automatycznej aktualizacji tego widoku. Przed usunięciem ostrzeżeń z widoku Zadanie należy ponownie sprawdzić poprawność obszaru roboczego. Więcej informacji na temat specyfikacji WS-I można znaleźć pod adresem: http://www.ws-i.org/
W preferencjach sprawdzania poprawności można określić, czy pliki WSDL używane przez kreatory usług WWW są sprawdzane oraz czy sprawdzanie WSDL musi zakończyć się zanim kreator przejdzie do kolejnego kroku.
Topologia projektu
Preferencje topologii projektu umożliwiają określenie następujących opcji.
  • Wybranie domyślnego typu projektu klienta, który kreator usług WWW utworzy podczas generowania klienta usługi WWW. Można także ustawić kolejność, w jakiej typy projektów klienta będą wymienione na liście w kreatorze. Należy mieć na uwadze, że wybór ten jest po prostu wartością domyślną i że w kreatorze można wybrać inny typ projektu.
  • Wybranie, czy usługa WWW i jej klient mają być generowane w jednym projekcie EAR, czy w różnych. Generowanie usługi i klienta w różnych projektach EAR zmniejsza ryzyko konfliktów, które występują, gdy oba elementy istnieją w jednym projekcie EAR, ale powoduje większe zużycie zasobów systemowych.
Zarządzanie zasobami
Preferencje zarządzania zasobami umożliwiają określenie wartości domyślnych tworzenia i nadpisywania plików i folderów, które mają być stosowane podczas tworzenia usługi WWW.
  • Zastąp pliki bez ostrzeżenia: wybranie tej opcji umożliwi kreatorom nadpisywanie wszelkich istniejących plików w obszarze roboczym bez wyświetlania ostrzeżenia. Jeśli opcja ta nie będzie zaznaczona, to za każdym razem, gdy potrzebne będzie nadpisanie pliku, zostanie wyświetlona prośba o potwierdzenie tej operacji.
  • Utwórz foldery w razie potrzeby: wybranie tej opcji umożliwia kreatorom tworzenie wybranych folderów.
  • Pobierz pliki bez ostrzeżenia: wybierz tę opcję, aby pobierać pliki bez wyświetlania komunikatów ostrzegawczych zawierających prośbę o potwierdzenie tej operacji.
  • Scal wygenerowany plik szkieletu: to pole wyboru jest domyślnie wyłączone. W przypadku włączenia tej opcji jeśli w obszarze roboczym występuje już plik szkieletu o podanej nazwie, nowo utworzony plik szkieletu zostanie z nim połączony. Włączenie tej opcji umożliwia zachowanie kodu, który już zmodyfikowano w istniejących plikach szkieletu.

    Jeśli opcja ta jest włączona, w przypadku zmiany typu powrotu interfejsu w wynikowym pliku szkieletu zostanie umieszczona metoda zwracająca typ zdefiniowany w nowym interfejsie, natomiast treść metody z pierwotnego pliku szkieletu pozostanie niezmieniona (czyli będzie zwracać inny typ). Spowoduje to błąd kompilacji, który będzie trzeba naprawić ręcznie.

Ustawienia domyślne scenariusza
Preferencje ustawień domyślnych scenariusza umożliwiają określanie następujących wartości domyślnych używanych podczas tworzenia usługi WWW:
  • jaki typ klienta i usługi WWW ma być wybrany domyślnie;
  • które fazy cyklu życia usługi WWW mają zostać zakończone w kreatorze;
  • czy eksporator usług WWW ma być uruchamiany domyślnie, aby można było opublikować usługę w rejestrze UDDI;
  • czy ruch SOAP usługi WWW ma być kierowany przez monitor TCP/IP, aby można było monitorować pakiety SOAP i opcjonalnie testować je pod kątem zgodności ze specyfikacją WS-I.
Wszystkie te wartości domyślne można przesłonić w kreatorze.
Serwer i środowisko wykonawcze
Wybierz serwer, środowisko wykonawcze usługi WWW oraz wersję środowiska J2EE, które mają być domyślnie wybrane w kreatorze usług WWW. Wszystkie te wartości domyślne można przesłonić w kreatorze.
Ustawienia domyślne narzędzia testującego
Umożliwia wybranie, czy kreator ma automatycznie uruchamiać narzędzie testujące, oraz określenie preferowanego typu narzędzia testującego.
Pliki WSDL
Podczas tworzenia pliku WSDL w edytorze WSDL można ustawić domyślną docelową przestrzeń nazw. Jeśli wartość domyślna nie zostanie zmieniona, to docelową przestrzenią nazw dla pliku WSDL będzie http://tempuri.org.