Java Academy · Pelajaran

Kad Liar dalam API

Reka bentuk kaedah generik yang fleksibel

Pelajaran 4 daripada 413 langkah

Kad Liar dalam API ialah pelajaran Java Academy percuma di CoddyKit. Ini ialah pelajaran 4 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Java Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Java Academy merangkumi sejumlah 4 pelajaran.

Mereka Bentuk Kaedah Fleksibel

Kad bebas terutamanya ialah alat untuk pereka API. Kad bebas yang diletakkan dengan baik membolehkan pemanggil menghantar lebih banyak jenis tanpa penukaran jenis secara paksa.

Matlamatnya ialah fleksibiliti maksimum untuk pemanggil dan keselamatan jenis sepenuhnya di dalam kaedah.

import java.util.List;

public class Main {
    static double total(List<? extends Number> items) {
        double sum = 0;
        for (Number n : items) sum += n.doubleValue();
        return sum;
    }
    public static void main(String[] args) {
        System.out.println(total(List.of(1, 2, 3)));
        System.out.println(total(List.of(1.5, 2.5)));
    }
}

Kad Bebas Tanpa Sempadan

List<?> ialah kad bebas tanpa sempadan: senarai bagi suatu jenis yang tidak diketahui.

Gunakannya apabila kaedah anda tidak mengambil berat tentang jenis elemen, contohnya untuk mengira elemen atau memeriksa kekosongan.

import java.util.List;

public class Main {
    static int size(List<?> any) {
        return any.size();
    }
    public static void main(String[] args) {
        System.out.println(size(List.of("a", "b")));
        System.out.println(size(List.of(1, 2, 3)));
    }
}

List<?> berbanding List<Object>

Kedua-duanya berbeza. List<Object> hanya menerima senarai yang diisytiharkan sebagai Object. List<?> menerima senarai bagi apa-apa jenis.

Anda boleh menghantar List<String> kepada parameter List<?>, tetapi bukan kepada parameter List<Object>.

import java.util.List;

public class Main {
    static void printAll(List<?> list) {
        for (Object o : list) System.out.println(o);
    }
    public static void main(String[] args) {
        List<String> names = List.of("Ada", "Linus");
        printAll(names); // works; List<Object> would reject this
    }
}

Bila Parameter Jenis Lebih Jelas

Jika anda perlu merujuk jenis elemen lebih daripada sekali, parameter jenis bernama lebih mudah dibaca berbanding kad bebas.

Bandingkan void swap(List<?> l, int i, int j) (yang memerlukan pembantu peribadi) dengan versi generik yang kemas.

import java.util.ArrayList;
import java.util.List;

public class Main {
    static <T> void swap(List<T> list, int i, int j) {
        T tmp = list.get(i);
        list.set(i, list.get(j));
        list.set(j, tmp);
    }
    public static void main(String[] args) {
        List<String> list = new ArrayList<>(List.of("a", "b", "c"));
        swap(list, 0, 2);
        System.out.println(list);
    }
}

Helah Menangkap Kad Bebas dengan Pembantu

Jika API awam mesti menggunakan List<?>, anda boleh menyerahkannya kepada pembantu generik peribadi untuk menangkap kad bebas itu.

Pembantu tersebut menamakan jenis itu sebagai T supaya ia boleh menulis semula ke dalam senarai.

import java.util.ArrayList;
import java.util.List;

public class Main {
    public static void reverse(List<?> list) { reverseHelper(list); }
    private static <T> void reverseHelper(List<T> list) {
        for (int i = 0, j = list.size() - 1; i < j; i++, j--) {
            T tmp = list.get(i);
            list.set(i, list.get(j));
            list.set(j, tmp);
        }
    }
    public static void main(String[] args) {
        List<Integer> list = new ArrayList<>(List.of(1, 2, 3, 4));
        reverse(list);
        System.out.println(list);
    }
}

Parameter Pengeluar dalam API Sebenar

Mereka bentuk addAll yang mengambil daripada mana-mana sumber serasi menggunakan sempadan atas pada sumber.

import java.util.ArrayList;
import java.util.Collection;
import java.util.List;

public class Main {
    static <T> void addAll(List<T> target, Collection<? extends T> source) {
        for (T t : source) target.add(t);
    }
    public static void main(String[] args) {
        List<Number> nums = new ArrayList<>();
        addAll(nums, List.of(1, 2, 3));
        System.out.println(nums);
    }
}

Parameter Pengguna dalam API Sebenar

API saluran penerima yang menulis hasil menggunakan sempadan bawah pada destinasi supaya pemanggil boleh membekalkan bekas yang lebih luas.

