Using The Java API
Using The Java API
http://java.sun.com/javase/6/docs/api/
9-Feb-14
Overview
General approach
If you know the name of the package, click it in the upper left panel; or click All Classes Click on the class in the lower left panel Scroll in the right pane to find the summary of the field, method, or constructor you want
For more information, click the link in the summary to go to the detailed information
Choose the package you are interested in Or, choose All Classes Classes in java.lang are automatically imported into every program--you dont have to do it yourself
Old snapshotsbut the format hasnt changed
5
This panel shows both classes and interfaces We havent yet talked about interfaces Note that some classes have names similar to primitive types (Boolean, Byte, Character)
Overview is where you start out Index is handy for looking up methods Help is the obvious If you dont like frames, you can choose NO FRAMES Deprecated methods are those that have been replaced by better methods and should not be used
7
General description of the class Field summary Constructor summary Method summary Field detail Constructor detail Method detail
public means accessible from anywhere char is the return type charAt is the name of the method int is the type of parameter expected index is just a suggestive name Example use: char firstChar = myStr.charAt(0);
Another example from the String class: public static String valueOf(int i)
public means accessible from anywhere static means this is a class method (see use below) String is the return type, and is a hyperlink valueOf is the name of the method int is the type of parameter expected i is just a suggestive name Example use: String numeral = String.valueOf(m / n);
10
All Java documentation was produced by the javadoc program from javadoc (or just doc) comments in the source code Your doc comments can be used in the same way to produce professional-looking documentation The Interface menu item in BlueJ does the same basic thing as javadoc Like most things in BlueJ, fancy features have been omitted in the interests of simplicity
11
Version packages classes methods Java 1.0 8 212 1545 Java 1.1 23 504 3851 Java 1.2 60 1781 15060 Java 1.3 77 2130 17158 Java 1.4 135 2738 ? Java 1.5 and 6 ? ? ? You can only learn a small fraction of these When you learn the kinds of things that are in the API, and learn to find your way around in it, you become a far more effective and efficient programmer A good craftsman knows his/her tools
12
On the web:
http://java.sun.com/javase/6/docs/api/
C:/ProgramFiles/Java/jdk1.6.0_01/docs/api/index.html
13
The End
Did you ride a horse to work today? I didnt. I'm sure plenty of people swore they would never ride in or operate a horseless carriageand they never did! And then they died.
http://chrisyeh.blogspot.com/2009/02/and-then-they-died-inevitability-of.html
14