Σημείωση
Όταν σε αυτό το έγγραφο γίνεται παραπομπή σε θέσεις αρχείων ή καταλόγων, το στοιχείο <install-home> αντιστοιχεί στον κατάλογο όπου έχει αποσυμπιεστεί το πακέτο του ελεγκτή ρουτινών.
Το αρχείο ρυθμίσεων εκκίνησης ρουτίνας (agent.xml) περιέχει στατικές πληροφορίες τις οποίες χρειάζεται ο ελεγκτής ρουτινών για την εκκίνηση και τη διαχείριση μιας ρουτίνας. Πιο συγκεκριμένα, το αρχείο agent.xml περιέχει τις ακόλουθες στατικές πληροφορίες:
Το αρχείο agent.xml πρέπει να βρίσκεται σε έναν κατάλογο που έχει την ονομασία της συγκεκριμένης ρουτίνας. Ο κατάλογος με το όνομα της ρουτίνας πρέπει να βρίσκεται σε έναν κατάλογο που ορίζεται από το στοιχείο Agent στο αρχείο serviceconfig.xml. Για παράδειγμα, το αρχείο ρυθμίσεων μιας ρουτίνας με το όνομα org.eclipse.tptp.TimeCollector θα βρίσκεται στον κατάλογο <install-home>/agents/org.eclipse.tptp.TimeCollector/agent.xml. Ο ελεγκτής ρουτινών χρησιμοποιεί το όνομα καταλόγου για την αναγνώριση των ρουτινών που ζητούνται με το όνομά τους. Οι πληροφορίες στο αρχείο ρυθμίσεων agent.xml είναι τα μεταδεδομένα για τη συγκεκριμένη ρουτίνα.
Ο ελεγκτής ρουτινών διαβάζει το αρχείο agent.xml για κάθε ρουτίνα μόνο μία φορά κατά την εκκίνηση. Επομένως, αν τροποποιήσετε τα περιεχόμενα αυτού του αρχείου για μια ρουτίνα ή αν προσθέσετε νέους καταλόγους ρουτινών, πρέπει να επανεκκινήσετε τον ελεγκτή ρουτινών για να ισχύσουν οι νέες ρυθμίσεις σας.
Στοιχείο: Agent
Αυτό είναι το βασικό στοιχείο ενός αρχείου ρυθμίσεων ρουτίνας. Αυτό το στοιχείο
ορίζει τα μεταδεδομένα για μια ρουτίνα. Ένα αντικείμενο μπορεί να ζητήσει τα
μεταδεδομένα για μια ρουτίνα και στη συνέχεια να χρησιμοποιήσει αυτές τις
πληροφορίες για οποιοδήποτε σκοπό. Τα υποστοιχεία που παρουσιάζονται παρακάτω
χρησιμοποιούνται από τον ελεγκτή ρουτινών για την εκκίνηση και τη διαχείριση της
ρουτίνας. Αν ο προγραμματιστής μιας ρουτίνας κρίνει ότι υπάρχουν και άλλες
πληροφορίες που θα έπρεπε να επιστρέφονται ως μεταδεδομένα, μπορεί να ορίσει
πρόσθετα υποστοιχεία. Τα μεταδεδομένα είναι χρήσιμα για έναν πελάτη που
προσπαθεί να αποφασίσει κατά το χρόνο εκτέλεσης ποια ρουτίνα πρέπει να
χρησιμοποιήσει για την εκτέλεση μιας συγκεκριμένης εργασίας.
Υποστοιχεία: Interface
SingleInstance
Bound
MaxControllers
MaxObservers
ConfigFile
LaunchConfigurationΓνωρίσματα:
- Name
- Αυτή η τιμή σειράς χαρακτήρων ορίζει το μοναδικό όνομα της ρουτίνας. Αυτή η τιμή πρέπει να είναι η ίδια με το όνομα που χρησιμοποιήθηκε από τη ρουτίνα κατά την εγγραφή στον ελεγκτή ρουτινών. Αν οι δύο τιμές διαφέρουν, οι αιτήσεις που υποβάλλονται για τη ρουτίνα με βάση το όνομά της θα έχουν διαφορετικό αποτέλεσμα ανάλογα με το αν η ρουτίνα εκτελείται ήδη ή όχι.
Στοιχείο: Interface
Αυτή η τιμή σειράς χαρακτήρων ορίζει το όνομα ενός περιβάλλοντος διεπαφής που
υποστηρίζεται από τη ρουτίνα. Ένα στοιχείο Agent μπορεί να περιλαμβάνει 0 ή
περισσότερα στοιχεία Interface. Ένα περιβάλλον διεπαφής είναι το μοναδικό
όνομα ενός συνόλου εντολών που υποστηρίζονται από μια ρουτίνα.
- Χρησιμοποιείται από το στοιχείο: Agent
Στοιχείο: SingleInstance
Η ακέραια τιμή για αυτό το στοιχείο είναι 0 ή 1. Η τιμή 0 (false) δηλώνει
ότι είναι δυνατή η ταυτόχρονη εκτέλεση πολλαπλών χρήσεων αυτής της ρουτίνας. Η
τιμή 1 (true) δηλώνει ότι επιτρέπεται η εκτέλεση μόνο μίας χρήσης της ρουτίνας.
Αν οριστεί η τιμή 1, ο ελεγκτής ρουτινών δεν θα κάνει δεκτές αιτήσεις για
νέες χρήσεις αυτής της ρουτίνας ενώ υπάρχει μια χρήση που ήδη εκτελείται.
Χρησιμοποιείται από το στοιχείο: Agent
Στοιχείο: Bound
Η ακέραια τιμή για αυτό το στοιχείο είναι 0 ή 1. Η τιμή 0 (false) δηλώνει
ότι αυτή η ρουτίνα δεν συνδέεται με μια εφαρμογή. Η τιμή 1 (true) δηλώνει ότι η
ρουτίνα συνδέεται με μια εφαρμογή. Μια ρουτίνα που συνδέεται με μια εφαρμογή
μπορεί να εκκινηθεί μόνο από αυτή την εφαρμογή. Αν η τιμή του στοιχείου
Bound είναι 1, ο ελεγκτής ρουτινών θα αρνηθεί να εκκινήσει τη ρουτίνα.
Χρησιμοποιείται από το στοιχείο: Agent
Στοιχείο: MaxControllers
Η ακέραια τιμή για αυτό το στοιχείο μπορεί να είναι -1, 0 ή ένας θετικός αριθμός.
Η τιμή -1 δηλώνει ότι δεν υπάρχει "κανένας περιορισμός". Ο ελεγκτής
ρουτινών θα κάνει δεκτές αιτήσεις για δικαιώματα ελέγχου σε αυτή τη ρουτίνα όταν ο
αριθμός των αιτήσεων υπερβαίνει την τιμή που θα ορίσετε σε αυτό το στοιχείο.
Τα δικαιώματα ενός ελεγκτή καθορίζονται από τον προγραμματιστή της ρουτίνας.
Σκοπός αυτού του στοιχείου είναι να περιοριστεί ο αριθμός των αντικειμένων που
μπορούν να ζητήσουν αντικρουόμενες ενέργειες (π.χ. έναρξη και τερματισμός συλλογής
δεδομένων).
Χρησιμοποιείται από το στοιχείο: Agent
Στοιχείο: MaxObservers
Η ακέραια τιμή για αυτό το στοιχείο μπορεί να είναι -1, 0 ή ένας θετικός αριθμός.
Η τιμή -1 δηλώνει ότι δεν υπάρχει "κανένας περιορισμός". Ο ελεγκτής
ρουτινών θα κάνει δεκτές αιτήσεις για δικαιώματα παρατήρησης σε αυτή τη ρουτίνα
όταν ο αριθμός των αιτήσεων υπερβαίνει την τιμή που θα ορίσετε σε αυτό το
στοιχείο. Τα δικαιώματα ενός παρατηρητή καθορίζονται από τον προγραμματιστή
της ρουτίνας. Σκοπός αυτού του στοιχείου είναι να περιοριστεί ο αριθμός των
αντικειμένων που μπορούν να ζητήσουν ενέργειες ερώτησης όπως παροχή στατικών ή
συλλεγόμενων δεδομένων (πιθανώς λόγω μιας αίτησης από έναν ελεγκτή).
Χρησιμοποιείται από το στοιχείο: Agent
Στοιχείο: ConfigFile
Η τιμή σειράς χαρακτήρων για αυτό το στοιχείο ορίζει την πλήρη διαδρομή και το
όνομα ενός πρόσθετου αρχείου ρυθμίσεων που περιέχει δυναμικές πληροφορίες ρύθμισης
στις οποίες έχει πρόσβαση η ρουτίνα. Αυτό το αρχείο είναι προαιρετικό. Ο
σκοπός και το περιεχόμενο αυτού του αρχείου καθορίζονται από τον προγραμματιστή
της ρουτίνας. Συνήθως αυτό το αρχείο χρησιμοποιείται για να μπορεί η ρουτίνα να
διαβάζει τις δικές της πληροφορίες ρύθμισης κατά την εκκίνηση ή οποιαδήποτε άλλη
στιγμή.
Χρησιμοποιείται από το στοιχείο: Agent
Στοιχείο: LaunchConfiguration
Καθορίζει τις παραμέτρους ρύθμισης για την εκκίνηση της ρουτίνας.
Χρησιμοποιείται από το στοιχείο: Agent
Υποστοιχεία: launchInfo
Στοιχείο: launchInfo
Συγκεντρώνει τις πληροφορίες που χρησιμοποιούνται για την εκκίνηση ενός
εκτελέσιμου αρχείου.
Χρησιμοποιείται από το στοιχείο: LaunchConfiguration
Υποστοιχεία: Application
Στοιχείο: Application
Το στοιχείο Application ορίζει τις πληροφορίες που χρησιμοποιούνται για την
εκκίνηση μιας εφαρμογής. Η τιμή του γνωρίσματος executable μπορεί
να ορίζει μια εφαρμογή με το ψευδώνυμό της (βλ. στοιχείο ApplicationAliases στο
αρχείο serviceconfig.xml) ή τη διαδρομή του εκτελέσιμου αρχείου που θα εκκινηθεί.
Η τιμή συγκρίνεται αρχικά με τη λίστα ψευδωνύμων που λαμβάνεται από το
αρχείο serviceconfig.xml κατά την εκκίνηση του ελεγκτή ρουτινών. Αν το
καθορισμένο ψευδώνυμο δεν περιλαμβάνεται στη λίστα, οι πληροφορίες εκκίνησης που
ορίζονται στο στοιχείο Application χρησιμοποιούνται ως έχουν. Αν το
καθορισμένο ψευδώνυμο βρεθεί στη λίστα, οι πληροφορίες εκκίνησης που ορίζονται στο
στοιχείο Application χρησιμοποιούνται σε συνδυασμό με τις πληροφορίες εκκίνησης
που έχουν οριστεί για αυτό το ψευδώνυμο, όπως περιγράφεται παρακάτω.
Χρησιμοποιείται από το στοιχείο: LaunchConfiguration
Υποστοιχεία: Variable
Parameter
Γνωρίσματα:
- executable
Αυτή η τιμή σειράς χαρακτήρων ορίζει το όνομα της εφαρμογής που θα εκκινείται. Μπορεί να είναι είτε το ψευδώνυμο της εφαρμογής είτε η διαδρομή του εκτελέσιμου αρχείου που θα εκκινείται. Αν είναι ένα ψευδώνυμο, το όνομα του εκτελέσιμου αρχείου θα αντικατασταθεί με τη διαδρομή που ορίζεται σε αυτό το ψευδώνυμο.
- location
(Προαιρετικό γνώρισμα) Αυτή η τιμή σειράς χαρακτήρων ορίζει τον κατάλογο από τον οποίο θα εκκινείται το εκτελέσιμο αρχείο. Αυτός ο κατάλογος αναφέρεται και ως κατάλογος εργασίας του εκτελέσιμου αρχείου. Αν αυτό το γνώρισμα παραλειφθεί και το όνομα του εκτελέσιμου δεν συμφωνεί με κάποιο ψευδώνυμο, η εφαρμογή εκτελείται από τον κατάλογο στον οποίο βρίσκεται ο ελεγκτής ρουτινών. Αν αυτό το γνώρισμα παραλειφθεί και το όνομα του εκτελέσιμου συμφωνεί με κάποιο ψευδώνυμο, η εφαρμογή εκτελείται από τη θέση που έχει οριστεί για το ψευδώνυμο.
Στοιχείο: Variable
Το στοιχείο Variable ορίζει μια μεταβλητή περιβάλλοντος και τον τρόπο με τον οποίο
πρέπει να τοποθετηθεί στο υπάρχον περιβάλλον. Όταν βρίσκεται σε ένα
στοιχείο Application, τροποποιεί το περιβάλλον που χρησιμοποιείται όταν εκκινείται
η εφαρμογή. Μπορείτε να ορίσετε 0 ή περισσότερα στοιχεία μεταβλητής για μια
εφαρμογή. Αν το γνώρισμα executable της εφαρμογής είναι ένα ψευδώνυμο, οι
ρυθμίσεις μεταβλητής περιβάλλοντος του ψευδωνύμου εφαρμόζονται στο προεπιλεγμένο
περιβάλλον και οι μεταβλητές περιβάλλοντος που ορίζονται εδώ εφαρμόζονται στη
συνέχεια σε αυτές.
Χρησιμοποιείται από το στοιχείο: Application
Γνωρίσματα:
- name
Αυτή η τιμή σειράς χαρακτήρων ορίζει το όνομα της μεταβλητής περιβάλλοντος.
- value
Αυτή η τιμή σειράς χαρακτήρων ορίζει την τιμή της μεταβλητής περιβάλλοντος.
- position
(Προαιρετικό γνώρισμα) Αυτή η τιμή σειράς χαρακτήρων μπορεί να είναι "append", "prepend" ή "replace". Το συγκεκριμένο γνώρισμα ορίζει τη θέση όπου θα τοποθετηθεί η μεταβλητή περιβάλλοντος σε σχέση με το τρέχον περιβάλλον. Αν παραλειφθεί, η μεταβλητή περιβάλλοντος προσαρτάται στο τρέχον περιβάλλον.
Στοιχείο: Parameter
Το στοιχείο Parameter ορίζει ένα όρισμα γραμμής εντολών που θα δίδεται στην
εφαρμογή όταν εκκινείται. Μπορείτε να ορίσετε 0 ή περισσότερα στοιχεία παραμέτρου
για μια εφαρμογή. Αν το γνώρισμα executable της εφαρμογής είναι ένα
ψευδώνυμο, χρησιμοποιούνται τα ορίσματα γραμμής εντολών του ψευδωνύμου και στη
συνέχεια εφαρμόζονται σε αυτά τα ορίσματα γραμμής εντολών που ορίζονται εδώ.
Χρησιμοποιείται από το στοιχείο: Application
Γνωρίσματα:
- value
Αυτή η τιμή σειράς χαρακτήρων ορίζει ένα όρισμα γραμμής εντολών.
- position
(Προαιρετικό γνώρισμα) Αυτή η τιμή σειράς χαρακτήρων μπορεί να είναι "append", "prepend" ή "replace". Το συγκεκριμένο γνώρισμα ορίζει τη θέση όπου θα τοποθετηθεί το όρισμα γραμμής εντολών σε σχέση με τα τρέχοντα ορίσματα γραμμής εντολών. Αν παραλειφθεί, το όρισμα της γραμμής εντολών προσαρτάται στη γραμμή περιβάλλοντος.
<Agent Name="org.eclipse.tptp.TimeCollector">
<Interface>org.eclipse.tptp.agent</Interface>
<Interface>org.eclipse.tptp.collector</Interface>
<SingleInstance>0</SingleInstance>
<Bound>0</Bound>
<MaxControllers>-1</MaxControllers>
<MaxObservers>-1</MaxObservers>
<ConfigFile>c:\tptp\agents\org.eclipse.tptp.TimeCollector\config\agentconfig.xml</ConfigFile>
<LaunchConfiguration>
<launchInfo>
<Application
executable=".\TimeCollector.exe">
<Parameter value="-serviceconfig ..\config\serviceconfig.xml" />
</Application>
</launchInfo>
</LaunchConfiguration>
</Agent>
Σχετικές παραπομπές
Επισκόπηση ρυθμίσεων ρουτίνας και ελεγκτή ρουτινών
Copyright (C) 2005, 2006 Intel Corporation.