...
On the mailing list, people ask regularly on how to write a custom partition. Please note that this is not an easy task. Nevertheless I try to give you a starting point with some simple examples. If you simply plan to add another suffix to ApacheDS (besides example.com, for instance), it is not necessary to write any code. You can simply add some lines to the configuration. The following is for those who plan to use another storage mechanism than the provided default.
...
Implementing your own partition is basically implementing the Partition interface from the org.apache.directory.server.core.partition package. Please note that this is not an easy task. Nevertheless I try to give you a starting point with some simple examples.
Hello world. A minimal partition
...