Δημιουργία διαδικτυακής υπηρεσίας από Java bean με χρήση του περιβάλλοντος εκτέλεσης Apache Axis1

Ο οδηγός διαδικτυακών υπηρεσιών σας βοηθά στη δημιουργία μιας νέας διαδικτυακής υπηρεσίας, τη ρύθμισή της για διανομή και τη διανομή της σε έναν εξυπηρετητή. Αφού γίνει διανομή της διαδικτυακής υπηρεσίας, ο οδηγός σας βοηθά στη δημιουργία του ενδιάμεσου εξυπηρετητή και του δείγματος εφαρμογής για τη δοκιμή της διαδικτυακής υπηρεσίας. Αφού ολοκληρώσετε τη δοκιμή, μπορείτε να δημοσιεύσετε τη διαδικτυακή υπηρεσία σε ένα επιχειρηματικό μητρώο UDDI χρησιμοποιώντας τον οδηγό εξαγωγής.

Προϋποθέσεις:
  1. Δημιουργήστε ή εισαγάγετε ένα bean στο φάκελο πρωτογενούς κώδικα Java™ του Διαδικτυακού έργου. Για εισαγωγή, επιλέξτε τον φάκελο Πόροι Java: src και από το μενού αρχείων επιλέξτε Εισαγωγή > Γενικά > Σύστημα αρχείων και περιηγηθείτε στο σημείο που βρίσκεται το πακέτο σας.
