SkillEndpoint.java

package com.ciandt.techgallery.service.endpoint;

import com.google.api.server.spi.config.Api;
import com.google.api.server.spi.config.ApiMethod;
import com.google.api.server.spi.config.Named;
import com.google.api.server.spi.config.AuthLevel;
import com.google.api.server.spi.config.ApiReference;
import com.google.api.server.spi.response.BadRequestException;
import com.google.api.server.spi.response.InternalServerErrorException;
import com.google.api.server.spi.response.NotFoundException;
import com.google.appengine.api.oauth.OAuthRequestException;
import com.google.appengine.api.users.User;

import com.ciandt.techgallery.Constants;
import com.ciandt.techgallery.persistence.model.Skill;
import com.ciandt.techgallery.service.SkillService;
import com.ciandt.techgallery.service.impl.SkillServiceImpl;
import com.ciandt.techgallery.service.model.UserSkillTO;

/**
 * Endpoint controller class for Skill requests.
 * 
 * @author Felipe Goncalves de Castro
 *
 */

@ApiReference(TechGalleryApiDefinition.class)
public class SkillEndpoint {

  private SkillService service = SkillServiceImpl.getInstance();

  /**
   * Endpoint for adding a Skill.
   * 
   * @param json with skill info.
   * @param user oauth user.
   * @return added skill
   * @throws InternalServerErrorException in case something goes wrong
   * @throws NotFoundException in case the information are not founded
   * @throws BadRequestException in case a request with problem were made.
   */
  @ApiMethod(name = "addSkill", path = "skill", httpMethod = "post")
  public Skill addSkill(Skill skill, User user)
      throws InternalServerErrorException, BadRequestException, NotFoundException {
    return service.addOrUpdateSkill(skill, user);
  }

  @ApiMethod(name = "deleteUserSkill", path = "skill", httpMethod = "delete")
  public void deleteUserSkill(@Named("id") String techId, User user)
          throws InternalServerErrorException, BadRequestException, NotFoundException, OAuthRequestException {
    service.deleteUserSkill(techId, user);
  }

  /**
   * Endpoint for getting an User Skill.
   * 
   * @param id technology id.
   * @param user oauth user.
   * @return the user skill
   * @throws InternalServerErrorException when an unknown error occurs
   * @throws BadRequestException when some request parameter is wrong missing
   * @throws OAuthRequestException when the user is not valid
   * @throws NotFoundException when the user skill is not found
   */
  @ApiMethod(name = "getUserSkill", path = "skill", httpMethod = "get")
  public Skill getUserSkill(@Named("id") String id, User user) throws InternalServerErrorException,
      BadRequestException, OAuthRequestException, NotFoundException {
    return service.getUserSkill(id, user);
  }

  /**
   * Endpoint for import user´s skills from sheet.
   * 
   * @param userSkills user´s with list of skill for each technology.
   * @param user oauth user.
   * @return String with error or success message.
   * @throws NotFoundException in case the information are not founded
   * @throws BadRequestException in case a request with problem were made.
   * @throws InternalServerErrorException in case something goes wrong
   */
  @ApiMethod(name = "importUserSkill", path = "skill/import", httpMethod = "post")
  public void importUserSkill(UserSkillTO userSkills, User user)
      throws NotFoundException, InternalServerErrorException, BadRequestException {
    service.importUserSkill(userSkills, user);
  }
}