3G Eden
RSS注意，这里使用 request.getFile() 方法获得上传的文件的引用。有了该引用后，便可以对它进行各种类型的内省。清单 7 显示上传 Grails 徽标后的控制台输出：
清单 7. 上传文件后的控制台输出
Class: class org.springframework.web.multipart.commons.CommonsMultipartFile Name: payload OriginalFileName: Grails_logo.jpg Size: 8065 ContentType: image/jpeg |
如果知道 Grails 在幕后使用 Spring MVC 框架，那么对此不应感到奇怪：上传的文件是作为 CommonsMultipartFile 对象提供给控制器的。除了公布 HTML 表单字段的名称外，这个类还允许访问原始文件名、文件大小（单位为字节）和文件的 MIME 类型。
接下来的步骤是将上传的文件保存到某个地方。在 save 闭包中添加几行代码，如清单 8 所示：
清单 8. 将上传的文件保存到磁盘
def save = {
def entryInstance = new Entry(params)
entryInstance.author = User.get(session.user.id)
//handle uploaded file
def uploadedFile = request.getFile('payload')
if(!uploadedFile.empty){
println "Class: ${uploadedFile.class}"
println "Name: ${uploadedFile.name}"
println "OriginalFileName: ${uploadedFile.originalFilename}"
println "Size: ${uploadedFile.size}"
println "ContentType: ${uploadedFile.contentType}"
def webRootDir = servletContext.getRealPath("/")
def userDir = new File(webRootDir, "/payload/${session.user.login}")
userDir.mkdirs()
uploadedFile.transferTo( new File( userDir, uploadedFile.originalFilename))
}
if(!entryInstance.hasErrors() && entryInstance.save()) {
flash.message = "Entry ${entryInstance.id} created"
redirect(action:show,id:entryInstance.id)
}
else {
render(view:'create',model:[entryInstance:entryInstance])
}
}
|
在 Web root 下创建 payload/jsmith 目录后，就可以使用 uploadedFile.transferTo() 方法将文件保存到磁盘。File.mkdirs() 方法是无损的，所以可以多次调用该方法，而不必担心当目录已经存在时会丢失已有的文件。
接下来，将一个 String 字段添加到 Entry 类，以存储 filename，如清单 9 所示。注意要添加一个约束，使这个新字段同时为 blank（在 HTML 表单中）和 nullable（在数据库中）。
清单 9. 将 filename 字段添加到 Entry 中
class Entry {
static constraints = {
title()
summary(maxSize:1000)
filename(blank:true, nullable:true)
dateCreated()
lastUpdated()
}
static mapping = {
sort "lastUpdated":"desc"
}
static belongsTo = [author:User]
String title
String summary
String filename
Date dateCreated
Date lastUpdated
}
|
最后，将 filename 添加到 save 闭包中的 Entry 对象中。清单 10 显示完整的 save 闭包：
清单 10. 将 filename 存储在 Entry 中
def save = {
def entryInstance = new Entry(params)
entryInstance.author = User.get(session.user.id)
//handle uploaded file
def uploadedFile = request.getFile('payload')
if(!uploadedFile.empty){
println "Class: ${uploadedFile.class}"
println "Name: ${uploadedFile.name}"
println "OriginalFileName: ${uploadedFile.originalFilename}"
println "Size: ${uploadedFile.size}"
println "ContentType: ${uploadedFile.contentType}"
def webRootDir = servletContext.getRealPath("/")
def userDir = new File(webRootDir, "/payload/${session.user.login}")
userDir.mkdirs()
uploadedFile.transferTo( new File( userDir, uploadedFile.originalFilename))
entryInstance.filename = uploadedFile.originalFilename
}
if(!entryInstance.hasErrors() && entryInstance.save()) {
flash.message = "Entry ${entryInstance.id} created"
redirect(action:show,id:entryInstance.id)
}
else {
render(view:'create',model:[entryInstance:entryInstance])
}
}
|
将上传的文件保存到文件系统的另一种方法是将它们直接存储在数据库中。如果在 Entry 中创建一个名为 payload 的 byte[] 字段，那么可以完全绕过前面添加到 save 闭包的所有定制代码。但是，如果那样做的话，您将错过下一节中所有的趣事。
  |
显示上传的文件
如果不将上传的文件在某个地方显示出来，那有何意义呢？打开 grails-app/views/entry/_entry.gsp，添加清单 11 中的代码：
清单 11. 用于显示上传的图像的 GSP 代码
<div class="entry">
<span class="entry-date">
<g:longDate>${entryInstance.lastUpdated}</g:longDate> : ${entryInstance.author}
</span>
<h2><g:link action="show" id="${entryInstance.id}">${entryInstance.title}</g:link></h2>
<p>${entryInstance.summary}</p>
<g:if test="${entryInstance.filename}">
<p>
<img src="${createLinkTo(dir:'payload/'+entryInstance.author.login,
file:''+entryInstance.filename)}"
alt="${entryInstance.filename}"
title="${entryInstance.filename}" />
</p>
</g:if>
</div>
|
由于上传文件是可选的，我将输出包含在一个 <g:if> 块中。如果 entryInstance.filename 字段被填充，则在一个 <img> 标记中显示结果。
图 2 显示新的列表，同时还在显眼的地方显示上传的 Grails 徽标：
图 2. 显示上传的图像
但是，如果用户上传其他东西，而不是图像呢？这时就不是将更多的逻辑放入到 GSP 中了，最好的地方是一个定制的 TagLib。
|
创建 TagLib
Blogito 在 grails-app/taglib 中已经有两个 TagLib：DateTagLib.groovy 和 LoginTagLib.groovy。在一个 TagLib 中可以定义任意数量的定制标记，但是这一次我建议创建一个新的 TagLib，以便按语义将标记分组。在命令提示符下输入 grails create-tag-lib Entry，并添加清单 12 中的代码：
清单 12. 创建 displayFile 标记
class EntryTagLib {
def displayFile = {attrs, body->
def user = attrs["user"]
def filename = attrs["filename"]
if(filename){
def extension = filename.split("\\.")[-1]
def userDir = "payload/${user}"
switch(extension.toUpperCase()){
case ["JPG", "PNG", "GIF"]:
def html = """
<p>
<img src="${createLinkTo(dir:''+userDir,
file:''+filename)}"
alt="${filename}"
title="${filename}" />
</p>
"""
out << html
break
case "HTML":
out << "p>html</p>"
break
default:
out << "<p>file</p>"
break
}
}else{
out << "<!-- no file -->"
}
}
}
|
不久后可以看到，该代码创建一个 <g:displayFile> 标记，该标记需要两个属性：user 和 filename。如果 filename 属性被填充，则取得文件扩展名，并将其转换为大写形式。
Groovy 中的 Switch 语句比 Java 中的对等物的灵活性要大得多。首先，可以在 String 上进行切换（而 Java 语言只能在 int 上进行切换）。更令人惊奇的是，case 既可以指定一个条件列表 List，也可以指定单个的条件。
有了这个 TagLib 后，可以大大简化 _entry.gsp 局部模板，如清单 13 所示：
