第19章. 微软的Excel 电子表格应用程序支持

第19章. 微软的Excel 电子表格应用程序支持

 

Seam也支持微软的Excel ?电子表格应用程序的电子表格生成，通过卓越的JExcelAPI库。生成的文档是与微软的Excel ?电子表格应用程序95, 97, 2000, XP and 2003版兼容的。 目前库功能的一个有限子集被暴露，但是最终目标是能做库允许的任何事情。有关其能力和局限性更多的信息请参考JExcelAPI文档

 

19.1. 微软的Excel ?电子表格应用程序支持

 

微软的Excel ?电子表格应用程序jboss-seam-excel.jar。这个JAR包含微软的Excel ?电子表格应用程序JSF控件， 其常被用来构建可以渲染文档的视窗，以及DocumentStore组件，其提供渲染的文档给用户。 为了包括微软的Excel ?电子表格应用程序支持在你的应用程序中， 连同jxl.jar文件 和jboss-seam-excel.jar文件包含在你的WEB-INF/lib目录中。此别，你需要在你的web.xml文件中配置DocumentStore servlet 。

微软的Excel ?电子表格应用程序Seam模块需要作为视窗技术的Facelets的使用。还加上，它需要seam-ui包的使用。

examples/excel项目在实践中包含了一个微软的Excel ?电子表格应用程序支持例子。它演示了正确地部署包，并且也显示了暴露的功能。

支持其它类的微软的Excel ?电子表格应用程序的电子表格API的自定义模块变得非常容易。实现工作簿接口，并在components.xml中注册。

 

<excel:excelFactory>

 

   <property name=”implementations”>

 

      <key>myExcelExporter</key>

 

      <value>my.excel.exporter.ExcelExport</value>

 

   </property>

 

</excel:excelFactory>

 

并用组件标签注册excel命名空间

xmlns:excel=http://jboss.com/products/seam/excel

然后，设置UIWorkbook类型到myExcelExporter ，那么你自己的输入器就会被使用。默认是”jxl”，但使用类型”csv”，增加了对CSV（Comma Separated value）的支持。

看章节18.6 “配置iText”有关怎么配置文档servlet支持.xls文档的信息。

