recommend
A simple packaging of Dropwizard, Groovy, Gradle, Guice, Mahout and Swagger to provide a REST recommendation API
Instructions:
Run:
./gradle idea
To generate your IDE files, you can update the build.gradle for your favourite IDE
To run all tests:
./gradlew clean test
Build the "farjar" containing all class and resource dependencies:
./gradle -Pversion=1.0 :dropwizard:shadow
This will generate a "fatjar" at
dropwizard/build/libs/dropwizard-1.0-shadow.jar
Run the service as follows:
java -Xmx1g -jar dropwizard/build/libs/dropwizard-1.0-shadow.jar server dropwizard/src/main/resources/configuration/configuration.yaml
Sample input csv file used for testing is at:
dropwizard/src/main/resources/input.csv
The CSV file has 3 values, userId, itemId, preferenceValue.
The Dropwizard Operational menu is available at: http://localhost:8081/
Swagger API docs available at: http://localhost:8080/swagger-ui/index.html
Test out the API at: http://localhost:8080/swagger-ui/index.html#!/{userId}/getRecommendations_get_0
Generate some randomish test data by running the GenerateCSVFile class in the test/groovy folder.
##License Copyright 2013 Oisin Kim
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License 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.