API dan Pustaka

Kosa kata

English	Makna
library/ˈlaɪbrəri/	pustaka
API/ˌeɪ piː ˈaɪ/	API

Berdiri di atas kode orang lain

Anda tidak menulis segalanya dari nol — Java dilengkapi dengan banyak kode siap pakai.
Library adalah kumpulan kelas pra-tulis yang dapat Anda gunakan.
Standard library Java mencakup String, Math, Scanner, ArrayList, dan ribuan lainnya.
Menggunakan ulang kode library yang teruji lebih cepat dan aman daripada membuat ulang.

Apa yang dikatakan API

API (Application Program Interface) adalah daftar terdokumentasi apa yang ditawarkan sebuah kelas.
Ia memberi tahu Anda nama setiap metode, parameter apa yang diambilnya, dan apa yang dikembalikan.
Anda memprogram kepada API — Anda menggunakan metode berdasarkan perilakunya yang didokumentasikan, bukan kodenya.
API adalah kontrak: "berikan saya input ini, saya akan berikan output ini."

Mengimpor sebuah kelas

Beberapa kelas memerlukan pernyataan import sebelum digunakan.
import java.util.Scanner; membuat Scanner tersedia.
Kelas inti seperti String dan Math berada di java.lang — diimpor otomatis.
Impor diletakkan di bagian atas file, di atas kelas.

Gunakan tanpa melihat ke dalam

Anda dapat memanggil Math.sqrt(x) tanpa mengetahui bagaimana ia menghitung akar kuadrat.
Ini adalah abstraksi: API menyembunyikan implementasi di balik antarmuka sederhana.
Anda hanya perlu apa (perilaku terdokumentasi), bukan bagaimana.
Library yang baik memungkinkan Anda membangun cepat dengan menganggap kode kompleks sebagai kotak hitam.

Jelajahi

Menggunakan pustaka, atau menulis sendiri?

Urutkan setiap tugas berdasarkan apakah pustaka standar sudah melakukannya.

Watch out

Anda memprogram terhadap perilaku terdokumentasi API, bukan kodenya. Baca apa yang diambil dan dikembalikan oleh suatu metode — Anda tidak perlu (atau ingin) melihat bagaimana cara kerjanya di dalam. Ingat bahwa sebagian besar kelas memerlukan import, tetapi kelas java.lang (String, Math, System, Integer) diimpor otomatis, jadi Scanner membutuhkan import java.util.Scanner; sementara Math tidak.

Example

Menggunakan perpustakaan Math:

Tidak perlu impor — Math ada di java.lang.
double r = Math.sqrt(16); → r adalah 4.0, dan Anda tidak pernah melihat algoritmanya.
API hanya menjanjikan: "berikan saya angka, saya kembalikan akar kuadratnya."

Key idea

Sebuah library adalah kode pra-tulis yang dapat digunakan kembali; API mendokumentasikan setiap metode kelas — nama, parameter, dan nilai kembalinya — agar Anda memprogram kepada perilaku terdokumentasi. Sebagian besar kelas memerlukan import (mis. Scanner), tetapi kelas java.lang (String, Math) diimpor otomatis. API adalah abstraksi: gunakan tanpa melihat ke dalam.

Latihan

Sebuah API mendokumentasikan metode kelas dengan memberitahu Anda tentang...