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.module.files;
35  
36  import info.magnolia.cms.core.Content;
37  import info.magnolia.cms.core.HierarchyManager;
38  import info.magnolia.cms.core.NodeData;
39  import info.magnolia.cms.util.ContentUtil;
40  import info.magnolia.cms.util.NodeDataUtil;
41  import org.apache.commons.codec.binary.Hex;
42  
43  import javax.jcr.RepositoryException;
44  import java.io.File;
45  import java.io.FileInputStream;
46  import java.io.IOException;
47  import java.io.InputStream;
48  import java.io.OutputStream;
49  import java.security.DigestInputStream;
50  import java.security.DigestOutputStream;
51  import java.security.MessageDigest;
52  import java.security.NoSuchAlgorithmException;
53  
54  /**
55   * A FileExtractorOperation which checks extracted files against an MD5 checksum
56   * stored in the repository. If the checksum does not exist or is identical to the
57   * file being extracted, the file is extracted and potentially overwrites the
58   * existing one. If not, which means the file was modified by the user,
59   * the operation is cancelled.
60   *
61   * TODO : what to do with removed files ? should probably be the responsibility of a different Task.
62   *
63   *
64   * @author gjoseph
65   * @version $Revision: $ ($Author: $)
66   */
67  class MD5CheckingFileExtractorOperation extends BasicFileExtractorOperation {
68      private final FileExtractionLogger log;
69      private final HierarchyManager hm;
70  
71      MD5CheckingFileExtractorOperation(FileExtractionLogger log, HierarchyManager hm, String resourcePath, String absoluteTargetPath) {
72          super(resourcePath, absoluteTargetPath);
73          this.log = log;
74          this.hm = hm;
75      }
76  
77      protected InputStream checkInput() throws IOException {
78          return wrap(super.checkInput());
79      }
80  
81      // TODO : behaviour: overwrite, log, backup, .. ?
82      protected File checkOutput() throws IOException {
83          final File out = super.checkOutput();
84  
85          if (out.exists()) {
86              // check md5 of the existing file
87              final InputStream stream = new FileInputStream(out);
88              final String existingFileMD5 = calculateMD5(stream);
89  
90              // check repository md5
91              final NodeData repoMD5prop = getRepositoryNode().getNodeData("md5");
92              if (repoMD5prop.isExist()) {
93                  final String repoMD5 = repoMD5prop.getString();
94                  if (existingFileMD5.equals(repoMD5)) {
95                      // resourcePath was found, with correct md5 in repo : repoMD5
96                      return out;
97                  } else {
98                      log.error("Can't extract " + resourcePath + " as this file was probably modified locally: expected MD5 [" + repoMD5 + "] but current MD5 is [" + existingFileMD5 + "].");
99                      return null;
100                 }
101             }
102             // resourcePath was found, but no md5 found in repo ...
103         } else {
104             // resourcePath does not exist yet, extracting ...
105         }
106         return out;
107     }
108 
109     protected OutputStream openOutput(File outFile) throws IOException {
110         final OutputStream outputStream = super.openOutput(outFile);
111         final MessageDigest md5 = getMessageDigest();
112         return new DigestOutputStream(outputStream, md5);
113     }
114 
115     protected void copyAndClose(InputStream in, OutputStream out) throws IOException {
116         super.copyAndClose(in, out);
117 
118         final DigestInputStream md5Stream = (DigestInputStream) in;
119         final String newMD5 = retrieveMD5(md5Stream);
120 
121         try {
122             NodeDataUtil.getOrCreate(getRepositoryNode(), "md5").setValue(newMD5);
123         } catch (RepositoryException e) {
124             throw new RuntimeException(e); // TODO
125         }
126         //TODO save .. ?
127     }
128 
129     protected Content getRepositoryNode() {
130         try {
131             final String repoPath = getRepositoryPath(resourcePath);
132             final Content node;
133             if (!hm.isExist(repoPath)) {
134                 node = ContentUtil.createPath(hm, repoPath);
135             } else {
136                 node = hm.getContent(repoPath);
137             }
138             return node;
139         } catch (RepositoryException e) {
140             throw new RuntimeException(e); // TODO
141         }
142     }
143 
144     /**
145      * Returns the path to the node that has the property with this resource's MD5.
146      * TODO : implement properly + test
147      */
148     protected String getRepositoryPath(String resourcePath) {
149         return "/server/install" + resourcePath;
150     }
151 
152     /**
153      * Completely reads an InputStream and returns its MD5.
154      * TODO : should we close it?
155      */
156     protected String calculateMD5(InputStream stream) throws IOException {
157         final DigestInputStream md5Stream = wrap(stream);
158         byte[] buffer = new byte[1024];
159         while (md5Stream.read(buffer) != -1) {
160         }
161 
162         return retrieveMD5(md5Stream);
163     }
164 
165     protected DigestInputStream wrap(InputStream stream) {
166         final MessageDigest md5 = getMessageDigest();
167         return new DigestInputStream(stream, md5);
168     }
169 
170     protected String retrieveMD5(DigestInputStream md5Stream) {
171         final byte[] digInBytes = md5Stream.getMessageDigest().digest();
172         return String.valueOf(Hex.encodeHex(digInBytes));
173     }
174 
175     protected MessageDigest getMessageDigest() {
176         try {
177             return MessageDigest.getInstance("MD5");
178         } catch (NoSuchAlgorithmException e) {
179             throw new RuntimeException("Can't check files with md5: " + e.getMessage(), e);
180         }
181     }
182 }