API en Java: REST, GraphQL, gRPC — ¿qué elegir en 2025?

Introducción: evolución de las API en Java

El mundo del desarrollo Java no se detiene. Hace solo 10 años, la elección era obvia: REST y JSON. Hoy en día, al diseñar una arquitectura de microservicios o una aplicación móvil, el desarrollador se enfrenta a todo un zoológico de protocolos. REST, GraphQL, gRPC — cada uno promete el paraíso, pero en realidad detrás de cada tecnología hay compromisos.

En este artículo no vamos a repetir la documentación. Tomaremos un problema real: necesitamos crear una API para una plataforma educativa (como nuestro PythonLib, pero en Java). Tenemos cursos, estudiantes y progreso de aprendizaje. E intentaremos implementar el mismo endpoint de tres maneras diferentes.

Vamos a descubrir qué protocolo hará tu código más rápido y tu vida más fácil.

API REST en Java: un clásico que nunca muere

REST (Representational State Transfer) es un estilo arquitectónico, no un protocolo. En Java, el estándar de facto para REST es Spring Boot con sus anotaciones. Simplicidad, claridad, una comunidad enorme — eso es lo que amamos de REST.

Ejemplo: obtener lista de cursos

Supongamos que necesitamos devolver al cliente una lista de todos los cursos con información básica:

@RestController\n@RequestMapping("/api/courses")\npublic class CourseController {\n\n    @GetMapping\n    public ResponseEntity<List<CourseDTO>> getAllCourses() {\n        List<Course> courses = courseService.findAll();\n        List<CourseDTO> dtos = courses.stream()\n                .map(c -> new CourseDTO(c.getId(), c.getTitle(), c.getAuthor()))\n                .toList();\n        return ResponseEntity.ok(dtos);\n    }\n}

El cliente recibe JSON:

[\n  {"id": 1, "title": "Java para principiantes", "author": "Iván Petrov"},\n  {"id": 2, "title": "Spring Boot Masterclass", "author": "Ana Smirnova"}\n]

Ventajas de REST en Java:

\n
• Barrera de entrada mínima: cualquier desarrollador Java conoce Spring.
\n
• Almacenamiento en caché mediante cabeceras HTTP (ETag, Cache-Control).
\n
• Amplio soporte de herramientas (Postman, Swagger, OpenAPI).
\n

Desventajas:

\n
• Problema de over-fetching (datos innecesarios) y under-fetching (datos insuficientes, necesidad de múltiples solicitudes).
\n
• Tipado débil: todo depende del contrato, que es fácil de romper.
\n

REST es ideal para API públicas, cuando los clientes son terceros y necesitas la máxima compatibilidad. Pero si tu cliente es una aplicación móvil que quiere recibir exactamente lo que necesita, REST empieza a ser molesto.

GraphQL en Java: dame solo lo que pido

GraphQL es un lenguaje de consultas creado por Facebook. En Java, se implementa más a menudo mediante la biblioteca graphql-java o la integración con Spring — GraphQL Kickstart.

El cliente decide qué campos necesita. Sin over-fetching. Una sola consulta y obtienes los cursos junto con el progreso del estudiante.

Ejemplo: esquema GraphQL y resolver

Definimos el esquema:

type Course {\n    id: ID!\n    title: String!\n    author: String!\n    progress(studentId: ID!): Int\n}\n\ntype Query {\n    courses: [Course!]!\n}

Escribimos el resolver en Java:

@Component\npublic class CourseResolver implements GraphQLQueryResolver {\n\n    @Autowired\n    private CourseService courseService;\n\n    public List<Course> courses() {\n        return courseService.findAll();\n    }\n}\n\n@Component\npublic class CourseFieldResolver implements GraphQLResolver<Course> {\n\n    @Autowired\n    private ProgressService progressService;\n\n    public Integer progress(Course course, Long studentId) {\n        return progressService.getProgress(course.getId(), studentId);\n    }\n}

Consulta del cliente:

query {\n  courses {\n    title\n