Index: trunk/docs/gettingstarted/src/main/docbook/en-US/content/introduction.xml =================================================================== --- trunk/docs/gettingstarted/src/main/docbook/en-US/content/introduction.xml (revision 844) +++ trunk/docs/gettingstarted/src/main/docbook/en-US/content/introduction.xml (working copy) @@ -95,7 +95,7 @@ JBoss DNA has other features as well. You can create federated repositories that dynamically merge the information from multiple databases, services, applications, and other JCR repositories. JBoss DNA also will allow you to - create customized views based upon the type of data and the role of the user that is accessing the data. And yet another is + create customized views based upon the type of data and the role of the user that is accessing the data. And yet another goal is to create a REST-ful API to allow the JCR content to be accessed easily by other applications written in other languages. Index: trunk/docs/gettingstarted/src/main/docbook/en-US/content/understanding_dna.xml =================================================================== --- trunk/docs/gettingstarted/src/main/docbook/en-US/content/understanding_dna.xml (revision 844) +++ trunk/docs/gettingstarted/src/main/docbook/en-US/content/understanding_dna.xml (working copy) @@ -32,7 +32,7 @@ JBoss DNA is a repository and set of tools that make it easy to capture, version, analyze, and understand the fundamental building blocks of information. As models, service and process definitions, schemas, source code, and other artifacts are added to the repository, JBoss DNA "sequences" the makeup of these components and extracts their structure - and interdependencies. The JBoss DNA web application allows end users to access, visualize, and edit this information in + and interdependencies. The JBoss DNA web application will allow end users to access, visualize, and edit this information in the terminology and structure they are familiar with. Such domain-specific solutions can be easily created with little or no programming. JBoss DNA supports the Java Content Repository (JCR) standard and is able to provide a single integrated view of @@ -372,38 +372,23 @@ This is a powerful connector that is discussed in more detail in the next section. - - There are also a number of connectors that are planned: - - JCR Repository Connector - - Connect to and interact with other JCR repositories. - - - - File System Connector - Expose the files and directories on a file system through JCR. - Maven 2 Repository Connector - - Access and expose the contents of a Maven 2 repository (either on the local file system or via HTTP) through - JCR. - - - - JDBC Metadata Connector - Connect to relational databases via JDBC and expose their schema as content in a repository. - UDDI Connector - - Interact with UDDI registries to integrate their content into a repository. + JDBC Storage Connector + - Store and access information in a relational database through JPA. Also useful for persisting information in the federated + repository not stored elsewhere. @@ -414,23 +399,38 @@ SVNkit (dual license) library for an API into Subversion. + + + There are also a number of connectors that are planned: + + + + JCR Repository Connector + - Connect to and interact with other JCR repositories. + - CVS Connector - - Interact with CVS software configuration management (SCM) repositories to expose the managed resources through + Maven 2 Repository Connector + - Access and expose the contents of a Maven 2 repository (either on the local file system or via HTTP) through JCR. - JDBC Storage Connector - - Store and access information in a relational database. Also useful for persisting information in the federated - repository not stored elsewhere. + UDDI Connector + - Interact with UDDI registries to integrate their content into a repository. + CVS Connector + - Interact with CVS software configuration management (SCM) repositories to expose the managed resources through + JCR. + + + + Distributed Database Connector - Store and access information in a Hypertable Index: trunk/docs/reference/src/main/docbook/en-US/content/development_tools.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/development_tools.xml (revision 844) +++ trunk/docs/reference/src/main/docbook/en-US/content/development_tools.xml (working copy) @@ -50,7 +50,8 @@ You should be able to use the latest JDK, - which is currently JDK 6. We periodically try to build JBoss DNA using JDK 6, but it's not our official JDK (yet). + which is currently JDK 6. It is possible to build JBoss DNA using JDK 6 without any code changes, but it's + not our official JDK (yet). Why do we build using JDK 5 and not 6? The main reason is that if we were to use JDK 6, then JBoss DNA couldn't really be used in any Index: trunk/docs/reference/src/main/docbook/en-US/content/introduction.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/introduction.xml (revision 844) +++ trunk/docs/reference/src/main/docbook/en-US/content/introduction.xml (working copy) @@ -179,7 +179,7 @@ JBoss DNA has other features as well. You can create federated repositories that dynamically merge the information from multiple databases, services, applications, and other JCR repositories. JBoss DNA also will allow you to - create customized views based upon the type of data and the role of the user that is accessing the data. And yet another is + create customized views based upon the type of data and the role of the user that is accessing the data. And yet another goal is to create a REST-ful API to allow the JCR content to be accessed easily by other applications written in other languages. @@ -289,15 +289,30 @@ + dna-cnd + provides a utilities for reading and writing files in the CND (Compact Node Definition) format. + + + + dna-jcr provides the JBoss DNA implementation of the JCR API, which relies upon a repository connector, such as the Federation Connector (see dna-connector-federation - ). + ). As DNA does not fully implement the JCR 1.0.1 specification, there are a series of tests that are currently commented + out in this module. The dna-jcr-tck module contains all of these tests. + dna-jcr-tck + provides a separate testing project that executes all JackRabbit JCR TCK tests on a nightly basis to track implementation + progress against the JCR 1.0 specification. This module will likely be retired when the dna-jcr implementation + is complete. + + + + dna-integration-tests provides a home for all of the integration tests that involve more components that just unit tests. Integration tests are often more complicated, take longer, and involve testing the integration and functionality of many @@ -313,7 +328,7 @@ - dna-maven-classloader + dna-classloader-maven is a small library that provides a ClassLoaderFactory implementation that can create @@ -324,6 +339,12 @@ + dna-common-jdbc + contains several helpful utility classes for interacting with JDBC connections. + + + + dna-connector-federation is a DNA repository connector that federates, integrates and caches information from multiple sources (via other repository connectors). @@ -331,6 +352,21 @@ + dna-connector-filesystem + is a DNA repository connector that provides read-only access to file systems, allowing their structure and data to be + viewed as repository content. + + + + + dna-connector-jdbc-metadata + is a prototype DNA repository connector that provides read-only access to metadata from relational databases through a JDBC + connection. + This is still under development. + + + + dna-connector-jbosscache is a DNA repository connector that manages content within a JBoss Cache @@ -340,6 +376,13 @@ + dna-connector-store-jpa + is a DNA sequencer that provides for persistent storage and access of DNA content in a relational database. This connector + is based on JPA technology. + + + + dna-connector-svn is a prototype DNA sequencer that obtains content from a Subversion repository, providing that content in the form of nt:file and nt:folder nodes. @@ -390,8 +433,7 @@ dna-sequencer-cnd - is a prototype DNA sequencer that extracts JCR node definitions from JCR Compact Node Definition (CND) files. - This is still under development. + is a DNA sequencer that extracts JCR node definitions from JCR Compact Node Definition (CND) files. @@ -403,12 +445,19 @@ + dna-sequencer-java + is a DNA sequencer that extracts the structure (methods, fields) from Java source files. + + + + dna-mimetype-detector-aperture is a DNA MIME type detector that uses the Aperture library to determine the best MIME type from the filename and file contents. + There are also documentation modules (located in the source under the docs/ Index: trunk/docs/reference/src/main/docbook/en-US/content/jcr.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/jcr.xml (revision 844) +++ trunk/docs/reference/src/main/docbook/en-US/content/jcr.xml (working copy) @@ -35,7 +35,7 @@ Content Repository for Java technology API provides a standard Java API for working with content repositories. Abbreviated "JCR", this API was developed as part of the Java Community Process under JSR-170 (JCR 1.0) and is being revised under JSR-283. - JBoss DNA provides a JCR 1.0 implementation that allows you to work with the contents of a repository using the + JBoss DNA provides a partial JCR 1.0 implementation that allows you to work with the contents of a repository using the JCR API. For information about how to use the JCR API, please see the JSR-170 specification. Index: trunk/docs/reference/src/main/docbook/en-US/content/sequencing.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/sequencing.xml (revision 844) +++ trunk/docs/reference/src/main/docbook/en-US/content/sequencing.xml (working copy) @@ -341,17 +341,12 @@ Microsoft Office document sequencer - This sequencer is included in JBoss DNA and processes Microsoft Office documents, including Excel spreadsheets - and PowerPoint presentations. With presentations, the sequencer extracts the slides, titles, text and slide thumbnails. + This sequencer is included in JBoss DNA and processes Microsoft Office documents, including Word documents, Excel spreadsheets, + and PowerPoint presentations. With documents, the sequencer extracts the internal structure based on Heading styles. + With presentations, the sequencer extracts the slides, titles, text and slide thumbnails. With spreadsheets, the sequencer extracts the names of the sheets. And, the sequencer extracts for all the files the general file information, including the name of the author, title, keywords, subject, comments, and various dates. - - - Currently, Word documents are not supported. For more information and the latest status, see - DNA-153. - - To use this sequencer, simply include the dna-sequencer-msoffice JAR and all of the POI JARs @@ -441,10 +436,24 @@ JCR Compact Node Definition (CND) file sequencer - This sequencer is incomplete and is not currently usable. The purpose is to sequence JCR Compact Node Definition (CND) files - to extract the node definitions with their property definitions, and inserting these into the repository using JCR standard notation. + This sequencer processes JCR Compact Node Definition (CND) files + to extract the node definitions with their property definitions, and inserts these into the repository using JCR standard notation. + + jBPM JPDL file sequencer + + This sequencer is incomplete and is not currently usable. The purpose is to sequence jBPM JPDL files to identify metadata + about processes, their actors, and their dependencies. + + + + XML file sequencer + + This sequencer stores the structure and data of an XML file into the repository. + + + Creating custom sequencers