APIs and Libraries · APIs et Bibliothèques
| English | Français |
|---|---|
| library/ˈlaɪbrəri/ | bibliothèque |
| API/ˌeɪ piː ˈaɪ/ | API |
Standing on others' code
- You don't write everything from scratch — Java ships with huge amounts of ready-made code.
- A library 库 is a collection of pre-written classes you can use.
- Java's standard library includes
String,Math,Scanner,ArrayList, and thousands more. - Reusing tested library code is faster and safer than reinventing it.
S'appuyer sur le code des autres
- Vous ne tout écrivez pas de zéro — Java livre énormément de code prêt à l'emploi.
- Une bibliothèque 库 est un ensemble de classes pré-écrites que vous pouvez utiliser.
- La bibliothèque standard de Java inclut
String,Math,Scanner,ArrayList, et des milliers d'autres. - Réutiliser du code testé de bibliothèque est plus rapide et sûr que tout réinventer.
What an API tells you
- An API (Application Program Interface) 应用程序接口 is the documented list of what a class offers.
- It tells you each method's name, what parameters it takes, and what it returns.
- You program to the API — you use a method by its documented behavior, not its inner code.
- The API is a contract: "give me these inputs, I'll give you this output."
Ce qu'une API vous dit
- Une API (Application Program Interface) 应用程序接口 est la liste documentée de ce qu'une classe offre.
- Elle vous indique le nom de chaque méthode, quels paramètres elle prend, et ce qu'elle retourne.
- Vous programmez selon l'API — vous utilisez une méthode selon son comportement documenté, pas son code interne.
- L'API est un contrat : "donnez-moi ces entrées, je vous donnerai cette sortie."
Importing a class
- Some classes need an
importstatement before you use them. import java.util.Scanner;makesScanneravailable.- Core classes like
StringandMathare injava.lang— imported automatically. - The import goes at the top of the file, above the class.
Importer une classe
- Certaines classes nécessitent une instruction
importavant de les utiliser. import java.util.Scanner;rendScannerdisponible.- Les classes centrales comme
StringetMathsont dansjava.lang— importées automatiquement. - L'import va en haut du fichier, au-dessus de la classe.
Use it without seeing inside
- You can call
Math.sqrt(x)without knowing how it computes a square root. - This is abstraction: the API hides the implementation behind a simple interface.
- You only need the what (the documented behavior), not the how.
- Good libraries let you build fast by treating complex code as a black box.
L'utiliser sans voir l'intérieur
- Vous pouvez appeler
Math.sqrt(x)sans savoir comment il calcule une racine carrée. - C'est l'abstraction : l'API cache l'implémentation derrière une interface simple.
- Vous avez seulement besoin du quoi (le comportement documenté), pas du comment.
- De bonnes bibliothèques permettent de construire vite en traitant le code complexe comme une boîte noire.
Use a library, or write it yourself? · Utiliser une bibliothèque, ou l'écrire soi-même ?
Sort each task by whether a standard library already does it. · Trier chaque tâche selon si une bibliothèque standard la réalise déjà.
You program to the API's documented behavior, not its internal code. Read what a method takes and returns — you don't need (or want) to see how it works inside. Remember most classes need an import, but java.lang classes (String, Math, System, Integer) are imported automatically, so Scanner needs import java.util.Scanner; while Math does not.
Vous programmez selon le comportement documenté de l'API, pas son code interne. Lisez ce qu'une méthode prend et retourne — vous n'avez pas besoin (ni ne voulez) voir comment elle fonctionne à l'intérieur. Rappelez-vous que la plupart des classes nécessitent un import, mais les classes java.lang (String, Math, System, Integer) sont importées automatiquement, donc Scanner a besoin de import java.util.Scanner; tandis que Math non.
Using the Math library:
- No import needed —
Mathis injava.lang. double r = Math.sqrt(16);→ris4.0, and you never see the algorithm.- The API just promised: "give me a number, I return its square root."
Utilisation de la bibliothèque Math :
- Pas d'import nécessaire —
Mathest dansjava.lang. double r = Math.sqrt(16);→rest4.0, et vous ne voyez jamais l'algorithme.- L'API a juste promis : "donnez-moi un nombre, je retourne sa racine carrée."
A library is reusable pre-written code; the API documents each class's methods — their names, parameters, and return values — so you program to the documented behavior. Most classes need an import (e.g. Scanner), but java.lang classes (String, Math) are imported automatically. The API is abstraction: use it without seeing inside.
Une bibliothèque est du code pré-écrit réutilisable ; l'API documente les méthodes de chaque classe — leurs noms, paramètres et valeurs de retour — pour que vous programriez selon le comportement documenté. La plupart des classes nécessitent un import (ex. Scanner), mais les classes java.lang (String, Math) sont importées automatiquement. L'API est une abstraction : utilisez-la sans voir l'intérieur.
An API documents a class's methods by telling you their... · Une API documente les méthodes d'une classe en indiquant leurs...
You program to the documented name/params/return, not the inner code. · Vous programmez selon le nom/paramètres/retour documenté, pas le code interne.
Which class needs an import statement before use? · Quelle classe nécessite une instruction import avant utilisation ?
java.lang classes import automatically; Scanner (java.util) needs an import. · Les classes java.lang sont importées automatiquement ; Scanner (java.util) en a besoin.
You must read a library method's internal code before you can use it. · Vous devez lire le code interne d'une méthode de bibliothèque avant de pouvoir l'utiliser.
You use it by its documented behavior — that's abstraction. · Vous l'utilisez par son comportement documenté — c'est l'abstraction.
A collection of pre-written, reusable classes is called a ___ (one word). · Un ensemble de classes pré-écrites et réutilisables s'appelle un ___ (un seul mot).
A library bundles reusable code. · Une bibliothèque regroupe du code réutilisable.
Math and String are imported automatically because they are in java.lang. · Math et String sont importés automatiquement car ils sont dans java.lang.
java.lang is imported by default in every Java program. · java.lang est importé par défaut dans chaque programme Java.