jackrabbit OCM(一)

OCM是Object Content Mapping的缩写，同Hibenrate的ORM功能类似，Jackrabbit提供了OCM的功能，只不过所映射的对象不是数据库表格，而是jcr节点，可以让我们以操作对象的方式来更新Jackrabbit存储结构。

Jackrabbit的OCM功能目前也仍处于修订状态，并且从1.5版本之后没有纳入API文档范围之内。针对JCR2.0的版本实现可以在这个网址进行下载

点击打开链接

jackrabbitOCM框架对外提供的最主要的一个类为ObjectContentManager，可通过如下代码实例化该对象：

ObjectContentManager ocm=new ObjectContentManagerImpl(session,mapper)；

第一个参数为Repository的会话Session, ObjectContentManager通过它创建、管理JCR内容节点(包括节点的检索、新增、更新、删除等)；

第二个参数为OCM要处理的映射描述信息

同hibenrate一样，OCM映射描述信息可通过两种方式来进行声明:

1.Annotation注解方式

*实体类注解为@Node

*原子字段类型注解为@Field,其中path=true表示该属性为节点的存储路径

*Bean字段类型注解为@Bean

*集合字段类型注解为@Collection

2.xml方式(类似Hibernate的hbm文件)

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE jackrabbit-ocm PUBLIC "-//The Apache Software Foundation//DTD 
Repository//EN" "http://jackrabbit.apache.org/dtd/jackrabbit-ocm-1.5.dtd"> 
<jackrabbit-ocm>
	<class-descriptor className=“model.PressRelease”>
		<field-descriptor...../> <!--原子字段类型-->
		<bean-descriptor...../> <!--Bean字段类型-->
		<collection-descriptor...../> <!-集合字段类型-->
	</class-descriptor>
</jackrabbit-ocm>

个人推荐第二种方式，这样可针对与同一个实体类，通过编写不同的XML映射描述，来实现不同方式的映射处理(ORM或OCM)。

OCM支持3种字段类型(Field Type)的映射处理，分别是:

1.Atomic Fields(原子字段类型):映射到节点的Property ;

2.Bean Filed(bean字段类型):映射到节点的Property或子节点;

3.Collection Filed(集合字段类型):映射到子节点或者节点的多值域(multivalue property)

在做映射处理的过程中，开发人员通常要处理3方面的信息内容，分别是：

1.JCR节点类型的定义:同数据库相比，每个JCR节点相当于是一张表，而节点类型相当于是表结构的定义

2.Java实体类的编写:OCM要映射出的实体类对象

3.映射配置描述文件的编写:XML映射描述信息

这3方面信息内容的展现在结构上是一一对应的关系，改变单方的同时也要级联修改其他方

原子字段类型

DTD声明如下：

<!ELEMENT field-descriptor EMPTY>
<!ATTLIST field-descriptor
    fieldName CDATA #REQUIRED
    jcrName CDATA #IMPLIED 
    id (true | false) "false"
    path (true | false) "false"
    uuid (true | false) "false"
    converter CDATA #IMPLIED
    jcrDefaultValue CDATA #IMPLIED
    jcrValueConstraints CDATA #IMPLIED 
    jcrType (String | Date | Long | Doube | Boolean | Binary) #IMPLIED
    jcrAutoCreated (true | false) "false"
    jcrMandatory (true | false) "false"
    jcrOnParentVersion (COPY | VERSION | INITIALIZE | COMPUTE | IGNORE | ABORT) "COPY"
    jcrProtected (true | false) "false"
    jcrMultiple (true | false) "false"
>

标签属性描述如下：

fieldName:所映射实体类的字段名称

jcrName:节点属性名

path:该字段属性是否为节点的存储路径

uuid:该字段属性是否为节点的唯一标识

converter:字段类型转换器，当实体类的字段属性与JCR节点的属性类型不一致时，可通过converter来完成彼此之间的相互转换

jcrDefaultValue:属性默认值

jcrValueConstraints:属性值约束

jcrType:节点属性类型，支持String , Date , Long , Doube , Boolean , Binary

jcrAutoCreated:该属性是否自动创建

jcrMandatory:该属性是否必须存在

jcrProtected:属性是否不可修改

jcrMultiple:属性是否为多值域(multiple value)

Bean字段类型

DTD描述如下:

<!ELEMENT bean-descriptor EMPTY>
<!ATTLIST bean-descriptor
    fieldName CDATA #REQUIRED
    jcrName CDATA #IMPLIED 
    proxy (true | false) "false" 
    autoRetrieve (true|false) "true"
    autoUpdate (true|false) "true"
    autoInsert (true|false) "true"
    converter CDATA #IMPLIED
    jcrType CDATA #IMPLIED
    jcrAutoCreated (true | false) "false"   
    jcrMandatory (true | false) "false"
    jcrOnParentVersion (COPY | VERSION | INITIALIZE | COMPUTE | IGNORE | ABORT) "COPY"
    jcrProtected (true | false) "false"
    jcrSameNameSiblings (true | false) "false"         
>

标签属性描述如下:

fieldName:所映射实体类的字段名称

jcrName:节点属性名

proxy:该属性是否延迟加载

autoRetrieve:是否级联查询

autoUpdate:是否级联更新

autoInsert:是否级联新增

converter:类型转换器,jackrabbit OCM框架对外提供了4种类型的转换器，以下内容中会有详细介绍。

jcrType:节点类型，默认为nt:unstructured

jcrAutoCreated:是否自动创建

jcrMandatory:是否必须存在

jcrProtected:是否不可修改

jcrSameNameSiblings:是否允许含有同名的兄弟节点

集合字段类型

DTD声明如下:

<!ELEMENT collection-descriptor EMPTY>
<!ATTLIST collection-descriptor
    fieldName CDATA #REQUIRED
    jcrName CDATA #IMPLIED 
    proxy (true | false) "false"
    autoRetrieve (true|false) "true"
    autoUpdate (true|false) "true"
    autoInsert (true|false) "true"
    elementClassName CDATA #IMPLIED
    collectionClassName CDATA #IMPLIED
    collectionConverter CDATA #IMPLIED
    jcrElementName CDATA #IMPLIED
    jcrType CDATA #IMPLIED
    jcrAutoCreated (true | false) "false"   
    jcrMandatory (true | false) "false"
    jcrOnParentVersion (COPY | VERSION | INITIALIZE | COMPUTE | IGNORE | ABORT) "COPY"
    jcrProtected (true | false) "false"
    jcrSameNameSiblings (true | false) "false"
>

标签属性描述如下:

fieldName:所映射实体类的字段名称

jcrName:节点属性名

proxy:该属性是否延迟加载

autoRetrieve:是否级联查询

autoUpdate:是否级联更新

autoInsert:是否级联新增

elementClassName:集合中元素的类名称

collectionClassName:集合对象类名称

collectionConverter:类型转换器,jackrabbitOCM对外提供了8种集合类型转换器，在下面会有详细的介绍。

jcrElementName：元素节点名称

jcrType:元素节点类型

jcrAutoCreated:是否自动创建

jcrMandatory:是否必须存在

jcrProtected:是否不可修改

jcrSameNameSiblings:是否允许含有同名的兄弟节点