Django-rest-framework: आसानी से ईटैग जोड़ें/सत्यापित करें।

ठीक है, मेरे पास एक प्रारंभिक पैच है: https://github.com/schinckel/django-rest-framework/commit/cc3a88edc6be21347a9b35929d158b8831ba9bd3

हालांकि इस पर प्रतिक्रिया के लिए बहुत खुश हैं।

ठीक है, तो, शुरू में मैंने जो लिखा वह यह था...

बढ़िया, हाँ, मैं वास्तव में इसे देखना पसंद करूंगा।

युगल विचार - आपको वर्तमान में मौजूद View._ETAG के बजाय केवल View.add_header का उपयोग करने में सक्षम होना चाहिए।
(और ऐसा लगता है कि .add_header को शायद ResponseMixin वर्ग में ले जाया जाना चाहिए।)

दूसरे, मैं देखना चाहता हूं कि @condition , @etag और @last_modified सजावट शायद https://github.com/django/django/blob/master/django/views/decorators का एक सीधा-सीधा क्लोन हो सकता है

लेकिन चीजों को थोड़ा और देख रहा था ...

और शायद बाद में जाने का यह बिल्कुल सही तरीका नहीं है ...

आप वास्तव में आरईएसटी ढांचे के विचारों से एचटीपीरेस्पॉन्स वापस कर सकते हैं, उन्हें बस सभी सामान्य सामग्री वार्ता/क्रमबद्ध सामग्री लागू नहीं होती है। @last_modified , @etag और @condition डेकोरेटर केवल खाली HttpResponses लौटाते हैं, इसलिए यह वास्तव में कोई समस्या नहीं है।

तो, मैं क्या सोच रहा हूं, अगर हमने केवल __setitem__ __getitem__ और has_header को रिस्पांस क्लास में जोड़ा है, तो मुझे लगता है कि Django का मौजूदा @last_modified , @etag और @condition डेकोरेटर्स को REST फ्रेमवर्क व्यू पर ठीक काम करना चाहिए _जब तक कि व्यू return Response(status, data) स्टाइल के बजाय return data स्टाइल का उपयोग कर रहा हो।

ओबीवी अगर हम इसे दस्तावेज करते हैं तो यह मददगार होगा, लेकिन यह कुछ ऐसा दोहराने से ज्यादा समझ में आता है जो Django पहले से ही करता है।

तुम क्या सोचते हो?

django डेकोरेटर्स का उपयोग करने में एक समस्या हो सकती है: मुझे यकीन नहीं है कि वे विधियों के साथ काम करेंगे, केवल नंगे कार्य। मैंने जो डेकोरेटर लिखा था, वह इस मामले के लिए स्टैक ओवरफ्लो के माध्यम से मिले एक पर आधारित था।

ऐसा नहीं हो सकता है, जिस स्थिति में यह समाधान बेहतर लगता है।

ऐसा कहकर, मैं वापसी डेटा शैली वापस कर रहा हूं, क्योंकि यह कम बॉयलरप्लेट है, और मैं आमतौर पर केवल उन वस्तुओं को लौटा रहा हूं जिन्हें मैं जेसन के रूप में क्रमबद्ध करना चाहता हूं। हम इसे दोनों तरीकों से काम करने में सक्षम हो सकते हैं।

एक अन्य विकल्प एक मिक्सिन हो सकता है जो इन्हें व्यू क्लास में जोड़ता है।

यह मेरे साथ भी होता है कि django सज्जाकार सशर्त PUT, POST और DELETE अनुरोधों के संबंध में सही काम नहीं कर सकते हैं। बस उस मुद्दे को ठीक करने के लिए सिनात्रा को एक पैच प्रस्तुत किया।

आखिरी बिट पर ध्यान न दें: स्पष्ट रूप से मैंने कोड को ठीक से नहीं पढ़ा था।

वास्तव में वहाँ एक बिंदु है: वे सज्जाकार _methods_ पर एटीएम काम नहीं कर सकते हैं, क्योंकि उनके पास अतिरिक्त 'स्वयं' तर्क है। मैं इसकी जांच करूंगा और Django को टिकट जमा करूंगा, क्योंकि उन्हें सीबीवी के साथ भी काम करना चाहिए ...

