<p>σύμφωνα με το πρότυπο http/1.1:</p><blockquote> <p>η μέθοδος <strong><code>post</code>name \_</strong> χρησιμοποιείται για να ζητήσει από τον διακομιστή προέλευσης να αποδεχθεί την οντότητα που περιλαμβάνεται στο αίτημα ως νέος υποκείμενος του πόρου που προσδιορίζεται από τον <code>request-uri</code> στο <code>request-line</code></p> </blockquote><p>με άλλα λόγια, το <code>post</code>χρησιμοποιείται για να <strong>δημιουργία</strong>.</p><blockquote> <p>η μέθοδος <strong><code>put</code>name \_</strong> ζητά την αποθήκευση της συνημμένης οντότητας κάτω από τον παρεχόμενο <code>request-uri</code>. εάν ο <code>request-uri</code> αναφέρεται σε έναν ήδη υπάρχοντα πόρο, η συνημμένη οντότητα θα πρέπει να θεωρηθεί ως τροποποιημένη έκδοση εκείνης που υπάρχει στον διακομιστή προέλευσης. εάν ο <code>request-uri</code> δεν υποδεικνύει έναν υπάρχοντα πόρο και το uri μπορεί να οριστεί ως νέα πηγή από τον αιτούντα παράγοντα χρήστη, ο διακομιστής προέλευσης μπορεί να δημιουργήσει τον πόρο με αυτό το uri. "</p> </blockquote><p>δηλαδή, το <code>put</code>χρησιμοποιείται για να <strong>δημιουργία ή ενημέρωση</strong>.</p><p>έτσι, ποιο πρέπει να χρησιμοποιηθεί για τη δημιουργία ενός πόρου; ή κάποιος πρέπει να υποστηρίξει και τα δύο;</p>
put εναντίον post σε rest
<p><strong> συνολικά: </strong></p><p>τόσο το put όσο και το post μπορούν να χρησιμοποιηθούν για τη δημιουργία.</p><p>πρέπει να ρωτήσετε "σε τι εκτελείτε τη δράση;" να διακρίνετε τι πρέπει να χρησιμοποιείτε. ας υποθέσουμε ότι σχεδιάζετε ένα api για να κάνετε ερωτήσεις. εάν θέλετε να χρησιμοποιήσετε το post τότε θα το κάνετε σε μια λίστα ερωτήσεων. εάν θέλετε να χρησιμοποιήσετε το put τότε θα το κάνετε αυτό σε μια συγκεκριμένη ερώτηση.</p><p><strong> μεγάλη και οι δύο μπορούν να χρησιμοποιηθούν, έτσι ποιο πρέπει να χρησιμοποιήσω στο restful σχεδιασμό μου: </strong></p><p>δεν χρειάζεται να υποστηρίζετε τόσο το put όσο και το post.</p><p>το οποίο χρησιμοποιείται παραμένει στο χέρι σας. αλλά θυμηθείτε να χρησιμοποιήσετε το σωστό, ανάλογα με το αντικείμενο που αναφέρετε στο αίτημα.</p><p>μερικές σκέψεις:</p><ul> <li>ονομάζετε ρητά τα αντικείμενα url που δημιουργείτε ή αφήστε το διακομιστή να αποφασίσει; εάν τους ονομάσετε τότε χρησιμοποιήστε put. εάν αφήσετε τον διακομιστή να αποφασίσει στη συνέχεια, χρησιμοποιήστε το post.</li> <li>put είναι idempotent, οπότε αν put ένα αντικείμενο δύο φορές, δεν έχει καμία επίδραση. αυτή είναι μια ιδιοκτησία της νίκαιας, οπότε θα μπορούσα να χρησιμοποιήσω το put όταν ήταν δυνατόν.</li> <li>μπορείτε να ενημερώσετε ή να δημιουργήσετε έναν πόρο με put με την ίδια διεύθυνση url αντικειμένου</li> <li>με το post μπορείτε να έχετε 2 αιτήματα που εισέρχονται ταυτόχρονα για τροποποιήσεις σε μια διεύθυνση url και μπορεί να ενημερώσουν διαφορετικά μέρη του αντικειμένου.</li> </ul><p><strong> ένα παράδειγμα: </strong></p><p> <a href="https://stackoverflow.com/questions/256349/what-are-the-best-common-restful-url-verbs-and-actions/256359#256359">έγραψα τα εξής ως μέρος μιας άλλης απάντησης σχετικά με το so</a> :</p><blockquote> <p><strong> post: </strong></p> <p>χρησιμοποιείται για την τροποποίηση και την ενημέρωση ενός πόρου</p> <pre><code>post /questions/&lt;existing\_question&gt; http/1.1 host: www.example.com/ </code></pre> <p>σημειώστε ότι το ακόλουθο είναι ένα σφάλμα:</p> <pre><code>post /questions/&lt;new\_question&gt; http/1.1 host: www.example.com/ </code></pre> <p>εάν η διεύθυνση url δεν έχει δημιουργηθεί ακόμη, δεν θα πρέπει να χρησιμοποιείτε το post για να το δημιουργήσετε ενώ καθορίζετε το όνομα. αυτό θα πρέπει να έχει ως αποτέλεσμα ένα σφάλμα 'πόρος δεν βρέθηκε' επειδή το <code>&lt;new\_question&gt;</code> δεν υπάρχει ακόμα. πρέπει πρώτα να τοποθετήσετε τον πόρο <code>&lt;new\_question&gt;</code> στον διακομιστή.</p> <p>θα μπορούσατε όμως να κάνετε κάτι τέτοιο για να δημιουργήσετε πόρους χρησιμοποιώντας post:</p> <pre><code>post /questions http/1.1 host: www.example.com/ </code></pre> <p>σημειώστε ότι σε αυτήν την περίπτωση το όνομα του πόρου δεν έχει καθοριστεί, η διαδρομή url των νέων αντικειμένων θα σας επιστραφεί.</p> <p><strong> σημειωση: </strong></p> <p>χρησιμοποιείται για τη δημιουργία ενός πόρου ή για την αντικατάστασή του. ενώ ορίσετε τους πόρους νέα διεύθυνση url.</p> <p>για έναν νέο πόρο:</p> <pre><code>put /questions/&lt;new\_question&gt; http/1.1 host: www.example.com/ </code></pre> <p>για να αντικαταστήσετε μια υπάρχουσα πηγή:</p> <pre><code>put /questions/&lt;existing\_question&gt; http/1.1 host: www.example.com/ </code></pre></blockquote>
<p>μπορείτε να βρείτε ισχυρισμούς στο διαδίκτυο που λένε</p><ul> <li> <a href="http://java.sun.com/developer/technicalarticles/webservices/restful/"><strong>post</strong> θα πρέπει να χρησιμοποιηθεί για τη δημιουργία ενός πόρου, και <strong>put</strong> θα πρέπει να χρησιμοποιηθεί για την τροποποίηση ενός</a> </li> <li> <a href="http://awsmedia.s3.amazonaws.com/pdf/restands3.pdf"><strong>put</strong> θα πρέπει να χρησιμοποιηθεί για τη δημιουργία ενός πόρου, και <strong>post</strong> θα πρέπει να χρησιμοποιηθεί για να τροποποιήσει ένα</a> </li> </ul><p>ούτε είναι σωστό.</p><hr><p>καλύτερα είναι να επιλέξετε μεταξύ put και post με βάση την <a href="http://en.wikipedia.org/wiki/idempotent">idempotence</a> της ενέργειας.</p><p><strong>put</strong> υπονοεί την τοποθέτηση ενός πόρου - αντικαθιστώντας εντελώς ό, τι είναι διαθέσιμο στη δεδομένη διεύθυνση url με ένα διαφορετικό πράγμα. εξ ορισμού, ένα put είναι idempotent. κάντε το όσες φορές θέλετε και το αποτέλεσμα είναι το ίδιο. <code>x=5</code> είναι idempotent. μπορείτε να χρησιμοποιήσετε έναν πόρο είτε υπήρχε προηγουμένως είτε όχι (π.χ., δημιουργία ή ενημέρωση)!</p><p><strong>post</strong> ενημερώνει έναν πόρο, προσθέτει έναν βοηθητικό πόρο ή προκαλεί μια αλλαγή. ένα post δεν είναι idempotent, με τον τρόπο που <code>x++</code> δεν είναι idempotent.</p><hr><p>με αυτό το επιχείρημα, το put είναι για τη δημιουργία όταν γνωρίζετε τη διεύθυνση url του πράγματος που θα δημιουργήσετε. post μπορεί να χρησιμοποιηθεί για τη δημιουργία όταν γνωρίζετε τη διεύθυνση url του "εργοστασίου" ή του διαχειριστή για την κατηγορία των πραγμάτων που θέλετε να δημιουργήσετε.</p><p>έτσι:</p><pre><code>post /expense-report </code></pre><p>ή:</p><pre><code>put /expense-report/10929 </code></pre>
<ul> <li><strong>post</strong> σε μια διεύθυνση url <strong>δημιουργεί μια πηγή παιδιού</strong> σε μια <em> server defined </em> url.</li> <li><strong>put</strong> σε μια διεύθυνση url <strong>δημιουργεί/αντικαθιστά τον πόρο</strong> στο σύνολό του στην διεύθυνση <em>πελάτης που ορίζεται </em> url.</li> <li><strong>patch</strong> σε μια διεύθυνση url <strong>pdates <em> part </em> του πόρου</strong> σε αυτή τη διεύθυνση url καθορισμένη από τον πελάτη.</li> </ul><p>η σχετική προδιαγραφή για τα put και post είναι <a href="http://www.w3.org/protocols/rfc2616/rfc2616-sec9.html#sec9.5">rfc 2616 §9.5ff.</a> </p><p><strong>post δημιουργεί μια πηγή παιδιού</strong>, έτσι post σε <code>/items</code> δημιουργεί πόρους που ζουν κάτω από τον πόρο <code>/items</code>. π.χ. <code>/items/1</code>. η αποστολή του ίδιου πακέτου μετά από δύο φορές θα δημιουργήσει δύο πόρους.</p><p><strong>put</strong> προορίζεται για τη δημιουργία ή την αντικατάσταση ενός πόρου σε <strong>rl γνωστή από τον πελάτη</strong>.</p><p>επομένως: <strong>put</strong> είναι μόνο υποψήφιος για το create όπου ο πελάτης γνωρίζει ήδη τη διεύθυνση url πριν δημιουργηθεί ο πόρος. π.χ. <code>/blogs/nigel/entry/when\_to\_use\_post\_vs\_put</code> καθώς ο τίτλος χρησιμοποιείται ως κλειδί πόρου</p><p><strong>put</strong> αντικαθιστά τον πόρο στη γνωστή διεύθυνση url εάν υπάρχει ήδη, οπότε η αποστολή του ίδιου αιτήματος δύο φορές δεν έχει αποτέλεσμα. με άλλα λόγια, <strong>οι κλήσεις προς το put είναι idempotent</strong>.</p><p>το rfc διαβάζει ως εξής:</p><blockquote> <p>η θεμελιώδης διαφορά μεταξύ των αιτήσεων post και put αντικατοπτρίζεται στην διαφορετική έννοια του uri αιτήματος. το uri σε ένα post αίτημα προσδιορίζει τον πόρο που θα χειριστεί την εσωκλειόμενη οντότητα. αυτός ο πόρος μπορεί να είναι μια διαδικασία αποδοχής δεδομένων, μια πύλη σε κάποιο άλλο πρωτόκολλο ή μια ξεχωριστή οντότητα που δέχεται σχολιασμούς. αντίθετα, το uri σε ένα αίτημα put προσδιορίζει την οντότητα που συνοδεύει την αίτηση - ο πράκτορας χρήστη ξέρει τι προορίζεται το uri και ο διακομιστής δεν πρέπει να επιχειρήσει να εφαρμόσει το αίτημα σε κάποιον άλλο πόρο. εάν ο διακομιστής επιθυμεί να εφαρμοστεί το αίτημα σε διαφορετικό uri,</p> </blockquote><p><strong>σημείωση:</strong> το put χρησιμοποιήθηκε ως επί το πλείστον για την ενημέρωση των πόρων (αντικαθιστώντας τα συνολικά), αλλά πρόσφατα υπάρχει κίνηση προς τη χρήση του patch για την ενημέρωση των υφιστάμενων πόρων, καθώς το put καθορίζει ότι αντικαθιστά ολόκληρο τον πόρο. <a href="http://tools.ietf.org/html/rfc5789">rfc 5789.</a> </p><p><strong>ενημέρωση 2018</strong>: υπάρχει μια περίπτωση που μπορεί να γίνει για να αποφευχθεί το put. βλέπε <a href="https://www.thoughtworks.com/radar/techniques/rest-without-put">"rest χωρίς put"</a> </p><blockquote> <p>με την τεχνική "rest without put", η ιδέα είναι ότι οι καταναλωτές αναγκάζονται να δημοσιεύουν νέους πόρους αιτήσεων για "ανανέωση". όπως αναφέρθηκε προηγουμένως, η αλλαγή της διεύθυνσης αλληλογραφίας ενός πελάτη είναι post σε έναν νέο "changeofaddress" πόρο, και όχι ένα put ενός πόρου "πελάτη" με διαφορετική τιμή πεδίου διεύθυνσης αλληλογραφίας.</p> </blockquote><p>από το <a href="https://www.thoughtworks.com/insights/blog/rest-api-design-resource-modeling">rest api design - μοντελοποίηση πόρων από prakash subramaniam thoughtworks</a> </p><p>αυτό αναγκάζει το api να αποφύγει προβλήματα μετάβασης στο κράτος με πολλαπλούς πελάτες που ενημερώνουν έναν μόνο πόρο και ταιριάζει καλύτερα με την προμήθεια συμβάντων και το cqrs. όταν η εργασία γίνεται ασύγχρονα, φαίνεται ότι είναι κατάλληλη η διεξαγωγή του μετασχηματισμού και η αναμονή για την εφαρμογή του.</p>
<p>θα ήθελα να προσθέσω τις "ρεαλιστικές" συμβουλές μου. χρησιμοποιήστε το put όταν γνωρίζετε το "id" με το οποίο μπορείτε να ανακτήσετε το αντικείμενο που αποθηκεύετε. η χρήση του put δεν θα λειτουργήσει πάρα πολύ καλά εάν χρειάζεστε, ας πούμε, μια βάση δεδομένων που δημιούργησε id για να σας επιστραφεί για μελλοντικές αναζητήσεις ή ενημερώσεις.</p><p>έτσι: για να αποθηκεύσετε έναν υπάρχοντα χρήστη ή εκείνο στον οποίο ο πελάτης δημιουργεί το αναγνωριστικό και έχει επαληθευτεί ότι το αναγνωριστικό είναι μοναδικό:</p><pre><code>put /user/12345 http/1.1 &lt;-- create the user providing the id 12345 host: mydomain.com get /user/12345 http/1.1 &lt;-- return that user host: mydomain.com </code></pre><p>διαφορετικά, χρησιμοποιήστε το post για να δημιουργήσετε αρχικά το αντικείμενο και put για την ενημέρωση του αντικειμένου:</p><pre><code>post /user http/1.1 &lt;--- create the user, server returns 12345 host: mydomain.com put /user/12345 http/1.1 &lt;--- update the user host: mydomain.com </code></pre>
<p>το post σημαίνει "δημιουργία νέου" όπως στο "εδώ είναι η είσοδος για τη δημιουργία ενός χρήστη, το δημιουργήστε για μένα".</p><p>το put σημαίνει "εισαγάγετε, αντικαταστήστε εάν υπάρχει ήδη" όπως στο "εδώ είναι τα δεδομένα για τον χρήστη 5".</p><p>μπορείτε post στο παράδειγμα.com/users αφού δεν γνωρίζετε ακόμα τη διεύθυνση url του χρήστη, θέλετε ο διακομιστής να το δημιουργήσει.</p><p>μπορείτε put να example.com/users/id, δεδομένου ότι θέλετε να αντικαταστήσετε/δημιουργήσετε έναν <em>συγκεκριμένο</em> χρήστη.</p><p>το posting δύο φορές με τα ίδια δεδομένα σημαίνει ότι δημιουργείτε δύο ταυτόσημους χρήστες με διαφορετικά ids. το puting δύο φορές με τα ίδια δεδομένα δημιουργεί τον χρήστη πρώτο και τον ενημερώνει στην ίδια κατάσταση τη δεύτερη φορά (χωρίς αλλαγές). δεδομένου ότι καταλήγετε στην ίδια κατάσταση μετά από ένα put ανεξάρτητα από το πόσες φορές το εκτελείτε, λέγεται ότι είναι "εξίσου ισχυρό" κάθε φορά - idempotent. αυτό είναι χρήσιμο για την αυτόματη επανάληψη αιτήσεων. δεν είστε πλέον "είστε βέβαιοι ότι θέλετε να ξαναστείλετε" όταν πιέζετε το κουμπί "πίσω" στο πρόγραμμα περιήγησης.</p><p>μια γενική συμβουλή είναι να χρησιμοποιήσετε τοpost όταν χρειάζεστε το διακομιστή να ελέγχει την παραγωγή url των πόρων σας. χρησιμοποιήστε το put αλλιώς. προτιμήστε το put πέρα ​​από το post.</p>
<p>χρησιμοποιήστε το post για να δημιουργήσετε και put για ενημέρωση. αυτό συμβαίνει με τον ruby on rails.</p><pre><code>put /items/1 #=&gt; update post /items #=&gt; create </code></pre>
<p>και οι δύο χρησιμοποιούνται για τη μετάδοση δεδομένων μεταξύ πελάτη-διακομιστή, αλλά υπάρχουν και λεπτές διαφορές μεταξύ τους, οι οποίες είναι:</p><p> <a href="https://i.stack.imgur.com/8d8z3.png"><img src="https://i.stack.imgur.com/8d8z3.png" alt="enter image description here"></a> </p><p>αναλογία:</p><ul> <li>put δηλ. πάρτε και <strong> βάλτε </strong> όπου ήταν.</li> <li>post ως αποστολή αλληλογραφίας στο <strong> post </strong> γραφείο.</li> </ul><p> <a href="https://i.stack.imgur.com/aqkrz.jpg"><img src="https://i.stack.imgur.com/aqkrz.jpg" alt="enter image description here"></a> </p><p>κοινωνικά μέσα/δίκτυο αναλογία:</p><ul> <li><strong> δημοσίευση </strong> στα κοινωνικά μέσα: όταν δημοσιεύουμε μήνυμα, δημιουργεί νέα δημοσίευση.</li> <li><strong> βάλτε </strong> (δηλ. επεξεργαστείτε) για το μήνυμα που έχουμε ήδη δημοσιεύσει.</li> </ul>
<p>το rest είναι μια ιδέα υψηλού επιπέδου <em> very </em>. στην πραγματικότητα, δεν αναφέρεται καθόλου το http!</p><p>αν έχετε αμφιβολίες σχετικά με τον τρόπο εφαρμογής του rest στο http, μπορείτε πάντα να ρίξετε μια ματιά στην προδιαγραφή <a href="https://www.ietf.org/rfc/rfc5023.txt">προδιαγραφή atom publication protocol (atompub)</a> . το atompub είναι ένα πρότυπο για τη σύνταξη restful webservices με http που αναπτύχθηκε από πολλά φωτιστικά http και rest, με κάποια εισροή από τον roy fielding, τον εφευρέτη του rest και του (συν) εφευρέτη του http.</p><p>στην πραγματικότητα, ίσως μπορείτε να χρησιμοποιήσετε το atompub άμεσα. ενώ βγήκε από την κοινότητα του blogging, δεν περιορίζεται καθόλου στο blogging: είναι ένα γενικό πρωτόκολλο για την αποτελεσματική αλληλεπίδραση με αυθαίρετες (ένθετες) συλλογές αυθαίρετων πόρων μέσω http. εάν μπορείτε να εκπροσωπήσετε την εφαρμογή σας ως μια ένθετη συλλογή πόρων, τότε μπορείτε απλά να χρησιμοποιήσετε το atompub και να μην ανησυχείτε για το αν θα χρησιμοποιήσετε το put ή το post, τους κωδικούς κατάστασης http που θα επιστρέψετε και όλες αυτές τις λεπτομέρειες.</p><p>αυτό είναι που λέει το atompub για τη δημιουργία πόρων (ενότητα 9.2):</p><blockquote> <p>για να προσθέσετε μέλη σε μια συλλογή, οι πελάτες αποστέλλουν αιτήματα post στο uri της συλλογής.</p> </blockquote>
<p>εν συντομία:</p><p><strong>put</strong> είναι idempotent, όπου η κατάσταση πόρων θα είναι η ίδια εάν εκτελείται η ίδια ενέργεια μία φορά ή πολλές φορές.</p><p><strong>post</strong> είναι μη-εικονική, όπου η κατάσταση του πόρου μπορεί να γίνει διαφορετική εάν η λειτουργία εκτελείται πολλές φορές σε σύγκριση με την εκτέλεση μιας μόνο χρονικής στιγμής.</p><h3>αναλογία με ερώτημα βάσης δεδομένων</h3><p><strong>put</strong> μπορείτε να σκεφτείτε παρόμοια με "update student set διεύθυνση =" abc "όπου id =" 123 "?</p><p><strong>post</strong> μπορείτε να σκεφτείτε κάτι σαν "εισαγωγη στο μελλον (όνομα, διεύθυνση) αξιες (" abc "," xyzzz ");</p><p>το αναγνωριστικό σπουδαστών δημιουργείται αυτόματα.</p><p>με το put, εάν το ίδιο ερώτημα εκτελείται πολλές φορές ή μία φορά, η κατάσταση του πίνακα student παραμένει η ίδια.</p><p>σε περίπτωση post, εάν το ίδιο ερώτημα εκτελείται πολλές φορές, τότε δημιουργούνται πολλαπλές εγγραφές φοιτητών στη βάση δεδομένων και αλλαγές στην κατάσταση της βάσης δεδομένων σε κάθε εκτέλεση ενός ερωτήματος "insert".</p><p><strong>σημειωση:</strong> το put χρειάζεται μια θέση πόρου (ήδη-πόρο) για την οποία πρέπει να γίνει η ενημέρωση, ενώ οpost δεν το απαιτεί. επομένως, διαισθητικά post προορίζεται για τη δημιουργία ενός νέου πόρου, ενώ το put απαιτείται για την ενημέρωση του ήδη υπάρχοντος πόρου.</p><p><em> κάποιοι μπορεί να βρουν ότι οι ενημερώσεις μπορούν να πραγματοποιηθούν με post. δεν υπάρχει κανένας σκληρός κανόνας ποιος κάποιος θα χρησιμοποιήσει για ενημερώσεις ή ποιος θα χρησιμοποιηθεί για τη δημιουργία. και πάλι αυτές οι συμβάσεις, και διαισθητικά είμαι διατεθειμένη με την παραπάνω συλλογιστική και την ακολουθώ </em>.</p>
<p>το post είναι σαν να τοποθετείτε μια επιστολή σε ένα γραμματοκιβώτιο ή να δημοσιεύετε ένα μήνυμα ηλεκτρονικού ταχυδρομείου σε μια ουρά μηνυμάτων ηλεκτρονικού ταχυδρομείου. το put είναι σαν να βάζετε ένα αντικείμενο σε μια τρύπα ή μια θέση σε ένα ράφι (έχει μια γνωστή διεύθυνση).</p><p>με το post, δημοσιεύετε τη διεύθυνση του queue ή της collection. με το put, τοποθετείτε τη διεύθυνση του στοιχείου.</p><p>το put είναι idempotent. μπορείτε να στείλετε το αίτημα 100 φορές και δεν θα έχει σημασία. post δεν είναι idempotent. εάν στείλετε το αίτημα 100 φορές, θα λάβετε 100 μηνύματα ηλεκτρονικού ταχυδρομείου ή 100 γράμματα στο ταχυδρομικό σας κουτί.</p><p>ένας γενικός κανόνας: αν γνωρίζετε την ταυτότητα ή το όνομα του αντικειμένου, χρησιμοποιήστε το put. εάν θέλετε το αναγνωριστικό ή το όνομα του αντικειμένου να ανατεθεί από το μέρος που το λαμβάνει, χρησιμοποιήστε το post.</p><p><img src="https://i.stack.imgur.com/ugbjx.png" alt="post versus put"></p>
<p><strong> νέα απάντηση (τώρα που καταλαβαίνω rest καλύτερα): </strong></p><p>το put είναι απλώς μια δήλωση του περιεχομένου που η υπηρεσία θα πρέπει από τώρα και στο εξής να χρησιμοποιεί για την αναπαραγωγή των πόρων που προσδιορίζονται από τον πελάτη. post είναι μια δήλωση του περιεχομένου της υπηρεσίας, από τώρα και στο εξής, να περιέχει (ενδεχομένως, διπλότυπο), αλλά εξαρτάται από το διακομιστή πώς να προσδιορίσει αυτό το περιεχόμενο.</p><p><code>put x</code> (αν το <code>x</code> προσδιορίζει ένα <a href="http://www.ics.uci.edu/~fielding/pubs/dissertation/rest\_arch\_style.htm#sec\_5\_2\_1\_1">resource</a> ): "αντικαταστήστε το περιεχόμενο του πόρου που προσδιορίστηκε από το <code>x</code> με το περιεχόμενό μου".</p><p><code>put x</code> (αν το <code>x</code> δεν εντοπίζει έναν πόρο): "δημιουργήστε έναν νέο πόρο που περιέχει το περιεχόμενό μου και χρησιμοποιήστε το <code>x</code> για να το προσδιορίσετε".</p><p><code>post x</code>: "αποθηκεύστε το περιεχόμενό μου και δώστε μου ένα αναγνωριστικό που μπορώ να χρησιμοποιήσω για να προσδιορίσω έναν πόρο (παλιό ή καινούργιο) που περιέχει το αναφερθέν περιεχόμενο (ενδεχομένως αναμεμειγμένο με άλλο περιεχόμενο)." "αυτός ο πόρος πρέπει να είναι πανομοιότυπος ή υποδεέστερος προς εκείνον που προσδιορίζει το <code>x</code>". "<em> y </em> ο πόρος είναι δευτερεύων στον πόρο <em> x </em> είναι τυπικά, αλλά όχι απαραίτητα, υλοποιώντας κάνοντας <em>) + y </em> μια υποδιαδρομή της <em> x </em> (π.χ. <em> x </em> = <code>/foo</code> και <em> y </em> = <code>/foo/bar</code>) και τροποποιώντας την αντιπροσώπευση του πόρου <em> x </em> για να αντικατοπτρίζει την ύπαρξη ενός νέου πόρου, π.χ. με μια υπερ-σύνδεση με τον πόρο <em> y </em> και μερικά μεταδεδομένα. μόνο ο τελευταίος είναι πραγματικά απαραίτητος για τον καλό σχεδιασμό, καθώς οι διευθύνσεις url είναι αδιαφανείς στο rest - υποτίθεται ότι <a href="https://stackoverflow.com/a/9194942/972499">χρήση hypermedia</a> αντί της κατασκευής url από την πλευρά του πελάτη για να διασχίσει την υπηρεσία ούτως ή άλλως .</p><p>στο rest, δεν υπάρχει κανένας πόρος που να περιέχει "περιεχόμενο". αναφέρομαι ως "περιεχόμενο" σε δεδομένα που χρησιμοποιεί η υπηρεσία για να κάνει τις αναπαραστάσεις με συνέπεια. συνήθως αποτελείται από ορισμένες σχετικές σειρές σε μια βάση δεδομένων ή ένα αρχείο (π.χ. ένα αρχείο εικόνας). εναπόκειται στην υπηρεσία να μετατρέψει το περιεχόμενο του χρήστη σε κάτι που μπορεί να χρησιμοποιήσει η υπηρεσία, π.χ. μετατροπή ενός ωφέλιμου φορτίου json σε δηλώσεις sql.</p><p><strong> αρχική απάντηση (ίσως είναι πιο εύκολη στην ανάγνωση) </strong>:</p><p><code>put /something</code> (αν το <code>/something</code> υπάρχει ήδη): "πάρτε ό, τι έχετε στο <code>/something</code> και αντικαταστήστε το με αυτό που σας δίνω".</p><p><code>put /something</code> (αν το <code>/something</code> δεν υπάρχει ήδη): "πάρτε αυτό που σας δίνω και το βάλετε στο <code>/something</code>."</p><p><code>post /something</code>: "πάρτε αυτό που σας δίνω και το βάζετε οπουδήποτε θέλετε κάτω από το <code>/something</code> αρκεί να μου δώσετε τη διεύθυνση url του όταν τελειώσετε."</p>
<p><strong>σύντομη απάντηση:</strong></p><p>απλός κανόνας: χρησιμοποιήστε post για να δημιουργήσετε, χρησιμοποιήστε το put για ενημέρωση.</p><p><strong>μεγάλη απάντηση:</strong></p><p>θεση:</p><ul> <li>το post χρησιμοποιείται για την αποστολή δεδομένων στο διακομιστή.</li> <li>χρήσιμο όταν η διεύθυνση url του πόρου είναι άγνωστη</li> </ul><p>βαζω:</p><ul> <li>το put χρησιμοποιείται για τη μεταφορά της κατάστασης στο διακομιστή</li> <li>χρήσιμο όταν είναι γνωστή η διεύθυνση url ενός πόρου</li> </ul><p><strong>μεγαλύτερη απάντηση:</strong></p><p>για να το καταλάβουμε πρέπει να αναρωτηθούμε γιατί χρειάστηκε το put, ποια ήταν τα προβλήματα που το put προσπαθούσε να επιλύσει αυτό post δεν μπορούσε.</p><p>από την άποψη της αρχιτεκτονικής rest αρχιτεκτονικής δεν έχει σημασία τίποτα. θα μπορούσαμε να ζήσαμε και χωρίς put. αλλά από την άποψη του προγραμματιστή του πελάτη, έκανε τη ζωή του πολύ απλούστερη.</p><p>πριν από το put, οι πελάτες δεν ήταν σε θέση να γνωρίζουν άμεσα τη διεύθυνση url που δημιούργησε ο διακομιστής ή αν είχαν δημιουργήσει όλα αυτά ή αν τα δεδομένα που θα αποστέλλονταν στον διακομιστή έχουν ήδη ενημερωθεί ή όχι. το put ανακούφισε τον υπεύθυνο ανάπτυξης όλων αυτών των πονοκεφάλων. το put είναι idempotent, το put χειρίζεται τις συνθήκες αγώνα και το put επιτρέπει στον πελάτη να επιλέξει τη διεύθυνση url.</p>
<p>το ruby on rails 4.0 θα χρησιμοποιήσει τη μέθοδο 'patch' αντί για put για να κάνει μερικές ενημερώσεις.</p><p>το rfc 5789 λέει για το patch (από το 1995):</p><blockquote> <p>απαιτείται μια νέα μέθοδος για τη βελτίωση της διαλειτουργικότητας και την πρόληψη σφαλμάτων. η μέθοδος put έχει ήδη οριστεί για να αντικαταστήσει έναν πόρο με ένα νέο νέο σώμα και δεν μπορεί να επαναχρησιμοποιηθεί για να κάνει μερικές αλλαγές. διαφορετικά, οι διακομιστές μεσολάβησης και οι προσωρινές μνήμες, ακόμα και οι πελάτες και οι διακομιστές, μπορεί να μπερδευτούν ως προς το αποτέλεσμα της λειτουργίας. post χρησιμοποιείται ήδη αλλά χωρίς ευρεία διαλειτουργικότητα (για τον ένα, δεν υπάρχει κανένας τυποποιημένος τρόπος για την εύρεση υποστήριξης μορφής patch). το patch αναφέρθηκε σε προηγούμενες προδιαγραφές http, αλλά δεν έχει οριστεί πλήρως.</p> </blockquote><p>" <a href="http://weblog.rubyonrails.org/2012/2/26/edge-rails-patch-is-the-new-primary-http-method-for-updates/">edge rails: patch είναι η νέα κύρια μέθοδος http για ενημερώσεις</a> " εξηγεί αυτό.</p>
<p>με τον κίνδυνο επαναφοράς των όσων έχουν ήδη ειπωθεί, φαίνεται σημαντικό να θυμηθούμε ότι <strong>put</strong> υπονοεί ότι ο πελάτης ελέγχει τι είναι <em>url</em> είναι θα καταλήξει να είναι, κατά τη δημιουργία ενός πόρου. έτσι μέρος της επιλογής μεταξύ <strong>put</strong> και <strong>post</strong> πρόκειται να είναι για το πόσο μπορείτε να εμπιστευτείτε τον πελάτη για να παρέχει σωστή, κανονικοποιημένη <em>url</em> που είναι συνεπείς με ό, τι και αν είναι το σχέδιό σας url.</p><p>όταν δεν μπορείτε να εμπιστεύεστε πλήρως τον πελάτη να κάνει το σωστό, θα ήταν πιο ενδεδειγμένο να χρησιμοποιήσετε <strong>post</strong> για να δημιουργήσετε ένα νέο στοιχείο και στη συνέχεια να στείλετε την διεύθυνση url πίσω στον πελάτη στην απάντηση.</p>
<p>με πολύ απλό τρόπο παίρνω το παράδειγμα της γραμμής του facebook.</p><p>περίπτωση 1: όταν δημοσιεύετε κάτι στο χρονικό σας πλαίσιο, είναι μια νέα νέα καταχώρηση. έτσι, σε αυτή την περίπτωση χρησιμοποιούν τη μέθοδο post επειδή η μέθοδος post δεν είναι μη εξουσιοδοτημένη.</p><p>περίπτωση 2: εάν ο φίλος σας σχολιάσει την ανάρτηση σας την πρώτη φορά, αυτό επίσης θα δημιουργήσει μια νέα καταχώρηση στη βάση δεδομένων, ώστε να χρησιμοποιηθεί η μέθοδος post.</p><p>περίπτωση 3: εάν ο φίλος σας επεξεργαστεί το σχόλιό του, στην περίπτωση αυτή, είχαν ένα σχόλιο id, ώστε να ενημερώσουν ένα υπάρχον σχόλιο αντί να δημιουργήσουν μια νέα καταχώρηση στη βάση δεδομένων. επομένως, για αυτόν τον τύπο λειτουργίας χρησιμοποιήστε τη μέθοδο put επειδή είναι idempotent. *</p><p>σε μια γραμμή, χρησιμοποιήστε <strong>post</strong> για να προσθέσετε <strong>μια νέα καταχώρηση</strong> στη βάση δεδομένων και <strong>put</strong> σε <strong>pdate</strong> = κάτι στη βάση δεδομένων.</p>
<p>το πιο σημαντικό θέμα είναι <em>αξιοπιστία</em>. εάν χάσει ένα μήνυμαpost, η κατάσταση του συστήματος είναι απροσδιόριστη. η αυτόματη ανάκτηση είναι αδύνατη. για τα μηνύματα put, η κατάσταση είναι απροσδιόριστη μόνο μέχρι την πρώτη επιτυχή επανάληψη.</p><p>για παράδειγμα, μπορεί να μην είναι καλή ιδέα να δημιουργήσετε συναλλαγές με πιστωτικές κάρτες με post.</p><p>αν τυχαίνει να έχετε δημιουργήσει αυτόματα uri στον πόρο σας, μπορείτε ακόμα να χρησιμοποιήσετε το put μεταφέροντας ένα παραγόμενο uri (δείχνοντας έναν κενό πόρο) στον πελάτη.</p><p>κάποιες άλλες σκέψεις:</p><ul> <li>το post ακυρώνει αποθηκευμένα αντίγραφα ολόκληρου του πόρου που περιέχει (καλύτερη συνέπεια)</li> <li>οι απαντήσεις put δεν είναι αποθηκευμένες στην κρυφή μνήμη ενώ οιpost είναι (απαιτούν content-location και λήξη)</li> <li>το put υποστηρίζεται λιγότερο από π.χ. java me, παλαιότερα προγράμματα περιήγησης, firewalls</li> </ul>
<p>οι αναγνώστες νέοι σε αυτό το θέμα θα χτυπηθούν από την ατελείωτη συζήτηση για το τι πρέπει να κάνετε <em> </em> και τη σχετική απουσία διδαγμάτων από την εμπειρία. το γεγονός ότι rest είναι "προτίμησε" πάνω από soap είναι, μάλλον, μια μάθηση υψηλού επιπέδου από την εμπειρία, αλλά καλό θα πρέπει να έχουμε προχωρήσει από εκεί; είναι το 2016. η διατριβή του roy ήταν το 2000. τι έχουμε αναπτύξει; ειχε πλακα? ήταν εύκολο να ενσωματωθεί; για να στηρίξει? θα χειριστεί την άνοδο των smartphones και τις κινητές συνδέσεις;</p><p>σύμφωνα με τον me, τα δίκτυα πραγματικής ζωής είναι αναξιόπιστα. ζητεί χρονικό όριο. οι συνδέσεις επαναφέρονται. τα δίκτυα κατεβαίνουν για ώρες ή ημέρες κάθε φορά. τα τρένα εισέρχονται σε σήραγγες με χρήστες κινητών επιβατών. για οποιοδήποτε αίτημα (όπως αναγνωρίζεται περιστασιακά σε όλη αυτή τη συζήτηση) το αίτημα μπορεί να πέσει στο νερό στο δρόμο του, ή η απόκριση μπορεί να πέσει στο νερό κατά την επιστροφή του. <strong>υπό αυτές τις συνθήκες, η έκδοση put, post και οι αιτήσεις delete απέναντι σε ουσιαστικούς πόρους, με χτύπησαν πάντοτε ως λίγο βάναυσο και αφελές.</strong></p><p>το http δεν κάνει τίποτα για να εξασφαλίσει την αξιόπιστη συμπλήρωση της απάντησης αίτησης, και αυτό είναι εντάξει επειδή αυτό είναι σωστά το έργο των εφαρμογών που έχουν επίγνωση του δικτύου. αναπτύσσοντας μια τέτοια εφαρμογή, μπορείτε να μεταβείτε στα στεφάνια για να χρησιμοποιήσετε το put αντί για το post και, στη συνέχεια, περισσότερα σκουλήκια για να δώσετε ένα συγκεκριμένο είδος σφάλματος στο διακομιστή αν ανιχνεύσετε διπλότυπα αιτήματα. πίσω στον πελάτη, πρέπει στη συνέχεια να περάσετε από τα στεφάνια για να ερμηνεύσετε αυτά τα λάθη, να επαναδημιουργήσετε, να επικυρώσετε και να επαναλάβετε.</p><p><strong>ή μπορείτε να το κάνετε αυτό</strong>: θεωρήστε τα μη ασφαλή αιτήματά σας ως εφήμερους πόρους για ένα χρήστη (ας τους ονομάσουμε ενέργειες). οι πελάτες ζητούν μια νέα "ενέργεια" σε έναν ουσιαστικό πόρο με κενό post στον πόρο. post θα χρησιμοποιηθεί μόνο για αυτό. αφού ασφαλώς κατέχει το uri της πρόσφατα εκλεπτυσμένης ενέργειας, ο πελάτης puts το ανασφαλές αίτημα στο uri ενέργειας, <em> όχι ο πόρος στόχος </em>. η επίλυση της ενέργειας και η ενημέρωση του "πραγματικού" πόρου είναι σωστά η εργασία του api σας, και εδώ αποσυνδέεται από το αναξιόπιστο δίκτυο.</p><p>ο διακομιστής κάνει την επιχείρηση, επιστρέφει την απάντηση <em> και το αποθηκεύει σε σχέση με το uri της συμφωνηθείσας ενέργειας </em>. αν κάτι πάει στραβά, ο πελάτης επαναλαμβάνει το αίτημα (φυσική συμπεριφορά!) και αν ο διακομιστής το έχει ήδη δει, επαναλαμβάνει την αποθηκευμένη απόκριση <em> και δεν κάνει τίποτα άλλο </em>.</p><p>θα παρατηρήσετε γρήγορα την ομοιότητα με τις υποσχέσεις: δημιουργούμε και επιστρέψουμε το σύμβολο κράτησης θέσης για το αποτέλεσμα προτού κάνουμε οτιδήποτε. επίσης, όπως μια υπόσχεση, μια δράση μπορεί να επιτύχει ή να αποτύχει μία φορά, αλλά το αποτέλεσμα της μπορεί να εξαχθεί επανειλημμένα.</p><p>το καλύτερο από όλα, δίνουμε την ευκαιρία να στέλνουμε και να λαμβάνουμε τις εφαρμογές μια ευκαιρία να συνδέσουμε τη μοναδικά προσδιορισμένη δράση με τη μοναδικότητα στο αντίστοιχο περιβάλλον. και μπορούμε να αρχίσουμε να απαιτούμε και να επιβάλλουμε !, υπεύθυνη συμπεριφορά από τους πελάτες: να επαναλάβετε τα αιτήματά σας όσο θέλετε, αλλά μην δημιουργείτε νέα ενέργεια έως ότου αποκτήσετε ένα οριστικό αποτέλεσμα από το υπάρχον.</p><p>ως εκ τούτου, πολυάριθμα ακανθώδη προβλήματα πάει μακριά. οι επαναλαμβανόμενες αιτήσεις εισαγωγής δεν δημιουργούν διπλότυπα και δεν δημιουργούμε τον πραγματικό πόρο μέχρι να έχουμε τα δεδομένα. (οι στήλες βάσης δεδομένων μπορούν να παραμείνουν μη-μηδενικές). τα αιτήματα επανειλημμένης ενημέρωσης δεν θα χτυπήσουν ασυμβίβαστες καταστάσεις και δεν θα αντικαταστήσουν τις επόμενες αλλαγές. οι πελάτες μπορούν (εκ νέου) να ανακτήσουν και να επεξεργαστούν χωρίς προβλήματα την αρχική επιβεβαίωση για οποιοδήποτε λόγο (ο πελάτης συνέτριψε, η απάντηση εξαφανίστηκε κλπ.).</p><p>διαδοχικά αιτήματα διαγραφής μπορούν να δουν και να επεξεργαστούν την αρχική επιβεβαίωση, χωρίς να χτυπήσουν ένα σφάλμα 404. εάν τα πράγματα διαρκούν περισσότερο από το αναμενόμενο, μπορούμε να απαντήσουμε προσωρινά και έχουμε έναν χώρο όπου ο πελάτης μπορεί να ελέγξει για το οριστικό αποτέλεσμα. το ωραιότερο μέρος αυτού του μοντέλου είναι η ιδιοκτησία του kung-fu (panda). παίρνουμε μια αδυναμία, την τάση των πελατών να επαναλαμβάνουν ένα αίτημα οποτεδήποτε δεν καταλαβαίνουν την απάντηση και να την μετατρέψουν σε <em> μια δύναμη </em> :-)</p><p>πριν μου πει ότι αυτό δεν είναι απολυτερη, παρακαλώ σκεφτείτε τους πολυάριθμους τρόπους με τους οποίους rest αρχές τηρούνται. οι πελάτες δεν κατασκευάζουν διευθύνσεις url. το api παραμένει ανιχνεύσιμο, αν και με μικρή αλλαγή στη σημασιολογία. τα ρήματα http χρησιμοποιούνται κατάλληλα. αν νομίζετε ότι πρόκειται για τεράστια αλλαγή στην εφαρμογή, μπορώ να σας πω από την εμπειρία ότι δεν είναι.</p><p>αν νομίζετε ότι θα έχετε τεράστια ποσά δεδομένων για αποθήκευση, ας μιλήσουμε για τόμους: μια τυπική επιβεβαίωση ενημέρωσης είναι ένα κλάσμα ενός κιλοβάτ. το http σας δίνει ένα ή δύο λεπτά για να απαντήσετε οριστικά. ακόμη και αν αποθηκεύετε μόνο ενέργειες για μια εβδομάδα, οι πελάτες έχουν αρκετές πιθανότητες να καλύψουν τη διαφορά. εάν έχετε πολύ μεγάλους όγκους, μπορεί να θέλετε να έχετε μια αποκλειστική τιμή αποθήκευσης βασικών τιμών συμβατή με οξύ ή μια λύση στη μνήμη.</p>
<p>φαίνεται πάντα να υπάρχει κάποια σύγχυση ως προς το πότε να χρησιμοποιείτε τη μέθοδο http post έναντι της μεθόδου http put για υπηρεσίες rest. οι περισσότεροι προγραμματιστές θα προσπαθήσουν να συνδέσουν τις λειτουργίες crud απευθείας με τις μεθόδους http. θα υποστηρίξω ότι αυτό δεν είναι σωστό και δεν μπορεί κανείς απλώς να συνδέσει τις έννοιες crud με τις μεθόδους http. αυτό είναι:</p><pre><code>create =&gt; http put retrieve =&gt; http get update =&gt; http post delete =&gt; http delete </code></pre><p>είναι αλήθεια ότι οι λειτουργίες r(etrieve) και d(elete) των λειτουργιών crud μπορούν να αντιστοιχιστούν απευθείας στις μεθόδους http get και delete αντίστοιχα. ωστόσο, η σύγχυση βρίσκεται στις λειτουργίες c(reate) και u(update). σε ορισμένες περιπτώσεις, μπορεί κανείς να χρησιμοποιήσει το put για δημιουργία, ενώ σε άλλες περιπτώσεις θα απαιτηθεί ένα post. η ασάφεια έγκειται στον ορισμό μιας μεθόδου http put έναντι μιας μεθόδου http post.</p><p>σύμφωνα με τις προδιαγραφές http 1.1 οι μέθοδοι get, head, delete και put πρέπει να είναι idempotent, και η μέθοδος post δεν είναι idempotent. αυτό σημαίνει ότι μια πράξη είναι ανεξάρτητη εάν μπορεί να εκτελεστεί σε έναν πόρο μία ή πολλές φορές και να επιστρέψει πάντα την ίδια κατάσταση αυτού του πόρου. ενώ μια μη εξουσιοδοτημένη λειτουργία μπορεί να επιστρέψει μια τροποποιημένη κατάσταση του πόρου από το ένα αίτημα στο άλλο. ως εκ τούτου, σε μια μη εξουσιοδοτημένη λειτουργία, δεν υπάρχει εγγύηση ότι κάποιος θα λάβει την ίδια κατάσταση ενός πόρου.</p><p>με βάση τον παραπάνω εξειδικευμένο ορισμό, η χρήση της μεθόδου http put σε σχέση με τη χρήση της μεθόδου http post για υπηρεσίες rest είναι: χρησιμοποιήστε τη μέθοδο http put όταν:</p><pre><code>the client includes all aspect of the resource including the unique identifier to uniquely identify the resource. example: creating a new employee. the client provides all the information for a resource to be able to modify that resource.this implies that the server side does not update any aspect of the resource (such as an update date). </code></pre><p>και στις δύο περιπτώσεις, αυτές οι λειτουργίες μπορούν να εκτελεστούν πολλές φορές με τα ίδια αποτελέσματα. αυτός είναι ο πόρος δεν θα αλλάξει ζητώντας τη λειτουργία περισσότερες από μία φορές. ως εκ τούτου, μια πραγματική εγχώρια λειτουργία. χρησιμοποιήστε τη μέθοδο http post όταν:</p><pre><code>the server will provide some information concerning the newly created resource. for example, take a logging system. a new entry in the log will most likely have a numbering scheme which is determined on the server side. upon creating a new log entry, the new sequence number will be determined by the server and not by the client. on a modification of a resource, the server will provide such information as a resource state or an update date. again in this case not all information was provided by the client and the resource will be changing from one modification request to the next. hence a non idempotent operation. </code></pre><p>συμπέρασμα</p><p>μην συσχετίζετε άμεσα και αντιστοιχίζετε λειτουργίες crud με μεθόδους http για υπηρεσίες rest. η χρήση μιας μεθόδου http put έναντι μιας μεθόδου http post θα πρέπει να βασίζεται στην ιδιότυπη πτυχή αυτής της λειτουργίας. δηλαδή, αν η λειτουργία είναι idempotent, τότε χρησιμοποιήστε τη μέθοδο http put. εάν η λειτουργία δεν είναι ενεργή, χρησιμοποιήστε τη μέθοδο http post.</p>
<blockquote> <p>ο διακομιστής προέλευσης μπορεί να δημιουργήσει τον πόρο με αυτό το uri</p> </blockquote><p>έτσι, χρησιμοποιείτε το post και πιθανόν, αλλά όχι απαραίτητο, για τη δημιουργία πόρων. δεν χρειάζεται να υποστηρίξετε και τα δύο. για μένα το post είναι απόλυτα αρκετό. είναι λοιπόν μια απόφαση σχεδιασμού.</p><p>όπως αναφέρθηκε στην απόφασή σας, χρησιμοποιείτε put για τη δημιουργία δεν υπάρχει πόρος που έχει αποδοθεί σε ένα iri, και θέλετε να δημιουργήσετε έναν πόρο ούτως ή άλλως. για παράδειγμα, ο <code>put /users/123/password</code> συνήθως αντικαθιστά τον παλιό κωδικό πρόσβασης με έναν νέο, αλλά μπορείτε να τον χρησιμοποιήσετε για να δημιουργήσετε έναν κωδικό πρόσβασης εάν δεν υπάρχει ήδη (για παράδειγμα, από πρόσφατα εγγεγραμμένους χρήστες ή αποκαθιστώντας τους απαγορευμένους χρήστες).</p>
<p>θα προσγειωθώ με τα εξής:</p><p>το put αναφέρεται σε έναν πόρο που προσδιορίζεται από το uri. σε αυτήν την περίπτωση, την ενημερώνετε. είναι το μέρος των τριών ρήματα που αναφέρονται στους πόρους - διαγράψτε και πάρτε τα άλλα δύο.</p><p>το post είναι βασικά ένα μήνυμα ελεύθερης φόρμας, με το νόημά του να ορίζεται "εκτός ζώνης". εάν το μήνυμα μπορεί να ερμηνευτεί ως προσθήκη ενός πόρου σε έναν κατάλογο, αυτό θα ήταν εντάξει, αλλά βασικά πρέπει να καταλάβετε το μήνυμα που στέλνετε (απόσπαση) για να μάθετε τι θα συμβεί με τον πόρο.</p><hr><p>επειδή τα put και get και delete αναφέρονται σε έναν πόρο, είναι επίσης εξ ορισμού idempotent.</p><p>το post μπορεί να εκτελέσει τις άλλες τρεις λειτουργίες, αλλά στη συνέχεια η σημασιολογία του αιτήματος θα χαθεί στους διαμεσολαβητές όπως οι κρυφές μνήμες και οι πληρεξούσιοι. αυτό ισχύει και για την παροχή ασφάλειας στον πόρο, δεδομένου ότι το uri μιας θέσης δεν υποδεικνύει απαραίτητα τον πόρο στον οποίο υποβάλλει αίτηση (μπορεί όμως).</p><p>ένα put δεν χρειάζεται να είναι μια δημιουργία? η υπηρεσία θα μπορούσε να σφάλσει εάν ο πόρος δεν έχει ήδη δημιουργηθεί, αλλά με άλλο τρόπο να τον ενημερώσει. ή αντίστροφα - μπορεί να δημιουργήσει τον πόρο, αλλά να μην επιτρέψει ενημερώσεις. το μόνο που απαιτείται για το put είναι ότι δείχνει έναν συγκεκριμένο πόρο και το ωφέλιμο φορτίο του είναι η αναπαράσταση αυτού του πόρου. ένα επιτυχημένο put σημαίνει (παρεμπόδιση παρεμβολής) ότι ένα get θα ανακτήσει τον ίδιο πόρο.</p><hr><p>επεξεργασία: ένα ακόμα πράγμα - ένα put μπορεί να δημιουργήσει, αλλά αν το κάνει τότε το id πρέπει να είναι ένα φυσικό id - aka μια διεύθυνση ηλεκτρονικού ταχυδρομείου. με αυτόν τον τρόπο, όταν put δύο φορές, το δεύτερο put είναι μια ενημέρωση του πρώτου. αυτό το κάνει <em>idempotent</em>.</p><p>αν το αναγνωριστικό δημιουργηθεί (για παράδειγμα ένα νέο αναγνωριστικό υπαλλήλου), τότε το δεύτερο put με την ίδια διεύθυνση url θα δημιουργήσει μια νέα εγγραφή, η οποία παραβιάζει τον κανόνα idempotent. σε αυτή την περίπτωση το ρήμα θα είναι post και το μήνυμα (όχι πόρος) θα είναι η δημιουργία ενός πόρου χρησιμοποιώντας τις τιμές που ορίζονται σε αυτό το μήνυμα.</p>
<p>εκτός από τις διαφορές που προτείνονται από άλλους, θέλω να προσθέσω ένα ακόμα.</p><p>στη μέθοδο <strong>post</strong> μπορείτε να στείλετε παραμέτρους σώματος στο <code>form-data</code></p><p>στη μέθοδο <strong>put</strong> πρέπει να στείλετε παραμέτρους σώματος στο <code>x-www-form-urlencoded</code></p><p>κεφαλίδα <code>content-type:application/x-www-form-urlencoded</code></p><p>σύμφωνα με αυτό, δεν μπορείτε να στείλετε αρχεία ή δεδομένα πολλαπλών τμημάτων στη μέθοδο <strong>put</strong></p><p><strong>επεξεργαστείτε</strong></p><blockquote> <p>ο τύπος περιεχομένου "application/x-www-form-urlencoded" είναι αναποτελεσματικός για την αποστολή μεγάλων ποσοτήτων δυαδικών δεδομένων ή κειμένου που περιέχουν χαρακτήρες που δεν είναι ascii. ο τύπος περιεχομένου "multipart/form-data" θα πρέπει να χρησιμοποιείται για την υποβολή εντύπων που περιέχουν αρχεία, μη ascii δεδομένα και δυαδικά δεδομένα.</p> </blockquote><p>αυτό σημαίνει αν πρέπει να υποβάλετε</p><blockquote> <p>αρχεία, μη ascii δεδομένα και δυαδικά δεδομένα</p> </blockquote><p>θα πρέπει να χρησιμοποιήσετε τη μέθοδο <strong>post</strong></p>
<p>η σημασιολογία υποτίθεται ότι είναι διαφορετική, καθώς το "put", όπως το "get" υποτίθεται ότι είναι idempotent - σημαίνει ότι μπορείτε να κάνετε την ίδια ακριβώς αίτηση put πολλές φορές και το αποτέλεσμα θα είναι σαν να το εκτελέσατε μόνο μία φορά.</p><p>θα περιγράψω τις συμβάσεις που νομίζω ότι χρησιμοποιούνται ευρύτερα και είναι πιο χρήσιμες:</p><p>όταν κάνετε put έναν πόρο σε μια συγκεκριμένη διεύθυνση url, αυτό που συμβαίνει είναι ότι θα πρέπει να αποθηκευτεί σε εκείνη τη διεύθυνση url ή κάτι παρόμοιο με αυτές τις γραμμές.</p><p>όταν post σε έναν πόρο σε μια συγκεκριμένη διεύθυνση url, συχνά δημοσιεύετε μια σχετική πληροφορία σε αυτή τη διεύθυνση url. αυτό σημαίνει ότι ο πόρος στη διεύθυνση url υπάρχει ήδη.</p><p>για παράδειγμα, όταν θέλετε να δημιουργήσετε μια νέα ροή, μπορείτε να την πληκτρολογήσετε σε κάποια διεύθυνση url. αλλά όταν θέλετε να post ένα μήνυμα σε μια υπάρχουσα ροή, μπορείτε post στη διεύθυνση url της.</p><p>όσο για την τροποποίηση των ιδιοτήτων του ρεύματος, μπορείτε να το κάνετε με put ή post. βασικά, χρησιμοποιήστε μόνο "put" όταν η λειτουργία είναι idempotent - διαφορετικά χρησιμοποιήστε το post.</p><p>σημειώστε, ωστόσο, ότι όλα τα σύγχρονα προγράμματα περιήγησης δεν υποστηρίζουν ρήματα http διαφορετικά από get ή post.</p>
<p>τις περισσότερες φορές, θα τις χρησιμοποιήσετε ως εξής:</p><ul> <li><strong>post</strong> ένας πόρος σε μια συλλογή</li> <li><strong>put</strong> ένας πόρος που προσδιορίζεται από τη συλλογή /: id</li> </ul><p>για παράδειγμα:</p><ul> <li><strong>μετά</strong>/στοιχεία</li> <li><strong>put</strong>/στοιχεία/1234</li> </ul><p>και στις δύο περιπτώσεις, το σώμα αιτήσεων περιέχει τα δεδομένα για τον δημιουργό ή την ενημέρωση του πόρου. θα πρέπει να είναι προφανές από τα ονόματα των διαδρομών ότι το post δεν είναι idempotent (αν το ονομάζετε 3 φορές θα δημιουργήσει 3 αντικείμενα), αλλά το put είναι idempotent (αν το αποκαλείτε 3 φορές το αποτέλεσμα είναι το ίδιο) . το put χρησιμοποιείται συχνά για λειτουργία "upsert" (δημιουργία ή ενημέρωση), αλλά πάντα μπορείτε να επιστρέψετε ένα σφάλμα 404 εάν θέλετε να το χρησιμοποιήσετε μόνο για να το τροποποιήσετε.</p><p>σημειώστε ότι το post "δημιουργεί" ένα νέο στοιχείο στη συλλογή και το put "αντικαθιστά" ένα στοιχείο σε μια δεδομένη διεύθυνση url, αλλά είναι μια πολύ συνηθισμένη πρακτική να χρησιμοποιείτε put για μερικές τροποποιήσεις, μόνο για να ενημερώσετε υπάρχοντες πόρους και να τροποποιήσετε μόνο τα πεδία που περιλαμβάνονται στο σώμα (αγνοώντας τα άλλα πεδία). αυτό είναι τεχνικά λανθασμένο, αν θέλετε να είστε rest-purist, το put θα πρέπει να αντικαταστήσει ολόκληρο τον πόρο και θα πρέπει να χρησιμοποιήσετε το patch για τη μερική ενημέρωση. εγώ προσωπικά δεν ενδιαφέρομαι πολύ όσο η συμπεριφορά είναι σαφής και συνεπής σε όλα τα τελικά σημεία api.</p><p>θυμηθείτε ότι τοrest είναι ένα σύνολο συμβάσεων και οδηγιών για να διατηρείτε απλό το api σας. εάν καταλήγετε σε μια περίπλοκη εργασία γύρω-γύρω ακριβώς για να ελέγξετε το "restful" κουτί τότε θα νικήσει το σκοπό?)</p>
<p>ενώ υπάρχει πιθανώς ένας αγνωστικός τρόπος να περιγραφούν αυτά, φαίνεται να έρχεται σε σύγκρουση με διάφορες δηλώσεις από απαντήσεις σε ιστότοπους.</p><p>ας είμαστε πολύ σαφείς και άμεσες εδώ. εάν είστε προγραμματιστής .net που συνεργάζεται με το web api, τα γεγονότα είναι (από την τεκμηρίωση του microsoft api), <a href="http://www.asp.net/web-api/overview/creating-web-apis/creating-a-web-api-that-supports-crud-operations">http://www.asp.net/web-api/overview/creating-web-apis/creating -a-web-api-that-supports-crud-operations</a> :</p><pre><code>1. put = update (/api/products/id) 2. mcsd exams 2014 - update = put, there are **no** multiple answers for that question period. </code></pre><p>βεβαιωθείτε ότι μπορείτε να χρησιμοποιήσετε το "post" για ενημέρωση, αλλά απλώς ακολουθήστε τις συμβάσεις που προβλέπονται για εσάς με το δεδομένο σας πλαίσιο. στην περίπτωσή μου είναι. net/web api, έτσι <strong> put είναι για update </strong> δεν υπάρχει συζήτηση.</p><p>ελπίζω ότι αυτό βοηθά όλους τους προγραμματιστές της microsoft που διαβάζουν όλα τα σχόλια με τους συνδέσμους ιστότοπων amazon και sun/java.</p>
<p>ακολουθεί ένας απλός κανόνας:</p><p><strong>put</strong> σε μια διεύθυνση url θα πρέπει να χρησιμοποιείται για την ενημέρωση ή τη δημιουργία του πόρου που μπορεί να βρίσκεται σε εκείνη τη διεύθυνση url.</p><p><strong>post</strong> σε μια διεύθυνση url θα πρέπει να χρησιμοποιείται για την ενημέρωση ή τη δημιουργία ενός πόρου που βρίσκεται σε κάποια άλλη διεύθυνση ("δευτερεύοντος") ή δεν μπορεί να εντοπιστεί μέσω http.</p>
<p>εάν γνωρίζετε τις λειτουργίες της βάσης δεδομένων, υπάρχουν</p><ol> <li>επιλέγω</li> <li>εισάγετε</li> <li>εκσυγχρονίζω</li> <li>διαγράφω</li> <li>συγχώνευση (ενημέρωση εάν υπάρχει ήδη, αλλιώς εισάγετε)</li> </ol><p>χρησιμοποιώ το <code>put</code> για τη συγχώνευση και την ενημέρωση όπως οι λειτουργίες και χρησιμοποιήστε το <code>post</code> για εισαγωγές.</p>
<p>στην πράξη, τοpost λειτουργεί καλά για τη δημιουργία πόρων. η διεύθυνση url του νεοσύστατου πόρου θα πρέπει να επιστραφεί στην κεφαλίδα απόκρισης τοποθεσίας. το put θα πρέπει να χρησιμοποιείται για την πλήρη ενημέρωση ενός πόρου. λάβετε υπόψη ότι αυτές είναι οι βέλτιστες πρακτικές κατά το σχεδιασμό ενός restful api. η προδιαγραφή http ως τέτοια δεν περιορίζει τη χρήση του put/post με λίγους περιορισμούς για τη δημιουργία/ενημέρωση πόρων. ρίξτε μια ματιά στο <a href="http://techoctave.com/c7/posts/71-twitter-rest-api-dissected">http://techoctave.com/c7/posts/71-twitter-rest-api-dissected</a> που συνοψίζει τις βέλτιστες πρακτικές.</p>
<p><strong>post:</strong> χρησιμοποιήστε το για τη δημιουργία νέων πόρων. είναι σαν την εντολή insert (δήλωση sql) με αναγνωριστικό αυτόματης αύξησης. στο τμήμα απάντησης περιέχει ένα νέο αναγνωριστικό.</p><blockquote> <p>το post χρησιμοποιείται επίσης για την ενημέρωση μιας εγγραφής.</p> </blockquote><p><strong>put:</strong> χρησιμοποιήστε το για τη δημιουργία ενός νέου πόρου, αλλά εδώ ξέρω το κλειδί ταυτότητας. είναι σαν το insert (δήλωση sql) όπου ξέρω εκ των προτέρων το κλειδί ταυτότητας. στο τμήμα απάντησης δεν στέλνει τίποτα.</p><blockquote> <p>το put χρησιμοποιείται επίσης για την ενημέρωση ενός πόρου</p> </blockquote>
<blockquote> <p>έτσι, ποιο πρέπει να χρησιμοποιηθεί για τη δημιουργία ενός πόρου; ή κάποιος πρέπει να υποστηρίξει και τα δύο;</p> </blockquote><p>θα πρέπει να χρησιμοποιήσετε <code>patch</code>. μπορείτε patch τη λίστα των ερωτήσεων όπως</p><pre><code>patch /questions http/1.1 </code></pre><p>με μια λίστα που περιέχει το αντικείμενο που θέλετε να δημιουργηθεί όπως</p><pre><code>[ { "title": "i said semantics!", "content": "is this serious?", "answer": "not really" } ] </code></pre><p>πρόκειται για ένα αίτημα patch ως</p><ul> <li>τροποποιείτε τον <em>υπάρχοντα</em> κατάλογο των πόρων <em>χωρίς να παρέχετε ολόκληρο το νέο</em> περιεχόμενο</li> <li>αλλάζετε την κατάσταση της νέας σας ερώτησης από μη υπάρχουσες σε υπάρχουσες <em>χωρίς την παροχή όλων των δεδομένων</em> (ο διακομιστής πιθανότατα θα προσθέσει <code>id</code>).</li> </ul><p>ένα μεγάλο πλεονέκτημα αυτής της μεθόδου είναι ότι μπορείτε να δημιουργήσετε πολλές οντότητες χρησιμοποιώντας ένα μόνο αίτημα, απλά παρέχοντάς τους όλες στη λίστα.</p><p>αυτό είναι κάτι <code>put</code> προφανώς δεν μπορεί. θα μπορούσατε να χρησιμοποιήσετε το <code>post</code> για τη δημιουργία πολλαπλών οντοτήτων καθώς είναι ο νεροχύτης της κουζίνας του http και μπορεί να κάνει τα πάντα.</p><p>ένα μειονέκτημα είναι ότι πιθανώς κανένας δεν χρησιμοποιεί <code>patch</code> αυτόν τον τρόπο. φοβάμαι, απλά το εφευρέθηκα, αλλά ελπίζω, παρέθεσα μια καλή επιχειρηματολογία.</p><p>θα μπορούσατε να χρησιμοποιήσετε το <code>create</code>, αντίθετα, καθώς επιτρέπονται τα ρήματα http, είναι πιθανό να μην λειτουργούν με κάποια εργαλεία.</p><p>όσον αφορά τη σημασιολογία, <code>create</code> είναι η imho η μόνη σωστή επιλογή, οτιδήποτε άλλο είναι ένα τετράγωνο πείρο σε μια στρογγυλή τρύπα. δυστυχώς, το μόνο που έχουμε είναι στρογγυλές τρύπες.</p>