<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<set>   
<setinfo>
<title>Reference Guides</title>
  <edition>1.0</edition>
  <pubsnumber>1</pubsnumber>
  <productname>eXo Platform</productname>
  <productnumber>3.5</productnumber>
  <copyright>
    <year>2009-2012</year>
    <holder>eXo Platform SAS</holder>
  </copyright>
<abstract>
Welcome to eXo Platform 3.5 Reference Guide.
This guide is a complete reference for customization points, and available APIs, for all modules.
</abstract>
</setinfo>
   <!--xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bookinfo.xml"/-->
  <!-- JCR -->
  <book lang="en" xml:id="JCRReferenceGuide">
    <bookinfo>
      <title>Reference Guide / eXo JCR</title>
      <subtitle>Java Content Repository and Extension services</subtitle>
    </bookinfo>
    <chapter xml:id="chapter-JCR">
      <title>eXo JCR</title>
      <para>eXo provides JCR implementation called eXo JCR.</para>
   <para>This part will show you how to configure and use eXo JCR in GateIn and standalone.</para>

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/intro.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <!-- concepts -->
  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/concepts/why-jcr.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

 <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/concepts/jcr-exo-implementation.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/concepts/jcr-advantages.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/concepts/jcr-compatibility-levels.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/concepts/jcr-usage.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/concepts/jcr-extensions.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/concepts/jcr-applications.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/concepts/nodetype-registration.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/concepts/jcr-registry-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude"  />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/concepts/jcr-namespace-altering.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/concepts/nodetypes-and-namespaces.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

 <!-- common configs -->

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/configuration/exo-jcr-configuration.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/configuration/multilanguage-support.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/configuration/multi-db-schema-support.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/configuration/search-configuration.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/configuration/configuration-persister.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/configuration/jdbc-data-container-config.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/configuration/external-value-storages.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/configuration/workspace-persistence-storage.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/configuration/rest-services-on-groovy.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <!-- cluster configs -->

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/cluster-config.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/jbosscache-configuration-templates.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/lock-manager-config.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/query-handler-config.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/jbossts-transaction-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/transaction-manager-lookup.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />


  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/repository-creation-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <!-- search -->

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/searching/jcr-query-usecases.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/searching/searching-repository-content.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/searching/fulltext-search-and-settings.xml"
                  xmlns:xi="http://www.w3.org/2001/XInclude" />

  <!-- protocols -->

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/protocols/webdav.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/protocols/ftp.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/statistics.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/repository-check-controller.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />


  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/jta.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/jca.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/other/acl.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/other/acl-ext.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/other/link-producer.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/other/binary-values-processing.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/other/jcr-resources.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <!-- data container configs -->

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/data-container.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/data-container-howto.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/db-cleaner-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <!-- tuning guide -->
  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr/performance-tuning-guide.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />
    </chapter>
    <chapter xml:id="chapter-Kernel">
      <title>eXo Kernel</title>

    <para>eXo Kernel is the basis of all eXo platform products and modules.
    Any component available in eXo Platform is managed by the Exo Container,
    our micro container responsible for gluing the services through dependency
    injection</para>

    <para>Therefore, each product is composed of a set of services and plugins
    registered to the container and configured by XML configuration
    files.</para>

    <para>The Kernel module also contains a set of very low level
    services.</para>

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/exo-container.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/service-configuration-for-beginners.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/service-configuration-in-detail.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/container-configuration.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/inversion-of-control.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/services-wiring.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/component-plugin-priority.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/understanding-listnerservice.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/initialcontext-binder-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/job-scheduler-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/data-source-provider.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/jndi-naming.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/logging.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/manageability.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/kernel/listener-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

   </chapter>
    <chapter xml:id="chapter-eXoCore">
      <title>eXo Core</title>

    <para>The eXo Core is a set of common services, such as Authentication and Security, Organization, Database, Logging,
        JNDI, LDAP, Document reader, and other services, that are used by eXo
        products and modules. It also can be used in the business logic.
    </para>

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/core/db-creator-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/core/security-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/core/organization-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/core/organization-service-initalizer.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/core/organization-service-listener.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/core/conversationstate-when-membership-changed.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/core/db-schema-creator-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/core/db-configuration-hibernate.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/core/ldap-configuration.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/core/organization-service-tck-tests-config.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/core/tika-document-reader-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/core/digest-auth.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />
  </chapter>

  <chapter xml:id="chapter-eXoWS">
  <title>eXo Web Services</title>

  <para>The Web Services module allows eXo technology to integrate with
  external products and services.</para>

  <para>It is implementation of API for RESTful Web Services with extensions,
  Servlet and cross-domain AJAX web-frameworks and JavaBean-JSON
  transformer.</para>

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/ws/introduction-to-rest.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/ws/overwrite-default-providers.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/ws/restservicelist-service.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/ws/groovy-scripts-as-rest-services.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/ws/framework-for-cross-domain-ajax.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />
</chapter>

 <chapter xml:id="chapter-eXoJCRWithGateIn">
<title>eXo JCR with GateIn</title>
<para>This chapter includes the following topics:</para>
<itemizedlist>
<listitem>
<para><link linkend="JCRWithGateIn.HowToExtendMyGateInInstance">How to extend my GateIn instance?</link></para>
</listitem>
<listitem>
<para><link linkend="JCRWithGateIn.HowToUseDataSourceUnderJBoss">How to use AS Managed DataSource under JBoss AS?</link></para>
</listitem>
</itemizedlist>
<xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr-with-gtn/how-to-extend-my-gatein-instance.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="org.exoplatform.jcr/docbook/en-US/modules/jcr-with-gtn/managed-datasources-under-jboss-as.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</chapter>

  <xi:include href="org.exoplatform.jcr/docbook/en-US/modules/faq.xml"
              xmlns:xi="http://www.w3.org/2001/XInclude" />


  </book>

  <!-- GateIn -->
 <!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="org.exoplatform.jcr/docbook/en-US/master.xml"/>      -->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="org.gatein.doc/master.xml"/>
<!-- WCM -->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="org.exoplatform.ecms/exo-ecms-docs-refguide.xml"/>

<!-- Collaboration -->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="org.exoplatform.cs/exo.cs.docs.refguide.xml"/>

<!-- Knowledge -->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="org.exoplatform.ks/exo.ks.docs.refguide.xml"/>

<!-- Social -->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="org.exoplatform.social/exo.social.docs.refguide.xml"/>

</set>
