I haven't had to build a PL/SQL portlet yet but I'm pretty sure one or two are in my future. So I've been doing a bit of research and here's what appears to be a javadoc but for the Portal PL/SQL API:
http://www.oracle.com/technology/products/ias/portal/html/plsqldoc/pldoc1014/index.html