🚰 👩‍🏭 👂🏽 Blobstore API (भाग 1) का उपयोग करके ड्रॉपबॉक्स सेवा को लागू करना 💲 👩🏿‍✈️ 🏒

Blobstore api - ऐप इंजन प्लेटफ़ॉर्म की हाल ही में पुनःपूर्ति, आपको बड़ी फ़ाइलों को डाउनलोड करने और साझा करने की अनुमति देती है, वर्तमान में 2Gb ( मूल - 50Mb, लगभग। ट्रांसलेटर ) तक। एपीआई का उपयोग करना भी सबसे कठिन में से एक है। नोट्स की एक छोटी श्रृंखला दिखाएगी कि ब्लॉबस्टोर एपीआई का उपयोग करके ऐप इंजन पर आधारित "ड्रॉपबॉक्स" सेवा को कैसे लागू किया जाए। आरंभ करने के लिए, हम फ़ाइलों को डाउनलोड करने के लिए आवश्यक बुनियादी बातों पर विचार करेंगे, उनके बारे में जानकारी एक डेटास्टोर में संग्रहीत करेंगे और फिर उन्हें डाउनलोड करने के लिए उपयोगकर्ताओं को लौटाएंगे।

चलिए अपलोड फॉर्म के साथ शुरू करते हैं। यह चरण बहुत स्पष्ट है: हम एक मानक एचटीएमएल फॉर्म बनाते हैं, केवल एक चीज जो हमें करने की आवश्यकता है वह है फॉर्म की कार्रवाई के लिए blobstore.create_upload_url विधि को कॉल करके और वांछित हैंडलर के साथ URL को पारित करके। नीचे हमारा कोड है:

class FileUploadFormHandler(BaseHandler): @util.login_required def get(self): self.render_template("upload.html", { 'form_url': blobstore.create_upload_url('/upload'), 'logout_url': users.create_logout_url('/'), })

सब कुछ मानक है, लेकिन फिर भी ध्यान देने योग्य है - सुविधा के लिए, हम google.appengine.ext.webapp.util पैकेज से login_required डेकोरेटर का उपयोग करते हैं, जिसके लिए उपयोगकर्ता को लॉग इन करना पड़ता है (और अन्यथा लॉगिन पर रीडायरेक्ट किया जाता है)। और यह टेम्प्लेट है:

 <html> <head> <title> </title> </head> <body> <p style="float: right"><a href="{{logout_url}}">Log Out</a></p> <h1>Upload a file to App Engine File Hangar</h1> <form method="POST" action="{{form_url}}" enctype="multipart/form-data"> <input type="file" name="file" /><br /> <input type="submit" value="Upload" /> </form> </body> </html>

फ़ॉर्म टैग की विशेषताओं पर ध्यान दें: विधि "POST" होनी चाहिए, और enctype "मल्टीपार्ट / फॉर्म-डेटा" होना चाहिए, अन्यथा डाउनलोड काम नहीं करेगा!

आगे हम एक बूट हैंडलर लिखना चाहते हैं। चलो डाउनलोड की गई फ़ाइलों के बारे में जानकारी संग्रहीत करने के लिए मॉडल के विवरण के साथ शुरू करते हैं। यहाँ यह है:

 class FileInfo(db.Model): blob = blobstore.BlobReferenceProperty(required=True) uploaded_by = db.UserProperty(required=True) uploaded_at = db.DateTimeProperty(required=True, auto_now_add=True)

सुंदर मानक मॉडल, blobstore.BlobReferenceProperty के 'बूँद' फ़ील्ड के अपवाद के साथ। BlobReferenceProperty ReferenceProperty के समान है, एकमात्र अंतर यह है कि यह किसी अन्य मॉडल को नहीं, बल्कि Blob को संदर्भित करता है। अनुरोध पर, BlobInfo ऑब्जेक्ट वापस किया जाता है ।

डाउनलोड प्रक्रिया के लिए सीधे जिम्मेदार कोड:

 class FileUploadHandler(blobstore_handlers.BlobstoreUploadHandler): def post(self): blob_info = self.get_uploads()[0] if not users.get_current_user(): blob_info.delete() self.redirect(users.create_login_url("/")) return file_info = FileInfo(blob=blob_info.key(), uploaded_by=users.get_current_user()) db.put(file_info) self.redirect("/file/%d" % (file_info.key().id(),))

चलो चरणों के माध्यम से चलते हैं। सबसे पहले, हैंडलर सामान्य webapp के बजाय BlobstoreUploadHandler वर्ग से विरासत में मिलता है। RequestHandler। BlobstoreUploadHandler एक सहायक विधि, self.get_uploads () को परिभाषित करता है, जो BlobInfo ऑब्जेक्ट्स की सूची देता है, प्रत्येक डाउनलोड की गई फ़ाइल के लिए।

