الخادم الوكيل لواجهات برمجة التطبيقات الجديدة

يوضِّح لك هذا الدرس كيفية تقسيم الفئتَين المجرّدة CompatTab وTabHelper إلى فئتَين فرعيتَين واستخدام واجهات برمجة تطبيقات جديدة. يمكن لتطبيقك استخدام عملية التنفيذ هذه على الأجهزة التي تعمل بإصدار نظام أساسي يتوافق معها.

تنفيذ علامات التبويب باستخدام واجهات برمجة التطبيقات الجديدة

إنّ الفئات الملموسة لنظامي التشغيل CompatTab وTabHelper واللذين يستخدمان واجهات برمجة تطبيقات أحدث هما تنفيذ خادم وكيل. نظرًا لأن الفئات المجرّدة المحددة في الدرس السابق تعكس واجهات برمجة التطبيقات الجديدة (بنية الفئة وتوقيعات الطرق وما إلى ذلك)، فإن الفئات الملموسة التي تستخدم واجهات برمجة التطبيقات الجديدة هذه هي ببساطة استدعاءات طريقة الوكيل ونتائجها.

يمكنك مباشرةً استخدام واجهات برمجة تطبيقات أحدث في هذه الفئات الملموسة، وعدم التعطُّل على الأجهزة السابقة، بسبب التحميل الكسول للصفوف. يتم تحميل الفئات وإعدادها عند الوصول الأول، أي إثبات الفئة أو الوصول إلى أحد حقولها أو طرقها الثابتة لأول مرة. وبالتالي، ما دمت لا تنشئ مثيلاً لعمليات التنفيذ الخاصة بـ Honeycomb على الأجهزة التي تعمل بالإصدارات السابقة من Honeycomb، لن يحصل جهاز Dalvik VM على أي استثناءات من VerifyError.

يتمثل أحد اصطلاحات التسمية الجيدة لهذا التنفيذ في إلحاق اسم مستوى واجهة برمجة التطبيقات أو اسم رمز إصدار النظام الأساسي المقابل لواجهات برمجة التطبيقات التي تطلبها الفئات المحددة. على سبيل المثال، يمكن توفير إمكانية تنفيذ علامة التبويب الأصلية من خلال الصفَّين CompatTabHoneycomb وTabHelperHoneycomb، وذلك لأنّهما يعتمدان على واجهات برمجة التطبيقات المتوفّرة في الإصدار Android 3.0 (المستوى 11 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.

الشكل 1. رسم بياني لفئة تنفيذ علامات التبويب في Honeycomb

تنفيذ CompatTabHoneycomb

CompatTabHoneycomb هو تطبيق لفئة CompatTab المجرّدة التي يستخدمها TabHelperHoneycomb للإشارة إلى علامات تبويب فردية. يعمل CompatTabHoneycomb ببساطة على إنشاء وكيل لجميع استدعاءات الطرق إلى كائن ActionBar.Tab المتضمّن.

بدء تنفيذ CompatTabHoneycomb باستخدام واجهات برمجة التطبيقات ActionBar.Tab الجديدة:

Kotlin

class CompatTabHoneycomb internal constructor(val activity: Activity, tag: String) :
        CompatTab(tag) {
    ...
    // The native tab object that this CompatTab acts as a proxy for.
    private var mTab: ActionBar.Tab =
            // Proxy to new ActionBar.newTab API
            activity.actionBar.newTab()

    override fun setText(@StringRes textId: Int): CompatTab {
        // Proxy to new ActionBar.Tab.setText API
        mTab.setText(textId)
        return this
    }

    ...
    // Do the same for other properties (icon, callback, etc.)
}

Java

public class CompatTabHoneycomb extends CompatTab {
    // The native tab object that this CompatTab acts as a proxy for.
    ActionBar.Tab mTab;
    ...

    protected CompatTabHoneycomb(FragmentActivity activity, String tag) {
        ...
        // Proxy to new ActionBar.newTab API
        mTab = activity.getActionBar().newTab();
    }

    public CompatTab setText(int resId) {
        // Proxy to new ActionBar.Tab.setText API
        mTab.setText(resId);
        return this;
    }

    ...
    // Do the same for other properties (icon, callback, etc.)
}

تنفيذ TabHelperHoneycomb

TabHelperHoneycomb هي تنفيذ الفئة المجرّدة TabHelper التي تمثِّل استدعاءات طريقة الخوادم الوكيلة لـ ActionBar فعلية، والتي تم الحصول عليها من Activity المضمّنة.

تنفيذ TabHelperHoneycomb، إنشاء خوادم وكيلة لاستدعاءات واجهة برمجة التطبيقات ActionBar:

Kotlin

class TabHelperHoneycomb internal constructor(activity: FragmentActivity) : TabHelper(activity) {

    private var mActionBar: ActionBar? = null

    override fun setUp() {
        mActionBar = mActionBar ?: mActivity.actionBar.apply {
            navigationMode = ActionBar.NAVIGATION_MODE_TABS
        }
    }

    override fun addTab(tab: CompatTab) {
        // Tab is a CompatTabHoneycomb instance, so its
        // native tab object is an ActionBar.Tab.
        mActionBar?.addTab(tab.getTab() as ActionBar.Tab)
    }
}

Java

public class TabHelperHoneycomb extends TabHelper {
    ActionBar actionBar;
    ...

    protected void setUp() {
        if (actionBar == null) {
            actionBar = activity.getActionBar();
            actionBar.setNavigationMode(
                    ActionBar.NAVIGATION_MODE_TABS);
        }
    }

    public void addTab(CompatTab tab) {
        ...
        // Tab is a CompatTabHoneycomb instance, so its
        // native tab object is an ActionBar.Tab.
        actionBar.addTab((ActionBar.Tab) tab.getTab());
    }

    // The other important method, newTab() is part of
    // the base implementation.
}

يجب عليك أيضًا قراءة

• شريط الإجراءات
• علامات تبويب شريط الإجراءات