JCR 2.0 的上传文件与 JCR 1.0 的上传文件基本相同。但是,JCR 2.0 添加了一些有用的附加内置属性定义。
“nt:file”节点类型旨在表示一个文件,并在 JCR 2.0 中具有两个内置属性定义(这两个属性定义都是在创建节点时由存储库自动创建的):
- jcr:创建(日期)
- jcr:createdBy (字符串)
并定义了一个名为“jcr:content”的子节点。这个“jcr:content”节点可以是任何节点类型,但一般来说,与内容本身有关的所有信息都存储在这个子节点上。事实上的标准是使用“nt:resource”节点类型,它定义了以下属性:
- jcr:data (BINARY) 强制
- jcr:lastModified (DATE) 自动创建
- jcr:lastModifiedBy (STRING) 自动创建
- jcr:mimeType (STRING) 受保护?
- jcr:编码(字符串)受保护?
请注意,“jcr:mimeType”和“jcr:encoding”是在 JCR 2.0 中添加的。
特别是,“jcr:mimeType”属性的目的是完全按照您的要求进行 - 捕获内容的“类型”。但是,“jcr:mimeType”和“jcr:encoding”属性定义可以(由 JCR 实现)定义为受保护(意味着 JCR 实现会自动设置它们) - 如果是这种情况,则不允许您手动设置这些属性。我相信Jackrabbit和ModeShape不会将这些视为受保护的。
下面是一些代码,展示了如何使用这些内置节点类型将文件上传到 JCR 2.0 存储库:
// Get an input stream for the file ...
File file = ...
InputStream stream = new BufferedInputStream(new FileInputStream(file));
Node folder = session.getNode("/absolute/path/to/folder/node");
Node file = folder.addNode("Article.pdf","nt:file");
Node content = file.addNode("jcr:content","nt:resource");
Binary binary = session.getValueFactory().createBinary(stream);
content.setProperty("jcr:data",binary);
如果 JCR 实现不将“jcr:mimeType”属性视为受保护(即 Jackrabbit 和 ModeShape),则必须手动设置此属性:
content.setProperty("jcr:mimeType","application/pdf");
元数据可以很容易地存储在“nt:file”和“jcr:content”节点上,但是开箱即用的“nt:file”和“nt:resource”节点类型不允许额外的属性. 因此,在添加其他属性之前,您首先需要添加一个 mixin(或多个 mixin),其中包含您要存储的各种属性的属性定义。你甚至可以定义一个允许任何属性的 mixin。这是一个定义这样一个 mixin 的 CND 文件:
<custom = 'http://example.com/mydomain'>
[custom:extensible] mixin
- * (undefined) multiple
- * (undefined)
注册此节点类型定义后,您可以在节点上使用它:
content.addMixin("custom:extensible");
content.setProperty("anyProp","some value");
content.setProperty("custom:otherProp","some other value");
您还可以定义和使用允许任何Dublin Core 元素的 mixin :
<dc = 'http://purl.org/dc/elements/1.1/'>
[dc:metadata] mixin
- dc:contributor (STRING)
- dc:coverage (STRING)
- dc:creator (STRING)
- dc:date (DATE)
- dc:description (STRING)
- dc:format (STRING)
- dc:identifier (STRING)
- dc:language (STRING)
- dc:publisher (STRING)
- dc:relation (STRING)
- dc:right (STRING)
- dc:source (STRING)
- dc:subject (STRING)
- dc:title (STRING)
- dc:type (STRING)
所有这些属性都是可选的,并且这个 mixin 不允许任何名称或类型的属性。我也没有真正解决这个'dc:metadata'混合的事实,其中一些已经用内置属性表示(例如,“jcr:createBy”,“jcr:lastModifiedBy”,“jcr:created” , "jcr:lastModified", "jcr:mimeType") 并且其中一些可能与内容更相关,而另一些则与文件更相关。
您当然可以定义其他更适合您的元数据需求的 mixin,在需要的地方使用继承。但是要小心使用 mixins 的继承 - 因为 JCR 允许一个节点到多个 mixins,所以通常最好将你的 mixins 设计为紧密范围和面向方面(例如,“ex:taggable”、“ex:describable”等)然后只需根据需要将适当的 mixin 应用到节点。
(甚至可以定义一个 mixin,允许更多的子节点在“nt:file”节点下,并在其中存储一些元数据,尽管要复杂得多。)
Mixin 非常棒,为您的 JCR 内容提供了极大的灵活性和强大的功能。
哦,当你创建了所有你想要的节点后,一定要保存会话:
session.save();