package org.activityinfo.server.util.jaxrs;
/*
* #%L
* ActivityInfo Server
* %%
* Copyright (C) 2009 - 2013 UNICEF
* %%
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public
* License along with this program. If not, see
* <http://www.gnu.org/licenses/gpl-3.0.html>.
* #L%
*/
import com.google.inject.servlet.ServletModule;
import com.sun.jersey.guice.spi.container.servlet.GuiceContainer;
import javax.ws.rs.Path;
import java.lang.reflect.Method;
import java.util.logging.Logger;
/**
* Base class for Guice Modules that provide REST endpoints.
* Use the bindResource() shortcut to tell the GuiceContainer
* about your resource and add it's @Path to the list of uris
* that are sent to GuiceContainer.
*/
public abstract class AbstractRestModule extends ServletModule {
protected final Logger LOGGER = Logger.getLogger(this.getClass().getName());
@Override
protected final void configureServlets() {
configureResources();
}
protected abstract void configureResources();
protected final void bindResource(Class clazz) {
bind(clazz);
Path path = (Path) clazz.getAnnotation(Path.class);
if (path == null) {
throw new IllegalStateException(clazz.getName() + " must have @Path annotation");
}
String pattern = path.value();
// only add the wildcard to the url pattern if the class contains at least
// one method with the Path annotation
for (Method method : clazz.getMethods()) {
if (method.isAnnotationPresent(Path.class)) {
pattern += "*";
break;
}
}
LOGGER.info("binding REST path '" + pattern + "'");
filter(pattern).through(GuiceContainer.class);
}
protected final void bindResource(Class clazz, String pattern, String... morePatterns) {
bind(clazz);
filter(pattern, morePatterns).through(GuiceContainer.class);
}
}