decoration decoration
Stories

GROKLAW
When you want to know more...
decoration
For layout only
Home
Archives
Site Map
Search
About Groklaw
Awards
Legal Research
Timelines
ApplevSamsung
ApplevSamsung p.2
ArchiveExplorer
Autozone
Bilski
Cases
Cast: Lawyers
Comes v. MS
Contracts/Documents
Courts
DRM
Gordon v MS
GPL
Grokdoc
HTML How To
IPI v RH
IV v. Google
Legal Docs
Lodsys
MS Litigations
MSvB&N
News Picks
Novell v. MS
Novell-MS Deal
ODF/OOXML
OOXML Appeals
OraclevGoogle
Patents
ProjectMonterey
Psystar
Quote Database
Red Hat v SCO
Salus Book
SCEA v Hotz
SCO Appeals
SCO Bankruptcy
SCO Financials
SCO Overview
SCO v IBM
SCO v Novell
SCO:Soup2Nuts
SCOsource
Sean Daly
Software Patents
Switch to Linux
Transcripts
Unix Books

Gear

Groklaw Gear

Click here to send an email to the editor of this weblog.


You won't find me on Facebook


Donate

Donate Paypal


No Legal Advice

The information on Groklaw is not intended to constitute legal advice. While Mark is a lawyer and he has asked other lawyers and law students to contribute articles, all of these articles are offered to help educate, not to provide specific legal advice. They are not your lawyers.

Here's Groklaw's comments policy.


What's New

STORIES
No new stories

COMMENTS last 48 hrs
No new comments


Sponsors

Hosting:
hosted by ibiblio

On servers donated to ibiblio by AMD.

Webmaster
Restaurant API Analogy | 133 comments | Create New Account
Comments belong to whoever posts them. Please notify us of inappropriate comments.
Good? API Analogy
Authored by: Anonymous on Monday, April 23 2012 @ 05:07 PM EDT
And the undocumentd things in an API are the off-menu items one can order
at the eating establishment.

[ Reply to This | Parent | # ]

Restaurant API Analogy
Authored by: SpaceLifeForm on Monday, April 23 2012 @ 08:26 PM EDT
Actually, it is more complex than that.

Your main object is the waitress.

You request a list (menu items) from the waitress.
(depending upon the service, that is implied as soon
as you sit down, but a drive thru, the list may be
on a board. Sometimes, you may have to ask anyway
at a sitdown establishment. Sometimes, they know you
are not going to eat).

You then repeatedly interact via calls the waitress
requesting items from the menu list.

Each call to the waitress can result in an exception.
Sorry, we are out of that today.

A call to the waitress function may be a request for
more information, ex: What is the special today?

Each call to the waitress function may result in the
waitress adding items from the list menu to another list,
the order list.

At some point, you tell the waitress that you have no
more items to add to the list.

The order list may be empty at this point too.

If the order list is not empty, the waitress function
place order occurs. This is the magic, the implementation,
that you normally do not have the source code to.
If you are in a real dive, you likely don't want to
see the secret sauce code.

At some time later, the waitress returns with
some output. Hopefully, it is good.




---

You are being MICROattacked, from various angles, in a SOFT manner.

[ Reply to This | Parent | # ]

Groklaw © Copyright 2003-2013 Pamela Jones.
All trademarks and copyrights on this page are owned by their respective owners.
Comments are owned by the individual posters.

PJ's articles are licensed under a Creative Commons License. ( Details )