आह, ठीक है - मुझे अब @method_decorator दिखाई दे रहा है... https://docs.djangoproject.com/en/dev/topics/class-based-views/#decorating -class -based-views
तो मुझे लगता है कि इसे बंद करने के लिए हमें इसकी आवश्यकता है:

1. प्रतिक्रिया के लिए थोड़ा सा बदलाव
2. कुछ हल्के दस्तावेज

मुझे यकीन है कि मैंने उस दस्तावेज़ को देखा, लेकिन मुझे वह डेकोरेटर नहीं मिला!

मैंने django डेकोरेटर का उपयोग करने की कोशिश की और प्रारंभिक परिणाम वास्तव में अजीब था, जानकारी के साथ जो केवल असंबंधित ईटैग कार्यों में दिखाई देने वाले विचारों से संबंधित होना चाहिए।

कुछ घंटों के बाद इसे थोड़ा बेहतर बनाने की कोशिश करने के बाद, मैं एक ऐसा समाधान लेकर आया जिसने मेरी समस्याओं का समाधान किया और काफी सामान्य लगता है। इस पर आपके विचार क्या हैं:

https://bitbucket.org/vitormazzi/django-rest-framework/changeset/6f8de4500c6f

इस मुद्दे में कुछ नए जीवन की सांस लेने की उम्मीद है कि अब हम 2.x रिलीज पर हैं।

यहां मेरे विचार ज्यादातर एक परियोजना में कार्यक्षमता जोड़ने की कोशिश करने और इस पोस्ट को पढ़ने से निश्चित रूप से अभी भी किसी न किसी तरह से जुड़े हुए हैं।

मैं दो क्षेत्रों को देखता हूं जहां डीआरएफ को ईटैग पर विचार करने की आवश्यकता है - विचारों में उपयोग और किसी उदाहरण के संस्करण का अद्वितीय प्रतिनिधित्व कैसे प्राप्त करें।

विचारों

प्राप्त
GET अनुरोधों को केवल उपयुक्त शीर्षलेख में ETag वस्तुओं की सेवा करने की आवश्यकता है। RetrieveModelMixin एक पंक्ति परिवर्तन इसे आसानी से जोड़ सकता है:

def retrieve(self, request, *args, **kwargs):
    self.object = self.get_object()
    serializer = self.get_serializer(self.object)
    headers = {'ETag': self.object.etag}
    return Response(serializer.data, headers=headers)

पुट, पैच, डिलीट
HTTP क्रियाओं को अद्यतन करने के लिए एक सामान्य जांच दृश्य के dispatch में की जा सकती है या संभवतः किसी अन्य विधि में खींची जा सकती है क्योंकि यह जांचने की आवश्यकता होगी कि क्या ईटैग चालू हैं (नीचे विकल्प अनुभाग देखें):

    header_etag = request.META.get('HTTP_IF_MATCH')
    if header_etag is None:
        return Response({'error': 'IF_MATCH header is required'}, status=400)

फिर वस्तु को पुनः प्राप्त करने के बाद एक अधिक विस्तृत जांच यह देखने के लिए कि क्या अनुरोध को लगता है कि यह सही देख रहा है:

    if self.object.etag != header_etag:
        return Response({'error': 'object has been updated since you last saw it'}, status=412)

एक इंस्टेंस संस्करण का अनूठा प्रतिनिधित्व

मुझे नहीं लगता कि किसी वस्तु के ETag की वास्तविक पीढ़ी DRF की समस्या होनी चाहिए। मैं अपने ऑब्जेक्ट के updated फ़ील्ड के युग समय का उपयोग करके परीक्षण कर रहा हूं लेकिन मैं आसानी से देख सकता हूं कि इसे और अधिक जटिल होने की आवश्यकता है।

मेरा प्रस्ताव है कि डीआरएफ डिफ़ॉल्ट रूप से obj.etag को देखता है लेकिन यह सामान्य सीबीवी प्रवाह का उपयोग करके कॉन्फ़िगर करने योग्य है, उदाहरण के लिए get_etag() और etag_var = 'get_my_objects_etag' ।

