001/* 002 * (C) Copyright 2015 Nuxeo SA (http://nuxeo.com/) and others. 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.apache.org/licenses/LICENSE-2.0 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 013 * See the License for the specific language governing permissions and 014 * limitations under the License. 015 * 016 * Contributors: 017 * Thomas Roger 018 */ 019 020package org.nuxeo.ecm.core.io.marshallers.json.enrichers; 021 022import static org.nuxeo.ecm.core.io.registry.reflect.Instantiations.SINGLETON; 023import static org.nuxeo.ecm.core.io.registry.reflect.Priorities.REFERENCE; 024 025import java.io.IOException; 026import java.util.List; 027 028import org.nuxeo.ecm.core.api.DocumentModel; 029import org.nuxeo.ecm.core.api.security.PermissionProvider; 030import org.nuxeo.ecm.core.api.security.UserVisiblePermission; 031import org.nuxeo.ecm.core.io.registry.reflect.Setup; 032import org.nuxeo.runtime.api.Framework; 033 034import com.fasterxml.jackson.core.JsonGenerator; 035 036/** 037 * Enrich {@link DocumentModel} Json. 038 * <p> 039 * Add document user visible permissions as json attachment. 040 * </p> 041 * <p> 042 * Enable if parameter enrichers-document=userVisiblePermissions is present. 043 * </p> 044 * <p> 045 * Format is: 046 * 047 * <pre> 048 * {@code 049 * { 050 * "entity-type":"document", 051 * ... 052 * "contextParameters": { 053 * "userVisiblePermissions": ["Read", "ReadWrite", "Everything"] 054 * } 055 * } 056 * </pre> 057 * 058 * </p> 059 * 060 * @since 7.4 061 */ 062@Setup(mode = SINGLETON, priority = REFERENCE) 063public class UserVisiblePermissionsJsonEnricher extends AbstractJsonEnricher<DocumentModel> { 064 065 public static final String NAME = "userVisiblePermissions"; 066 067 public UserVisiblePermissionsJsonEnricher() { 068 super(NAME); 069 } 070 071 @Override 072 public void write(JsonGenerator jg, DocumentModel document) throws IOException { 073 PermissionProvider permissionProvider = Framework.getService(PermissionProvider.class); 074 List<UserVisiblePermission> userVisiblePermissions = permissionProvider.getUserVisiblePermissionDescriptors(document.getType()); 075 076 jg.writeArrayFieldStart(NAME); 077 for (UserVisiblePermission permission : userVisiblePermissions) { 078 jg.writeString(permission.getId()); 079 } 080 jg.writeEndArray(); 081 } 082 083}