Par Valentin Brosseau / @c4software
Côté Android, pour écrire des applications.
Question : et le serveur que l'application interroge, en quoi est-il écrit ?
Une API qui gère les capteurs d'un bâtiment (température, humidité, CO2…).
GET /v1/capteursAujourd'hui : une seule route, mais toute la structure du projet.
{
"id": 1,
"name": "Salle serveur",
"type": "temperature",
"unit": "°C",
"active": true
}De la donnée, pas de l'affichage.
Une route, une requête SQL…
Tout écrire dans un seul fichier, ce serait plus simple, non ?
Mais pour cinquante ?
Route HTTP : la requête, la réponse en JSON
Service Les règles métier
DAO Les requêtes vers la base
Table La description de la table en KotlinChaque couche ne parle qu'à celle du dessous.
PostgreSQL, lancé dans Docker : rien à installer sur le poste.
docker compose up -d --waitAvec Adminer pour regarder ce qu'elle contient.
Vous créez la table à la main dans Adminer.
Comment vos collègues, ou le serveur de production, obtiennent-ils la même ?
Des scripts SQL numérotés, rangés dans le projet.
db/migration/
├── V1__create_capteur.sql
└── V2__create_salle.sqlAu démarrage, Flyway applique ceux qui manquent, dans l'ordre.
Une migration déjà appliquée ne se modifie jamais.
Pour corriger ou faire évoluer la base : une nouvelle migration.
object SensorTable : Table("capteur") {
val id = integer("id").autoIncrement()
val name = varchar("nom", 100)
}La table décrite en Kotlin : le code en anglais, la base en français.
SensorTable.selectAll().orderBy(SensorTable.id)SELECT * FROM capteur ORDER BY idUne faute de frappe devient une erreur de compilation.
class SensorService(private val sensorDao: SensorDao) {
fun getAll(): List<Sensor> = sensorDao.findAll()
}Il reçoit son DAO, il ne le crée pas.
Mais alors, qui crée le DAO et le donne au service ?
val sensorModule = module {
singleOf(::ExposedSensorDao) bind SensorDao::class
singleOf(::SensorService)
}Koin crée les objets et les fournit là où on en a besoin.
route("/capteurs") {
get {
call.respond(sensorService.getAll())
}
}Pas de SQL ici : la route appelle le service, la liste part en JSON.
GET /v1/capteurs
→ Route → Service → DAO → PostgreSQL
← JSON ← List<Sensor> ← lignesPlace au TP 🚀