HIDL ইন্টারফেস ফাইল দেওয়া হলে, Java HIDL ব্যাকএন্ড Java ইন্টারফেস,
স্টাব ও প্রক্সি কোড তৈরি করে। এটি সব স্কেলার HIDL টাইপ
([u]int{8,16,32,64}_t, float, double, এবং
enums), সেইসাথে স্ট্রিং, ইন্টারফেস, safe_union টাইপ, স্ট্রাক্ট
টাইপ এবং কাজ করে এমন HIDL টাইপের অ্যারে ও ভেক্টর সাপোর্ট করে। Java HIDL ব্যাকএন্ড
ইউনিয়ন টাইপ বা fmq টাইপ সাপোর্ট করে না। Android
11, memory এবং
handle ধরনের জন্য সহায়তা যোগ করে।
যেহেতু Java রানটাইম নেটিভভাবে আনসাইনড পূর্ণসংখ্যা ধারণাকে সমর্থন করে না,
তাই সমস্ত আনসাইনড ধরন (এবং সেগুলির উপর ভিত্তি করে তৈরি এনুম) নীরবে সেগুলির
সাইনড সমতুল্য হিসেবে বিবেচিত হয়, অর্থাৎ uint32_t, Java ইন্টারফেসে int হয়ে যায়। কোনও ভ্যালু কনভার্সন করা হয় না; Java-এর দিকে ইমপ্লিমেন্টরকে
সাইন করা ভ্যালুগুলিকে এমনভাবে ব্যবহার করতে হবে যেন সেগুলি সাইন করা নেই।
Enums
এনাম থেকে Java এনাম ক্লাস তৈরি হয় না, পরিবর্তে এগুলিকে ইন্টার্নাল ক্লাসে ট্রান্সলেট করা হয়, যার মধ্যে প্রতিটি এনাম কেসের জন্য স্ট্যাটিক কনস্ট্যান্ট ডেফিনিশন থাকে। enum class অন্য কোনও enum class থেকে ডিরাইভ করা হলে, সেটি সেই ক্লাসের স্টোরেজ টাইপ ইনহেরিট করে। আনসাইনড পূর্ণসংখ্যার ধরনের উপর ভিত্তি করে গণনা করা মানগুলিকে তাদের সাইনড সমতুল্যে আবার লেখা হয়। যেহেতু অন্তর্নিহিত ধরনটি হল একটি আদিম ধরন, তাই কোনও শূন্য এনুমারেটর না থাকলেও এনাম ফিল্ড/ভেরিয়েবলের ডিফল্ট ভ্যালু শূন্য হয়।
যেমন, SomeBaseEnum যার ধরন হল
uint8_t:
enum SomeBaseEnum : uint8_t { foo = 3 }; enum SomeEnum : SomeBaseEnum { quux = 33, goober = 127 };
… হয়ে যায়:
public final class SomeBaseEnum { public static final byte foo = 3; } public final class SomeEnum { public static final byte foo = 3; public static final byte quux = 33; public static final byte goober = 127; }
এবং:
enum SomeEnum : uint8_t { FIRST_CASE = 10, SECOND_CASE = 192 };
…-এর পরিবর্তে এটি লেখা হয়েছে:
public final class SomeEnum { static public final byte FIRST_CASE = 10; // no change static public final byte SECOND_CASE = -64; }
স্ট্রিং
Java-তে String হল utf-8 বা utf-16, কিন্তু ট্রান্সপোর্ট করার সময় সাধারণ HIDL টাইপ হিসেবে utf-8
এ কনভার্ট করা হয়। এছাড়াও, HIDL-এ পাস করার সময় String
নাল হলে চলবে না।
হ্যান্ডেল ও মেমরি
Android 11-এ handle এবং
memory ধরনের জন্য Java কাজ করে। এগুলি যথাক্রমে android.os.NativeHandle এবং
android.os.HidlMemory ভাষায় অনুবাদ করা হয়েছে। নাল হ্যান্ডেলকে সঠিক হিসেবে বিবেচনা করা হয়, তবে নাল
মেমরিকে নয়।
জেনারেট করা সার্ভার কোডে, প্রাপ্ত মেমরি ও হ্যান্ডেল আর্গুমেন্ট শুধুমাত্র
মেথড ইনভোকেশনের স্কোপের মধ্যে বৈধ। সার্ভার ইমপ্লিমেন্টেশন তার
লাইফটাইম বাড়াতে চাইলে, সংশ্লিষ্ট dup() পদ্ধতি ব্যবহার করে ডুপ্লিকেট করতে হবে। ফিরে আসা ইনস্ট্যান্সটি পদ্ধতি ইনভোকেশনের পরেও ব্যবহার করা যেতে পারে এবং ব্যবহার করা হয়ে গেলে সেটি সঠিকভাবে বন্ধ করে
দিতে হবে।
জেনারেট করা ক্লায়েন্ট কোডে, কল করা পদ্ধতির ইনপুট আর্গুমেন্ট হিসেবে পাঠানো হ্যান্ডেল ও মেমরি ইনস্ট্যান্সের ডুপ্লিকেট তৈরি করার প্রয়োজন নেই এবং পদ্ধতি রিটার্ন করার পরেও সেগুলিকে ভ্যালিড রাখার প্রয়োজন নেই। তবে, আউটপুট আর্গুমেন্ট হিসেবে প্রাপ্ত হ্যান্ডেল ও মেমরি ইনস্ট্যান্সগুলি অটোজেনারেটেড কোড অটোমেটিক ডুপ্লিকেট করে এবং কাজ হয়ে গেলে সেগুলি সঠিকভাবে বন্ধ করতে হবে। এটি সত্য যে সেইসব রিটার্ন আর্গুমেন্ট পদ্ধতির রিটার্ন ভ্যালু (সিঙ্গেল রিটার্ন ভ্যালুর ক্ষেত্রে) হিসেবে দেখানো হোক বা সিনক্রোনাস কলব্যাক স্টাইল (একাধিক রিটার্ন ভ্যালুর ক্ষেত্রে ব্যবহৃত) ব্যবহার করে দেখানো হোক না কেন।
ডুপ্লিকেশন ও বন্ধ করা সম্পর্কে আরও তথ্যের জন্য, Java ক্লাসের ডকুমেন্টেশন দেখুন।
অ্যারে ও ভেক্টর
অ্যারেগুলিকে Java অ্যারেতে এবং ভেক্টরগুলিকে
ArrayList<T>-এ ট্রান্সলেট করা হয়, যেখানে T হল উপযুক্ত অবজেক্টের ধরন, সম্ভবত
vec<int32_t> =>
ArrayList<Integer>-এর মতো স্কেলার ধরনকে র্যাপ করা হয়। যেমন:
takeAnArray(int32_t[3] array); returnAVector() generates (vec<int32_t> result);
… হয়ে যায়:
void takeAnArray(int[] array); ArrayList<Integer> returnAVector();
স্ট্রাকচার
একই ধরনের লেআউট সহ স্ট্রাকচারগুলিকে Java ক্লাসে অনুবাদ করা হয়। যেমন:
struct Bar { vec<bool> someBools; }; struct Foo { int32_t a; int8_t b; float[10] c; Bar d; };
… হয়ে যায়:
class Bar { public final ArrayList<Boolean> someBools = new ArrayList(); }; class Foo { public int a; public byte b; public final float[] c = new float[10]; public final Bar d = new Bar(); }
ঘোষিত ধরন
types.hal-এ ঘোষণা করা প্রতিটি টপ-লেভেল টাইপের নিজস্ব .java
আউটপুট ফাইল থাকে (Java-এর প্রয়োজন অনুযায়ী)। যেমন, নিম্নলিখিত
types.hal ফাইলের ফলে দুটি অতিরিক্ত ফাইল তৈরি হয় (Foo.java
এবং Bar.java):
struct Foo { ... }; struct Bar { ... struct Baz { }; ... };
Baz-এর সংজ্ঞা Bar-এর স্ট্যাটিক ইন্টার্নাল ক্লাসে (Bar.java-এ) থাকে।