001/* 002 * (C) Copyright 2015 Nuxeo SA (http://nuxeo.com/) and others. 003 * 004 * All rights reserved. This program and the accompanying materials 005 * are made available under the terms of the GNU Lesser General Public License 006 * (LGPL) version 2.1 which accompanies this distribution, and is available at 007 * http://www.gnu.org/licenses/lgpl-2.1.html 008 * 009 * This library is distributed in the hope that it will be useful, 010 * but WITHOUT ANY WARRANTY; without even the implied warranty of 011 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 012 * Lesser General Public License for more details. 013 * 014 * Contributors: 015 * Thomas Roger 016 */ 017 018package org.nuxeo.ecm.core.io.marshallers.json.enrichers; 019 020import static org.nuxeo.ecm.core.io.registry.reflect.Instantiations.SINGLETON; 021import static org.nuxeo.ecm.core.io.registry.reflect.Priorities.REFERENCE; 022 023import java.io.IOException; 024import java.util.List; 025 026import org.codehaus.jackson.JsonGenerator; 027import org.nuxeo.ecm.core.api.DocumentModel; 028import org.nuxeo.ecm.core.api.security.PermissionProvider; 029import org.nuxeo.ecm.core.api.security.UserVisiblePermission; 030import org.nuxeo.ecm.core.io.registry.reflect.Setup; 031import org.nuxeo.runtime.api.Framework; 032 033/** 034 * Enrich {@link DocumentModel} Json. 035 * <p> 036 * Add document user visible permissions as json attachment. 037 * </p> 038 * <p> 039 * Enable if parameter enrichers.document=userVisiblePermissions is present. 040 * </p> 041 * <p> 042 * Format is: 043 * 044 * <pre> 045 * {@code 046 * { 047 * "entity-type":"document", 048 * ... 049 * "contextParameters": { 050 * "userVisiblePermissions": ["Read", "ReadWrite", "Everything"] 051 * } 052 * } 053 * </pre> 054 * 055 * </p> 056 * 057 * @since 7.4 058 */ 059@Setup(mode = SINGLETON, priority = REFERENCE) 060public class UserVisiblePermissionsJsonEnricher extends AbstractJsonEnricher<DocumentModel> { 061 062 public static final String NAME = "userVisiblePermissions"; 063 064 public UserVisiblePermissionsJsonEnricher() { 065 super(NAME); 066 } 067 068 @Override 069 public void write(JsonGenerator jg, DocumentModel document) throws IOException { 070 PermissionProvider permissionProvider = Framework.getService(PermissionProvider.class); 071 List<UserVisiblePermission> userVisiblePermissions = permissionProvider.getUserVisiblePermissionDescriptors(document.getType()); 072 073 jg.writeArrayFieldStart(NAME); 074 for (UserVisiblePermission permission : userVisiblePermissions) { 075 jg.writeString(permission.getId()); 076 } 077 jg.writeEndArray(); 078 } 079 080}