Για να δημιουργήσετε διαδικτυακή υπηρεσία από ένα bean χρησιμοποιώντας το περιβάλλον εκτέλεσης Apache Axis1:
  1. Μεταβείτε στην προοπτική Java EE (Παράθυρο > Άνοιγμα προοπτικής > Java EE).
  2. Στην προβολή "Εξερεύνηση έργων", επιλέξτε το bean που δημιουργήσατε ή εισαγάγατε στο φάκελο πρωτογενούς κώδικα του διαδικτυακού έργου.
  3. Πατήστε Αρχείο > Δημιουργία > Άλλο. Επιλέξτε Διαδικτυακές υπηρεσίες για να εμφανιστούν οι διάφοροι οδηγοί διαδικτυακών υπηρεσιών. Επιλέξτε τον οδηγό Διαδικτυακή υπηρεσία. Πατήστε Επόμενο.
  4. Σελίδα Διαδικτυακές υπηρεσίες: επιλέξτε Διαδικτυακή υπηρεσία Java bean από κάτω προς τα πάνω ως είδος διαδικτυακής υπηρεσίας και καταχωρήστε το URI του αρχείου WSDL, WSIL ή HTML που θα χρησιμοποιηθεί για τη δημιουργία της υπηρεσίας.
    1. Επιλέξτε τα στάδια ανάπτυξης διαδικτυακών υπηρεσιών που θέλετε να ολοκληρώσετε χρησιμοποιώντας τη γραμμή κύλισης:
      • Ανάπτυξη: πραγματοποιεί ανάπτυξη του ορισμού WSDL και υλοποίηση της διαδικτυακής υπηρεσίας. Αυτή η διαδικασία περιλαμβάνει εργασίες όπως δημιουργία λειτουργικών μονάδων οι οποίες θα περιέχουν κώδικα που δημιουργείται, αρχείων WSDL, αρχείων περιγραφής διανομής καθώς και αρχείων Java όταν απαιτείται.
      • Συγκρότηση: αυτή η διαδικασία διασφαλίζει ότι το έργο που θα φιλοξενήσει τη διαδικτυακή υπηρεσία ή τον πελάτη θα συσχετιστεί με ένα αρχείο EAR όταν αυτό απαιτείται από τον εξυπηρετητή εφαρμογών προορισμού.
      • Διανομή: δημιουργεί τον κώδικα διανομής για την υπηρεσία.
      • Εγκατάσταση: πραγματοποιεί εγκατάσταση και ρύθμιση της διαδικτυακής λειτουργικής μονάδας και των EAR στον εξυπηρετητή προορισμού.
      • Έναρξη: εκκινεί τον εξυπηρετητή αφού εγκατασταθεί σε αυτόν η υπηρεσία. Θα δημιουργηθεί το αρχείο server-config.wsdd.
      • Δοκιμή: παρέχει διάφορες επιλογές δοκιμής της υπηρεσίας, όπως χρήση της εξερεύνησης διαδικτυακών υπηρεσιών ή δειγμάτων αρχείων JSP.
    2. Επιλογή εξυπηρετητή: εμφανίζεται ο προεπιλεγμένος εξυπηρετητής. Αν θέλετε να διανείμετε την υπηρεσία σε διαφορετικό εξυπηρετητή, πατήστε τη διασύνδεση για να καθορίσετε διαφορετικό εξυπηρετητή.
    3. Επιλογή περιβάλλοντος εκτέλεσης: εμφανίζεται το προεπιλεγμένο περιβάλλον εκτέλεσης. Αν θέλετε να διανείμετε την υπηρεσία σε διαφορετικό περιβάλλον εκτέλεσης, πατήστε στη διασύνδεση για να καθορίσετε διαφορετικό περιβάλλον εκτέλεσης.
    4. Επιλογή έργου υπηρεσίας: εμφανίζεται το έργο που περιέχει το επιλεγμένο έργο στον χώρο εργασίας. Για να επιλέξετε διαφορετικό έργο και EAR πατήστε στη διασύνδεση έργου.Βεβαιωθείτε ότι το έργο που επιλέχθηκε ως διαδικτυακό έργο πελάτη είναι διαφορετικό από το διαδικτυακό έργο υπηρεσίας, διαφορετικά η υπηρεσία θα αντικατασταθεί από τα τεχνουργήματα πελάτη που δημιουργούνται.
    5. Αν θέλετε να δημιουργήσετε έναν πελάτη, επιλέξτε το είδος του ενδιάμεσου εξυπηρετητή που θα δημιουργηθεί και επαναλάβετε τα παραπάνω βήματα για τον πελάτη.
    6. Δημοσίευση της διαδικτυακής υπηρεσίας: πραγματοποιείται εκκίνηση της εξερεύνησης διαδικτυακών υπηρεσιών για τη δημοσίευση της διαδικτυακής υπηρεσίας σε μητρώο UDDI.
    7. Παρακολούθηση της διαδικτυακής υπηρεσίας: αποστέλλει την κίνηση διαδικτυακής υπηρεσίας μέσω της λειτουργίας παρακολούθησης TCP/IP, το οποίο σας επιτρέπει την παρακολούθηση της κίνησης SOAP που δημιουργείται από τη διαδικτυακή υπηρεσία και τη δοκιμή της κίνησης αυτής για συμβατότητα με το WS-I. Εναλλακτικά, μπορείτε να ρυθμίσετε με μη αυτόματο τρόπο μια λειτουργία παρακολούθησης TCP/IP, όπως περιγράφεται στην ενότητα Χρήση της λειτουργίας παρακολούθησης TCP/IP για δοκιμή των διαδικτυακών υπηρεσιών
  5. Σελίδα "Ταυτότητα Java Bean διαδικτυακής υπηρεσίας: εμφανίζεται το όνομα WSDL τς διαδικτυακής υπηρεσίας. Έχετε τις ακόλουθες επιλογές:
    • Επιλέξτε τις μεθόδους που θα εκτεθούν.
    • Επιλέξτε το στυλ κωδικοποίησης. Συνιστάται το στυλ κωδικοποίησης RPC/Encoded για το περιβάλλον εκτέλεσης Axis. Αυτή η μέθοδος κωδικοποίησης δεν είναι συμβατή με WS-I.
    • Επιλέξτε αν θέλετε να προσαρμόσετε τις αντιστοιχίες μεταξύ πακέτων και χώρων ονομάτων.
    Πατήστε Επόμενο.
  6. Σελίδα Αντιστοίχιση πακέτου διαδικτυακών υπηρεσιών σε χώρο ονομάτων: Αν επιλέξατε Ορισμός προσαρμοσμένης αντιστοιχίας μεταξύ πακέτου και χώρου ονομάτων στο προηγούμενο πλαίσιο, μπορείτε να καταχωρήσετε τα προσαρμοσμένα ζεύγη αντιστοιχιών σε αυτό το πλαίσιο, πατώντας Προσθήκη. Εναλλακτικά, μπορείτε να πατήσετε Εισαγωγή για να εισαγάγετε προσαρμοσμένα ζεύγη αντιστοιχιών από ένα αρχείο .properties. Το περιεχόμενο του αρχείου ιδιοτήτων πρέπει να έχει τη μορφή package=namespace. Θα πρέπει να χρησιμοποιήσετε χαρακτήρες διαφυγής για ορισμένους ειδικούς χαρακτήρες στα αρχεία ιδιοτήτων. Για παράδειγμα, το κείμενο somePackage=http://someNamespace θα πρέπει να γραφεί ως somePackage=http\://someNamespace. Διαφορετικά, η άνω και κάτω τελεία (:) θα θεωρηθεί οριοθέτης και το πρόγραμμα θα επιχειρήσει να αντιστοιχίσει το somePackage με το http.
  7. Σελίδα "Δοκιμή διαδικτυακής υπηρεσίας": Αν έχετε επιλέξει τη δοκιμή της διαδικτυακής υπηρεσίας, επιλέξτε τη λειτουργία δοκιμής για τη διαδικτυακή υπηρεσία που δημιουργήθηκε. Με αυτόν τον τρόπο ανοίγει η διαδικτυακή υπηρεσία στην εξερεύνηση διαδικτυακών υπηρεσιών. Επιλέξτε τη λειτουργία που θέλετε να δοκιμάσετε, πληκτρολογήστε τις απαιτούμενες πληροφορίες και πατήστε Εκτέλεση. Το αποτέλεσμα θα εμφανιστεί στο πλαίσιο "Κατάσταση". Πατήστε Επόμενο.
  8. Σελίδα "Ενδιάμεσος εξυπηρετητής διαδικτυακής υπηρεσίας": Αν έχετε επιλέξει τη δημιουργία ενδιάμεσου εξυπηρετητή, επιλέξτε αν θέλετε να προσαρμόσετε τις αντιστοιχίες μεταξύ πακέτου και χώρο ονομάτων.
  9. Σελίδα "Δοκιμή διαδικτυακής υπηρεσίας: Χρησιμοποιήστε αυτήν τη σελίδα για να πραγματοποιήσετε τις παρακάτω επιλογές:
    1. Επιλέξτε τη λειτουργία δοκιμής. Μπορείτε να δοκιμάσετε τον ενδιάμεσο εξυπηρετητή που δημιουργείτε στην εξερεύνηση διαδικτυακών υπηρεσιών ή μπορείτε να δημιουργήσετε ένα δείγμα JSP διαδικτυακής υπηρεσίας.
    2. Αν επιλέξετε τη δοκιμή του ενδιάμεσου εξυπηρετητή μέσω ενός JSP, μπορείτε να επιλέξετε το φάκελο στον οποίο βρίσκεται το JSP καθώς και τις μεθόδους θα συμπεριληφθούν στο JSP.
    3. Επιλέξτε Εκτέλεση δοκιμής στον εξυπηρετητή για την αυτόματη εκκίνηση του εξυπηρετητή.
  10. Σελίδα "Δημοσίευση διαδικτυακής υπηρεσίας": Επιλέξτε εάν θέλετε να δημοσιεύσετε αυτήν τη διαδικτυακή υπηρεσία σε μητρώο UDDI. Πατήστε Ολοκλήρωση Σημείωση: Ενδέχεται να εμφανιστεί η ακόλουθη προειδοποίηση Σφάλμα κατά τη δημιουργία WSDL από Java. ClassNotFound: <όνομα bean>. Μπορείτε να αγνοήσετε αυτό το μήνυμα.
