source/mircoders/media/MediaHandlerGeneric.java

   1 /*
   2  * Copyright (C) 2001, 2002 The Mir-coders group
   3  *
   4  * This file is part of Mir.
   5  *
   6  * Mir is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * Mir is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with Mir; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  19  *
  20  * In addition, as a special exception, The Mir-coders gives permission to link
  21  * the code of this program with  any library licensed under the Apache Software License,
  22  * The Sun (tm) Java Advanced Imaging library (JAI), The Sun JIMI library
  23  * (or with modified versions of the above that use the same license as the above),
  24  * and distribute linked combinations including the two.  You must obey the
  25  * GNU General Public License in all respects for all of the code used other than
  26  * the above mentioned libraries.  If you modify this file, you may extend this
  27  * exception to your version of the file, but you are not obligated to do so.
  28  * If you do not wish to do so, delete this exception statement from your version.
  29  */
  30 package  mircoders.media;
  31
  32 import mir.config.MirPropertiesConfiguration;
  33 import mir.entity.Entity;
  34 import mir.log.LoggerWrapper;
  35 import mir.media.MediaExc;
  36 import mir.media.MediaFailure;
  37 import mir.misc.StringUtil;
  38 import mir.session.UploadedFile;
  39 import mir.util.IORoutines;
  40
  41 import javax.servlet.ServletContext;
  42 import java.io.FileInputStream;
  43 import java.io.FileOutputStream;
  44 import java.io.InputStream;
  45
  46
  47 /**
  48  * This is the Generic MediaHandler. It stores the media data on
  49  * the filesystem and keeps basic metadata  (size, type...) in the
  50  * DB. Usually only representation needs to be overridden.
  51  * See the MediaHandlerAudio class to see an example of how one
  52  * could override it.
  53  * <p>
  54  * Most media handlers should override this class.
  55  * <p>
  56  * In theory, it could be used to handle miscellaneous media that
  57  * we don't have entered in the media_type table, (like RTF documents,
  58  * PS, PDF, etc..)
  59  * <p>
  60  * Of course it implements the MirMediaHandler interface.
  61  *
  62  * @see mir.media.MediaHandler
  63  * @author mh <mh@nadir.org>
  64  * @version $Id: MediaHandlerGeneric.java,v 1.20.2.9 2005/08/21 17:09:23 zapata Exp $
  65  */
  66
  67 public class MediaHandlerGeneric extends AbstractMediaHandler {
  68   protected static MirPropertiesConfiguration configuration = MirPropertiesConfiguration.instance();
  69
  70   protected LoggerWrapper logger = new LoggerWrapper("Media.Generic");
  71
  72   /** {@inheritDoc} */
  73   public void store(UploadedFile anUploadedFile, Entity aMedia, Entity aMediaType) throws MediaExc, MediaFailure {
  74     try {
  75       anUploadedFile.writeToFile(getMediaStorageFile(aMedia, aMediaType));
  76       aMedia.setFieldValue("publish_path", getRelativeMediaStoragePath(aMedia, aMediaType));
  77       aMedia.setFieldValue("size", Long.toString(getMediaStorageFile(aMedia, aMediaType).length()));
  78       aMedia.update();
  79     }
  80     catch (Throwable e) {
  81       logger.error("MediaHandlerGeneric.set: " + e.toString());
  82       throw new MediaFailure(e);
  83     }
  84   }
  85
  86   /** {@inheritDoc} */
  87   public void store(InputStream anInputStream, Entity aMedia, Entity aMediaType) throws MediaExc, MediaFailure {
  88     try {
  89       IORoutines.copyStream(anInputStream, new FileOutputStream(getMediaStorageFile(aMedia, aMediaType)));
  90
  91       aMedia.setFieldValue("publish_path", getRelativeMediaStoragePath(aMedia, aMediaType));
  92       aMedia.setFieldValue("size", Long.toString(getMediaStorageFile(aMedia, aMediaType).length()));
  93       aMedia.update();
  94     }
  95     catch (Throwable e) {
  96       logger.error("MediaHandlerGeneric.set: " + e.toString());
  97       throw new MediaFailure(e);
  98     }
  99   }
 100
 101   /** {@inheritDoc} */
 102   public void produce(Entity aMedia, Entity aMediaType) throws MediaExc, MediaFailure {
 103     if (!getMediaStorageFile(aMedia, aMediaType).exists()) {
 104       throw new MediaExc("error in producing media:: " + getMediaStorageFile(aMedia, aMediaType) + " does not exist!");
 105     }
 106   }
 107
 108   /** {@inheritDoc} */
 109   public InputStream getMedia(Entity aMedia, Entity aMediaType) throws MediaExc, MediaFailure {
 110     try {
 111       return new FileInputStream(getMediaStorageFile(aMedia, aMediaType));
 112     }
 113     catch (Throwable e) {
 114       throw new MediaFailure("MediaHandlerGeneric.getMedia(): " + e.toString(), e);
 115     }
 116   }
 117
 118   public InputStream getThumbnail(Entity ent) throws MediaExc, MediaFailure {
 119     return null;
 120   }
 121
 122   public String getThumbnailMimeType(Entity aMediaEntity, Entity aMediaType) throws MediaExc, MediaFailure {
 123     ServletContext servletContext = MirPropertiesConfiguration.getContext();
 124     String fileName = aMediaEntity.getId() + "." + aMediaType.getFieldValue("name");
 125
 126     return servletContext.getMimeType(fileName);
 127   }
 128
 129   public String getBaseStoragePath() {
 130     return configuration.getString("Producer.Media.Path");
 131   }
 132
 133   public String getBaseIconStoragePath() {
 134     return configuration.getString("Producer.Image.IconPath");
 135   }
 136
 137   public String getPublishHost() {
 138     return StringUtil.removeSlash(configuration.getString("Producer.Media.Host"));
 139   }
 140
 141   public String getTinyIconName() {
 142     return configuration.getString("Producer.Icon.TinyText");
 143   }
 144
 145   public String getBigIconName() {
 146     return configuration.getString("Producer.Icon.BigText");
 147   }
 148
 149   public String getIconAltName() {
 150     return "Generic media";
 151   }
 152
 153   public String getDescr(Entity mediaType) {
 154     return mediaType.getFieldValue("mime_type");
 155   }
 156
 157 }
 158
 159
 160