如果你在IE下（尤其对https）访问生成的文件有问题，确定你在浏览器中没有使用了严格的约束(看http://www.nwnetworks.com/iezones.htm/)，在web.xml中也没有太严格的安全约束，或者两者的组合。

 

19.2. 创建一个简单的工作薄

工作表支持的基本用法是简单； 它使用了熟悉的<h:dataTable>，并且你能绑定一个List, Set, Map, Array或者DataModel。

             <e:workbook xmlns:e=”http://jboss.com/products/seam/excel”>

 

                                  <e:worksheet>

 

                  <e:cell column=”0” row=”0” value=”Hello world!”/>

 

               </e:worksheet>

 

            </e:workbook>

 

这是非常无用的，所以让我们看一个更通用的案例：

 

                 <e:workbook xmlns:e=”http://jboss.com/products/seam/excel”>

 

 

                       <e:worksheet value=”#{data}” var=”item”>

 

                           <e:column>

 

                                <e:cell value=”#{item.value}”/>

 

                  </e:column>

 

               </e:worksheet>

 

</e:workbook>

 

首先我们有一个顶级的工作簿元素，它作为容器提供，并且没有任何属性。 子元素工作表有两个属性； value=”#{data}” 是EL绑定到数据， var=”item” 是当前项目的名字。嵌套在工作表内的是一个单列，并且它内部的单元最终绑定了在当前迭代项目内的数据。

 

这就是你知道得开始转储你的数据到工作表的全部了。

 

19.3. 工作簿

工作簿是工作表和样式表链接的顶层父类。

 

<e:workbook>

属性 ·         type —使用的输出模块定义。其值是字符串，可以是"jxl" or "csv"之一。默认是"jxl"。 ·         templateURI —一个模板，应使用来作为工作表的基础，值是一个字符串（URL）。 ·         arrayGrowSize —内存数量，通过它增加分配来存储工作簿数据的内存数量。对于在一个WAS内部读取许多小工作簿的进程，减少默认大小可能是有必要的，默认值是一兆字节。值是一个数（字节）。 ·         autoFilterDisabled —自动过滤将禁止吗？值为一个布尔值。 ·         cellValidationDisabled —单元格校验将忽略吗？值为一个布尔值。 ·         characterSet —字符集。这只在电子表格读取时使用，在写入时无效。值是一个字符串（字符集编码）。 ·         drawingsDisabled —制图将禁止吗？值为一个布尔值。 ·         excelDisplayLanguage —语言，产生的文件显示使用。值是一个字符串(两个字符ISO 3166国家代码)。 ·         excelRegionalSettings —产生的excel文件的区域设置值是一个字符串(两个字符ISO 3166国家代码)。 ·         formulaAdjust —公式将调整吗？值是一个布尔值。 ·         gcDisabled —垃圾回收将禁止吗？值是一个布尔值。 ·         ignoreBlanks —忽略空格吗？值是一个布尔值。 ·         initialFileSize —在读取工作表时，分配来存储工作簿数据的初始内存数量。对于在一个WAS内部读取许多小工作簿的进程，减少默认大小可能是有必要的，默认值是五兆字节。值是一个数（字节）。 ·         locale —使用的地区，通过JExcelApi产生电子表格。涉及到产生的excel文件的语言和区域时，设置此值是无效的。值是一个字符串。 ·         mergedCellCheckingDisabled —合并单元格检查将禁止吗？值是一个布尔值。 ·         namesDisabled —处理的名字将禁止吗？值是一个布尔值。 ·         propertySets —所有属性集随工作被拷贝将启用（比如宏）吗？放弃启用这个功能会导致JXL处理使用更多的内存。值是一个布尔值。 ·         rationalization —在写下表之前，单元格格式将被合理化吗？值是一个布尔值。默认为true。 ·         supressWarnings —警告将被抑制吗？ 由于在登录版2.4的改变，现在，这会对跨越JVM（依赖于使用的注册器的类型）行为设置警告。值是一个布尔值 ·         temporaryFileDuringWriteDirectory —与useTemporaryFileDuringWrite 设置联合使用来设置临时对象目录。此值可以为空，在这种情况，常规系统使用默认目录代替。值是一个字符串（临时文件将写入的目录） ·         useTemporaryFileDuringWrite —在产生工作簿期间临时文件将被使用。如果没有使用，工作簿会完全运行在内存。设置这个标志涉及到内存使用和性能之间的权衡评估。值是一个布尔值。 ·         workbookProtected —工作簿将被保护吗？值是一个布尔值。 ·         filename —用来下载的文件名。值是一个字符串。如果你映射DocumentServlet到一些模板，此文件的扩展名也必须匹配，请不要这样。 ·         exportKey —一个key，根据它在事件作用域中存储结果数据到一个DocumentData对象。 子元素 ·         <e:link/> —零或多个样式表链接。 (见章节Section 19.14.1, “样式表链接” )。 ·         <e:worksheet/> —零或多个工作簿。(见章节 19.4, “工作簿” )。 Facets ·         无

            <e:workbook>

               <e:worksheet>

                  <e:cell value="Hello World" row="0" column="0"/>

               </e:worksheet>

            <e:workbook>

定义用一个工作表定义一个工作簿，并且一个问候名放在A1单元。

19.4. 工作表

工作表是工作簿的孩子，又是列的父亲，并且它们也可以包含工作表命令明确地设置单元、公式、图象和超链接。它们是构成工作簿的页面。

<e:worksheet>

·         value —一个返回数据的EL表达式。值是一个字符串。这个表达式的目的是审查一个可迭代。注意，如果目标是一个映射，迭代是越过Map.Entry entrySet()执行, 所经在你的引用中你应该使用一个.key或 .value到目标 。 ·         var —当前行的迭代器变量名，稍后可以在单元格值属性中引用。值是一个字符串。 ·         name —工作表名。值是一个字符串。默认成Sheet#，这儿#是该工作表的索引。如果给定的工作表名存在，这个表被选定。这可以用来合并几个数据集到单一的工作表，只要为它们定义同样的名字就可以了（使用startRow 和 startCol确保它们不占据同样的空间）。 ·         startRow —定义数据的开始行。值为数字。用来设置数据在与左上角相比较的其它地方（如果单一工作表有多个数据集，尤其有用）。默认值为0。 ·         startColumn —定义数据的开始列。值为数字。用来设置数据在与左上角相比较的其它地方（如果单一工作表有多个数据集，尤其有用）。默认值为0。 ·         automaticFormulaCalculation —公式将要自动计算吗？值为一个布尔值。 ·         bottomMargin —下边距。值为数字（inches）。 ·         copies —复制的份数。值为数字。 ·         defaultColumnWidth —默认的列宽。值为数字（字符*256）。 ·         defaultRowHeight —默认行高。值为数字（点的1/20ths） ·         displayZeroValues —零值将要显示吗？值为布尔值。 ·         fitHeight —工作表将要被打印到页面的纵向数。值为数字。 ·         fitToPages —打印将符合页面吗？ 值为布尔。 ·         fitWidth —工作表将要被打印到页面的横向数。值为数字。 ·         footerMargin —所有页脚的边距。值为数字(inches)。 ·         headerMargin —所有页眉的边距。值为数字(inches)。 ·         hidden —工作表将要被隐藏吗？值为布尔。 ·         horizontalCentre —工作表将要被水平居中吗？值为布尔。 ·         horizontalFreeze —行所在的边被水平冻结吗？值为数字。   ·         horizontalPrintResolution —水平打印的解析度。值为数字。   ·         leftMargin —左边距. 值为数字(inches)。 ·         normalMagnification —标准放大系数（不放大或比例系数）值为数字(百分比)。 ·         orientation —打印这个工作表的纸的方向。值是字符“landscape”或“portrait”（横或纵）。 ·         pageBreakPreviewMagnification —分页预览的放大系数(不放大或比例系数). 值为数字(百分比)。 ·         pageBreakPreviewMode —用预览方式显示页面？值为布尔。. ·         pageStart —开始打印的页面数。值为数字。 ·         paperSize —打印此页使用的纸张大小。值是字符"a4", "a3", "letter", "legal" 等之一(见 jxl.format.PaperSize ). ·         password —工作表的密码。值为字符。 ·         passwordHash —密码散列- 仅用在复制工作表时。值为字符。 ·         printGridLines —将要打印网格线吗？值为布尔。 ·         printHeaders —将要打印页眉吗？ 值为布尔。 ·         sheetProtected —将工作表保护吗(read-only只读)？ (值为布尔。 ·         recalculateFormulasBeforeSave —在工作表被保存时将要重计算公式吗？值为布尔。假 ·         rightMargin —右边距. 值为数字(inches)。 ·         scaleFactor —用来打印此表时的放大系数。值为数字(百分比)。 ·         selected —在工作簿打开时，将要选此工作表吗？值为布尔。 ·         showGridLines —将要显示网格线吗？值为布尔。 ·         topMargin —上边距。值为数字(inches)。 ·         verticalCentre —垂直居中吗？值为布尔。 ·         verticalFreeze —行所在的边被垂直冻结吗？值为数字。    ·         verticalPrintResolution —垂直打印的解析度。值为数字。值为数字。 ·         zoomFactor —缩放系数。不要混淆缩放系数（相对屏幕视图）与比例系数（）。Do not confuse zoom factor (which relates to the on screen view) with scale factor (它指打印的比例系数). 值是数字（(percentage) 子元素 ·         <e:printArea/> —定义的零个或多个打印区域。(见章节19.11, “打印区和标题” )。 ·         <e:printTitle/> —定义的零个或多个打印标题(见章节19.11, “打印区和标题” )。 ·         <e:headerFooter/> —定义的零个或多个页眉/页脚 (见章节 19.10, “页眉和页脚” )。. ·         零个或多个工作表命令 (见章节 19.12, “工作表命令” ). Facets ·         header—会被放在数据块顶部的内容，在列标题的上面。 (如果有的话) ·         footer—会被放在数据块底部的内容，在列页脚的下面。 (如果有的话)

            <e:workbook>

               <e:worksheet name="foo" startColumn="1" startRow="1">

                  <e:column value="#{personList}" var="person">

                     <f:facet name="header">

                        <e:cell value="Last name"/>

                     </f:facet>

                     <e:cell value="#{person.lastName}"/>

                  </e:column>

               </e:worksheet>

            <e:workbook>

用名字 "foo"定义一个工作表, 开始在B2。

19.5. 列

列是工作表的子元素，又是单元格、图象、公式和超链接的父元素。它们是控制工作表数据迭代的结构。格式见章节 19.14.5, “列设置”。

<e:column>

属性 ·         无 子元素 ·         <e:cell/> —零或多个单元格(见章节19.6, “单元格” ). ·         <e:formula/> —零或多个公式(见章节 19.7, “公式” ). ·         <e:image/> —零或多个图象(见章节19.8, “图象” ). ·         <e:hyperLink/> —零或多个超链接(见章节19.9, “超链接” ). Facets ·         header —这个 facet可以包含一个<e:cell> , <e:formula> , <e:image> 或r <e:hyperLink> ，会被用来作为列的标题。 ·         footer —这个 facet可以包含一个<e:cell> , <e:formula> , <e:image> 或 <e:hyperLink> ，会被用来作为列页脚。

            <e:workbook>

               <e:worksheet>

                  <e:column value="#{personList}" var="person">

                     <f:facet name="header">

                        <e:cell value="Last name"/>

                     </f:facet>

                     <e:cell value="#{person.lastName}"/>

                  </e:column>

               </e:worksheet>

            <e:workbook>

用一个标题和一个迭代输出定义一个列。

19.6. 单元格

单元格嵌套在列的里面（为迭代）或在工作表的内部（为使用column或row的属性直接布置），且负责值的输入（但通常包括数据表的var属性的EL表达式，并且它们可以包含字体或其它格式和预定义模板）。

<e:cell>

属性 ·         column —列，用来放置单元格的地方。默认的是内部计数器。值为数字。注意，值是基于0的。 ·         row —行，用来放置单元格的地方。默认的是内部计数器。值为数字。注意，值是基于0的。 ·         <sp 分享到： 第 20章. RSS支持 | 第18章. iText PDF 生成 2009-05-26 20:07 浏览 1176 评论(0) 相关推荐 评论 发表评论 您还没有登录,请您登录后再发表评论 alienj 浏览: 45902 次 性别: 来自: 重庆 最近访客 更多访客>> xb_2542155001 Justin_168562 dylinshi126 文章分类 全部博客 (54) 闲话 (9) JAVA随笔 (5) jboss-seam2.1用户手册 (33) 脚本 (1) 社区版块 我的资讯 (0) 我的论坛 (5) 我的问答 (0) 存档分类 2010-12 (1) 2009-09 (2) 2009-08 (1) 更多存档... 最新评论 禀圣含华： 怎么弄空格呢？___________然后我固定这些空格，怎么弄 ... 第18章. iText PDF 生成 super0555： managed 第13章 Seam 应用程序框架 Javakeith： 代码呢？共享下代码呗！ 第18章. iText PDF 生成 tonyshen277： 同感啊。还在做Win32下的开发，楼主所说的一个都不能少啊。 转自baidu wqqq 给软件开发初学者 kdboy： 的确，把人放在宇宙中去看，从上帝的眼中去看，人的确是非常渺小， ... 人生是什么 声明：ITeye文章版权属于作者，受法律保护。没有作者书面许可不得转载。若作者同意转载，必须以超链接形式标明文章原始出处和作者。 © 2003-2015 ITeye.com. All rights reserved. [ 京ICP证110151号 京公网安备110105010620 ]