Vaadin Web应用开发教程(6):使用资源

Web应用使用多种资源，比如图像或是供下载的文件。Vaadin中的Embeded UI通常显示图像而Link提供可供下载的文件，其它的UI组件，比如TabSheet可以使用图标资源。

Web服务器通常无需Application对象的帮助就可以处理对静态资源的请求，对于一些可以动态生成的资源（图像，或文件等）Application则需动态创建这些资源。Vaadin支持多种资源类型的创建，比如动态创建文件。

下图为Vaadin提供的资源管理的接口类：

Vaadin提供两大类资源接口，一为通用的资源Resource接口，另外一个为特定的应用程序资源ApplicationResource.

应用程序资源ApplicationResource的管理是通过Application对象来完成的。当创建该类资源时，Application对象做为构造函数的参数传入。构造函数使用addResource向Application对象注册该资源。

Application对象提供URI来管理对资源的访问。URI的基本格式为 “APP/”+resourceid+”/”+filename, 其中resourceid 为自动生成的用于唯一指定资源的ID号。

文件资源(File Resources) 文件资源指文件系统的文件，一般可以分为两种，供显示的图像和供下载的文件。 可以使用标准的java.io.File API来访问文件。可以使用相对路径或是绝对路径来访问某个文件。

包资源 (Class Loader Resources) 随打包文件.war 打包的文件中可以包含图像等资源，此时可以通过ClassLoader 来访问这些资源文件。比如下面代码使用ClassLoader 来访问打包文件中的一个图像资源。

mainwindow.addComponent(new Embedded ("",
        new ClassResource("smiley.jpg",
                  mainwindow.getApplication())));

主题资源 (Theme Resources) 由类ThemeResource 管理的主题资源文件，通常为一些图像文件。Vaadin的主题在项目中存放在目录VAADIN/themes/themename 下。下面代码片段用来获取当前主题的一个图像资源。

// A theme resource in the current theme ("book-examples")
// Located in: VAADIN/themes/book-examples/img/themeimage.png
ThemeResource resource = new ThemeResource("img/themeimage.png");

// Use the resource
Embedded image = new Embedded("My Theme Image", resource);

对应项目资源目录如下图：

关于资源的详细使用将在后面的文章中介绍。

流资源(Stream Resources) 使用流资源允许应用动态创建资源。比如动态创建图表。可以通过实现StreamResource.StreamSource 接口来定义一个流资源。这个方法返回一个InputStream。

下面的例子动态创建一个PNG图像。

import java.awt.image.*;

public class MyImageSource
             implements StreamResource.StreamSource {
    ByteArrayOutputStream imagebuffer = null;
    int reloads = 0;

    /* We need to implement this method that returns
     * the resource as a stream. */
    public InputStream getStream () {
        /* Create an image and draw something on it. */
        BufferedImage image = new BufferedImage (200, 200,
                               BufferedImage.TYPE_INT_RGB);
        Graphics drawable = image.getGraphics();
        drawable.setColor(Color.lightGray);
        drawable.fillRect(0,0,200,200);
        drawable.setColor(Color.yellow);
        drawable.fillOval(25,25,150,150);
        drawable.setColor(Color.blue);
        drawable.drawRect(0,0,199,199);
        drawable.setColor(Color.black);
        drawable.drawString("Reloads="+reloads, 75, 100);
        reloads++;

        try {
            /* Write the image to a buffer. */
            imagebuffer = new ByteArrayOutputStream();
            ImageIO.write(image, "png", imagebuffer);

            /* Return a stream from the buffer. */
            return new ByteArrayInputStream(
                         imagebuffer.toByteArray());
        } catch (IOException e) {
            return null;
        }
    }
}

使用资源的方法可以多种多样。某些UI组件比如Embeded,Link 可以直接使用资源作为参数。
下面代码使用MyImageSource 作为Embeded 的图像资源。

// Create an instance of our stream source.
StreamResource.StreamSource imagesource = new MyImageSource ();

// Create a resource that uses the stream source and give it a name.
// The constructor will automatically register the resource in
// the application.
StreamResource imageresource =
        new StreamResource(imagesource, "myimage.png", this);

// Create an embedded component that gets its contents
// from the resource.
main.addComponent(new Embedded("Image title", imageresource));

显示结果如下：

这个资源我们取名为myimage.png ,Application对象为其添加一个资源ID使得资源标识唯一。 此时可以通过http://localhost:8080/testbench/APP/1/myimage.png 来访问这个图像。 其中APP/1/myimage.png 为资源的相对路径，可以通过方法Application.getRelativeLocation()来取得资源的相对路径。