Sources
From APIDesign
| Line 1: | Line 1: | ||
| - | + | All the code snippets shown in the [[TheAPIBook|Practical API Design]] book | |
| + | are extracted from real projects. As such it is guaranteed they are correct, they compile and can even be executed, [[debugger|debugged]] and tested. | ||
| + | |||
| + | Moreover, as it is often not enough to see just few lines of code in middle of a page, readers are recommended to get the whole tree of [[sources]], including their history and play with them for real. Preferably use [[Mercurial]] to clone the [[sources]] [[Hg]] [http://source.apidesign.org/hg/apidesign/ repository]: | ||
| + | |||
| + | <source lang="bash"> | ||
| + | $ hg clone http://source.apidesign.org/hg/apidesign/ | ||
| + | </source> | ||
=== Environment === | === Environment === | ||
In order to use the sample sources you may need: | In order to use the sample sources you may need: | ||
| - | * [[JDK]] 1.6.0 - necessary for compilation and execution | + | * At least [[JDK]] 1.6.0 - necessary for compilation and execution |
| - | * [[Ant]] 1.8.1 - allows simple compilation and execution from command line | + | * At least [[Ant]] 1.8.1 - allows simple compilation and execution from command line |
| - | * [[NetBeans]] IDE 6.9 - all projects are configured to smoothly open in [[NetBeans]] IDE | + | * At least [[NetBeans]] IDE 6.9 - all projects are configured to smoothly open in [[NetBeans]] IDE |
| + | |||
| + | If you managed to successfully start [[NetBeans]] IDE, you probably have everything necessary installed on your computer. | ||
=== Download === | === Download === | ||
| - | + | Those that prefer [[ZIP]] over [[Mercurial]] (which [[I]] don't understand) can download the latest published build from our | |
| + | [http://hudson.apidesign.org/job/samples continuous build server]. Download the latest version of apidesign-XYZ.zip, unzip it on your local computer. Start [[NetBeans]] IDE and open individual projects as needed. | ||
| - | |||
| - | |||
| - | |||
=== Usage === | === Usage === | ||
| - | You need to run <tt>build.xml</tt> before opening the projects in the IDE. Otherwise the projects have unsolvable broken references | + | You need to run <tt>build.xml</tt> before opening the projects in the IDE. Otherwise the projects have unsolvable broken references (due to missing [[libraries]] that need to be downloaded). |
| - | + | ||
| - | + | ||
Revision as of 11:26, 6 August 2014
All the code snippets shown in the Practical API Design book are extracted from real projects. As such it is guaranteed they are correct, they compile and can even be executed, debugged and tested.
Moreover, as it is often not enough to see just few lines of code in middle of a page, readers are recommended to get the whole tree of sources, including their history and play with them for real. Preferably use Mercurial to clone the sources Hg repository:
$ hg clone http://source.apidesign.org/hg/apidesign/
Environment
In order to use the sample sources you may need:
- At least JDK 1.6.0 - necessary for compilation and execution
- At least Ant 1.8.1 - allows simple compilation and execution from command line
- At least NetBeans IDE 6.9 - all projects are configured to smoothly open in NetBeans IDE
If you managed to successfully start NetBeans IDE, you probably have everything necessary installed on your computer.
Download
Those that prefer ZIP over Mercurial (which I don't understand) can download the latest published build from our continuous build server. Download the latest version of apidesign-XYZ.zip, unzip it on your local computer. Start NetBeans IDE and open individual projects as needed.
Usage
You need to run build.xml before opening the projects in the IDE. Otherwise the projects have unsolvable broken references (due to missing libraries that need to be downloaded).
Follow