पोस्ट () विधि में, हम self.get_uploads () कहते हैं और पहले तत्व को पुनः प्राप्त करते हैं। चूंकि ब्लॉबस्टोर एपीआई वर्तमान में एक फॉर्म में कई फ़ाइल अपलोड का समर्थन नहीं करता है, केवल एक तत्व हमेशा वापस आ जाता है, हम बस इसे निकालते हैं ( पहले से समर्थित, लगभग। अनुवादक )। फिर, हम खुद को अनधिकृत उपयोगकर्ताओं से बचाते हैं जो फॉर्म को एक या दूसरे तरीके से सबमिट करते हैं। यदि हम डाउनलोड प्रयास के लिए अधिकृत नहीं थे, तो हम यहां login_required डेकोरेटर का उपयोग नहीं कर सकते हैं। अंत में, हम डाउनलोड की गई फ़ाइल के लिए डेटास्टोर में एक प्रविष्टि बनाते हैं और नए जोड़े गए फ़ाइल के बारे में जानकारी के साथ उपयोगकर्ता को रीडायरेक्ट करते हैं।

अगला कदम एक हैंडलर लागू करना है जो डाउनलोड की गई फ़ाइल के बारे में जानकारी प्राप्त करता है और प्रदर्शित करता है। यहां कुछ भी जटिल नहीं है:

 class FileInfoHandler(BaseHandler): def get(self, file_id): file_info = FileInfo.get_by_id(long(file_id)) if not file_info: self.error(404) return self.render_template("info.html", { 'file_info': file_info, 'logout_url': users.create_logout_url('/'), })

और प्रदर्शित करने के लिए टेम्प्लेट:

 <html> <head> <title>  </title> </head> <body> <p style="float: right"><a href="{{logout_url}}">Log Out</a></p> <h1>  </h1> <table> <tr><th> </th><td>{{file_info.blob.filename}}</td></tr> <tr><th></th><td>{{file_info.blob.size}} bytes</td></tr> <tr><th> </th><td>{{file_info.uploaded_at}}</td></tr> <tr><th> </th><td>{{file_info.uploaded_by}}</td></tr> <tr><th>Content Type</th><td>{{file_info.blob.content_type}}</td></tr> </table> <p><a href="/file/{{file_info.key.id}}/download">  </a></p> </body> </html>

अंत में, एक हैंडलर जो सीधे उपयोगकर्ता को फाइल देता है:

 class FileDownloadHandler(blobstore_handlers.BlobstoreDownloadHandler): def get(self, file_id): file_info = FileInfo.get_by_id(long(file_id)) if not file_info or not file_info.blob: self.error(404) return self.send_blob(file_info.blob, save_as=True)

यहां, हम कुंजी द्वारा FileInfo प्रविष्टि का अनुरोध करते हैं, और यदि यह मौजूद है और इसमें एक बूँद है, तो हम send_blob सहायक विधि को मूल वर्ग BlobstoreDownloadHandler द्वारा प्रदान करते हैं। हम True पर सेट अतिरिक्त तर्क 'save_as' पास करते हैं, जो गारंटी देता है कि फ़ाइल डाउनलोड के लिए भेजी जाएगी, ब्राउज़र में प्रदर्शन के लिए नहीं। हम विशिष्ट फ़ाइल नाम को इंगित करने के लिए True के बजाय फ़ाइल नाम भी निर्दिष्ट कर सकते हैं: डिफ़ॉल्ट रूप से, यह वह नाम है जिसके साथ फ़ाइल डाउनलोड की गई थी।

यह लेख केवल सतही वर्णन करता है कि हम ब्लॉबस्टोर के साथ क्या कर सकते हैं, और अधिक संपूर्ण चित्र के लिए, आप प्रलेखन से बहुत कुछ सीख सकते हैं। ये आवश्यक मूल बातें हैं, हालांकि, अगले भाग में हम कुछ नया करेंगे: बेहतर अनुभव के अनुभव के लिए जावास्क्रिप्ट या फ्लैश में डाउनलोड विजेट के लिए समर्थन जोड़ें!

जो लोग इसे सभी कार्रवाई में परीक्षण करना चाहते हैं, उनके लिए डेमो एप्लिकेशन का स्रोत कोड यहां उपलब्ध है ।

Blobstore API (भाग 1) का उपयोग करके ड्रॉपबॉक्स सेवा को लागू करना

More articles: