2 * This document is a part of the source code and related artifacts
3 * for CollectionSpace, an open source collections management system
4 * for museums and related institutions:
6 * http://www.collectionspace.org
7 * http://wiki.collectionspace.org
9 * Copyright 2009 University of California at Berkeley
11 * Licensed under the Educational Community License (ECL), Version 2.0.
12 * You may not use this file except in compliance with this License.
14 * You may obtain a copy of the ECL 2.0 License at
16 * https://source.collectionspace.org/collection-space/LICENSE.txt
18 * Unless required by applicable law or agreed to in writing, software
19 * distributed under the License is distributed on an "AS IS" BASIS,
20 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 * See the License for the specific language governing permissions and
22 * limitations under the License.
24 package org.collectionspace.services.authorization.storage;
26 import java.util.HashMap;
27 import java.util.List;
29 import org.collectionspace.services.common.document.DocumentNotFoundException;
30 import org.collectionspace.services.common.context.ServiceContext;
31 import org.collectionspace.services.common.context.ServiceContextProperties;
32 import org.collectionspace.services.common.storage.jpa.JpaRelationshipStorageClient;
33 import org.collectionspace.services.common.storage.jpa.JpaStorageUtils;
35 import org.collectionspace.services.authorization.Permission;
36 import org.collectionspace.services.authorization.PermissionRole;
37 import org.collectionspace.services.authorization.PermissionRoleRel;
38 import org.collectionspace.services.authorization.PermissionValue;
39 import org.collectionspace.services.authorization.Role;
40 import org.collectionspace.services.authorization.RoleResource;
41 import org.collectionspace.services.authorization.RoleValue;
42 import org.collectionspace.services.authorization.SubjectType;
44 import org.slf4j.Logger;
45 import org.slf4j.LoggerFactory;
47 // TODO: Auto-generated Javadoc
49 * The Class PermissionRoleUtil.
53 public class PermissionRoleUtil {
55 final Logger logger = LoggerFactory.getLogger(PermissionRoleUtil.class);
58 * Gets the relation subject.
61 * @return the relation subject
63 static SubjectType getRelationSubject(ServiceContext ctx) {
64 Object o = ctx.getProperty(ServiceContextProperties.SUBJECT);
66 throw new IllegalArgumentException(ServiceContextProperties.SUBJECT
67 + " property is missing in context "
70 return (SubjectType) o;
74 * Gets the relation subject.
78 * @return the relation subject
80 static SubjectType getRelationSubject(ServiceContext ctx, PermissionRole pr) {
81 SubjectType subject = pr.getSubject();
82 if (subject == null) {
83 //it is not required to give subject as URI determines the subject
84 subject = getRelationSubject(ctx);
90 * buildPermissionRoleRel builds persistent relationship entities from given
93 * @param pr permissionrole
94 * @param subject the subject
95 * @param prrl persistent entities built are inserted into this list
96 * @param toDelete the to delete
98 static public void buildPermissionRoleRel(PermissionRole pr,
100 List<PermissionRoleRel> prrl,
101 boolean handleDelete)
102 throws DocumentNotFoundException {
103 if (subject.equals(SubjectType.ROLE)) {
104 //FIXME: potential index out of bounds exception...negative test needed
105 PermissionValue pv = pr.getPermissions().get(0);
106 for (RoleValue rv : pr.getRoles()) {
107 PermissionRoleRel prr = buildPermissonRoleRel(pv, rv, subject, handleDelete);
110 } else if (SubjectType.PERMISSION.equals(subject)) {
111 //FIXME: potential index out of bounds exception...negative test needed
112 RoleValue rv = pr.getRoles().get(0);
113 for (PermissionValue pv : pr.getPermissions()) {
114 PermissionRoleRel prr = buildPermissonRoleRel(pv, rv, subject, handleDelete);
121 * Builds a permisson role relationship for either 'create' or 'delete'
123 * @param pv the pv (currently using only the ID)
124 * @param rv the rv (currently using only the ID)
125 * @param handleDelete the handle delete
126 * @return the permission role rel
128 static private PermissionRoleRel buildPermissonRoleRel(PermissionValue permissionValue,
131 boolean handleDelete)
132 throws DocumentNotFoundException {
134 PermissionRoleRel result = null;
137 // Ensure we can find both the Permission and Role to relate.
138 // FIXME: REM - This is a workaround until the Import utility creates Perm/Role relationships
139 // correctly. The import utility should create and store the permissions and roles BEFORE creating the relationships
141 PermissionValue pv = permissionValue;
143 Permission permission = (Permission)JpaStorageUtils.getEntity(pv.getPermissionId(),
145 if (permission != null) {
146 // If the permission already exists, then use it to fill our the relation record
147 pv = JpaRelationshipStorageClient.createPermissionValue(permission);
149 } catch (DocumentNotFoundException e) {
150 // ignore this exception, pv is set to permissionValue;
153 // Ensure we can find both the Permission and Role to relate.
154 // FIXME: REM - This is a workaround until the Import utility creates Perm/Role relationships
155 // correctly. The import utility should create and store the permissions and roles BEFORE creating the relationships
157 RoleValue rv = roleValue;
159 Role role = (Role)JpaStorageUtils.getEntity(rv.getRoleId(),
162 // If the role already exists, then use it to fill out the relation record
163 rv = JpaRelationshipStorageClient.createRoleValue(role);
165 } catch (DocumentNotFoundException e) {
166 // ignore this exception, rv is set to roleValue
169 result = new PermissionRoleRel();
170 result.setPermissionId(pv.getPermissionId());
171 result.setPermissionResource(pv.getResourceName());
172 result.setActionGroup(pv.getActionGroup());
173 result.setRoleId(rv.getRoleId());
174 result.setRoleName(rv.getRoleName());
176 // For 'delete' we need to set the hjid of the existing relstionship
178 String relationshipId = null;
179 if (subject.equals(SubjectType.ROLE) == true) {
180 relationshipId = roleValue.getRoleRelationshipId();
181 } else if (subject.equals(SubjectType.PERMISSION) == true) {
182 relationshipId = permissionValue.getPermRelationshipId();
184 if (relationshipId != null && handleDelete == true) {
185 result.setHjid(Long.parseLong(relationshipId)); // set this so we can convince JPA to del the relation
192 * Checks if is invalid tenant.
194 * @param tenantId the tenant id
195 * @param msgBldr the msg bldr
196 * @return true, if is invalid tenant
198 static boolean isInvalidTenant(String tenantId, StringBuilder msgBldr) {
199 boolean invalid = false;
201 if (tenantId == null || tenantId.isEmpty()) {
203 msgBldr.append("\n tenant : tenantId is missing");
205 String whereClause = "where id = :id";
206 HashMap<String, Object> params = new HashMap<String, Object>();
207 params.put("id", tenantId);
209 Object tenantFound = JpaStorageUtils.getEntity(
210 "org.collectionspace.services.account.Tenant", whereClause, params);
211 if (tenantFound == null) {
213 msgBldr.append("\n tenant : tenantId=" + tenantId