Apache MyFaces Trinidad - Οδηγός αρχικών ρυθμίσεων

Επισκόπηση

Αυτός ο οδηγός χρησιμεύει ως αρωγός για τις αρχικές ρυθμίσεις μιας δυναμικής διαδικτυακής εφαρμογής για τη χρήση της βιβλιοθήκης JSF Apache MyFaces Trinidad ("Trinidad"). Παρόλο που στόχος είναι να χρησιμοποιείται ως ένας οδηγός με επαρκείς πληροφορίες για την καθοδήγηση του χρήστη στις αρχικές ρυθμίσεις, ο δικτυακός τόπος Trinidad θα πρέπει να θεωρείται πάντα ως πηγή πλήρων και τρεχουσών πληροφοριών. Ο οδηγός αυτός προορίζεται για τη ρύθμιση του Trinidad για χρήση σε συνδυασμό με το Eclipse Web Tools Platform ("WTP"), και όχι για τη γενική ρύθμιση του Trinidad, παρόλο που οι βασικές έννοιες μπορεί να μην αφορούν αποκλειστικά στο WTP.

Ρυθμίσεις δυναμικού διαδικτυακού έργου

Σύνολο ρυθμίσεων βιβλιοθήκης JSF

Όπως συμβαίνει με όλα τα πλαίσια, το Trinidad απαιτεί την ύπαρξη συγκεκριμένων βιβλιοθηκών στη διαδρομή κλάσεων. Ορισμένες βιβλιοθήκες ενδεχομένως να παρέχονται από το περιβάλλον εκτέλεσης εξυπηρετητή (για παράδειγμα, ένα περιβάλλον εκτέλεσης εξυπηρετητή JEE5 είναι πιθανό να παράσχει μια υλοποίηση JSF 1.2 και JSTL 1.2). Όταν δεν παρέχονται οι απαιτούμενες βιβλιοθήκες από το περιβάλλον εκτέλεσης εξυπηρετητή, συνιστάται η προσθήκη τους ως μία ή περισσότερες βιβλιοθήκες χρήστη (ανατρέξτε στην ενότητα Δημιουργία και ενημέρωση βιβλιοθηκών JSF).

Σύνολο ρυθμίσεων δυναμικού διαδικτυακού έργου

Κατά τη δημιουργία ενός δυναμικού διαδικτυακού έργου, στην ενότητα "Σύνολο ρυθμίσεων", επιλέξτε Έργο JavaServer Faces (v1.1 ή v1.2, ανάλογα με τις απαιτήσεις), όπως υποδεικνύεται παρακάτω:

Έργο JavaServer Faces v1.2

Μεταβείτε στη σελίδα Δυνατότητες JSF του οδηγού. Σε αυτήν τη σελίδα, επιλέξτε τις απαιτούμενες βιβλιοθήκες JSF που δημιουργήθηκαν προηγουμένως, όπως υποδεικνύεται παρακάτω:

Δυνατότητες JSF

ΣΗΜΕΙΩΣΗ: Αν οι βιβλιοθήκες JSF δημιουργήθηκαν με διαφορετικά ονόματα σε σχέση με αυτά που αναφέρονται παραπάνω, τα διαθέσιμα ονόματα βιβλιοθηκών ενδέχεται να διαφέρουν.

Εκτελέστε τον οδηγό για να δημιουργήσετε το δυναμικό διαδικτυακό έργο.

Προσθήκες στο αρχείο περιγραφής διαδικτυακών εφαρμογών

Ορισμένες προσθήκες στο αρχείο περιγραφής των διαδικτυακών εφαρμογών (.../WEB-INF/web.xml) είναι υποχρεωτικές και άλλες προαιρετικές.

ΣΗΜΕΙΩΣΗ: Ανατρέξτε σε ηλεκτρονικούς πόρους στο δικτυακό τόπο Apache MyFaces Trinidad για πλήρεις και τρέχουσες πληροφορίες.

