View Javadoc

1   /**
2    * This file Copyright (c) 2003-2010 Magnolia International
3    * Ltd.  (http://www.magnolia-cms.com). All rights reserved.
4    *
5    *
6    * This file is dual-licensed under both the Magnolia
7    * Network Agreement and the GNU General Public License.
8    * You may elect to use one or the other of these licenses.
9    *
10   * This file is distributed in the hope that it will be
11   * useful, but AS-IS and WITHOUT ANY WARRANTY; without even the
12   * implied warranty of MERCHANTABILITY or FITNESS FOR A
13   * PARTICULAR PURPOSE, TITLE, or NONINFRINGEMENT.
14   * Redistribution, except as permitted by whichever of the GPL
15   * or MNA you select, is prohibited.
16   *
17   * 1. For the GPL license (GPL), you can redistribute and/or
18   * modify this file under the terms of the GNU General
19   * Public License, Version 3, as published by the Free Software
20   * Foundation.  You should have received a copy of the GNU
21   * General Public License, Version 3 along with this program;
22   * if not, write to the Free Software Foundation, Inc., 51
23   * Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
24   *
25   * 2. For the Magnolia Network Agreement (MNA), this file
26   * and the accompanying materials are made available under the
27   * terms of the MNA which accompanies this distribution, and
28   * is available at http://www.magnolia-cms.com/mna.html
29   *
30   * Any modifications to this file must keep this entire header
31   * intact.
32   *
33   */
34  package info.magnolia.cms.security;
35  
36  import java.util.ArrayList;
37  import java.util.Collection;
38  
39  import info.magnolia.cms.beans.config.ContentRepository;
40  import info.magnolia.cms.core.Content;
41  import info.magnolia.cms.core.ItemType;
42  import info.magnolia.cms.core.HierarchyManager;
43  import info.magnolia.context.MgnlContext;
44  
45  import org.slf4j.Logger;
46  import org.slf4j.LoggerFactory;
47  
48  import javax.jcr.PathNotFoundException;
49  
50  
51  /**
52   * @author Sameer Charles $Id: MgnlGroupManager.java 33092 2010-03-19 21:13:50Z gjoseph $
53   */
54  public class MgnlGroupManager implements GroupManager {
55      private static final Logger log = LoggerFactory.getLogger(MgnlGroupManager.class);
56  
57      /**
58       * Create a group
59       * @param name
60       * @return newly created group
61       * @throws UnsupportedOperationException if the implementation does not support writing
62       * @throws AccessDeniedException if logged in repository user does not sufficient rights
63       */
64      public Group createGroup(String name) throws UnsupportedOperationException, AccessDeniedException {
65          try {
66              Content node = getHierarchyManager().createContent("/", name, ItemType.GROUP.getSystemName());
67              getHierarchyManager().save();
68              return newGroupInstance(node);
69          }
70          catch (Exception e) {
71              log.error("can't create group [" + name + "]", e);
72              return null;
73          }
74      }
75  
76      /**
77       * Get group by the given name
78       * @param name
79       * @return group
80       * @throws UnsupportedOperationException if the implementation does not support writing
81       * @throws AccessDeniedException if logged in repository user does not sufficient rights
82       */
83      public Group getGroup(String name) throws UnsupportedOperationException, AccessDeniedException {
84          try {
85              return newGroupInstance(getHierarchyManager().getContent(name));
86          } catch (PathNotFoundException e) {
87              // this is not an error, once we have MAGNOLIA-1757 implemented we can change this.
88              log.warn("can't find group [" + name + "] in magnolia");
89              log.debug("can't find group [" + name + "] in magnolia", e);
90          } catch (AccessDeniedException e) {
91              throw e;
92          } catch (Throwable e) {
93              log.error("Exception while retrieving group", e);
94          }
95          return null;
96      }
97  
98      /**
99       * All groups
100      */
101     public Collection<Group> getAllGroups() {
102         Collection<Group> groups = new ArrayList<Group>();
103         try {
104             Collection<Content> nodes = getHierarchyManager().getRoot().getChildren(ItemType.GROUP);
105             for (Content node : nodes) {
106                 groups.add(newGroupInstance(node));
107             }
108         }
109         catch (Exception e) {
110             log.error("can't find user");
111         }
112         return groups;
113     }
114 
115     protected Group newGroupInstance(Content node) {
116         return new MgnlGroup(node);
117     }
118 
119     /**
120      * return the groups HierarchyManager (through the system context)
121      */
122     protected HierarchyManager getHierarchyManager() {
123         return MgnlContext.getSystemContext().getHierarchyManager(ContentRepository.USER_GROUPS);
124     }
125 }