Amazon.com: Practical API Design: Confessions of a Java Framework Architect eBook: Jaroslav Tulach: Kindle Store
Start reading Practical API Design on your Kindle in under a minute. Don't have a Kindle? Get your Kindle here.

Deliver to your Kindle or other device

 
 
 

Try it free

Sample the beginning of this book for free

Deliver to your Kindle or other device

Read books on your computer or other mobile devices with our FREE Kindle Reading Apps.
Practical API Design: Confessions of a Java Framework Architect
 
 

Practical API Design: Confessions of a Java Framework Architect [Kindle Edition]

Jaroslav Tulach
4.6 out of 5 stars  See all reviews (7 customer reviews)

Digital List Price: $59.99 What's this?
Print List Price: $74.99
Kindle Price: $47.99 includes free wireless delivery via Amazon Whispernet
You Save: $27.00 (36%)

Formats

Amazon Price New from Used from
Kindle Edition $47.99  
Hardcover $53.56  
Paperback $47.71  


Editorial Reviews

Product Description

The definitive guide to API design, this book will be required reading for all designers and engineers involved with the development, testing, and maintenance of APIs.

About the Author

Jaroslav Tulach

"I'm one of the founders of NetBeans, the company that got acquired by Sun later, and I am the last founder who still remains with the NetBeans project. I was also part of the group which started the original student project in 1996 at the Faculty of Mathematics and Physics of Charles University. So I have been with NetBeans, an API still going strong, since its beginnings."


Product Details

  • Format: Kindle Edition
  • File Size: 3918 KB
  • Publisher: Apress; 1 edition (July 28, 2008)
  • Sold by: Amazon Digital Services
  • Language: English
  • ASIN: B001XCVZP8
  • Text-to-Speech: Enabled
  • Lending: Enabled
  • Average Customer Review: 4.6 out of 5 stars  See all reviews (7 customer reviews)
  • Amazon Best Sellers Rank: #274,866 Paid in Kindle Store (See Top 100 Paid in Kindle Store)
  •  Would you like to give feedback on images?


 

Customer Reviews

7 Reviews
5 star:
 (5)
4 star:
 (1)
3 star:
 (1)
2 star:    (0)
1 star:    (0)
 
 
 
 
 
Average Customer Review
4.6 out of 5 stars (7 customer reviews)
 
 
 
 
Share your thoughts with other customers:
Most Helpful Customer Reviews

