View Javadoc

1   /**
2    * This file Copyright (c) 2008-2011 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.module.rssaggregator.importhandler;
35  
36  import static java.lang.String.format;
37  import info.magnolia.jcr.util.PropertyUtil;
38  import info.magnolia.module.rssaggregator.util.ContentMapper;
39  
40  import javax.jcr.Node;
41  import javax.jcr.RepositoryException;
42  
43  /**
44   * Maps a content node defining a feed channel to an actual {@link FeedChannel}.
45   *
46   * @author Rob van der Linden Vooren
47   */
48  public class FeedChannelContentMapper implements ContentMapper<FeedChannel> {
49  
50      /**
51       * Map a content node defining a feed channel to an actual {@link FeedChannel}. If the content node does not have
52       * <code>link</code> node data, <code>null</code> is returned.
53       * <p/>
54       * Furthermore, {@link String#trim() trimming} occurs on the <code>link</code> and <code>title</code> node data
55       * values.
56       *
57       * @param feedChannelNode the content node defining a feed channel
58       * @return a feed channel mapped from the given <code>feedNode</code> when mapped succesful, <code>null</code> if
59       *         the content node does not have <code>link</code> node data
60       * @throws RepositoryException      when an exception occurs
61       * @throws IllegalArgumentException when <code>link</code> or <code>title</code> node data are blank
62       */
63      public FeedChannel map(Node feedChannelNode) throws RepositoryException {
64          if (!feedChannelNode.hasProperty("link")) {
65              return null;
66          }
67          // prefix channel name to prevent xpath query issues that occur when node names start with numbers
68          String name = format("channel-%s", feedChannelNode.getName());
69          String trimmedUrl = PropertyUtil.getString(feedChannelNode,"link").trim();
70          String trimmedTitle = PropertyUtil.getString(feedChannelNode,"title").trim();
71          return new FeedChannel(name, trimmedUrl, trimmedTitle);
72      }
73  
74  }