Spurred by a conversation with some Intel colleagues, I wrote up an account of how we can use Java interfaces to model various kinds of APIs. http://cr.openjdk.java.net/~jrose/panama/using-interfaces.html Enjoy. — John