DNA SVN: r164 - trunk/dna-integration-tests.
by dna-commits＠lists.jboss.org
Author: rhauch
Date: 2008-05-13 19:45:41 -0400 (Tue, 13 May 2008)
New Revision: 164
Modified:
trunk/dna-integration-tests/pom.xml
Log:
Another trial of setting version information for the Maven 2 release plugin
Modified: trunk/dna-integration-tests/pom.xml
===================================================================
--- trunk/dna-integration-tests/pom.xml 2008-05-13 22:52:21 UTC (rev 163)
+++ trunk/dna-integration-tests/pom.xml 2008-05-13 23:45:41 UTC (rev 164)
@@ -34,7 +34,7 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>0.1-SNAPSHOT</version>
+ <version>${dna-version}</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
15 years, 12 months
DNA SVN: r163 - in trunk: dna-maven-classloader and 5 other directories.
by dna-commits＠lists.jboss.org
Author: rhauch
Date: 2008-05-13 18:52:21 -0400 (Tue, 13 May 2008)
New Revision: 163
Modified:
trunk/dna-integration-tests/pom.xml
trunk/dna-maven-classloader/pom.xml
trunk/dna-repository/pom.xml
trunk/dna-spi/pom.xml
trunk/docs/examples/gettingstarted/sequencers/pom.xml
trunk/sequencers/dna-sequencer-images/pom.xml
trunk/sequencers/dna-sequencer-mp3/pom.xml
Log:
Another attempt to get the dependency versions to work with the Maven release plugin.
Modified: trunk/dna-integration-tests/pom.xml
===================================================================
--- trunk/dna-integration-tests/pom.xml 2008-05-13 22:42:09 UTC (rev 162)
+++ trunk/dna-integration-tests/pom.xml 2008-05-13 22:52:21 UTC (rev 163)
@@ -22,22 +22,19 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-maven-classloader</artifactId>
- <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-repository</artifactId>
- <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${dna-version}</version>
+ <version>0.1-SNAPSHOT</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
Modified: trunk/dna-maven-classloader/pom.xml
===================================================================
--- trunk/dna-maven-classloader/pom.xml 2008-05-13 22:42:09 UTC (rev 162)
+++ trunk/dna-maven-classloader/pom.xml 2008-05-13 22:52:21 UTC (rev 163)
@@ -22,12 +22,11 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${dna-version}</version>
+ <version>0.1-SNAPSHOT</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
Modified: trunk/dna-repository/pom.xml
===================================================================
--- trunk/dna-repository/pom.xml 2008-05-13 22:42:09 UTC (rev 162)
+++ trunk/dna-repository/pom.xml 2008-05-13 22:52:21 UTC (rev 163)
@@ -22,19 +22,17 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${dna-version}</version>
+ <version>0.1-SNAPSHOT</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-spi</artifactId>
- <version>${dna-version}</version>
</dependency>
<!--
Rules
Modified: trunk/dna-spi/pom.xml
===================================================================
--- trunk/dna-spi/pom.xml 2008-05-13 22:42:09 UTC (rev 162)
+++ trunk/dna-spi/pom.xml 2008-05-13 22:52:21 UTC (rev 163)
@@ -22,12 +22,11 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${dna-version}</version>
+ <version>0.1-SNAPSHOT</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
Modified: trunk/docs/examples/gettingstarted/sequencers/pom.xml
===================================================================
--- trunk/docs/examples/gettingstarted/sequencers/pom.xml 2008-05-13 22:42:09 UTC (rev 162)
+++ trunk/docs/examples/gettingstarted/sequencers/pom.xml 2008-05-13 22:52:21 UTC (rev 163)
@@ -20,18 +20,27 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-repository</artifactId>
+ <version>0.1-SNAPSHOT</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
+ <version>0.1-SNAPSHOT</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-sequencer-images</artifactId>
+ <version>0.1-SNAPSHOT</version>
<scope>runtime</scope>
</dependency>
+ <dependency>
+ <groupId>org.jboss.dna</groupId>
+ <artifactId>dna-sequencer-mp3</artifactId>
+ <version>0.1-SNAPSHOT</version>
+ <scope>runtime</scope>
+ </dependency>
<!--
Logging (require SLF4J API for compiling, but use Log4J and its SLF4J binding for testing)
-->
@@ -73,11 +82,6 @@
<artifactId>junit</artifactId>
<scope>test</scope>
</dependency>
- <dependency>
- <groupId>org.jboss.dna</groupId>
- <artifactId>dna-sequencer-mp3</artifactId>
- <version>0.1-SNAPSHOT</version>
- </dependency>
</dependencies>
<build>
Modified: trunk/sequencers/dna-sequencer-images/pom.xml
===================================================================
--- trunk/sequencers/dna-sequencer-images/pom.xml 2008-05-13 22:42:09 UTC (rev 162)
+++ trunk/sequencers/dna-sequencer-images/pom.xml 2008-05-13 22:52:21 UTC (rev 163)
@@ -34,14 +34,14 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${dna-version}</version>
+ <version>0.1-SNAPSHOT</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-spi</artifactId>
- <version>${dna-version}</version>
+ <version>0.1-SNAPSHOT</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
Modified: trunk/sequencers/dna-sequencer-mp3/pom.xml
===================================================================
--- trunk/sequencers/dna-sequencer-mp3/pom.xml 2008-05-13 22:42:09 UTC (rev 162)
+++ trunk/sequencers/dna-sequencer-mp3/pom.xml 2008-05-13 22:52:21 UTC (rev 163)
@@ -19,12 +19,10 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-spi</artifactId>
- <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jaudiotagger</groupId>
15 years, 12 months
DNA SVN: r162 - trunk.
by dna-commits＠lists.jboss.org
Author: rhauch
Date: 2008-05-13 18:42:09 -0400 (Tue, 13 May 2008)
New Revision: 162
Modified:
trunk/pom.xml
Log:
Changed DNA version to use explicit version, so that it works with the Maven release plugin
Modified: trunk/pom.xml
===================================================================
--- trunk/pom.xml 2008-05-13 22:26:35 UTC (rev 161)
+++ trunk/pom.xml 2008-05-13 22:42:09 UTC (rev 162)
@@ -28,7 +28,7 @@
</modules>
<properties>
- <dna-version>${project.version}</dna-version>
+ <dna-version>0.1-SNAPSHOT</dna-version>
</properties>
<profiles>
<profile>
15 years, 12 months
DNA SVN: r161 - in trunk/docs/gettingstarted/en: images and 1 other directory.
by dna-commits＠lists.jboss.org
Author: rhauch
Date: 2008-05-13 18:26:35 -0400 (Tue, 13 May 2008)
New Revision: 161
Added:
trunk/docs/gettingstarted/en/images/example-sequencer-search-with-mp3.png
Modified:
trunk/docs/gettingstarted/en/images/example-sequencer-search.png
trunk/docs/gettingstarted/en/images/example-sequencer-statistics.png
trunk/docs/gettingstarted/en/master.xml
Log:
Revisions to the screenshots to address uploading the MP3 audio file.
Added: trunk/docs/gettingstarted/en/images/example-sequencer-search-with-mp3.png
===================================================================
(Binary files differ)
Property changes on: trunk/docs/gettingstarted/en/images/example-sequencer-search-with-mp3.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: trunk/docs/gettingstarted/en/images/example-sequencer-search.png
===================================================================
(Binary files differ)
Modified: trunk/docs/gettingstarted/en/images/example-sequencer-statistics.png
===================================================================
(Binary files differ)
Modified: trunk/docs/gettingstarted/en/master.xml
===================================================================
--- trunk/docs/gettingstarted/en/master.xml 2008-05-13 22:07:45 UTC (rev 160)
+++ trunk/docs/gettingstarted/en/master.xml 2008-05-13 22:26:35 UTC (rev 161)
@@ -985,6 +985,11 @@
<title>Searching for media using the Example Client</title>
<graphic align="center" scale="100" fileref="images/example-sequencer-search.png" />
</figure>
+ Here are the search results after the <code>sample1.mp3</code> audio file has been uploaded (to the <code>/a/b/sample1.mp3</code> location):
+ <figure id="example-sequencer-search-with-mp3">
+ <title>Searching for media using the Example Client</title>
+ <graphic align="center" scale="100" fileref="images/example-sequencer-search-with-mp3.png" />
+ </figure>
You can also display the sequencing statistics using the "d" menu option:
<figure id="example-sequencer-statistics">
<title>Sequencing statistics using the Example Client</title>
15 years, 12 months
DNA SVN: r160 - trunk/docs/gettingstarted/en.
by dna-commits＠lists.jboss.org
Author: rhauch
Date: 2008-05-13 18:07:45 -0400 (Tue, 13 May 2008)
New Revision: 160
Modified:
trunk/docs/gettingstarted/en/master.xml
Log:
More corrections, including a change to include the MP3 sequencer in the document.
Modified: trunk/docs/gettingstarted/en/master.xml
===================================================================
--- trunk/docs/gettingstarted/en/master.xml 2008-05-13 22:06:57 UTC (rev 159)
+++ trunk/docs/gettingstarted/en/master.xml 2008-05-13 22:07:45 UTC (rev 160)
@@ -829,6 +829,14 @@
<listitem>
<para>
<emphasis role="strong">
+ <code>sample1.mp3</code>
+ </emphasis>
+ is a sample MP3 audio file you'll use later to upload into the repository.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="strong">
<code>caution.gif</code>
</emphasis>, <emphasis role="strong">
<code>caution.png</code>
@@ -863,9 +871,11 @@
<sect1 id="running">
<title>Running the example</title>
<para>This example consists of a client application that sets up an in-memory JCR repository and that allows a user to
- upload files into that repository. The client also sets up the DNA services with an image sequencer so that if any of the
- uploaded files are PNG, JPEG, GIF, BMP, or other images, DNA will automatically extract the image's metadata (e.g., image
- format, physical size, pixel density, etc.) and store that in the repository.</para>
+ upload files into that repository. The client also sets up the DNA services with two sequencers so that if any of the
+ uploaded files are PNG, JPEG, GIF, BMP or other images, DNA will automatically extract the image's metadata (e.g., image
+ format, physical size, pixel density, etc.) and store that in the repository. Alternatively, if the uploaded file
+ is an MP3 audio file, DNA will extract some of the ID3 metadata (e.g., the author, title, album, year and comment)
+ and store that in the repository.</para>
<para>
To run the client application, go to the
<code>examples/sequencers/target/dna-example-sequencers-basic.dir/
@@ -877,7 +887,7 @@
<title>Example Client</title>
<graphic align="center" scale="100" fileref="images/example-sequencer-cli-client.png" />
</figure>
- From this menu, you can upload a file into the repository, search for images in the repository, print sequencing statistics,
+ From this menu, you can upload a file into the repository, search for media in the repository, print sequencing statistics,
or quit the application.
</para>
<para>
@@ -891,7 +901,7 @@
<graphic align="center" scale="100" fileref="images/example-sequencer-upload.png" />
</figure>
You can specify any fully-qualified or relative path. The application will notify you if it cannot find the file you
- specified. The example client configures JBoss DNA to sequence image files with one of
+ specified. The example client configures JBoss DNA to sequence and MP3 audio files and image files with one of
the following extensions (technically, nodes that have names ending in the following):
<code>jpg</code>
,
@@ -921,8 +931,10 @@
<code>caution.png</code>
,
<code>caution.jpg</code>
- and
+ ,
<code>caution.gif</code>
+ , and
+ <code>sample1.mp3</code>
) and one image that will not be sequenced (
<code>caution.pict</code>
). Feel free to try other files.
@@ -955,24 +967,27 @@
@jcr:mimeType = {mime type of the file}
@jcr:lastModified = {now}
</programlisting>
+ Other kinds of files are treated in a similar way.
</para>
<para>
When the client uploads the file using the JCR API, DNA gets notified of the changes, consults the sequencers to see whether
any of them are interested in the new or updated content, and if so runs those sequencers. The image sequencer processes image
files for metadata, and any metadata found is stored under the
<code>/images</code>
- branch of the repository. All of this happens asynchronously, so any DNA activity doesn't impede or slow down the client
+ branch of the repository. The MP3 sequencer processes MP3 audio files for metadata, and any metadata found is stored under the
+ <code>/mp3s</code>
+ branch of the repository. All of this happens asynchronously, so any DNA activity doesn't impede or slow down the client
activities.
</para>
<para>
So, after the file is uploaded, you can search the repository for the image metadata using the "s" menu option:
<figure id="example-sequencer-search">
- <title>Uploading an image using the Example Client</title>
+ <title>Searching for media using the Example Client</title>
<graphic align="center" scale="100" fileref="images/example-sequencer-search.png" />
</figure>
You can also display the sequencing statistics using the "d" menu option:
<figure id="example-sequencer-statistics">
- <title>Uploading an image using the Example Client</title>
+ <title>Sequencing statistics using the Example Client</title>
<graphic align="center" scale="100" fileref="images/example-sequencer-statistics.png" />
</figure>
These stats show how many nodes were sequenced, and how many nodes were skipped because they didn't apply to the sequencer's
@@ -989,13 +1004,13 @@
nodes with acceptable names.
</para>
</note>
- <para>You can repeat this process with other files. Any file that isn't an image (as recognized by the sequencing configuration
+ <para>You can repeat this process with other files. Any file that isn't an image or MP3 files (as recognized by the sequencing configurations
that we'll describe later) will not be sequenced.</para>
</sect1>
<sect1 id="downloading_and_running_review">
<title>Summarizing what we just did</title>
<para>In this chapter you downloaded and installed the example application and used it to upload files into a
- JCR repository. JBoss DNA automatically sequenced the image files you uploaded, extracted the metadata from the
+ JCR repository. JBoss DNA automatically sequenced the image and/or MP3 files you uploaded, extracted the metadata from the
files, and stored that metadata inside the repository. The application allowed you to see this metadata
and the sequencing statistics.</para>
<para>This application was very simplistic. In fact, running through the example probably only took you a minute or two.
@@ -1099,7 +1114,14 @@
String[] classpath = null; // Use the current classpath
String[] pathExpressions = {"//(*.(jpg|jpeg|gif|bmp|pcx|png))[*]/jcr:content[@jcr:data] => /images/$1"};
SequencerConfig imageSequencerConfig = new SequencerConfig(name, desc, classname, classpath, pathExpressions);
-SesequencingService.addSequencer(imageSequencerConfig);</programlisting>
+sequencingService.addSequencer(imageSequencerConfig);
+
+name = "Mp3 Sequencer";
+desc = "Sequences mp3 files to extract the id3 tags of the audio file";
+classname = "org.jboss.dna.sequencer.mp3.Mp3MetadataSequencer";
+String[] mp3PathExpressions = {"//(*.mp3)[*]/jcr:content[@jcr:data] => /mp3s/$1"};
+SequencerConfig mp3SequencerConfig = new SequencerConfig(name, desc, classname, classpath, mp3PathExpressions);
+sequencingService.addSequencer(mp3SequencerConfig);</programlisting>
This is pretty self-explanatory, except for the <code>classpath</code> and <code>pathExpression</code> parameters.
The classpath parameter defines the classpath that is passed to the class loader factory mentioned above.
Our sequencer is on the classpath, so we can simply use <code>null</code> here.
@@ -1117,7 +1139,7 @@
<note>
<para>Sequencer path expressions can be fairly complex and may use wildcards, specificy same-name sibling indexes,
provide optional and choice elements, and may capture parts of the selection criteria for use in the output expression.
- The path expression used in the sequencer configuration example above shows a more complex example:
+ The path expression used in the image sequencer configuration example above shows a more complex example:
<programlisting>
//(*.(jpg|jpeg|gif|bmp|pcx|png))[*]/jcr:content[@jcr:data] => /images/$1</programlisting>
This uses "//" to select any node at any level in the repository whose name ends with "." and one of the extensions (e.g., ".jpg", ".jpeg", etc.)
@@ -1193,22 +1215,23 @@
<para>Recall that the example application consists of a client application that sets up an in-memory JCR repository and
that allows a user to upload files into that repository. The client also sets up the DNA services with an image sequencer so
that if any of the uploaded files are PNG, JPEG, GIF, BMP or other images, DNA will automatically extract the image's
- metadata (e.g., image format, physical size, pixel density, etc.) and store that in the repository.</para>
+ metadata (e.g., image format, physical size, pixel density, etc.) and store that in the repository. Or, if the client uploads
+ MP3 audio files, the title, author, album, year, and comment are extract from the audio file and stored in the repository.</para>
<para>
The example is comprised of 3 classes and 1 interface, located in the
<code>src/main/java</code>
directory:
<programlisting>
org/jboss/example/dna/sequencers/ConsoleInput.java
- /ImageInfo.java
+ /MediaInfo.java
/SequencingClient.java
/UserInterface.java</programlisting>
</para>
<para>
<code>SequencingClient</code>
is the class that contains the main application.
- <code>ImageInfo</code>
- is a simple Java object that encapsulates metadata about an image (as generated by the sequencer), and used by the client to
+ <code>MediaInfo</code>
+ is a simple Java object that encapsulates metadata about a media file (as generated by the sequencer), and used by the client to
pass information to the
<code>UserInterface</code>
, which is an interface with methods that will be called at runtime to request data from the user.
@@ -1347,6 +1370,14 @@
SequencerConfig imageSequencerConfig = new SequencerConfig(name, desc, classname, classpath, pathExpressions);
this.sequencingService.addSequencer(imageSequencerConfig);
+ // Set up the MP3 sequencer ...
+ name = "Mp3 Sequencer";
+ desc = "Sequences mp3 files to extract the id3 tags of the audio file";
+ classname = "org.jboss.dna.sequencer.mp3.Mp3MetadataSequencer";
+ String[] mp3PathExpressions = {"//(*.mp3)[*]/jcr:content[@jcr:data] => /mp3s/$1"};
+ SequencerConfig mp3SequencerConfig = new SequencerConfig(name, desc, classname, classpath, mp3PathExpressions);
+ this.sequencingService.addSequencer(mp3SequencerConfig);
+
// Use the DNA observation service to listen to the JCR repository (or multiple ones), and
// then register the sequencing service as a listener to this observation service...
this.observationService = new ObservationService(this.executionContext.getSessionFactory());
15 years, 12 months
DNA SVN: r159 - trunk/docs/examples/gettingstarted/sequencers/src/main/java/org/jboss/example/dna/sequencers.
by dna-commits＠lists.jboss.org
Author: rhauch
Date: 2008-05-13 18:06:57 -0400 (Tue, 13 May 2008)
New Revision: 159
Modified:
trunk/docs/examples/gettingstarted/sequencers/src/main/java/org/jboss/example/dna/sequencers/SequencingClient.java
Log:
Minor changes to the example application code.
Modified: trunk/docs/examples/gettingstarted/sequencers/src/main/java/org/jboss/example/dna/sequencers/SequencingClient.java
===================================================================
--- trunk/docs/examples/gettingstarted/sequencers/src/main/java/org/jboss/example/dna/sequencers/SequencingClient.java 2008-05-13 21:41:05 UTC (rev 158)
+++ trunk/docs/examples/gettingstarted/sequencers/src/main/java/org/jboss/example/dna/sequencers/SequencingClient.java 2008-05-13 22:06:57 UTC (rev 159)
@@ -234,10 +234,11 @@
SequencerConfig imageSequencerConfig = new SequencerConfig(name, desc, classname, classpath, pathExpressions);
this.sequencingService.addSequencer(imageSequencerConfig);
+ // Set up the MP3 sequencer ...
name = "Mp3 Sequencer";
desc = "Sequences mp3 files to extract the id3 tags of the audio file";
classname = "org.jboss.dna.sequencer.mp3.Mp3MetadataSequencer";
- String[] mp3PathExpressions = {"//(*.(mp3))[*]/jcr:content[@jcr:data] => /mp3s/$1"};
+ String[] mp3PathExpressions = {"//(*.mp3)[*]/jcr:content[@jcr:data] => /mp3s/$1"};
SequencerConfig mp3SequencerConfig = new SequencerConfig(name, desc, classname, classpath, mp3PathExpressions);
this.sequencingService.addSequencer(mp3SequencerConfig);
15 years, 12 months
DNA SVN: r158 - trunk/docs/gettingstarted/en.
by dna-commits＠lists.jboss.org
Author: jverhaeg(a)redhat.com
Date: 2008-05-13 17:41:05 -0400 (Tue, 13 May 2008)
New Revision: 158
Modified:
trunk/docs/gettingstarted/en/master.xml
Log:
Corrected some grammatical errors and did a little word-smithing.
Modified: trunk/docs/gettingstarted/en/master.xml
===================================================================
--- trunk/docs/gettingstarted/en/master.xml 2008-05-13 21:26:48 UTC (rev 157)
+++ trunk/docs/gettingstarted/en/master.xml 2008-05-13 21:41:05 UTC (rev 158)
@@ -540,15 +540,15 @@
<para>
<emphasis role="strong">SVN Connector</emphasis>
- Interact with Subversion software configuration management (SCM) repositories to expose the managed resources
- through JCR. Consider using
+ through JCR. Consider using the
<ulink url="http://svnkit.com/">SVNkit</ulink>
- (dual license) library for API into Subversion.
+ (dual license) library for an API into Subversion.
</para>
</listitem>
<listitem>
<para>
<emphasis role="strong">CVS Connector</emphasis>
- - Interact with CVS software configuration management (SCM) repositories, to expose the managed resources through
+ - Interact with CVS software configuration management (SCM) repositories to expose the managed resources through
JCR.
</para>
</listitem>
@@ -623,7 +623,7 @@
be consulted prior to returning the query results, as the results from one source might have contributions from another
source.</para>
<note>
- <para> It is hoped that the MetaMatrix query engine can be used for this purpose, after it is open sourced. This engine
+ <para> It is hoped that the MetaMatrix query engine can be used for this purpose after it is open-sourced. This engine
implements sophisticated query planning and optimization techniques for working efficiently with multiple sources.
</para>
</note>
@@ -683,11 +683,11 @@
with a JCR repository to automatically sequence changing content to extract useful information. So read on to get the simple
application running, and then in the
<link linkend="using_dna">next chapter</link>
- we'll we'll dive into the source code for the example and show how to use JBoss DNA in your own applications.
+ we'll dive into the source code for the example and show how to use JBoss DNA in your own applications.
</para>
<para>JBoss DNA uses Maven 2 for its build system, as is this example. Using Maven 2 has several advantages, including
the ability to manage dependencies. If a library is needed, Maven automatically finds and downloads that library, plus
- everything that library needs. This means that its very easy to build the examples - or even create a maven project that
+ everything that library needs. This means that it's very easy to build the examples - or even create a maven project that
depends on the JBoss DNA JARs.</para>
<note>
<para>
@@ -702,7 +702,7 @@
<code>maven-2.0.7-bin.zip</code>
file to a convenient location on your local disk. Simply add
<code>$MAVEN_HOME/bin</code>
- to your path and adding the following profile to your
+ to your path and add the following profile to your
<code>~/.m2/settings.xml</code>
file:
<programlisting role="XML" language="xml"><settings>
@@ -769,13 +769,13 @@
</programlisting>
</para>
<para>There are essentially two Maven projects: a <code>sequencers</code> project and a parent project. All of the source
- for the examples are located in the <code>sequencers</code> subdirectory. And you may have noticed that none
+ for the example is located in the <code>sequencers</code> subdirectory. And you may have noticed that none
of the JBoss DNA libraries are there. This is where Maven comes in. The two <code>pom.xml</code> files tell
Maven everything it needs to know about what libraries are required and how to build the example.</para>
<para>In a terminal, go to the <code>examples</code> directory and run <emphasis role="strong"><code>mvn install</code></emphasis>.
This command downloads all of the JARs necessary to compile and build the example, including the JBoss DNA libraries,
the libraries they depend on, and any missing Maven components. (These are downloaded from the JBoss repositories
- only once, and saved on your machine. This means that the next time you run Maven, all the libraries will
+ only once and saved on your machine. This means that the next time you run Maven, all the libraries will
already be available locally, and the build will run much faster.) The command then continues by compiling the example's source
code (and unit tests) and running the unit tests. The build is successful if you see the following:
<programlisting language="bash">$ mvn install
@@ -796,7 +796,7 @@
$ </programlisting>
If there are errors, check whether you have the correct version of Maven installed and that you've correctly updated
your Maven settings as described above.</para>
- <para>If you successfully built the examples, there will be a <code>examples/sequencers/target/dna-example-sequencers-basic.dir/</code>
+ <para>If you've successfully built the examples, there will be a <code>examples/sequencers/target/dna-example-sequencers-basic.dir/</code>
directory that contains the following:
<itemizedlist>
<listitem>
@@ -864,7 +864,7 @@
<title>Running the example</title>
<para>This example consists of a client application that sets up an in-memory JCR repository and that allows a user to
upload files into that repository. The client also sets up the DNA services with an image sequencer so that if any of the
- uploaded files are PNG, JPEG, GIF, BMP or other images, DNA will automatically extract the image's metadata (e.g., image
+ uploaded files are PNG, JPEG, GIF, BMP, or other images, DNA will automatically extract the image's metadata (e.g., image
format, physical size, pixel density, etc.) and store that in the repository.</para>
<para>
To run the client application, go to the
@@ -872,7 +872,7 @@
</code>
directory and type
<code>./run.sh</code>
- . You should see the command line client and its menus in your terminal:
+ . You should see the command-line client and its menus in your terminal:
<figure id="xample-sequencer-cli-client">
<title>Example Client</title>
<graphic align="center" scale="100" fileref="images/example-sequencer-cli-client.png" />
@@ -891,8 +891,8 @@
<graphic align="center" scale="100" fileref="images/example-sequencer-upload.png" />
</figure>
You can specify any fully-qualified or relative path. The application will notify you if it cannot find the file you
- specified. The example client configures JBoss DNA to sequence image files (technically nodes that have names) with one of
- the following extensions:
+ specified. The example client configures JBoss DNA to sequence image files with one of
+ the following extensions (technically, nodes that have names ending in the following):
<code>jpg</code>
,
<code>jpeg</code>
@@ -928,7 +928,7 @@
). Feel free to try other files.
</para>
<para>
- After you specified the file you want to upload, the example application asks you where in the repository you'd like to
+ After you have specified the file you want to upload, the example application asks you where in the repository you'd like to
place the file. (If you want to use the suggested location, just press
<code>return</code>
.) The client application uses the JCR API to upload the file to that location in the repository, creating any nodes (of
@@ -958,7 +958,7 @@
</para>
<para>
When the client uploads the file using the JCR API, DNA gets notified of the changes, consults the sequencers to see whether
- any of them are interested in the new or updated content, and if so runs the sequencers. The image sequencer processes image
+ any of them are interested in the new or updated content, and if so runs those sequencers. The image sequencer processes image
files for metadata, and any metadata found is stored under the
<code>/images</code>
branch of the repository. All of this happens asynchronously, so any DNA activity doesn't impede or slow down the client
@@ -986,7 +986,7 @@
<code>nt:resource</code>
nodes than there are
<code>nt:file</code>
- nodes with acceptible names.
+ nodes with acceptable names.
</para>
</note>
<para>You can repeat this process with other files. Any file that isn't an image (as recognized by the sequencing configuration
15 years, 12 months
DNA SVN: r157 - in trunk: dna-integration-tests and 5 other directories.
by dna-commits＠lists.jboss.org
Author: rhauch
Date: 2008-05-13 17:26:48 -0400 (Tue, 13 May 2008)
New Revision: 157
Modified:
trunk/dna-integration-tests/pom.xml
trunk/dna-maven-classloader/pom.xml
trunk/dna-repository/pom.xml
trunk/dna-spi/pom.xml
trunk/pom.xml
trunk/sequencers/dna-sequencer-images/pom.xml
trunk/sequencers/dna-sequencer-mp3/pom.xml
Log:
Changed POM files and the versions of JBoss DNA they use, so that they're compatible with Maven's release plugin
Modified: trunk/dna-integration-tests/pom.xml
===================================================================
--- trunk/dna-integration-tests/pom.xml 2008-05-13 21:26:03 UTC (rev 156)
+++ trunk/dna-integration-tests/pom.xml 2008-05-13 21:26:48 UTC (rev 157)
@@ -22,22 +22,22 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-maven-classloader</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-repository</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
Modified: trunk/dna-maven-classloader/pom.xml
===================================================================
--- trunk/dna-maven-classloader/pom.xml 2008-05-13 21:26:03 UTC (rev 156)
+++ trunk/dna-maven-classloader/pom.xml 2008-05-13 21:26:48 UTC (rev 157)
@@ -22,12 +22,12 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
Modified: trunk/dna-repository/pom.xml
===================================================================
--- trunk/dna-repository/pom.xml 2008-05-13 21:26:03 UTC (rev 156)
+++ trunk/dna-repository/pom.xml 2008-05-13 21:26:48 UTC (rev 157)
@@ -22,19 +22,19 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-spi</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
</dependency>
<!--
Rules
Modified: trunk/dna-spi/pom.xml
===================================================================
--- trunk/dna-spi/pom.xml 2008-05-13 21:26:03 UTC (rev 156)
+++ trunk/dna-spi/pom.xml 2008-05-13 21:26:48 UTC (rev 157)
@@ -22,12 +22,12 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
Modified: trunk/pom.xml
===================================================================
--- trunk/pom.xml 2008-05-13 21:26:03 UTC (rev 156)
+++ trunk/pom.xml 2008-05-13 21:26:48 UTC (rev 157)
@@ -32,6 +32,13 @@
</properties>
<profiles>
<profile>
+ <id>release</id>
+ <modules>
+ <module>docs</module>
+ <module>docs/examples/gettingstarted</module>
+ </modules>
+ </profile>
+ <profile>
<!--
This profile is activated when the "generate.docs" property is set,
as in "mvn ... -Dgenerate.docs=true ..."
Modified: trunk/sequencers/dna-sequencer-images/pom.xml
===================================================================
--- trunk/sequencers/dna-sequencer-images/pom.xml 2008-05-13 21:26:03 UTC (rev 156)
+++ trunk/sequencers/dna-sequencer-images/pom.xml 2008-05-13 21:26:48 UTC (rev 157)
@@ -34,14 +34,14 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-spi</artifactId>
- <version>${project.version}</version>
+ <version>${dna-version}</version>
<type>test-jar</type>
<scope>test</scope>
</dependency>
Modified: trunk/sequencers/dna-sequencer-mp3/pom.xml
===================================================================
--- trunk/sequencers/dna-sequencer-mp3/pom.xml 2008-05-13 21:26:03 UTC (rev 156)
+++ trunk/sequencers/dna-sequencer-mp3/pom.xml 2008-05-13 21:26:48 UTC (rev 157)
@@ -19,12 +19,12 @@
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-common</artifactId>
- <version>0.1-SNAPSHOT</version>
+ <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jboss.dna</groupId>
<artifactId>dna-spi</artifactId>
- <version>0.1-SNAPSHOT</version>
+ <version>${dna-version}</version>
</dependency>
<dependency>
<groupId>org.jaudiotagger</groupId>
15 years, 12 months
DNA SVN: r156 - trunk/docs/gettingstarted/en.
by dna-commits＠lists.jboss.org
Author: rhauch
Date: 2008-05-13 17:26:03 -0400 (Tue, 13 May 2008)
New Revision: 156
Modified:
trunk/docs/gettingstarted/en/master.xml
Log:
Added reference to MP3 sequencer in section 2.3
Modified: trunk/docs/gettingstarted/en/master.xml
===================================================================
--- trunk/docs/gettingstarted/en/master.xml 2008-05-13 20:43:18 UTC (rev 155)
+++ trunk/docs/gettingstarted/en/master.xml 2008-05-13 21:26:03 UTC (rev 156)
@@ -330,9 +330,10 @@
and let sequencers extract the metadata from the image and save it in the repository. The same with XSDs, WSDL, WS
policies, UML, MetaMatrix models, etc.</para>
<para>
- JBoss DNA sequencers sit on top of existing JCR repositories (including federated repositories) - it basically extracts
- more useful information from what's already stored in the repository. And it uses the existing JCR versioning system. Each
- sequencer typically processes a single kind of file format. The following sequencer is included in JBoss DNA:
+ JBoss DNA sequencers sit on top of existing JCR repositories (including federated repositories) - they basically extract
+ more useful information from what's already stored in the repository. And they use the existing JCR versioning system. Each
+ sequencer typically processes a single kind of file format or a single kind of content. </para>
+ <para>The following sequencers are included in JBoss DNA:
<itemizedlist>
<listitem>
<para>
@@ -346,6 +347,16 @@
.)
</para>
</listitem>
+ <listitem>
+ <para>
+ <emphasis role="strong">MP3 sequencer</emphasis>
+ - A sequencer that processes the contents of an MP3 audio file, extracts the metadata for the file, and then
+ writes that image metadata to the repository. It gets the title, author, album, year, and comment.
+ (This sequencer may be improved in the future to also extract other ID3 metadata from other audio file formats; see
+ <ulink url="http://jira.jboss.org/jira/browse/DNA-66">DNA-26</ulink>
+ .)
+ </para>
+ </listitem>
</itemizedlist>
</para>
<para>
15 years, 12 months
DNA SVN: r155 - in trunk/docs/examples/gettingstarted/sequencers/src: test/resources and 1 other directory.
by dna-commits＠lists.jboss.org
Author: rhauch
Date: 2008-05-13 16:43:18 -0400 (Tue, 13 May 2008)
New Revision: 155
Added:
trunk/docs/examples/gettingstarted/sequencers/src/main/resources/sample1.mp3
Removed:
trunk/docs/examples/gettingstarted/sequencers/src/test/resources/sample1.mp3
Log:
Moved sample.mp3 to the src/main/resources directory rather than the src/test/resources directory.
Copied: trunk/docs/examples/gettingstarted/sequencers/src/main/resources/sample1.mp3 (from rev 154, trunk/docs/examples/gettingstarted/sequencers/src/test/resources/sample1.mp3)
===================================================================
(Binary files differ)
Property changes on: trunk/docs/examples/gettingstarted/sequencers/src/main/resources/sample1.mp3
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Deleted: trunk/docs/examples/gettingstarted/sequencers/src/test/resources/sample1.mp3
===================================================================
(Binary files differ)
15 years, 12 months