JCR与SQL：功能边界解析
内容仓库（content repository），如apache jackrabbit，是基于java内容仓库api (jcr, jsr-283) 规范实现的。jcr的设计理念与传统的关系型数据库（rdbms）有着本质区别。在jcr中，内容以树状结构（节点和属性）组织，而非二维表格。因此，传统的sql insert、update、delete 等数据操作语句并不适用于jcr。
JCR API中确实存在SQL查询功能（例如JCR-SQL2），但其作用仅限于查询内容，即通过类似SQL的语法检索节点和属性，而非修改或创建内容。当需要向Jackrabbit仓库中写入、更新或删除数据时，必须使用javax.jcr包提供的核心API。
使用JCR API存储内容
存储内容到Jackrabbit仓库的核心步骤涉及获取仓库连接、创建会话、导航到目标节点、创建新节点或设置属性，最后保存更改。以下是一个通过JCR API存储图片（或其他二进制文件）的典型流程。
1. 获取Repository和Session
首先，你需要连接到Jackrabbit仓库并获取一个Session对象。Session是与仓库交互的主要接口，它代表了用户对仓库的视图和操作上下文。
import javax.jcr.Repository;
import javax.jcr.Session;
import javax.jcr.SimpleCredentials;
import javax.jcr.RepositoryException;
// 假设你已经配置了Jackrabbit仓库，例如通过JNDI或直接创建
public class JcrConnection {
public static Session getSession() throws RepositoryException {
// 示例：通过JackrabbitStandaloneRepositoryFactory获取仓库实例
// 实际应用中，你可能通过JNDI查找或Spring配置获取Repository
Repository repository = new org.apache.jackrabbit.commons.JcrRepositoryFactory().getRepository();
// 使用管理员凭据登录
// 生产环境中应使用更安全的凭据管理方式
return repository.login(new SimpleCredentials("admin", "admin".toCharArray()));
}
public static void closeSession(Session session) {
if (session != null && session.isLive()) {
session.logout();
}
}
}2. 创建或导航到目标节点
在JCR中，所有内容都组织在节点树中。你需要决定将图片存储在哪个父节点下。你可以导航到现有节点，或者创建新的文件夹节点。
import javax.jcr.Node;
import javax.jcr.RepositoryException;
public class JcrContentManager {
public Node getOrCreateFolder(Session session, String path) throws RepositoryException {
Node rootNode = session.getRootNode();
Node currentNode = rootNode;
String[] pathSegments = path.split("/");
for (String segment : pathSegments) {
if (segment.isEmpty()) continue;
if (currentNode.hasNode(segment)) {
currentNode = currentNode.getNode(segment);
} else {
currentNode = currentNode.addNode(segment, "nt:folder"); // 创建nt:folder类型的节点
}
}
return currentNode;
}
}3. 存储二进制数据（图片）
存储图片通常涉及创建nt:file和nt:resource节点结构，并将二进制数据作为jcr:data属性存储。
import javax.jcr.Binary;
import javax.jcr.Node;
import javax.jcr.Session;
import javax.jcr.RepositoryException;
import java.io.InputStream;
import java.util.Calendar;
import java.io.FileInputStream;
import java.io.IOException;
public class ImageUploader {
public void uploadImage(Session session, String parentPath, String imageName, String mimeType, InputStream imageStream)
throws RepositoryException, IOException {
Node parentNode = new JcrContentManager().getOrCreateFolder(session, parentPath);
// 创建nt:file节点
Node fileNode = parentNode.addNode(imageName, "nt:file");
// 创建jcr:content节点（nt:resource类型），用于存储实际内容
Node resNode = fileNode.addNode("jcr:content", "nt:resource");
// 将InputStream转换为JCR Binary类型
Binary binary = session.getValueFactory().createBinary(imageStream);
// 设置jcr:data属性来存储二进制数据
resNode.setProperty("jcr:data", binary);
// 设置jcr:mimeType属性，指明文件类型
resNode.setProperty("jcr:mimeType", mimeType);
// 设置jcr:lastModified属性，记录最后修改时间
resNode.setProperty("jcr:lastModified", Calendar.getInstance());
// 保存所有更改
session.save();
// 释放Binary资源
binary.dispose();
System.out.println("图片 '" + imageName + "' 已成功上传到 " + parentPath);
}
public static void main(String[] args) {
Session session = null;
InputStream imageInputStream = null;
try {
session = JcrConnection.getSession();
ImageUploader uploader = new ImageUploader();
// 示例图片文件路径和信息
String imageFilePath = "path/to/your/image.jpg"; // 请替换为你的图片路径
String parentFolder = "my-application/images";
String fileName = "sample-image.jpg";
String mimeType = "image/jpeg";
imageInputStream = new FileInputStream(imageFilePath);
uploader.uploadImage(session, parentFolder, fileName, mimeType, imageInputStream);
} catch (RepositoryException | IOException e) {
e.printStackTrace();
} finally {
if (imageInputStream != null) {
try {
imageInputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
JcrConnection.closeSession(session);
}
}
}注意事项
- 会话管理： Session是重量级资源，应妥善管理其生命周期。在完成操作后务必调用session.logout()来释放资源。
- 事务性： session.save()操作具有事务性。它会将自上次保存以来所有对会话所做的更改原子性地提交到仓库。如果发生错误，所有未保存的更改都将被回滚。
- 节点类型： JCR定义了一系列标准节点类型（如nt:file, nt:resource, nt:folder）。正确使用这些节点类型有助于保持仓库结构的清晰和规范。你也可以定义自定义节点类型。
- 错误处理： 在实际应用中，需要对RepositoryException和IOException等异常进行健壮的错误处理。
- 二进制数据处理： InputStream在传递给createBinary()后，其内容会被复制到JCR的内部存储。完成操作后，记得关闭InputStream。Binary对象也应在不再需要时调用dispose()释放资源。
- 权限管理： 示例代码使用管理员账户。在生产环境中，应使用具有最小必要权限的用户账户进行操作。
总结
通过javax.jcr API，开发者可以完全控制Jackrabbit内容仓库中的数据存储和管理。虽然JCR提供了类似SQL的查询语言，但它仅用于检索数据。要实现数据的创建、修改和删除，必须通过Session、Node和Property等核心JCR接口进行操作。理解并熟练运用这些API是有效利用Jackrabbit进行内容管理的关键。
