আপলোডডেটাপ্রোভাইডার

public abstract class UploadDataProvider implements Closeable

---

এটি একটি অ্যাবস্ট্রাক্ট ক্লাস যা এমবেডারকে UrlRequest এ একটি আপলোড বডি সরবরাহ করার সুযোগ দেয়। এটি নন-চাঙ্কড (আকার আগে থেকে জানা) এবং চাঙ্কড (আকার আগে থেকে জানা নেই) উভয় প্রকার আপলোড সমর্থন করে। মনে রাখবেন যে, সব সার্ভার চাঙ্কড আপলোড সমর্থন করে না।

একটি আপলোড হয় সবসময় খণ্ডে খণ্ডে বিভক্ত করা হয়, অথবা ডেটা একাধিকবার পাঠানো হলে তা একাধিক আপলোডে ভাগ করা হয়, কিংবা কখনোই খণ্ডে খণ্ডে বিভক্ত করা হয় না।

সারসংক্ষেপ

সরকারি নির্মাণকারী
UploadDataProvider ()

জনসাধারণের পদ্ধতি
void	close () যখন কোনো অনুরোধের জন্য এই UploadDataProvider-টির আর প্রয়োজন হয় না, তখন এটিকে কল করা হয়, যাতে রিসোর্স (যেমন একটি ফাইল) স্পষ্টভাবে মুক্ত করা যায়।
abstract long	getLength () যদি এটি একটি অবিভক্ত আপলোড হয়, তাহলে আপলোডটির দৈর্ঘ্য ফেরত দেওয়া হয়।
abstract void	read ( UploadDataSink uploadDataSink, ByteBuffer byteBuffer) রিড ডেটা byteBuffer আপলোড করে।
abstract void	rewind ( UploadDataSink uploadDataSink) রিওয়াইন্ড ডেটাকে একেবারে শুরুতে আপলোড করে।

সরকারি নির্মাণকারী

আপলোডডেটাপ্রোভাইডার

public UploadDataProvider()

জনসাধারণের পদ্ধতি

বন্ধ

public void close()

যখন কোনো অনুরোধের জন্য এই UploadDataProvider-টির আর প্রয়োজন হয় না, তখন এটিকে কল করা হয়, যাতে রিসোর্স (যেমন একটি ফাইল) স্পষ্টভাবে মুক্ত করা যায়।

নিক্ষেপ
java.io.IOException	প্রক্রিয়া চলাকালীন কোনো IOException ঘটলে, অনুরোধটি সম্পূর্ণ না হয়ে থাকলে তা ব্যর্থ হবে; অন্যথায় এটি লগ করা হবে।

দৈর্ঘ্য

public abstract long getLength()

যদি এটি একটি নন-চাঙ্কড আপলোড হয়, তাহলে আপলোডটির দৈর্ঘ্য ফেরত দেবে। যদি এটি একটি চাঙ্কড আপলোড হয়, তবে অবশ্যই -১ ফেরত দিতে হবে।

ফেরত
long	নন-চাঙ্কড আপলোডের ক্ষেত্রে আপলোডের দৈর্ঘ্য, অন্যথায় -১।

নিক্ষেপ
java.io.IOException	প্রক্রিয়া চলাকালীন যদি কোনো IOException ঘটে থাকে।

পড়ুন

public abstract void read(UploadDataSink uploadDataSink, ByteBuffer byteBuffer)

byteBuffer এ আপলোড ডেটা পড়ে। কাজটি সম্পন্ন হলে, বাফারের অবস্থান পঠিত বাইটগুলোর শেষ পর্যন্ত আপডেট করা হয়। বাফারের সীমা পরিবর্তন করা হয় না। এই মেথডের প্রতিটি কলের পরে অবশ্যই uploadDataSink কে একবার কল করতে হবে, যা সিনক্রোনাস বা অ্যাসিনক্রোনাস হতে পারে: সফল হলে onReadSucceeded এবং ব্যর্থ হলে onReadError । এই মেথডগুলোর কোনো একটি কল না করা পর্যন্ত read বা rewind কোনোটিই কল করা হবে না। এমনকি যদি সংশ্লিষ্ট UrlRequest বাতিলও করা হয়, রিসোর্স নিরাপদে মুক্ত করার আগে এই দুটির কোনো একটি অবশ্যই কল করতে হবে। একটি এক্সেপশন থ্রো করলেও রিসোর্স মুক্ত হয়ে যাবে এবং রিকোয়েস্টটি এররড হয়ে যাবে।