हमें यह भी लागू करने की आवश्यकता होगी कि ईटैग को एक स्ट्रिंग के रूप में वस्तुओं से पुनर्प्राप्त किया जाता है क्योंकि हम एक हेडर के खिलाफ तुलना कर रहे हैं और इस प्रकार की व्याख्या करने की कोशिश करना सबसे अच्छा दर्दनाक होगा।

विकल्प

• ईटैग के उपयोग को चालू या बंद करने के लिए वैश्विक सेटिंग (सीरियलाइज़र आदि के साथ)।
• दृश्यों पर दो सेटिंग्स:
  
  
  
  • use_etags (या कुछ इसी तरह) - एक बूलियन
  
  
  • etag_var - एक फ़ंक्शन नाम की स्ट्रिंग जिसे हम प्रश्न में वस्तु पर getattr कर सकते हैं
  
  

@ghickman - मैं अन्य प्लग करने योग्य वर्गों के समान ईटैग और लास्टमोडिफाइड लुक निर्धारित करने के लिए व्यवहार देखना चाहता हूं। अर्थात। कुछ ऐसा हो:

class MyView(views.APIView):
    cache_lookup_classes = []

कैशिंग हस्ताक्षर को ईटैग और लास्टमॉडिफाइड दोनों से निपटना चाहिए, और दो अलग-अलग चीजें हैं जिन्हें हम प्रदान करना चाहते हैं:

• एक ऑब्जेक्ट इंस्टेंस दिए गए एक ईटैग और/या अंतिम संशोधित निर्धारित करें।
• आने वाले अनुरोध को देखते हुए पूर्व-निर्धारित रूप से एक ईटैग और/या अंतिम संशोधित निर्धारित करें।

एक BaseCacheLookup , जिसमें दो विधि हस्ताक्षर होंगे जो कुछ इस तरह दिख सकते हैं:

.object_etag_and_last_modified(self, view, obj)
.preemptive_etag_and_last_modified(self, view, request, *view_kwargs, **view_kwargs)

किसी वस्तु को देखते हुए (etag, last modified) दो-टुपल लौटाएं, जिनमें से कोई भी बस कोई नहीं हो सकता है।
यदि आने वाले अनुरोध में इफ-मॉडिफाइड-से या इफ-नो-मैच हेडर से मेल खाता है, तो 304 नॉट मॉडिफाइड रिस्पॉन्स वापस किया जाएगा। यदि आने वाली प्रतिक्रिया में मेल खाने वाला इफ-मैच या इफ-अनमॉडिफाइड-से है तो 412 पूर्व शर्त विफल प्रतिक्रिया वापस कर दी जाएगी।

यह आपके द्वारा वर्णित कार्यान्वयन से मेल खाने वाले CacheLookupClass को अनुमति देगा, लेकिन अन्य रूपों को भी।

आप विभिन्न अंतिम संशोधित ग्रैन्युलैरिटी पर कई कैश लुकअप क्लासेस भी लागू कर सकते हैं, उदाहरण के लिए,
GlobalLastModifiedLookup के अतिरिक्त एक ObjectETagLookup । कैश्ड कॉपी के बाद से कोई लेखन नहीं किया गया था, तो इससे कोई भी डेटाबेस कॉल करने से पहले दृश्य को पूर्ववत रूप से वापस जाने की अनुमति मिल जाएगी। (यदि आप वार्निश के साथ सर्वर साइड कैशिंग का उपयोग कर रहे हैं तो वास्तव में इस तरह की बुनियादी नीतियां भी एक बड़ा अंतर ला सकती हैं)

क्या इस का प्लग करने योग्य वर्ग पक्ष आपके लिए उचित है?

मैंने LastModified के बारे में नहीं सोचा था क्योंकि मैं इसे अपने वर्तमान कार्यान्वयन में उपयोग नहीं कर रहा हूं लेकिन इसका उद्देश्य निश्चित रूप से शामिल करना समझ में आता है।