Αφού δημιουργηθεί η διαδικτυακή υπηρεσία, ενδέχεται να προκύψουν οι ακόλουθες περιπτώσεις ανάλογα με τις επιλογές που έχετε πραγματοποιήσει:
  • Αν έχετε επιλέξει τη δοκιμή του ενδιάμεσου εξυπηρετητή που δημιουργείται με τη χρήση JSP διαδικτυακών υπηρεσιών, γίνεται εκκίνηση του ενδιάμεσου εξυπηρετητή σε ένα πρόγραμμα πλοήγησης στην ακόλουθη διεύθυνση URL: http://localhost: port/ WebProjectClient/sampleBeanName/WebServiceName/TestClient.jsp Μπορείτε να χρησιμοποιήσετε αυτό το δείγμα εφαρμογής για να πραγματοποιήσετε δοκιμή της διαδικτυακής υπηρεσίας επιλέγοντας μια μέθοδο, εισάγοντας μια τιμή για τη μέθοδο και πατώντας Κλήση. Το αποτέλεσμα της μεθόδου εμφανίζεται στο πλαίσιο Αποτελέσματα.
  • Αν έχετε επιλέξει τη δοκιμή της διαδικτυακής υπηρεσίας με τη χρήση της εξερεύνησης διαδικτυακών υπηρεσιών, ανοίγει η "Εξερεύνηση". Επιλέξτε τη λειτουργία που θέλετε να δοκιμάσετε, πληκτρολογήστε τις απαιτούμενες πληροφορίες και πατήστε Εκτέλεση. Το αποτέλεσμα θα εμφανιστεί στο πλαίσιο "Κατάσταση".
  • Αν έχετε επιλέξει τη δημοσίευση της διαδικτυακής υπηρεσίας, εκκινείται η εξερεύνηση διαδικτυακών υπηρεσιών εμφανίζοντας τη σελίδα που απαιτείται για τη δημοσίευση της διαδικτυακής υπηρεσίας. Ακολουθήστε τις οδηγίες της ενότητας Δημοσίευση της διαδικτυακής υπηρεσίας για την ολοκλήρωση της εργασίας.

Σημαντικό: Αν οι μέθοδοί σας περιέχουν είδη που δεν υποστηρίζονται από το δείγμα, όπως πίνακες, ευρετηριοποιημένες ιδιότητες και συλλογές, οι μέθοδοι θα παραλειφθούν από το δείγμα και θα εμφανιστεί ένα μήνυμα προειδοποίησης.

Σχετικές έννοιες
Δημιουργία Διαδικτυακών υπηρεσιών με το περιβάλλον εκτέλεσης Apache Axis1