/* * #%L * Alfresco Remote API * %% * Copyright (C) 2005 - 2016 Alfresco Software Limited * %% * This file is part of the Alfresco software. * If the software was purchased under a paid Alfresco license, the terms of * the paid license agreement will prevail. Otherwise, the software is * provided under the following open source license terms: * * Alfresco is free software: you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * Alfresco 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 Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with Alfresco. If not, see . * #L% */ package org.alfresco.rest.api.people; import java.util.List; import org.alfresco.rest.api.Sites; import org.alfresco.rest.api.model.FavouriteSite; import org.alfresco.rest.framework.WebApiDescription; import org.alfresco.rest.framework.resource.RelationshipResource; import org.alfresco.rest.framework.resource.actions.interfaces.RelationshipResourceAction; import org.alfresco.rest.framework.resource.parameters.CollectionWithPagingInfo; import org.alfresco.rest.framework.resource.parameters.Parameters; import org.alfresco.util.ParameterCheck; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.springframework.beans.factory.InitializingBean; /** * * @author steveglover * */ @RelationshipResource(name = "favorite-sites", entityResource = PeopleEntityResource.class, title = "Person Favorite Sites") public class PersonFavouriteSitesRelation implements RelationshipResourceAction.Read, RelationshipResourceAction.ReadById, RelationshipResourceAction.Create, RelationshipResourceAction.Delete, InitializingBean { private static final Log logger = LogFactory.getLog(PersonFavouriteSitesRelation.class); private Sites sites; public void setSites(Sites sites) { this.sites = sites; } @Override public void afterPropertiesSet() { ParameterCheck.mandatory("sites", this.sites); } /** * List the user's favourite sites. * * @see org.alfresco.rest.framework.resource.actions.interfaces.RelationshipResourceAction.Read#readAll(java.lang.String, org.alfresco.rest.framework.resource.parameters.Parameters) */ @Override @WebApiDescription(title = "Get Person Favorite Sites", description = "Get a paged list of the person's favorite sites") public CollectionWithPagingInfo readAll(String personId, Parameters parameters) { return sites.getFavouriteSites(personId, parameters); } /** * List the favourite site information for a specific site. * * @see org.alfresco.rest.framework.resource.actions.interfaces.RelationshipResourceAction.ReadById#readById(String, String, org.alfresco.rest.framework.resource.parameters.Parameters) */ @Override @WebApiDescription(title = "Get Person Favorite Site", description = "Get information on a person's specific favorite site") public FavouriteSite readById(String personId, String siteShortName, Parameters parameters) { return sites.getFavouriteSite(personId, siteShortName); } /** * Adds the given site as a favourite site for the user. * * @see org.alfresco.rest.framework.resource.actions.interfaces.RelationshipResourceAction.Create#create(String, java.util.List, org.alfresco.rest.framework.resource.parameters.Parameters) */ @Override @WebApiDescription(title = "Add Person Favorite Site", description = "Favorite a site") public List create(String personId, List entity, Parameters parameters) { for (FavouriteSite favSite : entity) { sites.addFavouriteSite(personId, favSite); } return entity; } @Override @WebApiDescription(title = "Remove Person Favorite Site", description = "Un-favorite a site") public void delete(String personId, String siteId, Parameters parameters) { sites.removeFavouriteSite(personId, siteId); } }