Κοινοποίηση μέσω

API Fabric για το πρόγραμμα επεξεργασίας GraphQL

Το API Fabric για GraphQL παρέχει ένα περιβάλλον ανάπτυξης GraphQL με γραφικά στο πρόγραμμα περιήγησης, το οποίο επιτρέπει σε μια διαδραστική παιδική χαρά να συντάσσει, να δοκιμάζει και να βλέπει τα ζωντανά αποτελέσματα των ερωτημάτων και των μεταλλάξεων σας GraphQL.

Για να μεταβείτε στο πρόγραμμα επεξεργασίας, ανοίξτε το στοιχείο API για GraphQL από τον χώρο εργασίας του στο Fabric και επιλέξτε Ερώτημα στην κάτω αριστερή γωνία της οθόνης της πύλης.

Στιγμιότυπο οθόνης που δείχνει πού εμφανίζεται η επιλογή

Πληκτρολογήστε και εκτελέστε ερωτήματα GraphQL απευθείας στην καρτέλα Ερώτημα . Οι δυνατότητες Intellisense είναι διαθέσιμες με μια συντόμευση πληκτρολογίου: CTRL + Space (Windows) ή Command + Space (macOS). Επιλέξτε Εκτέλεση για να εκτελέσετε το ερώτημα και να ανακτήσετε δεδομένα από την προέλευση δεδομένων.

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

Δημιουργία κώδικα

Μετά τη δοκιμή και τη δημιουργία πρωτοτύπων της επιθυμητής λειτουργίας GraphQL, ο επεξεργαστής API δημιουργεί στερεότυπο κώδικα Python ή Node.js με βάση το ερώτημα ή τη μετάλλαξη που εκτελείται στον επεξεργαστή. Μπορείτε να εκτελέσετε τον κώδικα που δημιουργείται τοπικά για δοκιμαστικούς σκοπούς και να επαναχρησιμοποιήσετε μέρη του στη διαδικασία ανάπτυξης εφαρμογών.

Σημαντικό

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

Για να ξεκινήσετε, εκτελέστε ένα ερώτημα, επιλέξτε το κουμπί Δημιουργία κώδικα και επιλέξτε τη γλώσσα ανάλογα:

Στιγμιότυπο οθόνης του προγράμματος επεξεργασίας API οθόνη που δείχνει τον τρόπο δημιουργίας κώδικα επιλογή.

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

Python

  1. Δημιουργήστε ένα εικονικό περιβάλλον εκτελώντας την εντολή python -m venv .venv.

  2. Ενεργοποιήστε το εκτελώντας venv.venv\Scripts\activate ή source .venv/bin/activate.

  3. Εγκαταστήστε την απαιτούμενη εξάρτηση εκτελώντας pip install azure.identityτο .

  4. Εκτελέστε τον κώδικα με python <filename.py>το .

Node.JS

  1. Στον ίδιο φάκελο με το αρχείο που αποθηκεύσατε, δημιουργήστε ένα package.json αρχείο με το ακόλουθο περιεχόμενο:

    {
  "type": "module",
  "dependencies": {}
}

  2. Εκτελέστε npm install --save @azure/identity ή μια παρόμοια εντολή στον επιλεγμένο διαχειριστή πακέτων για να εγκαταστήσετε την πιο πρόσφατη έκδοση της βιβλιοθήκης ταυτοτήτων.

  3. Εκτελέστε τον κώδικα με node <filename>.jsτο .

Ανάπτυξη ερωτημάτων και μεταλλάξεων

Εξετάστε αυτό το σύντομο σχήμα GraphQL. Ορίζει έναν ενιαίο Post τύπο με ερωτήματα για την ανάγνωση μιας μεμονωμένης ανάρτησης ή τη λίστα όλων των αναρτήσεων και μεταλλάξεις για τη δημιουργία, ενημέρωση ή διαγραφή αναρτήσεων, υποστηρίζοντας όλες τις περιπτώσεις χρήσης CRUDL (δημιουργία, ανάγνωση, ενημέρωση, διαγραφή, λίστα).

{
  type Post {
    id: ID!
    published: Boolean
  }

  type Query {
    getPost(id: ID!): Post
    getAllPosts: [Post]
  }

  type Mutation {
    createPost(title: String!, content: String!, author: String!): Post
    updatePost(id: ID!, title: String, content: String, author: String, published: Boolean): Post
    deletePost(id: ID!): Boolean
  }
}

Διαβάστε τα δεδομένα που εκτίθενται μέσω του GraphQL χρησιμοποιώντας οποιοδήποτε ερώτημα ορίζεται στο σχήμα. Το ερώτημα μοιάζει με αυτό το getPost παράδειγμα.

query MyQuery {
  getPost(id: "1234") {
    title
    content
    author
  }
}

Απάντηση:

{
  "data": {
    "getPost": {
      "title": "First Post",
      "content": "This is my first post.",
      "author": "Jane Doe"
    }
  }
}

Χρησιμοποιήστε μεταλλάξεις όπως createPost να γράψετε δεδομένα και να δημιουργήσετε μια ανάρτηση με τις απαιτούμενες παραμέτρους.

mutation MyMutation {
  createPost(title: "Second post", content: "This is my second post", author: "Jane Doe", published: false) {
    id
    title
    content
    author
  }
}

Απάντηση:

{
  "data": {
    "createPost": {
      "id": "5678",
      "title": "Second Post",
      "content": "This is my second post.",
      "author": "Jane Doe"
    }
  }
}

Μεταβλητές ερωτήματος

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

mutation MyMutation ($title: String!, $content: String!, $author: String!){
  createPost(title: $title, content: $content, author: $author) {
    id
    title
    content
    author
  }
}

Ορίστε μεταβλητές στο παράθυρο χρησιμοποιώντας το ακόλουθο παράδειγμα.

{
  "id": "5678",
  "title": "Second Post",
  "content": "This is my second post.",
  "author": "Jane Doe"
}

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

Σχετικό περιεχόμενο

  • Last updated on