Apache Derby Papers
This ad hoc spot in the Derby site hosts papers, and check the Derby Wiki for more.
The table below summarizes resources that describe the Derby engine.
|Navigation Menu Entry||Title|
|Architecture||Derby Engine Architecture Overview|
|BTree||BTree package documentation|
|Disk Page Format||Derby On Disk Page Format|
|How Things Work||How Things Work|
|Intersect & Except||Intersect & Except Design|
|JDBC||Derby JDBC Implementation Notes|
|Log Format||Derby Write Ahead Log Format|
|Logging & Recovery||Derby Logging and Recovery|
|Optimizer||Derby Optimizer Design|
|Type System||Derby Type System (Note: if your browser shows HTML source for this page instead of displaying it, save the file locally with File -> Save Page As, then open the file you saved.)|
|Versioning||Derby Versioning Scheme|
Derby Network Client
The table below summarizes white papers that describe the Derby Network Client.
|Navigation Menu Entry||Title|
|Functional Spec||Derby Network Client|
How to Contribute Papers
If you have figured out how something works in Derby or how to do something cool and have produced a white paper you would like to contribute to the Derby web site, please open a Jira issue with the component set to "Web Site". Upload your contribution to that issue with the "Attach file to this issue" option. It will prompt you to click on "Grant license to ASF for inclusion in ASF works", and this is the permission we need in place to host your contribution on the Derby web site.
As time permits, somebody will take the document from the Jira issue and put it on the Derby web site. You can speed the posting process up by testing your white paper in Forrest to verify it works well before you post it.
If you want the paper integrated with the Derby web site, with the forrest-generated navigation, it is easiest to incorporate these types of files:
- HTML (an example is Derby JDBC Implementation Notes).
- XML, using the Forrest DTD (an example is Derby Engine Architecture Overview).
- ASCII text embedded in XML (an example is in the derby_web.html page).
That much said, even though your favorite word processing program can produce an HTML file, that doesn't necessarily mean that forrest can read it and do something visually pleasing with it. If forrest can't consume your document, or you don't like what forrest did with it, or you want to provide your document in a binary format it can be included in its native format on the site -- it just won't have the forrest-generated left hand navigation and top banner. Examples are:
- Running DOTS (Database open Source Test Suite) with Derby.
- The C-JDBC PDF and Open Office files.
You can also link directly to a file in the Derby code tree; for example, to the Building Derby file. Don't link with a viewcvs URL like the one below because it turns out to put a heavier burden on the server than is needed:
ViewCVS is good for when you need to browse the history. But if all you need to do is display the file, link to it like this instead:
Last Updated: March 30, 2005