Compass::Core provides OSEM technology for use with an applications Object domain model. Compass::Core also provides Resource Mapping technology for resources other than Objects (that do not benefit from OSEM). The benefits of using Resources can be summarised as:

In order to work directly with a Resource, Compass needs to know the alias and the primary properties (i.e. primary keys in data-base systems) associated with the Resource. The primary properties are also known as id properties. This information is declared in Resource Mapping XML documents, so that Compass knows how to manage the Resource internally.

Here is an example of a Resource Mapping XML document:

<?xml version="1.0"?>
<!DOCTYPE compass-core-mapping PUBLIC
    "-//Compass/Compass Core Mapping DTD 1.0//EN"
    "http://www.opensymphony.com/compass/dtd/compass-core-mapping.dtd">

<compass-core-mapping>

  <resource alias="a">
    <resource-id name="id" />
  </resource>

  <resource alias="b">
    <resource-id name="id1" />
    <resource-id name="id2" />
  </resource>

  <resource alias="c">
    <resource-id name="id" />
    <resource-property name="value1" />
    <resource-property name="value2" store="yes" index="tokenized" />
    <resource-property name="value3" store="compress" index="tokenized" />
    <resource-property name="value4" store="yes" index="un_tokenized" />
    <resource-property name="value5" store="yes" index="no" />
  </resource>
</compass-core-mapping>

Now that the Resource Mapping has be declared, you can create the Resource in the application. In the following code example the Resource is created with an alias and id property matching the Resource Mapping declaration.

Resource r = session.createResource("a");
Property id = session.createProperty("id", "1",
    Property.Store.YES, Property.Index.UN_TOKENIZED);
r.addProperty(id);
r.addProperty(session.createProperty("mvalue", "property test",
    Property.Store.YES, Property.Index.TOKENIZED));

session.save(r);

The Resource Mapping file example above defines mappings for two resources (each identified with a different alias). Each resource has a set of resource ids that are associated with it. The value for the resource-id tag is the name of the Property that is associated with the primary property for the Resource.

The third mapping (alias "c"), defined resource-property mappings as well as resource-id mappings. The resource-property mapping works with the Resource#addProperty(String name, Object value) operation. It provides definitions for the resource properties that are added (index, store, and so on), and they are then looked up when using the mentioned add method. Using the resource-property mapping, helps clean up the code when constructing a Resource, since all the Property characteristics are defined in the mapping definition, as well as auto conversion from different objects, and the ability to define new ones. Note that the resource-property definition will only work with the mentioned addProperty method, and no other addProperty method.

All XML mappings should declare the doctype shown. The actual DTD may be found at the URL above or in the compass-core-x.x.x.jar. Compass will always look for the DTD in the classpath first.

There are no compass-core-mapping attributes that are applicable when working with resource mappings.

<resource
      alias="aliasName"
      sub-index="sub index name"
      analyzer="name of the analyzer"
      all="true|false"
      all-term-vector="no|yes|positions|offsets|positios_offsets"
      all-metadata="name of all metadata"
/>
    resource-id*,
    (resource-analyzer?),
    (resource-property)*

<resource-id
      name="idName"
/>

<resource-property
      name="property name"
      store="yes|no|compress"
      index="tokenized|un_tokenized|no"
      boost="boost value for the property"
      analyzer="name of the analyzer"
      reverse="no|reader|string"
      exclude-from-all="[parent's exclude-from-all]|false|true"
      converter="fully qualified converter class name"
      converter-param="parameter for the converter"
>
   (converter-param)*,
</resource-property>

<resource-analyzer
      name="property name"
      null-analyzer="analyzer name if value is null"
      converter="fully qualified converter class name"
      converter-param="parameter for the converter"
>
</resource-analyzer>