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:是否允许含有同名的兄弟节点