You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@uima.apache.org by sc...@apache.org on 2016/08/23 20:47:25 UTC
svn commit: r1757434 - in
/uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook:
./ annotator_analysis_engine_guide.xml tug.application.xml
Author: schor
Date: Tue Aug 23 20:47:24 2016
New Revision: 1757434
URL: http://svn.apache.org/viewvc?rev=1757434&view=rev
Log:
[UIMA-5018] merge catchup
Modified:
uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook/ (props changed)
uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook/annotator_analysis_engine_guide.xml
uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook/tug.application.xml
Propchange: uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook/
------------------------------------------------------------------------------
--- svn:mergeinfo (added)
+++ svn:mergeinfo Tue Aug 23 20:47:24 2016
@@ -0,0 +1,4 @@
+/uima/uimaj/branches/depend-on-july-9-build-tools/uima-docbook-tutorials-and-users-guides/src/docbook:963167-964468
+/uima/uimaj/branches/depend-on-parent-pom-4/uima-docbook-tutorials-and-users-guides/src/docbook:961329-961745
+/uima/uimaj/branches/filteredCompress-uima-2498/uima-docbook-tutorials-and-users-guides/src/docbook:1436573-1462257
+/uima/uimaj/trunk/uima-docbook-tutorials-and-users-guides/src/docbook:1690273-1757433
Modified: uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook/annotator_analysis_engine_guide.xml
URL: http://svn.apache.org/viewvc/uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook/annotator_analysis_engine_guide.xml?rev=1757434&r1=1757433&r2=1757434&view=diff
==============================================================================
--- uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook/annotator_analysis_engine_guide.xml (original)
+++ uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook/annotator_analysis_engine_guide.xml Tue Aug 23 20:47:24 2016
@@ -1136,7 +1136,7 @@ public void initialize(UimaContext aCont
UIMA also provides a logging implementation that use Apache Log4j instead of Java logging. To
use Log4j you have to provide the Log4j jars in the classpath and your application
must specify the logging configuration as shown below.
- <programlisting><?db-font-size 80% ?>-Dorg.apache.uima.logger.class=<org.apache.uima.util.impl.Log4jLogger_impl></programlisting>
+ <programlisting><?db-font-size 80% ?>-Dorg.apache.uima.logger.class=org.apache.uima.util.impl.Log4jLogger_impl</programlisting>
</para>
</section>
Modified: uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook/tug.application.xml
URL: http://svn.apache.org/viewvc/uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook/tug.application.xml?rev=1757434&r1=1757433&r2=1757434&view=diff
==============================================================================
--- uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook/tug.application.xml (original)
+++ uima/uimaj/branches/experiment-v3-jcas/uima-docbook-tutorials-and-users-guides/src/docbook/tug.application.xml Tue Aug 23 20:47:24 2016
@@ -516,13 +516,19 @@ ae.destroy();</programlisting></para>
web applications. See <olink targetdoc="&uima_docs_ref;" targetptr="ugr.ref.json.overview"/>.
For JSON, only serialization is supported.</para>
</listitem>
+ <listitem>
+ <para>Java Object serialization: There are APIs to convert a CAS to a Java object that can be serialized
+ and deserialized
+ using standard Java object read and write Object methods. There is also a way to include the CAS's type system and
+ index definition.</para>
+ </listitem>
</itemizedlist>
</para>
<para>Each of these serializations has different capabilities, summarized in the table below.
<table frame="all" id="ugr.tug.tbl.serialization_capabilities">
<title>Serialization Capabilities</title>
- <tgroup cols="7" rowsep="1" colsep="1">
+ <tgroup cols="8" rowsep="1" colsep="1">
<colspec colname="c1"/>
<colspec colname="c2"/>
<colspec colname="c3"/>
@@ -530,6 +536,7 @@ ae.destroy();</programlisting></para>
<colspec colname="c5"/>
<colspec colname="c6"/>
<colspec colname="c7"/>
+ <colspec colname="c8"/>
<thead>
<row>
<entry align="center"></entry>
@@ -539,6 +546,7 @@ ae.destroy();</programlisting></para>
<entry align="center">Binary</entry>
<entry align="center">Cmpr 4</entry>
<entry align="center">Cmrp 6</entry>
+ <entry align="center">JavaObj</entry>
</row>
</thead>
<tbody>
@@ -550,6 +558,7 @@ ae.destroy();</programlisting></para>
<entry>Output Stream</entry>
<entry>Output Stream, Data Output Stream, File</entry>
<entry>Output Stream, Data Output Stream, File</entry>
+ <entry>-</entry>
</row>
<row>
<entry>Lists/Arrays inline formatting?</entry>
@@ -559,6 +568,7 @@ ae.destroy();</programlisting></para>
<entry>-</entry>
<entry>-</entry>
<entry>-</entry>
+ <entry>-</entry>
</row>
<row>
<entry>Formatted?</entry>
@@ -568,6 +578,7 @@ ae.destroy();</programlisting></para>
<entry>-</entry>
<entry>-</entry>
<entry>-</entry>
+ <entry>-</entry>
</row>
<row>
<entry>Type Filtering?</entry>
@@ -577,6 +588,7 @@ ae.destroy();</programlisting></para>
<entry>-</entry>
<entry>-</entry>
<entry>Yes</entry>
+ <entry>-</entry>
</row>
<row>
<entry>Delta Cas?</entry>
@@ -586,6 +598,7 @@ ae.destroy();</programlisting></para>
<entry>Yes</entry>
<entry>Yes</entry>
<entry>Yes</entry>
+ <entry>-</entry>
</row>
<row>
<entry>OOTS?</entry>
@@ -595,6 +608,7 @@ ae.destroy();</programlisting></para>
<entry>-</entry>
<entry>-</entry>
<entry>-</entry>
+ <entry>-</entry>
</row>
<row>
<entry>Only send indexed + reachable FSs?</entry>
@@ -604,6 +618,7 @@ ae.destroy();</programlisting></para>
<entry>send all</entry>
<entry>send all</entry>
<entry>Yes</entry>
+ <entry>send all</entry>
</row>
<row>
<entry>NameSpace/Schemas?</entry>
@@ -613,6 +628,17 @@ ae.destroy();</programlisting></para>
<entry>-</entry>
<entry>-</entry>
<entry>-</entry>
+ <entry>-</entry>
+ </row>
+ <row>
+ <entry>lenient available?</entry>
+ <entry>Yes</entry>
+ <entry>Yes</entry>
+ <entry>-</entry>
+ <entry>-</entry>
+ <entry>-</entry>
+ <entry>Yes</entry>
+ <entry>-</entry>
</row>
</tbody>
</tgroup>
@@ -620,7 +646,8 @@ ae.destroy();</programlisting></para>
</table>
</para>
- <para>In the above table, Cmpr 4 and Cmpr 6 refer to Compressed forms of the serialization.</para>
+ <para>In the above table, Cmpr 4 and Cmpr 6 refer to Compressed forms of the serialization,
+ and JavaObj refers to Java Object serialization.</para>
<para>For the XMI and JSON formats, lists and arrays can sometimes be formatted "inline".
In this representation, the elements are formatted directly as the value of a particular
@@ -646,7 +673,7 @@ ae.destroy();</programlisting></para>
returned back to the sender), the out-of-type-system information is re-merged back into the output stream.
</para>
- <para>The Binary and Compressed Form 4 serializations send all the Feature Structures in the CAS,
+ <para>The Binary, Java Object, and Compressed Form 4 serializations send all the Feature Structures in the CAS,
in the order they were created in the CAS. The other methods only
send Feature Structures that are reachable, either by
their being in some CAS index, or being referenced
@@ -654,15 +681,35 @@ ae.destroy();</programlisting></para>
<para>The NameSpace/Schema support allows specifying a set of schemas, each one corresponding to a particular
namespace, used in XMI serialization.</para>
- <para>To save an XMI representation of a CAS, use the <literal>serialize</literal> method of the class
+
+ <para>Lenient allows the receiving Type System to be missing types and/or features that being deserialized.
+ Normally this causes an exception, but with the lenient flag turned on, these extra types and/or features are
+ skipped over and ignored, with no error indicated.</para>
+
+ <para>To save an XMI representation of a CAS, use the <code>save</code> method in <code>CasIOUtils</code> or the
+ <literal>serialize</literal> method of the class
<literal>org.apache.uima.util.XmlCasSerializer</literal>. To save an XCAS representation of a CAS,
- use the class <literal>org.apache.uima.cas.impl.XCASSerializer</literal> instead; see the Javadocs
+ use the <code>save</code> method in <code>CasIOUtils</code> class or see the <literal>org.apache.uima.cas.impl.XCASSerializer</literal> instead; see the Javadocs
for details.</para>
- <para>Both of these external forms can be read back in, using the <literal>deserialize</literal> method of
- the class <literal>org.apache.uima.util.XmlCasDeserializer</literal>. This method deserializes
- into a pre-existing CAS, which you must create ahead of time, pre-set-up with the proper type system. See the
+ <para>All the external serialized forms (except JSON and the inline CAS approximate serialization)
+ can be read back in using the <code>CasIOUtils load</code> methods.
+ The <code>CasIOUtils load</code> methods also support loading type system and index definition information
+ at the same time (usually from addition input sources). Some variations of these will use the read type system
+ and indexes definition to replace those in the CAS.
+ The XCAS and XMI external forms can also be read back in using the <literal>deserialize</literal> method of
+ the class <literal>org.apache.uima.util.XmlCasDeserializer</literal>. All of these methods deserialize
+ into a pre-existing CAS, which you must create ahead of time. See the
Javadocs for details.</para>
+
+ <para>The <code>CasIOUtils</code> class has a collection of static methods to load (deserialize) and save (serialize) CASes,
+ optionally with their type system and index definitions.
+ The <code>Serialization</code> class has various static methods for serializing and deserializing Java Object forms and
+ compressed forms, with finer control over available options.
+ See the Javadocs for that class for details.</para>
+
+ <para>Several of the APIs use or return instances of <code>SerialFormat</code>, which is an enum specifying the various
+ forms of serialization.</para>
</section>
</section>