/*
* #%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);
}
}