Vaadin6.4.9中文开发手册.docVIP

Vaadin 简介 略 Vaadin入门 本章将以一个实例来说明Vaddin的安装和工具使用，以及如何在Eclipse（Vaadin提供Eclipse等开发IDE的插件）下如何运行和调试。 安装 本章将对Vaadin包以及安装做个概述。安装有两种方式可选： 下载安装包 如果你使用Eclipse，可以安装Vaadin的Eclispe插件，“Eclipse下的Vaadin插件”章节会做详细介绍。 如果€使用Eclispe，可以安装安装包，然后导入“快速入门”项目到Eclipse下。你将可以运行并调试演示程序及包含的文档。 安装发布包 按照下面简单几步完成安装： 从/download/下载最新版的Vaadin安装包 用你系统中的压缩软件解压安装包到任意目录下（参考下例） 在Windows下，用默认ZIP解压程序解压安装包到你指定的目录下，如：C:\dev 警告 至少Windows XP默认的压缩软件和某些版本的WinRAR软件某些情况下无法解压安装包。解压后可能会出现类似“系统无法找到指定文件”的错误。这个错误产生的原因是由于压缩软件不支持长文件路径名，总长度超出256字符。此问题常发生在解压到桌面的时候。你可以尝试解压安装程序到C:\dev或一些短路径的目录下，再或者选择其他的压缩软件。 在Linux、Mac OS X和UNIX系列系统下用InfoZIP或其他ZIP程序用unzip vaadin-6.x.x.zip命令解压安装包 启动内容浏览器 当你在使用Vaadin的时候，内容浏览器（Content Browser）（没用过这个软件）是你最好的朋友。它允许你浏览文档和一些示例源码，以及演示程序。演示程序演示了大部分Vaadin的主要特性。你可以从Vaadin站点：/demo找到演示程序。 启动内容浏览器，运行Vaadin安装目录中的启动脚本。这将会启动一个独立的Web服务器，运行在本地主机的8888端口，使用网页浏览器输入地址http://localhost:8888/。 内容浏览器会你打开你系统中默认的网页浏览器。如果默认的浏览器与Vaadin的演示程序不兼容导致无法正常工作。在这种情况下，需要启动一个可被支持的浏览器并访问http://localhost:8888/ 如果内容浏览器启动失败，确认一下其他的服务没有占用8888端口。 JRE必须已安装 你必须安装了Java运行环境（JRE），否则执行批处理文件将发生错误并立即关闭。JRE可以从/javase/downloads/index.jsp处下载。 防火墙软件 本机启动内容浏览器可能会导致你的防火墙软件发出安全警告，原因是启动了WEB服务器。你需要允许内容浏览器连接8888端口 Windows 双击运行start.bat批处理文件图标，等待一会，直到Web服务器和网页浏览器已启动。 Linux / UNIX 略 Mac OS X 略 浏览器支持 Vaddin支持大多数常见浏览器，包括IE6—8，Firxfox3，Sarari3和Opera9.6。除了上述浏览器外，可从/features找到浏览器的支持情况 包内容 在安装根目录下，你可以找到start.bat（Windows）或start.sh（Linux和Mac）脚本文件启动内容浏览器，你可以运行演示程序，并阅读包中含有的文档。 图1.1 包内容 WebContent目录包含Vaadin所有相关文件。如果你不希望或者不能运行内容浏览器，你可以在网页浏览器中打开index.html文件查看安装包内容和文档。虽然这些示例程序并不可用。 release-notes.html文件包含了最新发布版本所作修改的内容介绍和发布历史。License子目录包含Vaadin的授权指南(licensing-guidelines.html)及其他类库的安装授权。安装目录根下的COPYING文件也包含了授权信息。Vaadin自己的库在WebContent/vaadin-6.x.x.jar。jar中包含了完整源码以及编译后的class文件。 WebContent/docs目录下包含了全部Vaadin文档，包括JavaDoc，API相关文档（api子目录）和该手册的HTML格式及PDF格式。 WebContent/WEB-INF目录下的src子目录下包含了实例程序的源码，lib子目录下包含所需类库。 GWT目录包含了完整的Google Web Toolkit安装包，包含所选操作系统的运行库（*.dll），完整的文档和示例。如果你打算为Vaadin编译客户端组件，那么你就需要GWT。（参考“自定义组件开发”章节） 此外，安装目录包含了可以作为Eclipse项目的所需文件，可以导入到Eclipse中。参考“用Eclispe快速入门”章