9 of 10 people found the following review helpful:
5.0 out of 5 stars As essential to programming as Effective Java by Bloch, January 9, 2009
By 
mathboy (San Diego, CA) - See all my reviews
Amazon Verified Purchase(What's this?)
Enough said.

This and Effective Java by Bloch are the two books every Java programmer should have read. It will change the way you program and you'll be grateful for the change. The examples in this book are in Java but that's because they had to be in some language; I don't think any part of this book is specific to Java. If your code is consumed by other people, or even a future self, then this book will help you think through issues you may not have know you have. It did me.

In my opinion, this is those one of those once in a decade books that changes the game for anyone who reads it.

A totally mature, non-didactic work written by someone with that perfect combination of real-world experience, a high intellect, a no BS attitude, and humility.

This book is like getting a magical time telescope- you can see what the decisions you are making in your coding today will actually lead to in the future and what the inescapable consequences will be for you.

Actually, reading this book is a little like being put into the role of Scrooge being visited by the three ghosts of Christmas. You get to see what's going to happen to you because of your past and present actions before it happens. At it's heart it's a longitudinal study of how code is first consumed, abused and misused by other programmers and how those abuses become dependencies which determine what YOU, the code's author can and cannot do in future releases.

In a very small nutshell- totally innocent innocuous, completely legal and even recommended programming practices which you apply every day in your code can and will completely shut down any chance for your code to evolve in any rational way going forward in future releases. Why? Because you can't see the potential consequences of consumers of your code doing something you never thought they might do in ways you never meant for them to do it.

But here's a guy who did do those things and lived to pay the price.

For example, if you think that using interfaces (in Java) is usually the best way to program, then you might have a nasty surprise coming at you when other people (damn them!) actually start to program against your code.

When the book's over, you might be as happy as Scrooge that there's still time to change things before it's too late.

Like Bloch's Effective Java, the lessons in this book are so important that they're destined to become diffused throughout the general programming culture and become known to people who haven't even heard of the book. But can you wait until all that filters down to you through osmosis?
Help other customers find the most helpful reviews 
Was this review helpful to you? Yes No


4 of 4 people found the following review helpful:
5.0 out of 5 stars The book I've always been waiting for, March 2, 2009
By 
David Linsin (Karlsruhe, Germany) - See all my reviews
(REAL NAME)   
Practical API Design: Confessions of a Java Framework Architect is the book I've always been waiting for. Jaroslav Tulach, the founder and architect of NetBeans, created a highly recommend read for everyone in charge of developing APIs.

But even if it's not your job to define interfaces, you are somewhat alway on the other side consuming them and it's good to know what drives evolution of the APIs you work with.

The book consists of 3 parts:

Part 1 is called "Theory and Justification". It defines the terminology and background which gives you the necessary foundation to explain and justify API design.

Let me give you and example: Have you ever had problems explaining your design to a colleague? You couldn't find the right words to reasonably highlight your decision, but you know it was right? The only justification was your intuition and the feeling that your design was the right choice. Does that sound familiar?

That's where Part 1 of this book comes in and tries to give you a tool to justify and even measure the quality of your design decisions: Selective Cluelessness. It's a principle which is based on the assumption that you can achieve more by knowing less:

"The more good APIs we have, the bigger the systems we'll be able to build without understanding all their details."

"Practical Design" is Part 2 and basically puts the theory highlighted in the first part to practice. Using Java, the author provides a set of what he calls API design patterns. They are design patterns in the traditional sense, but with a focus on evolution. Most of them accompanied by an examples the the NetBeans APIs. It doesn't matter if you are not familiar with NetBeans. Due to the author's years of experience with NetBeans, he does a great job explaining the problems it was facing and how they came with a solution, which evolved into an API design pattern.

..., it's slightly more complicated to design a universe than building a house. As a result, we need an enhanced version of the design patters. We need patterns that help us building a "universe".

Part 3 of the book, "Daily Life", is a collection of advices on how to bugfix, evolve and maintain an API. The author points out how important versioning is and how NetBeans solves such a problem. He highlights the importance of compatibility and how to keep the promises to the users of your APIs.

The theory and initial design are just the tip of the iceberg. The rest is the real work.

I'm really glad I read this book, although it took me quite a while. The reason is not the 365 pages. It was all the moments I had during reading it. So many times I was reminded of mistakes I made in APIs I previously designed. I often pondered on whether a solution suggested in the book was better than the one I came up with. I think that's what makes a book interesting, if it makes you think and critically review your own solutions.

I enjoyed taking the journey through the API universe and learning how to design an API in a selective cluelessness way. As for the reasons why you should read this book:

... when you understand the API world, its needs and its laws of evolution, you can shape it into a form containing all that the creators of the oldest and most perfect science always searched for - beauty, truth and elegance. A properly API universe ain't a bad place to be.
Help other customers find the most helpful reviews 
Was this review helpful to you? Yes No


2 of 2 people found the following review helpful:
5.0 out of 5 stars Surprisingly Enlightening Top Notch Software Development Book for the Advanced Professional, November 5, 2009
By 
ws__ (Hamburg, Germany) - See all my reviews
Wow! I only wanted to brush up some of my development skills and than this rock of a book. There are problems and solutions I did not have the slightest idea of their existence. I even learned more than in the classic Effective Java (2nd Edition) by Joshua Bloch. The section about concurrency is worth this book alone.

The key part for the PRACTICAL design is part 2. So do not be discouraged from part 1. If you do not like philosophy you might be annoyed, and if you do like philosophy you will be disappointed. A condensed version of the philosophical background of his advice is helpful though: Users of your library should be effective with the maximum amount of cluelessnes. And the development of your library should stay flexible without breaking the code of your clients.

In part 2 and 3 you will find a treasure trove of hard to find advice. Highlights are a very detailed comparison between the tradeoffs of using: interfaces, abstract classes, concrete final classes, ... . You find about problems of offering callbacks to your clients. The ramifications to multithreading are especially interesting. Also of particular interest is his implementation of the visitor pattern that abstracts from the API version of the concrete used library: an example of triple dispatch.

I do strongly support Jaroslav Tulachs call for direct compiler support of versioning of APIs. This immediately helps for solving the great challenges in our open source libraries weaving world.

I do strongly recommend this great book. Thank you Jaroslav.
Help other customers find the most helpful reviews 
Was this review helpful to you? Yes No

Share your thoughts with other customers: Create your own review
 
 
 
Most Recent Customer Reviews





Only search this product's reviews



More About the Author

My name is Jaroslav Tulach and I am the founder and initial architect of NetBeans, which is not just a well known IDE, but also the first modular desktop application framework written in Java. My name sounds Slavic and has a strange pronunciation (read the initial J as Y and last ch as in Scottish loch or in German Bach), because I am Czech. However, as NetBeans has been the flagship software product of Sun Microsystems/Oracle for a while now, you don't have to worry that content of my Practical API Design book might not be widely applicable and understandable.

What Other Items Do Customers Buy After Viewing This Item?


Popular Highlights

 (What's this?)
&quote;
A valid use case is the justification for a class or a method in an API. If there's no use case for a given method or class, or if the use case is slightly suspicious, then it's better to leave that element out of the API. &quote;
Highlighted by 6 Kindle users
&quote;
Once a field is defined in a class, it has to stay there forever to maintain binary compatibility, which is another reason to keep fields private. &quote;
Highlighted by 6 Kindle users
&quote;
Never expose fields in an API, except for public static final primitive or string constants, enum values, or immutable object references. &quote;
Highlighted by 6 Kindle users

Tags Customers Associate with This Product

 (What's this?)
Click on a tag to find related items, discussions, and people.
 

Your tags: Add your first tag
 

Customer Discussions

This product's forum
Discussion Replies Latest Post
No discussions yet

Ask questions, Share opinions, Gain insight
Start a new discussion
Topic:
First post:
Prompts for sign-in
 


Active discussions in related forums
Search Customer Discussions
Search all Amazon discussions
   
Related forums



So You'd Like to...


Create a guide

Look for Similar Items by Category