import java.util.ArrayList;
import java.util.List;

public class Main {
    static <T> void repeat(T value, int times, List<? super T> sink) {
        for (int i = 0; i < times; i++) sink.add(value);
    }
    public static void main(String[] args) {
        List<Object> out = new ArrayList<>();
        repeat("hi", 3, out);
        System.out.println(out);
    }
}

Kad Bebas dengan Generik Bersarang

Generik bersarang sering memerlukan kad bebas. Kaedah yang menerima senarai bagi apa-apa jenis senarai menggunakan List<? extends List<?>>.

import java.util.List;

public class Main {
    static int countAll(List<? extends List<?>> lists) {
        int total = 0;
        for (List<?> inner : lists) total += inner.size();
        return total;
    }
    public static void main(String[] args) {
        System.out.println(countAll(List.of(List.of(1, 2), List.of("a", "b", "c"))));
    }
}

Mengelakkan Penggunaan Generik Berlebihan

Tidak semua kaedah memerlukan kad bebas. Jika pemanggil hanya akan menghantar satu jenis, parameter biasa lebih jelas.

Tambahkan kad bebas apabila anda mendapati pemanggil sebenar tersekat akibat keinvarian, bukan sebagai langkah awal.

import java.util.List;

public class Main {
    // Simple and clear; no wildcard needed for this internal use
    static String joinStrings(List<String> parts) {
        return String.join(", ", parts);
    }
    public static void main(String[] args) {
        System.out.println(joinStrings(List.of("a", "b", "c")));
    }
}

Mendokumentasikan Tujuan Kad Bebas

Kad bebas menyampaikan tujuan. ? extends T memberitahu pembaca "Saya hanya membaca ini". ? super T pula menyatakan "Saya hanya menulis ini".

Memilih kad bebas yang betul ialah satu bentuk kod yang mendokumentasikan dirinya sendiri dan pada masa yang sama menguatkuasakan kontrak.

import java.util.ArrayList;
import java.util.List;

public class Main {
    // src: read-only producer; dest: write-only consumer
    static <T> void transfer(List<? extends T> src, List<? super T> dest) {
        for (T t : src) dest.add(t);
    }
    public static void main(String[] args) {
        List<Number> dest = new ArrayList<>();
        transfer(List.of(1, 2), dest);
        System.out.println(dest);
    }
}

API Timbunan Generik

Contoh timbunan terkenal Bloch: pushAll menggunakan nilai daripada pengeluar (extends), manakala popAll menghasilkan nilai ke dalam pengguna (super).

import java.util.ArrayDeque;
import java.util.Collection;
import java.util.Deque;
import java.util.ArrayList;
import java.util.List;

public class Main {
    static class Stack<E> {
        private final Deque<E> items = new ArrayDeque<>();
        void pushAll(Collection<? extends E> src) { for (E e : src) items.push(e); }
        void popAll(Collection<? super E> dst) { while (!items.isEmpty()) dst.add(items.pop()); }
    }
    public static void main(String[] args) {
        Stack<Integer> s = new Stack<>();
        s.pushAll(List.of(1, 2, 3));
        List<Number> out = new ArrayList<>();
        s.popAll(out);
        System.out.println(out);
    }
}

Semakan Pantas

Uji naluri anda dalam mereka bentuk API.

Jawab dalam pelajaran interaktif

Rumusan

Anda telah mempelajari cara mereka bentuk API dengan kad bebas:

List<?> untuk kaedah baca sahaja yang tidak bergantung pada jenis.
Gunakan PECS pada parameter untuk mendapatkan fleksibiliti.
Gunakan helah menangkap kad bebas dengan pembantu peribadi apabila anda mesti menulis melalui kad bebas.
Elakkan kad bebas dalam jenis pulangan dan jangan gunakan generik secara berlebihan.

Anda telah menamatkan kursus kad bebas dan PECS.

public class Main {
    public static void main(String[] args) {
        System.out.println("Wildcards in APIs course complete");
    }
}

Percuma untuk bermula

Pelajari Java dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 104
Pelajaran: 374

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Kad Liar dalam API” percuma?

Ya — teks penuh “Kad Liar dalam API” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus Java Academy, tingkat taraf kepada CoddyKit PRO. Kursus Java Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Kad Liar dalam API”?

Reka bentuk kaedah generik yang fleksibel Anda berlatih Java Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Java Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Java Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 4 daripada 4.

Berapa lamakah pelajaran “Kad Liar dalam API” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Java Academy ini?

Ya. Setiap pelajaran Java Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

← Kembali ke Java Academy