What are the best practices for the Middleware API?

Question

We develop middleware SDKs, both in C ++ and Java, that will be used as a library / DLL, for example, game developers, animation software developers, avatar developers to improve their products.

What I would like to know is: Are there standard “best practices” for developing these types of APIs?

I think in terms of usability, readability, efficiency, etc.

Answer 1

My two favorite related resources: http://mollyrocket.com/873 and http://video.google.com/videoplay?docid=-3733345136856180693

Answer 2

Windows :

DLL, . . visual ++ , , .

++, . ++ , , , ++, Windows. C, , dll.

++ (, ), ++, , c-. , .

c/++ Java, , c-, ++ - .

"Imperfect ++" , .

Answer 3

, yrp, - .

:

• API , .
• DO , API.
• DO , API.
• - .
• singleton , , .
• javadoc, .

Answer 4

apis, , . , , . , Java, -, Effective Java 2nd Edition. - , . Java Java, , .

Answer 5

. , .NET, , , .