দ্রষ্টব্য: নন-চাঙ্কড আপলোডের ক্ষেত্রে, onReadSucceeded শুধুমাত্র তখনই কল করা উচিত যখন রিড সফল হয় এবং byteBuffer এ অন্তত এক বাইট রিড করা হয়। চাঙ্কড আপলোডের ক্ষেত্রে (যেখানে ডেটার আকার অজানা), একটি খালি বাইট বাফার থাকা সত্ত্বেও শেষ চাঙ্কটির জন্য onReadSucceeded কল করার অনুমতি আছে।

প্যারামিটার
UploadDataSink uploadDataSink	পঠন সম্পন্ন হলে অবহিত করার উদ্দেশ্য।
ByteBuffer byteBuffer	পঠিত বাইটগুলো কপি করার জন্য বাফার। byteBuffer-এর সীমা পরিবর্তন করবেন না।

নিক্ষেপ
java.io.IOException	প্রক্রিয়া চলাকালীন কোনো IOException ঘটলে, onFailed কল করা হবে এবং থ্রো করা এক্সেপশনটিকে CallbackException এর কারণ হিসেবে সেট করা হবে।

রিওয়াইন্ড

public abstract void rewind(UploadDataSink uploadDataSink)

আপলোড ডেটাকে একেবারে শুরুতে ফিরিয়ে নিয়ে যায়। এটি তখন কার্যকর হয় যখন ক্রোনেট চায় যে আপলোড ডেটা প্রোভাইডারটি এমন একটি সমতুল্য অবস্থায় থাকুক, যেন read এখনও কল করা হয়নি।

অপারেশনটি যে শেষ হয়েছে তা বোঝানোর জন্য, এই ফাংশনের ইমপ্লিমেন্টেশনগুলোকে সফলতার জন্য onRewindSucceeded , অথবা ব্যর্থতার ক্ষেত্রে onRewindError কল করতে হবে। এমনকি সংশ্লিষ্ট UrlRequest বাতিল করা হলেও, রিসোর্সগুলো নিরাপদে মুক্ত করার আগে দুটির মধ্যে একটি অবশ্যই কল করতে হবে। মেথড থেকে একটি এক্সেপশন থ্রো করা onRewindError কল করার সমতুল্য। যদি রিওয়াইন্ডিং সমর্থিত না হয় (উদাহরণস্বরূপ, যদি কোনো ওয়ান-অফ স্ট্রিম থেকে রিড করা হয়), তবে এটি অবিলম্বে onRewindError কল করবে।

বাস্তবায়নকারী নিরাপদে ধরে নিতে পারেন যে, পূর্ববর্তী অনুচ্ছেদে বর্ণিত পদ্ধতি অনুযায়ী, রিওয়াইন্ডিং শেষ হওয়ার বিষয়ে সিঙ্ককে অবহিত না করা পর্যন্ত কোনো read বা যুগপৎ rewind কল জারি করা হবে না।

বডি একাধিকবার আপলোড করার প্রয়োজন হলে ক্রোনেট অভ্যন্তরীণভাবে এই পদ্ধতিটি ব্যবহার করে। এটি বিভিন্ন পরিস্থিতিতে ঘটতে পারে, যেমন রিডাইরেক্ট অনুসরণ করার সময়, অথবা টাইমআউট বা নেটওয়ার্ক সংযোগ বিচ্ছিন্ন হওয়ার পর অনুরোধ পুনরায় চেষ্টা করার সময়। উল্লেখ্য যে, যদিও রিওয়াইন্ডিং প্রয়োগ করা সাধারণত ঐচ্ছিক, কিন্তু যে অনুরোধগুলির জন্য এটির প্রয়োজন হয়, সেগুলি রিওয়াইন্ডিং প্রয়োগ করা না হলে ব্যর্থ হবে।

প্যারামিটার
UploadDataSink uploadDataSink	রিওয়াইন্ড অপারেশনটি সফলভাবে বা অন্যথায় সম্পন্ন হলে তা জানানোর উদ্দেশ্য।

নিক্ষেপ
java.io.IOException	প্রক্রিয়া চলাকালীন কোনো IOException ঘটলে, onFailed কল করা হবে এবং থ্রো করা এক্সেপশনটিকে CallbackException এর কারণ হিসেবে সেট করা হবে।