Прикладний програмний інтерфейс: відмінності між версіями

[неперевірена версія][неперевірена версія]
Вилучено вміст Додано вміст
Немає опису редагування
Рядок 52:
[[Java мова | Java]] поставляється з документацією організованою в [[HTML]] сторінки ([[JavaDoc]] формат), в той час як [[Microsoft]] розподіляє ППІ документацію для своїх мов ([[Visual C++]], [[C Sharp (programming language)|C#]], [[Visual Basic]], [[f sharp language|F#]], etc...), вбудовані в довідкову систему [[Visual Studio]].
 
У=== цьому випадку Прикладний Програмний Інтерфейс можеже бути інтерпретованим як два способи pop() і push(), або, більш широко використовується варіант, коли можна використовувати елемент типу Stack, який реалізує поведінку стека надаючи йому можливість вершині для додавання / видалення елементів. Друга інтерпретація видається більш доречною в дусі об'єктно-орієнтованого підходу.
=== Прикладний програмний інтерфейс у об'єктно-орієнтованих мовах ===
В [[об'єктно-орієнтованому | об'єктно-орієнтованих]] мовах, прикладний програмний інтерфейс зазвичай включає в себе опис набору визначень [[Class (інформатика) | класу]], з набором форм поведінки, пов'язаних з цими класами. Це абстрактне поняття пов'язане з реальними функціями, які надані або надаватимуться, класами, які реалізуються в методах класу.
 
Прикладний програмний інтерфейс в даному випадку можна розглядати як сукупність всіх методів, які публічно доступні в класах (зазвичай званий інтерфейс класу). Це означає, що прикладний програмний інтерфейс вказує методи, за допомогою яких взаємодіє з об'єктами, отриманими з визначень класів і обробляє їх.
 
У більш загальному плані можна визначити Прикладний Програмний Інтерфейс як сукупність усіх видів об'єктів, які можна вивести з визначення класу, і пов'язаних з ними можливих варіантів поведінки.
 
Наприклад: клас, що представляє Stack може просто виставити публічно два методи Push() (для додавання нового елемента в стек ) і Pop() (для вилучення останнього пункту, ідеально розташований на вершині стека)​​.
 
У цьому випадку Прикладний Програмний Інтерфейс може бути інтерпретованим як два способи pop() і push(), або, більш широко використовується варіант, коли можна використовувати елемент типу Stack, який реалізує поведінку стека надаючи йому можливість вершині для додавання / видалення елементів. Друга інтерпретація видається більш доречною в дусі об'єктно-орієнтованого підходу.
 
Якість документації, пов'язаної з Приклданим Програмним Інтерфейсом є часто ключовим фактором, що визначає його успішність з точки зору простоти використання.