Υποχρεωτικές προσθήκες

Οι ακόλουθες προσθήκες πρέπει να πραγματοποιηθούν στο αρχείο περιγραφής διαδικτυακών εφαρμογών για ρύθμιση της μικροεφαρμογής εξυπηρετητή πόρου του Trinidad (που εξυπηρετεί φύλλα στυλ, σενάρια και εικόνες κατά το χρόνο εκτέλεσης):

  <servlet>
    <servlet-name>resources</servlet-name>
    <servlet-class>org.apache.myfaces.trinidad.webapp.ResourceServlet</servlet-class>
  </servlet>

  <servlet-mapping>
    <servlet-name>resources</servlet-name>
    <url-pattern>/adf/*</url-pattern>
  </servlet-mapping>

Οι ακόλουθες προσθήκες πρέπει να πραγματοποιηθούν στο αρχείο περιγραφής διαδικτυακών εφαρμογών για ρύθμιση του φίλτρου του Trinidad:

  <filter>
    <filter-name>trinidad</filter-name>
    <filter-class>org.apache.myfaces.trinidad.webapp.TrinidadFilter</filter-class>
  </filter>

  <filter-mapping>
    <filter-name>trinidad</filter-name>
    <servlet-name>faces</servlet-name>
  </filter-mapping>

ΣΗΜΕΙΩΣΗ: Το στοιχείο filter-mapping που αναφέρεται παραπάνω θεωρεί ότι το στοιχείο servlet-name της βασικής μικροεφαρμογής εξυπηρετητή ορίζεται ως "faces". Αυτό ενδέχεται να διαφέρει ανάλογα με τις ρυθμίσεις του χρήστη και, επομένως, πρέπει να καθορίζεται κατάλληλα.

Προαιρετικές προσθήκες

Οι ακόλουθες προσθήκες στο αρχείο περιγραφής διαδικτυακών εφαρμογών είναι προαιρετικές, ανάλογα με τις ειδικές απαιτήσεις των εφαρμογών:

  <context-param>
    <param-name>javax.faces.STATE_SAVING_METHOD</param-name>
    <param-value>client</param-value>
  </context-param>

  <context-param>
    <param-name>javax.faces.DEFAULT_SUFFIX</param-name>
    <param-value>.jspx</param-value>
  </context-param>

  <context-param>
    <param-name>org.apache.myfaces.trinidad.USE_APPLICATION_VIEW_CACHE</param-name>
    <param-value>false</param-value>
  </context-param>

  <context-param>
    <param-name>org.apache.myfaces.trinidad.CHECK_FILE_MODIFICATION</param-name>
    <param-value>false</param-value>
  </context-param>

  <context-param>
    <param-name>org.apache.myfaces.trinidad.CHANGE_PERSISTENCE</param-name>
    <param-value>session</param-value>
  </context-param>

  <context-param>
    <param-name>org.apache.myfaces.trinidad.resource.DEBUG</param-name>
    <param-value>false</param-value>
  </context-param>

ΣΗΜΕΙΩΣΗ: Ορισμένες από αυτές τις προαιρετικές προσθήκες είναι ειδικές για το Trinidad και κάποιες όχι.

Προσθήκες πόρου συνόλου ρυθμίσεων εφαρμογής JSF

Απαιτείται προσθήκη στον πόρο συνόλου ρυθμίσεων εφαρμογής JSF (συνήθως .../WEB-INF/faces-config.xml).

Υποχρεωτική προσθήκη

Η ακόλουθη προσθήκη πρέπει να πραγματοποιηθεί στον πόρο συνόλου ρυθμίσεων εφαρμογής JSF για τη ρύθμιση του βασικού κιτ λειτουργιών απόδοσης του Trinidad:

  <application>
    <default-render-kit-id>org.apache.myfaces.trinidad.core</default-render-kit-id>
  </application>