1 files changed, 188 insertions, 0 deletions
diff --git a/server/src/com/vaadin/terminal/ClassResource.java b/server/src/com/vaadin/terminal/ClassResource.java
new file mode 100644
index 0000000000..e4921f2413
--- /dev/null
+++ b/server/src/com/vaadin/terminal/ClassResource.java
@@ -0,0 +1,188 @@
+/* 
+ * Copyright 2011 Vaadin Ltd.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ * 
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations under
+ * the License.
+ */
+
+package com.vaadin.terminal;
+
+import java.io.Serializable;
+
+import com.vaadin.Application;
+import com.vaadin.service.FileTypeResolver;
+
+/**
+ * <code>ClassResource</code> is a named resource accessed with the class
+ * loader.
+ * 
+ * This can be used to access resources such as icons, files, etc.
+ * 
+ * @see java.lang.Class#getResource(java.lang.String)
+ * 
+ * @author Vaadin Ltd.
+ * @since 3.0
+ */
+@SuppressWarnings("serial")
+public class ClassResource implements ApplicationResource, Serializable {
+
+    /**
+     * Default buffer size for this stream resource.
+     */
+    private int bufferSize = 0;
+
+    /**
+     * Default cache time for this stream resource.
+     */
+    private long cacheTime = DEFAULT_CACHETIME;
+
+    /**
+     * Associated class used for indetifying the source of the resource.
+     */
+    private final Class<?> associatedClass;
+
+    /**
+     * Name of the resource is relative to the associated class.
+     */
+    private final String resourceName;
+
+    /**
+     * Application used for serving the class.
+     */
+    private final Application application;
+
+    /**
+     * Creates a new application resource instance. The resource id is relative
+     * to the location of the application class.
+     * 
+     * @param resourceName
+     *            the Unique identifier of the resource within the application.
+     * @param application
+     *            the application this resource will be added to.
+     */
+    public ClassResource(String resourceName, Application application) {
+        this(application.getClass(), resourceName, application);
+    }
+
+    /**
+     * Creates a new application resource instance.
+     * 
+     * @param associatedClass
+     *            the class of the which the resource is associated.
+     * @param resourceName
+     *            the Unique identifier of the resource within the application.
+     * @param application
+     *            the application this resource will be added to.
+     */
+    public ClassResource(Class<?> associatedClass, String resourceName,
+            Application application) {
+        this.associatedClass = associatedClass;
+        this.resourceName = resourceName;
+        this.application = application;
+        if (resourceName == null || associatedClass == null) {
+            throw new NullPointerException();
+        }
+        application.addResource(this);
+    }
+
+    /**
+     * Gets the MIME type of this resource.
+     * 
+     * @see com.vaadin.terminal.Resource#getMIMEType()
+     */
+    @Override
+    public String getMIMEType() {
+        return FileTypeResolver.getMIMEType(resourceName);
+    }
+
+    /**
+     * Gets the application of this resource.
+     * 
+     * @see com.vaadin.terminal.ApplicationResource#getApplication()
+     */
+    @Override
+    public Application getApplication() {
+        return application;
+    }
+
+    /**
+     * Gets the virtual filename for this resource.
+     * 
+     * @return the file name associated to this resource.
+     * @see com.vaadin.terminal.ApplicationResource#getFilename()
+     */
+    @Override
+    public String getFilename() {
+        int index = 0;
+        int next = 0;
+        while ((next = resourceName.indexOf('/', index)) > 0
+                && next + 1 < resourceName.length()) {
+            index = next + 1;
+        }
+        return resourceName.substring(index);
+    }
+
+    /**
+     * Gets resource as stream.
+     * 
+     * @see com.vaadin.terminal.ApplicationResource#getStream()
+     */
+    @Override
+    public DownloadStream getStream() {
+        final DownloadStream ds = new DownloadStream(
+                associatedClass.getResourceAsStream(resourceName),
+                getMIMEType(), getFilename());
+        ds.setBufferSize(getBufferSize());
+        ds.setCacheTime(cacheTime);
+        return ds;
+    }
+
+    /* documented in superclass */
+    @Override
+    public int getBufferSize() {
+        return bufferSize;
+    }
+
+    /**
+     * Sets the size of the download buffer used for this resource.
+     * 
+     * @param bufferSize
+     *            the size of the buffer in bytes.
+     */
+    public void setBufferSize(int bufferSize) {
+        this.bufferSize = bufferSize;
+    }
+
+    /* documented in superclass */
+    @Override
+    public long getCacheTime() {
+        return cacheTime;
+    }
+
+    /**
+     * Sets the length of cache expiration time.
+     * 
+     * <p>
+     * This gives the adapter the possibility cache streams sent to the client.
+     * The caching may be made in adapter or at the client if the client
+     * supports caching. Zero or negavive value disbales the caching of this
+     * stream.
+     * </p>
+     * 
+     * @param cacheTime
+     *            the cache time in milliseconds.
+     * 
+     */
+    public void setCacheTime(long cacheTime) {
+        this.cacheTime = cacheTime;
+    }
+}