Pete Freitag Pete Freitag

How to Design a Good API and Why it Matters


Joshua Bloch has a good presentation outline called How to Design a Good API and Why it Matters. Joshua is a Principal Software Engineer for Google, before that an architect in Sun's Core Java Platform Group (he designed several of the standard java API's). Josh also wrote Effective Java.

Here are a few points from the presentation that I found interesting...

  • If you program, you are an API designer
  • If you keep the spec short, it?s easy to modify
  • API Should Do One Thing and Do it Well
  • API Should Be As Small As Possible But No Smaller
  • Names Matter - API is a Little Language
  • Fail Fast - Report Errors as Soon as Possible After They Occur

Like this? Follow me ↯

How to Design a Good API and Why it Matters was first published on March 20, 2006.

If you like reading about api, design, architecture, bloch, google, sun, or java then you might also like:

FuseGuard Web App Firewall for ColdFusion

The FuseGuard Web Application Firewall for ColdFusion & CFML is a high performance, customizable engine that blocks various attacks against your ColdFusion applications.