Simple library
From APIDesign
Line 1: | Line 1: | ||
- | Some libraries, let's name them | + | Some libraries, let's name them [[simple library|simple libraries]], have just one implementation. The designer that defines what the [[API]] should do also implements it. Obviously, the [[proximity]] between the [[API]] and the [[ProviderAPI|provider of the implementation]] is almost zero - it is the same person or the same team. |
- | Simple [[library]] are usually self contained. They contains the [[API]] as well as the implementation. Examples include most of '''java.util''' package, or {{JDK|java/lang|Math}} class. Of course, there may be some attempts to re-implement these libraries (like GNU Classpath or Harmony), but those are licensing driven efforts, not technical ones. In general, there is little to no reason to re-implement such libraries. | + | Simple [[library|libraries]] are usually self contained. They contains the [[API]] as well as the implementation. There is no reason, no way to plug into the library and change the way it behaves (for other [[ClientAPI|clients of its API]]). Examples of such [[simple library]] include most of '''java.util''' package, or {{JDK|java/lang|Math}} class. |
+ | |||
+ | Of course, there may be some attempts to re-implement these libraries (like GNU Classpath or Harmony), but those are often licensing driven efforts, not purely technical ones. Especially when they are available as open source. If there is some flaw in the library, then it is better to contribute patches back (see [[Teamwork]] chapter of the [[TheAPIBook]]) then fork and maintain such fork. In general, there is little to no reason to re-implement such libraries. |
Revision as of 13:53, 8 May 2012
Some libraries, let's name them simple libraries, have just one implementation. The designer that defines what the API should do also implements it. Obviously, the proximity between the API and the provider of the implementation is almost zero - it is the same person or the same team.
Simple libraries are usually self contained. They contains the API as well as the implementation. There is no reason, no way to plug into the library and change the way it behaves (for other clients of its API). Examples of such simple library include most of java.util package, or Math class.
Of course, there may be some attempts to re-implement these libraries (like GNU Classpath or Harmony), but those are often licensing driven efforts, not purely technical ones. Especially when they are available as open source. If there is some flaw in the library, then it is better to contribute patches back (see Teamwork chapter of the TheAPIBook) then fork and maintain such fork. In general, there is little to no reason to re-implement such libraries.