[dna-commits] DNA SVN: r498 - in trunk/docs: gettingstarted/src/main/docbook/en-US and 7 other directories.

Author: rhauch Date: 2008-09-04 14:58:12 -0400 (Thu, 04 Sep 2008) New Revision: 498 Added: trunk/docs/gettingstarted/src/main/docbook/en-US/master.xml trunk/docs/reference/src/ trunk/docs/reference/src/main/ trunk/docs/reference/src/main/docbook/ trunk/docs/reference/src/main/docbook/en-US/ trunk/docs/reference/src/main/docbook/en-US/content/ trunk/docs/reference/src/main/docbook/en-US/content/author_group.xml trunk/docs/reference/src/main/docbook/en-US/content/classloaders.xml trunk/docs/reference/src/main/docbook/en-US/content/configuration.xml trunk/docs/reference/src/main/docbook/en-US/content/development_environment.xml trunk/docs/reference/src/main/docbook/en-US/content/future.xml trunk/docs/reference/src/main/docbook/en-US/content/introduction.xml trunk/docs/reference/src/main/docbook/en-US/content/jcr.xml trunk/docs/reference/src/main/docbook/en-US/content/legal_notice.xml trunk/docs/reference/src/main/docbook/en-US/content/mimetypes.xml trunk/docs/reference/src/main/docbook/en-US/content/preface.xml trunk/docs/reference/src/main/docbook/en-US/content/repositories.xml trunk/docs/reference/src/main/docbook/en-US/content/security.xml trunk/docs/reference/src/main/docbook/en-US/content/sequencing.xml trunk/docs/reference/src/main/docbook/en-US/content/testing.xml trunk/docs/reference/src/main/docbook/en-US/images/ trunk/docs/reference/src/main/docbook/en-US/images/dna-logo.png trunk/docs/reference/src/main/docbook/en-US/master.xml Removed: trunk/docs/gettingstarted/src/main/docbook/en-US/Getting_Started.xml Modified: trunk/docs/gettingstarted/pom.xml trunk/docs/reference/pom.xml Log: Restructured the new Reference Guide document Modified: trunk/docs/gettingstarted/pom.xml =================================================================== --- trunk/docs/gettingstarted/pom.xml 2008-09-04 17:44:52 UTC (rev 497) +++ trunk/docs/gettingstarted/pom.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -18,10 +18,6 @@ <version>2.1.2</version> <extensions>true</extensions> <dependencies> - <!-- - <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-jdocbook-style</artifactId> - <version>1.0.2</version> <type>jdocbook-style</type> </dependency> - --> <dependency> <groupId>org.jboss</groupId> <artifactId>jbossorg-docbook-xslt</artifactId> @@ -35,7 +31,7 @@ </dependency> </dependencies> <configuration> - <sourceDocumentName>Getting_Started.xml</sourceDocumentName> + <sourceDocumentName>master.xml</sourceDocumentName> <imageResource> <directory>${basedir}/src/main/docbook/en-US/images</directory> <includes> Deleted: trunk/docs/gettingstarted/src/main/docbook/en-US/Getting_Started.xml =================================================================== --- trunk/docs/gettingstarted/src/main/docbook/en-US/Getting_Started.xml 2008-09-04 17:44:52 UTC (rev 497) +++ trunk/docs/gettingstarted/src/main/docbook/en-US/Getting_Started.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -1,59 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - ~ JBoss, Home of Professional Open Source. - ~ - ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as - ~ indicated by the @author tags or express copyright attribution - ~ statements applied by the authors. All third-party contributions are - ~ distributed under license by Red Hat Middleware LLC. - ~ - ~ This copyrighted material is made available to anyone wishing to use, modify, - ~ copy, or redistribute it subject to the terms and conditions of the GNU - ~ Lesser General Public License, as published by the Free Software Foundation. - ~ - ~ This program is distributed in the hope that it will be useful, - ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY - ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License - ~ for more details. - ~ - ~ You should have received a copy of the GNU Lesser General Public License - ~ along with this distribution; if not, write to: - ~ Free Software Foundation, Inc. - ~ 51 Franklin Street, Fifth Floor - ~ Boston, MA 02110-1301 USA - --> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -<!ENTITY versionNumber "0.3"> -<!ENTITY copyrightYear "2008"> -<!ENTITY copyrightHolder "Red Hat Middleware, LLC."> -]> -<book lang="en"> - <bookinfo> - <title>JBoss DNA</title> - <subtitle>Getting Started Guide</subtitle> - <releaseinfo>&versionNumber;</releaseinfo> - <productnumber>&versionNumber;</productnumber> - <issuenum>1</issuenum> - <mediaobject> - <imageobject role="fo"> - <imagedata fileref="dna-logo.png" align="center"/> - </imageobject> - <imageobject role="html"> - <imagedata fileref="dna-logo.png" depth="3cm"/> - </imageobject> - </mediaobject> - <copyright> - <year>&copyrightYear;</year> - <holder>&copyrightHolder;</holder> - </copyright> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/author_group.xml"/> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/legal_notice.xml"/> - </bookinfo> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/preface.xml"/> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/introduction.xml"/> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/understanding_dna.xml"/> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/downloading_and_running.xml"/> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/using_dna.xml"/> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/custom_sequencers.xml"/> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/future.xml"/> -</book> Copied: trunk/docs/gettingstarted/src/main/docbook/en-US/master.xml (from rev 497, trunk/docs/gettingstarted/src/main/docbook/en-US/Getting_Started.xml) =================================================================== --- trunk/docs/gettingstarted/src/main/docbook/en-US/master.xml (rev 0) +++ trunk/docs/gettingstarted/src/main/docbook/en-US/master.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY versionNumber "0.3"> +<!ENTITY copyrightYear "2008"> +<!ENTITY copyrightHolder "Red Hat Middleware, LLC."> +]> +<book lang="en"> + <bookinfo> + <title>JBoss DNA</title> + <subtitle>Getting Started Guide</subtitle> + <releaseinfo>&versionNumber;</releaseinfo> + <productnumber>&versionNumber;</productnumber> + <issuenum>1</issuenum> + <mediaobject> + <imageobject role="fo"> + <imagedata fileref="dna-logo.png" align="center"/> + </imageobject> + <imageobject role="html"> + <imagedata fileref="dna-logo.png" depth="3cm"/> + </imageobject> + </mediaobject> + <copyright> + <year>&copyrightYear;</year> + <holder>&copyrightHolder;</holder> + </copyright> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/author_group.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/legal_notice.xml"/> + </bookinfo> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/preface.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/introduction.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/understanding_dna.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/downloading_and_running.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/using_dna.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/custom_sequencers.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/future.xml"/> +</book> Modified: trunk/docs/reference/pom.xml =================================================================== --- trunk/docs/reference/pom.xml 2008-09-04 17:44:52 UTC (rev 497) +++ trunk/docs/reference/pom.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -1,17 +1,75 @@ -<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> - - <modelVersion>4.0.0</modelVersion> - - <parent> - <groupId>org.jboss</groupId> - <artifactId>documentation</artifactId> - <version>1.0</version> - </parent> - - <groupId>org.jboss.dna</groupId> - <artifactId>reference-guide-${translation}</artifactId> - <version>0.2-SNAPSHOT</version> - <packaging>jdocbook</packaging> - <name>JBoss DNA Reference Guide (${translation})</name> - +<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> + <modelVersion>4.0.0</modelVersion> + <!-- + parent> <groupId>org.jboss</groupId> <artifactId>documentation</artifactId> <version>1.0</version> </parent + --> + <groupId>org.jboss.dna</groupId> + <artifactId>reference-guide-en</artifactId> + <version>0.2-SNAPSHOT</version> + <packaging>jdocbook</packaging> + <name>JBoss DNA Reference Guide</name> + <description>The reference guide for JBoss DNA developers and advanced users</description> + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.1.2</version> + <extensions>true</extensions> + <dependencies> + <dependency> + <groupId>org.jboss</groupId> + <artifactId>jbossorg-docbook-xslt</artifactId> + <version>1.1.0.Beta1</version> + </dependency> + <dependency> + <groupId>org.jboss</groupId> + <artifactId>jbossorg-jdocbook-style</artifactId> + <version>1.1.0.Beta1</version> + <type>jdocbook-style</type> + </dependency> + </dependencies> + <configuration> + <sourceDocumentName>master.xml</sourceDocumentName> + <imageResource> + <directory>${basedir}/src/main/docbook/en-US/images</directory> + <includes> + <include>*.png</include> + </includes> + </imageResource> + <!-- cssResource> + <directory>${basedir}/src/main/docbook/css</directory> + </cssResource--> + <targetDirectory>${basedir}/target/docbook/en-US</targetDirectory> + <formats> + <format> + <formatName>html</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <!-- + <format> + <formatName>html_single</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + --> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource> + <finalName>userguide_en.pdf</finalName> + </format> + </formats> + <options> + <xincludeSupported>true</xincludeSupported> + <xmlTransformerType>saxon</xmlTransformerType> + <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme --> + <!-- could also locate the docbook dependency and inspect its version... --> + <docbookVersion>1.72.0</docbookVersion> + </options> + </configuration> + </plugin> + </plugins> + </build> </project> \ No newline at end of file Added: trunk/docs/reference/src/main/docbook/en-US/content/author_group.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/author_group.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/author_group.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,28 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<authorgroup> + <corpauthor>Randall M. Hauch</corpauthor> +</authorgroup> \ No newline at end of file Added: trunk/docs/reference/src/main/docbook/en-US/content/classloaders.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/classloaders.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/classloaders.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,33 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<chapter id="classloaders"> + <title>Class loaders</title> + <para></para> + <sect1 id="dna-maven-classloader"> + <title>Maven Repository class loader</title> + <para></para> + </sect1> +</chapter> Added: trunk/docs/reference/src/main/docbook/en-US/content/configuration.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/configuration.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/configuration.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,34 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<chapter id="configuration"> + <title>Configuration</title> + <para> + Discuss how to configure JBoss DNA and how configuration repositories are used to bootstrap the various services and + components. Describe how the next release will focus on making this easier and will detail configuration using the + <ulink url="http://www.jboss.org/jbossmc/">JBoss Microcontainer</ulink> + . + </para> +</chapter> Added: trunk/docs/reference/src/main/docbook/en-US/content/development_environment.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/development_environment.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/development_environment.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,31 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<chapter id="development-environment"> + <title>Developer environment and tooling</title> + <para> + Discuss our use of Maven, Eclipse, coding styles/preferences, SVN, Hudson, etc. + </para> +</chapter> Added: trunk/docs/reference/src/main/docbook/en-US/content/future.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/future.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/future.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,43 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<chapter id="future"> + <title>Looking to the future</title> + <para>What's next for JBoss DNA? Well, the sequencing system is just the beginning. With this release, the sequencing system + is stable enough so that more <link linkend="sequencers">sequencers</link> can be developed and used within your own applications. + If you're interested in getting involved with the JBoss DNA project, consider picking up one of the sequencers on our + <ulink url="http://jira.jboss.org/jira/browse/DNA?report=com.atlassian.jira...;. + Or, check out <ulink url="http://jira.jboss.org/jira/secure/IssueNavigator.jspa?reset=tru... + for the list of sequencers we've thought of. If you think of one that's not there, please add it to JIRA! </para> + <para>The next release will focus on creating the <link linkend="federation">federation engine</link> and connectors + for several popular and ubiquitous systems. The 0.2 release will likely only federate information in a read-only manner, + but updates will soon follow. Also, during the early part of the next release, the JBoss DNA project will switch to use JDK 6. + Java 5 is being end-of-lifed, so we want to move to a supported JDK. However, a number of JBoss projects and products continue to + require Java 5, so our next release will most likely use JDK 6 with Java 5 compatibility.</para> + <para>Other components on our roadmap include a web user interface, a REST-ful server, and a view system that allows domain-specific + views of information in the repository. These components are farther out on our roadmap, and at this time have not been + targeted to a particular release. If any of these are of interest to you, please <link linkend="preface">get involved</link> + in the community.</para> +</chapter> Added: trunk/docs/reference/src/main/docbook/en-US/content/introduction.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/introduction.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/introduction.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,302 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<chapter id="introduction"> + <title>Introduction to JBoss DNA</title> + <para>There are a lot of choices for how applications can store information persistently so that it can be accessed at a + later time and by other processes. The challenge developers face is how to use an approach that most closely matches the + needs of their application. This choice becomes more important as developers choose to focus their efforts on + application-specific logic, delegating much of the responsibilities for persistence to libraries and frameworks.</para> + <para> + Perhaps one of the easiest techniques is to simply store information in + <emphasis>files</emphasis> + . The Java language makes working with files relatively easy, but Java really doesn't provide many bells and whistles. So + using files is an easy choice when the information is either not complicated (for example property files), or when users may + need to read or change the information outside of the application (for example log files or configuration files). But using + files to persist information becomes more difficult as the information becomes more complex, as the volume of it increases, + or if it needs to be accessed by multiple processes. For these situations, other techniques often offer better choices. + </para> + <para> + Another technique built into the Java language is + <emphasis>Java serialization</emphasis> + , which is capable of persisting the state of an object graph so that it can be read back in at a later time. However, Java + serialization can quickly become tricky if the classes are changed, and so it's beneficial usually when the information is + persisted for a very short period of time. For example, serialization is sometimes used to send an object graph from one + process to another. + </para> + <para> + One of the more popular persistence technologies is the + <emphasis>relational database</emphasis> + . Relational database management systems have been around for decades and are very capable. The Java Database Connectivity + (JDBC) API provides a standard interface for connecting to and interacting with relational databases. However, it is a + low-level API that requires a lot of code to use correctly, and it still doesn't abstract away the DBMS-specific SQL + grammar. Also, working with relational data in an object-oriented language can feel somewhat unnatural, so many developers + map this data to classes that fit much more cleanly into their application. The problem is that manually creating this + mapping layer requires a lot of repetitive and non-trivial JDBC code. + </para> + <para> + <emphasis>Object-relational mapping</emphasis> + libraries automate the creation of this mapping layer and result in far less code that is much more maintainable with + performance that is often as good as (if not better than) handwritten JDBC code. The new + <ulink url="http://java.sun.com/developer/technicalArticles/J2EE/jpa/"... Persistence API (JPA)</ulink> + provide a standard mechanism for defining the mappings (through annotations) and working with these entity objects. Several + commercial and open-source libraries implement JPA, and some even offer additional capabilities and features that go beyond + JPA. For example, + <ulink url="http://www.hibernate.org">Hibernate</ulink> + is one of the most feature-rich JPA implementations and offers object caching, statement caching, extra association + mappings, and other features that help to improve performance and usefulness. + </para> + <para> + While relational databases and JPA are solutions that work for many applications, they become more limited in cases when the + information structure is highly flexible, is not known + <emphasis>a priori</emphasis> + , or is subject to frequent change and customization. In these situations, + <emphasis>content repositories</emphasis> + may offer a better choice for persistence. Content repositories are almost a hybrid between relational databases and file + systems, and typically provide other capabilities as well, including versioning, indexing, search, access control, + transactions, and observation. Because of this, content repositories are used by content management systems (CMS), document + management systems (DMS), and other applications that manage electronic files (e.g., documents, images, multi-media, web + content, etc.) and metadata associated with them (e.g., author, date, status, security information, etc.). The + <ulink url="http://www.jcp.org/en/jsr/detail?id=170">Content Repository for Java technology API</ulink> + provides a standard Java API for working with content repositories. Abbreviated "JCR", this API was developed as part of the + Java Community Process under + <ulink url="http://www.jcp.org/en/jsr/detail?id=170">JSR-170</ul... + and is being revised under + <ulink url="http://www.jcp.org/en/jsr/detail?id=283">JSR-283</ul... + . + </para> + <para> + The + <emphasis>JBoss DNA project</emphasis> + is building the tools and services that surround content repositories. Nearly all of these capabilities are to be hidden + below the JCR API and involve automated processing of the information in the repository. Thus, JBoss DNA can add value to + existing repository implementations. For example, JCR repositories offer the ability to upload files into the repository and + have the file content indexed for search purposes. JBoss DNA also defines a library for "sequencing" content - to extract + meaningful information from that content and store it in the repository, where it can then be searched, accessed, and + analyzed using the JCR API. + </para> + <para> JBoss DNA is building other features as well. One goal of JBoss DNA is to create federated repositories that + dynamically merge the information from multiple databases, services, applications, and other JCR repositories. Another is 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 + to create a REST-ful API to allow the JCR content to be accessed easily by other applications written in other languages. + </para> + <sect1 id="roadmap"> + <title>Project roadmap</title> + <para> + The roadmap for JBoss DNA is managed in the project's + <ulink url="https://jira.jboss.org/jira/browse/DNA">JIRA instance</ulink> + . The roadmap shows the different tasks, requirements, issues and other activities that have been targeted to each of the + upcoming releases. (The + <ulink url="https://jira.jboss.org/jira/browse/DNA?report=com.atlassian.jir... report</ulink> + always shows the next three releases.) + </para> + <para> + By convention, JIRA issues not immediately targeted to a release will be reviewed periodically to determine the + appropriate release where they can be targeted. Any issue that is reviewed and that does not fit in a known release will + be targeted to the + <ulink url="https://jira.jboss.org/jira/browse/DNA?report=com.atlassian.jir... Releases</ulink> + bucket. This should be reviewed periodically and at least at the beginning of each release cycle, with the goal of + targeting most of the issues to specific releases. + </para> + </sect1> + <sect1 id="modules"> + <title>JBoss DNA modules</title> + <para> + JBoss DNA consists of the following modules: + <itemizedlist> + <listitem> + <para> + <emphasis role="strong">dna-common</emphasis> + is a low-level library of common utilities and frameworks, including logging, progress monitoring, + internationalization/localization, text translators, component management, and class loader factories. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-spi</emphasis> + defines the Service Provider Interface (SPI) for DNA, including the repository connectors, sequencers, graph + interfaces, and MIME type detectors. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-repository</emphasis> + is the main module and provides the repository-oriented services, including the Repository Service, Sequencing + Service, Observation Service, and Rules Service. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-jcr</emphasis> + provides the JBoss DNA implementation of the JCR API, which relies upon a repository connector, such as the + Federation Connector (see + <code>dna-connector-federation</code> + ). + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-integration-tests</emphasis> + 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 + components (whereas unit tests focus on testing a single class or component and may use stubs or mock objects for + other components). + </para> + </listitem> + </itemizedlist> + The following modules are optional extensions that may be used selectively and as needed (and are located in the source + under the + <code>extensions</code> + directory): + <itemizedlist> + <listitem> + <para> + <emphasis role="strong">dna-maven-classloader</emphasis> + is a small library that provides a + <code>ClassLoaderFactory</code> + implementation that can create + <code>java.lang.ClassLoader</code> + instances capable of loading classes given a Maven Repository and a list of Maven coordinates. The Maven Repository + can be managed within a JCR repository. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-connector-federation</emphasis> + is a DNA repository connector that federates, integrates and caches information from multiple sources (via other + repository connectors). + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-connector-inmemory</emphasis> + is a simple DNA repository connector that manages content within memory. This can be used as a simple cache or as a + transient repository. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-connector-jbosscache</emphasis> + is a DNA repository connector that manages content within a + <ulink url="http://www.jboss.org/jbosscache/">JBoss Cache</ulink> + instance. JBoss Cache is a powerful cache implementation that can serve as a distributed cache and that can persist + information. The cache instance can be found via JNDI or created and managed by the connector. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-sequencer-zip</emphasis> + is a DNA sequencer that extracts from ZIP archives the files (with content) and folders. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-sequencer-images</emphasis> + is a DNA sequencer that extracts the image metadata (e.g., size, date, etc.) from PNG, JPEG, GIF, BMP, PCS, IFF, + RAS, PBM, PGM, and PPM image files. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-sequencer-mp3</emphasis> + is a DNA sequencer that extracts metadata (e.g., author, album name, etc.) from MP3 audio files. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-sequencer-java</emphasis> + is a DNA sequencer that extracts the package, class/type, member, documentation, annotations, and other information + from Java source files. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-sequencer-msoffice</emphasis> + is a DNA sequencer that extracts metadata and summary information from + <ulink url="http://office.microsoft.com/en-us/">Microsoft Office</ulink> + documents. For example, the sequencer extracts from a PowerPoint presentation the outline as well as thumbnails of + each slide. Microsoft Word and Excel files are also supported. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-sequencer-cnd</emphasis> + is a DNA sequencer that extracts JCR node definitions from JCR Compact Node Definition (CND) files. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">dna-mimetype-detector-aperture</emphasis> + is a DNA MIME type detector that uses the + <ulink url="http://aperture.sourceforge.net/">Aperture</ulink> + library to determine the best MIME type from the filename and file contents. + </para> + </listitem> + </itemizedlist> + There are also documentation modules (located in the source under the + <code>docs</code> + directory): + <itemizedlist> + <listitem> + <para> + <emphasis role="strong">docs-getting-started</emphasis> + is the project with the + <ulink url="http://www.docbook.org/">DocBook</ulink> + source for the JBoss DNA Getting Started document. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">docs-getting-started-examples</emphasis> + is the project with the Java source for the example application used in the JBoss DNA Getting Started document. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">docs-reference-guide</emphasis> + is the project with the + <ulink url="http://www.docbook.org/">DocBook</ulink> + source for this document, the JBoss DNA Reference Guide document. + </para> + </listitem> + </itemizedlist> + Finally, there is a module that represents the whole JBoss DNA project: + <itemizedlist> + <listitem> + <para> + <emphasis role="strong">dna</emphasis> + is the parent project that aggregates all of the other projects and that contains some asset files to create the + necessary Maven artifacts during a build. + </para> + </listitem> + </itemizedlist> + Each of these modules is a Maven project with a group ID of + <code>org.jboss.dna</code> + . All of these projects correspond to artifacts in the + <ulink url="http://repository.jboss.com/maven2/">JBoss Maven 2 Repository</ulink> + . + </para> + </sect1> +</chapter> Added: trunk/docs/reference/src/main/docbook/en-US/content/jcr.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/jcr.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/jcr.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,38 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<chapter id="jcr"> + <title>Content Repositories for Java (JCR)</title> + <para></para> + <sect1 id="jcr-repositories"> + <title>Obtaining JCR repositories</title> + <para>Discuss how to obtain JCR repository instances (from the Repository Service).</para> + </sect1> + <sect1 id="jcr-sessions"> + <title>Creating JCR sessions</title> + <para>Discuss how to obtain JCR sessions and how the credentials work. Also discuss that sessions should be created, + used, and closed.</para> + </sect1> +</chapter> Added: trunk/docs/reference/src/main/docbook/en-US/content/legal_notice.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/legal_notice.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/legal_notice.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<legalnotice id="Legal_Notice"> + <title>Legal Notice</title> + <para> + <address> + <street>1801 Varsity Drive</street> + <city>Raleigh</city>, <state>NC</state><postcode>27606-2072</postcode><country>USA</country> + <phone>Phone: +1 919 754 3700</phone> + <phone>Phone: 888 733 4281</phone> + <fax>Fax: +1 919 754 3701</fax> + <pob>PO Box 13588</pob><city>Research Triangle Park</city>, <state>NC</state><postcode>27709</postcode><country>USA</country> + </address> + </para> + <para> + Copyright <trademark class="copyright"/> 2007 by Red Hat, Inc. This copyrighted material is made available to + anyone wishing to use, modify, copy, or redistribute it subject to the terms and conditions of the + GNU <ulink url="http://www.gnu.org/licenses/lgpl-2.1.html">Lesser General Public License</ulink>, as published + by the Free Software Foundation. + </para> + <para> + Red Hat and the Red Hat "Shadow Man" logo are registered trademarks of Red Hat, Inc. in the United States and other countries. + </para> + <para> + All other trademarks referenced herein are the property of their respective owners. + </para> + <para> + The GPG fingerprint of the security(a)redhat.com key is: + </para> + <para> + CA 20 86 86 2B D6 9D FC 65 F6 EC C4 21 91 80 CD DB 42 A6 0E + </para> +</legalnotice> Added: trunk/docs/reference/src/main/docbook/en-US/content/mimetypes.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/mimetypes.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/mimetypes.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,41 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<chapter id="mimetypes"> + <title>MIME types</title> + <para></para> + <sect1 id="detectors"> + <title>JBoss DNA MIME type detectors</title> + <para></para> + <sect2 id="dna-mimetype-detector-aperture"> + <title>Aperture MIME type detector</title> + <para></para> + </sect2> + </sect1> + <sect1 id="custom-detectors"> + <title>Writing custom detectors</title> + <para></para> + </sect1> +</chapter> Added: trunk/docs/reference/src/main/docbook/en-US/content/preface.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/preface.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/preface.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,44 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<preface id="preface"> + <title>Target audience</title> + <para> + This guide is for the developers of JBoss DNA and those users that want to have a better understanding of how JBoss DNA + works or how to extend the functionality. For a higher-level introduction to JBoss DNA, see the + <ulink url="http://www.jboss.org/file-access/default/members/dna/freezone/d... Started</ulink> + document. + </para> + <para> + If you have any questions or comments, please feel free to contact JBoss DNA's + <ulink url="mailto:dna-users@jboss.org">user mailing list</ulink> or use the + <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... forums</ulink>. + If you'd like to get involved on the project, join the <ulink url="http://www.jboss.org/dna/lists.html">mailing lists</ulink>, + <ulink url="http://www.jboss.org/dna/subversion.html">download the code</ulink> and get it building, and visit our + <ulink url="http://jira.jboss.org/jira/browse/DNA">JIRA issue management system</ulink>. + If there's something in particular you're interested in, talk with the community - there may be others interested in the + same thing. + </para> +</preface> Added: trunk/docs/reference/src/main/docbook/en-US/content/repositories.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/repositories.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/repositories.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<chapter id="repositories"> + <title>Repositories</title> + <para></para> + <sect1 id="repository-service"> + <title>Repository Service</title> + <para></para> + </sect1> + <sect1 id="connectors"> + <title>Repository connectors and sources</title> + <para></para> + <sect2 id="dna-connector-inmemory"> + <title>In-memory connector</title> + <para></para> + </sect2> + <sect2 id="dna-connector-jbosscache"> + <title>JBoss Cache connector</title> + <para></para> + </sect2> + <sect2 id="dna-connector-federation"> + <title>Federating connector</title> + <para></para> + </sect2> + </sect1> + <sect1 id="custom-connectors"> + <title>Writing custom connectors</title> + <para></para> + </sect1> +</chapter> Added: trunk/docs/reference/src/main/docbook/en-US/content/security.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/security.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/security.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,91 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<chapter id="security"> + <title>Security</title> + <para> + JBoss DNA uses the + <ulink url="http://java.sun.com/javase/technologies/security/">Java Authentication and Authorization Service (JAAS)</ulink> + for its security mechanism. This offers the greatest flexibility and power for integrating JBoss DNA into other + applications. + </para> + <sect1 id="jboss-security"> + <title>JBoss Security</title> + <para> + The + <ulink url="http://www.jboss.org/jbosssecurity/">JBoss Security</ulink> + provides one of the best and most powerful implementations of the JAAS specification - plus it's open source. JBoss + Security offers a number of login modules, including: + <itemizedlist> + <listitem> + <para> + <emphasis role="strong">User-Roles Login Module</emphasis> + is a simple + <code>javax.security.auth.login.LoginContext</code> + implementation that uses usernames and passwords stored in a properties file. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">Client Login Module</emphasis> + prompts the user for their username and password. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">Database Server Login Module</emphasis> + uses a JDBC database to authenticate principals and associate them with roles. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">LDAP Login Module</emphasis> + uses an LDAP directory to authenticate principals. Two implementations are available. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">Certificate Login Module</emphasis> + authenticates using X509 certificates, obtaining roles from either property files or a JDBC database. + </para> + </listitem> + <listitem> + <para> + <emphasis role="strong">Operating System Login Module</emphasis> + authenticates using the operating system's mechanism. + </para> + </listitem> + </itemizedlist> + and many others. + </para> + <para> + JBoss Security also provides other capabilities, such as using XACML policies or using federated single sign-on. For more + detail, see the + <ulink url="http://www.jboss.org/jbosssecurity/">JBoss Security</ulink> + project. + </para> + </sect1> +</chapter> + Added: trunk/docs/reference/src/main/docbook/en-US/content/sequencing.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/sequencing.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/sequencing.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<chapter id="sequencing"> + <title>Sequencing content</title> + <para></para> + <sect1 id="sequencing-service"> + <title>Sequencing Service</title> + <para></para> + </sect1> + <sect1 id="sequencers"> + <title>JBoss DNA Sequencers</title> + <para></para> + <sect2 id="dna-sequencer-images"> + <title>Image sequencer</title> + <para></para> + </sect2> + <sect2 id="dna-sequencer-msoffice"> + <title>Microsoft Office document sequencer</title> + <para></para> + </sect2> + <sect2 id="dna-sequencer-zip"> + <title>ZIP archive sequencer</title> + <para></para> + </sect2> + <sect2 id="dna-sequencer-java"> + <title>Java source sequencer</title> + <para>The JBoss DNA makes somes extensions available to clients and one of these extensions is the <emphasis role="strong">dna-sequence-java</emphasis>, + the sequencer tool for java source. + The Java source sequencer sequences any kind of java source with "*.java" extension and extras meaningful informations from this + file. The tool may have the ability to sequence any type of java compilation units (class declaration, interface declaration, + and enum declaration), that are stored in a content repository. + </para> + </sect2> + <sect2 id="dna-sequencer-mp3"> + <title>MP3 audio file sequencer</title> + <para></para> + </sect2> + <sect2 id="dna-sequencer-cnd"> + <title>JCR Compact Node Definition (CND) file sequencer</title> + <para></para> + </sect2> + </sect1> + <sect1 id="custom-sequencers"> + <title>Writing custom sequencers</title> + <para></para> + </sect1> +</chapter> Added: trunk/docs/reference/src/main/docbook/en-US/content/testing.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/content/testing.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/content/testing.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,37 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<chapter id="testing"> + <title>Testing</title> + <para></para> + <sect1 id="unit-tests"> + <title>Unit tests</title> + <para></para> + </sect1> + <sect1 id="integration-tests"> + <title>Integration tests</title> + <para></para> + </sect1> +</chapter> Added: trunk/docs/reference/src/main/docbook/en-US/images/dna-logo.png =================================================================== (Binary files differ) Property changes on: trunk/docs/reference/src/main/docbook/en-US/images/dna-logo.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/docs/reference/src/main/docbook/en-US/master.xml =================================================================== --- trunk/docs/reference/src/main/docbook/en-US/master.xml (rev 0) +++ trunk/docs/reference/src/main/docbook/en-US/master.xml 2008-09-04 18:58:12 UTC (rev 498) @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ JBoss, Home of Professional Open Source. + ~ + ~ Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as + ~ indicated by the @author tags or express copyright attribution + ~ statements applied by the authors. All third-party contributions are + ~ distributed under license by Red Hat Middleware LLC. + ~ + ~ This copyrighted material is made available to anyone wishing to use, modify, + ~ copy, or redistribute it subject to the terms and conditions of the GNU + ~ Lesser General Public License, as published by the Free Software Foundation. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + ~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License + ~ for more details. + ~ + ~ You should have received a copy of the GNU Lesser General Public License + ~ along with this distribution; if not, write to: + ~ Free Software Foundation, Inc. + ~ 51 Franklin Street, Fifth Floor + ~ Boston, MA 02110-1301 USA + --> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY versionNumber "0.3"> +<!ENTITY copyrightYear "2008"> +<!ENTITY copyrightHolder "Red Hat Middleware, LLC."> +]> +<book lang="en"> + <bookinfo> + <title>JBoss DNA</title> + <subtitle>Getting Started Guide</subtitle> + <releaseinfo>&versionNumber;</releaseinfo> + <productnumber>&versionNumber;</productnumber> + <issuenum>1</issuenum> + <mediaobject> + <imageobject role="fo"> + <imagedata fileref="dna-logo.png" align="center"/> + </imageobject> + <imageobject role="html"> + <imagedata fileref="dna-logo.png" depth="3cm"/> + </imageobject> + </mediaobject> + <copyright> + <year>&copyrightYear;</year> + <holder>&copyrightHolder;</holder> + </copyright> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/author_group.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/legal_notice.xml"/> + </bookinfo> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/preface.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/introduction.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/development_environment.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/classloaders.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/security.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/repositories.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/jcr.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/sequencing.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/mimetypes.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/configuration.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/testing.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="content/future.xml"/> +</book>