JarCastingDarkLord
DarkLord is a Java API for Project Voldemort. It uses official Voldemort Java API and provides additional abstraction.
It is named after the fictional Harry Potter villain Lord Voldemort. The Dark Lord is used as a nick name for the Lord Voldemort. In the series, almost no witch or wizard dares to speak his name, instead referring to him by epithets such as "You-Know-Who", "He-Who-Must-Not-Be-Named" or "the Dark Lord".
Project Voldemort is a distributed data store that is designed as a key-value store used by LinkedIn for high-scalability storage.
Project Voldemort already has a Java API which is used by Voldemort internally. But DarkLord provides a tiny API as an abstraction on top of official Voldemort client API.
Purpose
The current design of original Voldemort API is not TDD friendly. It's sometimes impossible to write unit tests using the API. The main aim to build a new abstraction on top of Voldemort API is to be able to have less-features but cleaner codebase.
DarkLord Client API
darklord-client API provides a java client using the original Voldemort Java API.
DarkLord Server API
darklord-server API provides a server implementation to startup Voldemort instances on local machines for testing purposes. This provides capability to develop or test without any need to Voldemort server installation.
Main Dependencies
Java version:
- Java 7
Libraries not available in central maven repository. You can access these libraries from project's lib/ folder and copy to your local maven repository:
- Voldemort-1.3.0
- Je-4.1.17
Usage
For maven users, you can add DarkLord-Client and DarkLord-Server from OSS Central Maven Repository as the following.
<dependency>
<groupId>com.agilistanbul</groupId>
<artifactId>darklord-client</artifactId>
<version>0.1.1</version>
</dependency>
<dependency>
<groupId>com.agilistanbul</groupId>
<artifactId>darklord-server</artifactId>
<version>0.1.1</version>
</dependency>
Please note that Voldemort-1.3.0 is not available in central maven repository. You should download and add it to your local repository by yourself.
Configuring Server and Client
Voldemort server and clients can be configured by changing values of the predefined settings. The list of all possible settings are added to the codebase as sample files. You can check the settings of Voldemort server from server.properties, the settings of Voldemort client from client.properties and the settings of Voldemort admin client from admin.properties files.
Contributors
Copyright (C) Lemi Orhan Ergin
License
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