प्लग करने योग्य कक्षाएं एक महान विचार की तरह लगती हैं, खासकर यदि हम LastModified और ETag कार्यान्वयन को बुनियादी उदाहरणों के रूप में शामिल करते हैं। मुझे यह विचार पसंद है कि किसी प्रोजेक्ट में न्यूनतम परिवर्तनों के साथ जीईटी कैशिंग चालू करना बहुत आसान होगा।

मैं etag और last_modified पीढ़ी को दो विधियों (उन नामों में से) में विभाजित करना पसंद करूंगा, जैसा कि आपने सुझाव दिया था, लागू नहीं होने पर None लौटाएं। CacheLookup बैकएंड तब एक और/या दूसरे को लागू करना चुन सकता है। हम सुविधा के लिए हमेशा एक उपयोगिता पद्धति प्रदान कर सकते हैं ( cachable_obj_repr या unique_obj_repr शायद?)

टीएल; डॉ हां प्लग करने योग्य वर्ग पक्ष उचित लगता है और इसे अधिक लचीलापन देना चाहिए। मुझे इसके लिए पैच लिखना शुरू करने में खुशी हो रही है।

सभी को नमस्कार। यदि आप रुचि रखते हैं तो मैंने अपनी एक्सटेंशन लाइब्रेरी http://chibisov.github.io/drf-extensions/docs/ में ईटैग समर्थन के लिए अलग दृष्टिकोण लागू किया है।

@चिबिसोव नीटो । हमें वास्तव में #1019 को समाप्त करना चाहिए, इसलिए हमें इस तरह के पैकेज से लिंक करने के लिए डॉक्स में कहीं मिल गया है।

इसे #1019 के रूप में बंद करना बंद कर दिया गया है और @chibisov का पैकेज सूचीबद्ध है।

यह एक उद्देश्य पर 3.3 के रूप में मील का पत्थर था क्योंकि मैं चाहूंगा कि हम किसी बिंदु पर इस पर कुछ औपचारिक निर्देश दें। अगर हम इसे बंद करना चुनते हैं तो अति-चिंतित नहीं है, लेकिन यह मेरे आंतरिक रोडमैप पर रहा है।

दुर्भाग्य से drf-एक्सटेंशन में Etag कार्यक्षमता पर डिफ़ॉल्ट कार्यान्वयन और दस्तावेज़ीकरण केवल गलत और खतरनाक रूप से छोटी गाड़ी है। अगर _request_ बदलता है तो यह Etag को बदल देता है, न कि _response_ बदलने पर। सर्वर-साइड कैशिंग के लिए आप ठीक यही चाहते हैं, और ठीक वही जो आप Etag के लिए नहीं चाहते हैं।

@mbox सबसे अच्छी बात यह होगी कि इस बारे में drf-एक्सटेंशन पर एक मुद्दा खोला जाए या यदि आपको लगता है कि यह एक DRF "कोर" मुद्दा है जो यहां खुला है। कृपया ध्यान दें कि एक असफल परीक्षण समस्या को देखने के लिए हमारे लिए एक अच्छी शुरुआत होगी।

@mbox @xordoquy
मैंने अभी-अभी drf-एक्सटेंशन (https://github.com/chibisov/drf-extensions/pull/171) के लिए एक पीआर सबमिट किया है जो डीआरएफ एपीआई के माध्यम से संसाधनों में हेरफेर करने के लिए आशावादी समवर्ती नियंत्रण की अनुमति देता है। यह सभी ऑब्जेक्ट फ़ील्ड के सिमेंटिक हैश का उपयोग कर रहा है और मैंने प्रदर्शन उद्देश्यों के लिए एक परीक्षण ऐप शामिल किया है। इसका परीक्षण पायथन 2.7, 3.4, 3.5 के साथ DRF>=3.3.1 और django>=1.8 के खिलाफ किया गया है।

धन्यवाद

भविष्य के पाठकों के लिए बस एक नोट - मैंने डीआरएफ के साथ Django से सशर्त सज्जाकारों का उपयोग करने के लिए छोटा पैकेज बनाया है। तो यदि आप रुचि रखते हैं:
https://github.com/jozo/django-rest-framework-condition