Ο οδηγός διαδικτυακών υπηρεσιών σας βοηθάει στη δημιουργία σκελετού bean από υπάρχον έγγραφο WSDL. Το bean σκελετού περιλαμβάνει μια σειρά απο μεθόδους οι οποίες αντιστοιχούν στις λειτουργίες που περιγράφονται στο έγγραφο WSDL. Όταν δημιουργείται το bean, η συνήθης υλοποίηση κάθε μεθόδου μπορεί να αντικατασταθεί με τροποποίηση του bean.
Προϋποθέσεις:
- Αν χρησιμοποιείτε τη θέση υποδοχής μικροεφαρμογής εξυπηρετητή
Apache Jakarta Tomcat ως εξυπηρετητή, πρέπει να την εγκαταστήσετε, να ρυθμίστε μια χρήση
της και να δημιουργήσετε ένα διαδικτυακό έργο το οποίο να προορίζεται σε αυτή όπως
περιγράφεται στην ενότητα Δημιουργία
εξυπηρετητή Apache Tomcat και διαδικτυακού έργου
- Δημιουργήστε ή εισαγάγετε ένα αρχείο WSDL στο φάκελο διαδικτυακού περιεχομένου του
διαδικτυακού έργου.
Μπορείτε να χρησιμοποιήσετε μόνο ένα αρχείο WSDL που περιέχει ένα στοιχείο service.
Για να δημιουργήσετε διαδικτυακή υπηρεσία από ένα αρχείο WSDL χρησιμοποιώντας το
περιβάλλον εκτέλεσης Apache Axis1:
- Μεταβείτε στην προοπτική Java EE (Παράθυρο > Άνοιγμα προοπτικής > Java EE).
- Στην προβολή "Εξερεύνηση έργων", επιλέξτε το αρχείο WSDL που δημιουργήσατε ή
εισαγάγατε στο φάκελο διαδικτυακού περιεχομένου του διαδικτυακού έργου.
- Πατήστε Αρχείο > Δημιουργία >
Άλλο. Επιλέξτε
Διαδικτυακές υπηρεσίες για να εμφανιστούν οι διάφοροι οδηγοί
διαδικτυακών υπηρεσιών.
Επιλέξτε τον οδηγό Διαδικτυακή υπηρεσία. Πατήστε
Επόμενο.
- Σελίδα Διαδικτυακές υπηρεσίες: επιλέξτε
Διαδικτυακή υπηρεσία Java bean από πάνω προς τα κάτω ως
είδος διαδικτυακής υπηρεσίας και επιλέξτε το τεχνούργημα από το οποίο θα δημιουργηθεί η
υπηρεσία.
- Επιλέξτε τα στάδια ανάπτυξης διαδικτυακών υπηρεσιών που
θέλετε να ολοκληρώσετε χρησιμοποιώντας τη γραμμή κύλισης:
- Ανάπτυξη: πραγματοποιεί ανάπτυξη του ορισμού WSDL και υλοποίηση της διαδικτυακής
υπηρεσίας. Αυτή η διαδικασία περιλαμβάνει εργασίες όπως δημιουργία λειτουργικών μονάδων
οι οποίες θα περιέχουν κώδικα που δημιουργείται, αρχείων WSDL, αρχείων περιγραφής
διανομής καθώς και αρχείων Java όταν απαιτείται.
- Συγκρότηση: αυτή η διαδικασία διασφαλίζει ότι το έργο που θα φιλοξενήσει τη
διαδικτυακή υπηρεσία ή τον πελάτη θα συσχετιστεί με ένα αρχείο EAR όταν αυτό απαιτείται
από τον εξυπηρετητή εφαρμογών προορισμού.
- Διανομή: δημιουργεί τον κώδικα διανομής για την υπηρεσία.
- Εγκατάσταση: πραγματοποιεί εγκατάσταση και ρύθμιση της διαδικτυακής λειτουργικής
μονάδας και των EAR στον εξυπηρετητή προορισμού.
- Έναρξη: εκκινεί τον εξυπηρετητή αφού εγκατασταθεί σε αυτόν η υπηρεσία.
Θα δημιουργηθεί το αρχείο server-config.wsdd.
- Δοκιμή: παρέχει διάφορες επιλογές δοκιμής της υπηρεσίας, όπως χρήση της εξερεύνησης
διαδικτυακών υπηρεσιών ή δειγμάτων αρχείων JSP.
- Επιλογή εξυπηρετητή: εμφανίζεται ο προεπιλεγμένος
εξυπηρετητής. Αν θέλετε να διανείμετε την υπηρεσία σε διαφορετικό εξυπηρετητή, πατήστε τη διασύνδεση για να καθορίσετε διαφορετικό εξυπηρετητή.
- Επιλογή περιβάλλοντος εκτέλεσης: εμφανίζεται το
προεπιλεγμένο περιβάλλον εκτέλεσης. Αν θέλετε να διανείμετε την υπηρεσία σε διαφορετικό
περιβάλλον εκτέλεσης, πατήστε στη διασύνδεση για να καθορίσετε διαφορετικό περιβάλλον
εκτέλεσης.
- Επιλογή έργου υπηρεσίας: εμφανίζεται το έργο που
περιέχει το επιλεγμένο έργο στον χώρο εργασίας. Για να επιλέξετε διαφορετικό έργο και EAR
πατήστε στη διασύνδεση έργου.Βεβαιωθείτε ότι το έργο που επιλέχθηκε ως διαδικτυακό έργο πελάτη είναι διαφορετικό
από το διαδικτυακό έργο υπηρεσίας, διαφορετικά η υπηρεσία θα αντικατασταθεί από τα
τεχνουργήματα πελάτη που δημιουργούνται.
- Αν θέλετε να δημιουργήσετε έναν πελάτη, επιλέξτε το είδος του ενδιάμεσου εξυπηρετητή
που θα δημιουργηθεί και επαναλάβετε τα παραπάνω βήματα για τον πελάτη.
- Δημοσίευση της διαδικτυακής υπηρεσίας: πραγματοποιείται εκκίνηση της εξερεύνησης
διαδικτυακών υπηρεσιών για τη δημοσίευση της διαδικτυακής υπηρεσίας σε μητρώο UDDI.
- Παρακολούθηση της διαδικτυακής υπηρεσίας: αποστέλλει την
κίνηση διαδικτυακής υπηρεσίας μέσω της λειτουργίας παρακολούθησης TCP/IP, το οποίο σας
επιτρέπει την παρακολούθηση της κίνησης SOAP που δημιουργείται από τη διαδικτυακή
υπηρεσία και τη δοκιμή της κίνησης αυτής για συμβατότητα με το WS-I. Εναλλακτικά, μπορείτε να ρυθμίσετε
με μη αυτόματο τρόπο μια λειτουργία παρακολούθησης TCP/IP, όπως περιγράφεται στην ενότητα
Χρήση
της λειτουργίας παρακολούθησης TCP/IP για δοκιμή των διαδικτυακών υπηρεσιών
- Σελίδα "Ρύθμιση σκελετού Java™ Bean διαδικτυακής υπηρεσίας":
Επιλέξτε τον φάκελο στον οποίο θα αποθηκευτεί ο κώδικας Java που θα δημιουργηθεί. Αν θέλετε να εξετάσετε ή να τροποποιήσετε τις αντιστοιχίες μεταξύ
πακέτων και χώρων ονομάτων, επιλέξτε το τετραγωνίδιο Ορισμός προσαρμοσμένης
αντιστοιχίας μεταξύ χώρου ονομάτων και πακέτου. Πατήστε
Επόμενο.
- Σελίδα "Αντιστοίχιση χώρου ονομάτων διαδικτυακών υπηρεσιών σε
πακέτο": Αν επιλέξατε Ορισμός προσαρμοσμένης αντιστοιχίας
μεταξύ χώρου ονομάτων και πακέτου στο προηγούμενο πλαίσιο, μπορείτε να καταχωρήσετε
τα προσαρμοσμένα ζεύγη αντιστοιχιών σε αυτό το πλαίσιο πατώντας
Προσθήκη. Εναλλακτικά, μπορείτε να πατήσετε Εισαγωγή για να εισαγάγετε προσαρμοσμένα ζεύγη
αντιστοιχιών από ένα αρχείο .properties.
Το περιεχόμενο του αρχείου ιδιοτήτων πρέπει να έχει τη μορφη
namespace=package.
Θα πρέπει να χρησιμοποιήσετε χαρακτήρες διαφυγής για ορισμένους ειδικούς χαρακτήρες
στα αρχεία ιδιοτήτων.
Για παράδειγμα, το κείμενο http://someNamespace=somePackage θα πρέπει να
γραφεί ως http\://someNamespace=somePackage.
Διαφορετικά, η άνω και κάτω τελεία (:) θα θεωρηθεί οριοθέτης και το πρόγραμμα θα
επιχειρήσει να αντιστοιχίσει το http με το
//someNamespace=somePackage.
- Σελίδα "Δοκιμή διαδικτυακής υπηρεσίας": Αν έχετε επιλέξει τη
δοκιμή της διαδικτυακής υπηρεσίας, επιλέξτε τη λειτουργία δοκιμής για τη διαδικτυακή
υπηρεσία που δημιουργήθηκε. Με αυτόν τον τρόπο ανοίγει η διαδικτυακή υπηρεσία στην εξερεύνηση διαδικτυακών
υπηρεσιών. Επιλέξτε τη λειτουργία που θέλετε να δοκιμάσετε, πληκτρολογήστε
τις απαιτούμενες πληροφορίες και πατήστε Εκτέλεση.
Το αποτέλεσμα θα εμφανιστεί στο πλαίσιο "Κατάσταση". Πατήστε
Επόμενο.
- Σελίδα "Ενδιάμεσος εξυπηρετητής διαδικτυακής υπηρεσίας": Αν
έχετε επιλέξει τη δημιουργία ενδιάμεσου εξυπηρετητή, αυτή η σελίδα εμφανίζει τις
επιλογές του ενδιάμεσου εξυπηρετητή. Εμφανίζει το φάκελο στον οποίο θα δημιουργηθεί ο
ενδιάμεσος εξυπηρετητής και προαιρετικά μπορείτε να δημιουργήσετε προσαρμοσμένες
αντιστοιχίες μεταξύ χώρων ονομάτων και πακέτων. Πατήστε
Επόμενο.
- Σελίδα "Δοκιμή πελάτη διαδικτυακής υπηρεσίας": Χρησιμοποιήστε
αυτήν τη σελίδα για να πραγματοποιήσετε τις παρακάτων επιλογές:
- Επιλέξτε τη λειτουργία δοκιμής. Μπορείτε να δοκιμάσετε τον ενδιάμεσο
εξυπηρετητή που δημιουργείται στην εξέρευνηση διαδικτυακών υπηρεσιών ή μπορείτε να
δημιουργήσετε ένα δείγμα JSP διαδικτυακής υπηρεσίας.
- Αν επιλέξετε τη δοκιμή του ενδιάμεσου εξυπηρετητή μέσω ενός JSP, μπορείτε να
επιλέξετε το φάκελο στον οποίο βρίσκεται το JSP καθώς και τις μεθόδους θα συμπεριληφθούν
στο JSP.
- Επιλέξτε Εκτέλεση δοκιμής στον εξυπηρετητή
για την αυτόματη εκκίνηση του εξυπηρετητή.
- Σελίδα "Δημοσίευση διαδικτυακής υπηρεσίας": Αν έχετε
επιλέξει τη δημοσίευση της διαδικτυακής υπηρεσίας σε μητρώο UDDI, χρησιμοποιήστε αυτή
τη σελίδα για την εκκίνηση της εξερεύνησης διαδικτυακών υπηρεσιών και επιλέξτε το μητρώο
UDDI στο οποίο θα δημοσιευτεί η διαδικτυακή υπηρεσία. Πατήστε
Ολοκλήρωση.
Αφού δημιουργηθεί η διαδικτυακή υπηρεσία, ενδέχεται να
προκύψουν οι ακόλουθες περιπτώσεις ανάλογα με τις επιλογές που έχετε πραγματοποιήσει:
- Αν έχετε επιλέξει τη δοκιμή του ενδιάμεσου εξυπηρετητή που δημιουργείται με τη χρήση
JSP διαδικτυακών υπηρεσιών, γίνεται εκκίνηση του ενδιάμεσου εξυπηρετητή σε ένα πρόγραμμα
πλοήγησης στην ακόλουθη διεύθυνση URL: http://localhost: port/
WebProjectClient/sampleBeanName/WebServiceName/TestClient.jsp
Μπορείτε να χρησιμοποιήσετε αυτό το δείγμα εφαρμογής για να πραγματοποιήσετε δοκιμή της
διαδικτυακής υπηρεσίας επιλέγοντας μια μέθοδο, εισάγοντας μια τιμή για τη μέθοδο και
πατώντας Κλήση. Το αποτέλεσμα της μεθόδου εμφανίζεται στο πλαίσιο Αποτελέσματα.
- Αν έχετε επιλέξει τη δοκιμή της διαδικτυακής υπηρεσίας με τη χρήση της εξερεύνησης
διαδικτυακών υπηρεσιών, ανοίγει η "Εξερεύνηση". Επιλέξτε τη λειτουργία που θέλετε να
δοκιμάσετε, πληκτρολογήστε τις απαιτούμενες πληροφορίες και πατήστε Εκτέλεση. Το αποτέλεσμα θα εμφανιστεί στο πλαίσιο "Κατάσταση".
- Αν έχετε επιλέξει τη δημοσίευση της διαδικτυακής υπηρεσίας, εκκινείται η εξερεύνηση
διαδικτυακών υπηρεσιών εμφανίζοντας τη σελίδα που απαιτείται για τη δημοσίευση της
διαδικτυακής υπηρεσίας. Ακολουθήστε τις οδηγίες της ενότητας Δημοσίευση της
διαδικτυακής υπηρεσίας για την ολοκλήρωση της εργασίας.