Чем спецификация отличается от API?

Question

[Eugenue Cesarevich]

Разбираюсь с Hibernate. Выяснилось, что JPA - это спецификация, а Hibernate - реализующий её ORM, причём Hibernate может работать и через собственное API, а не только через API JPA.

Чем спецификация отличается от обычных интерфейсов / API? Ведь в спецификации, насколько я понимаю, так же декларируется то, что должно быть реализовано, как и в контракте интерфейса.

Answer 1

[Сергей Горностаев]

В данном случае отличается тем, что это стандартная спецификация. Разработчик Hibernate может как угодно и когда угодно поменять своё API, но JPA меняется только в процессе многолетнего согласования примерно полусотни крупных компаний.

Comments

[Eugenue Cesarevich]

Спасибо за ответ!
Я всё ещё не могу догнать, почему используется два отдельных термина. Может быть спецификацией обычно называют то, что не имеет стандартной реализации вообще? Типа "вот вам спецификация, делайте свои программы в соответствии с ней". Или эти термины не отличаются вообще?

[Сергей Горностаев]

Eugenue Cesarevich, именно так. Спецификация - это описание требований, которым должна соответствовать библиотека для соответствия некому стандарту.

Answer 2

[Dmitry Roo]

JPA - Java Persistence API
Ваш вопрос: чем API отличается от API.
Ответ - ничем.

Comments

[Eugenue Cesarevich]

Нет, вопрос больше про термины. Вообще в целом спецификация и API или интерфейс - это всё одно и то же?

[Сергей Горностаев]

Eugenue Cesarevich, API - это понятие скорее программного уровня, а спецификация - это документ описывающий что-либо, то же API например.