blob: 655fae169306ef1f22d3d7740093f60d3700c83d [file] [log] [blame]
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia Site Renderer 1.9.2 from org.apache.maven.plugins:maven-changes-plugin:2.12.1:changes-report at 21 September 2021
| Rendered using Apache Maven Fluido Skin 1.9
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
<title>Fulcrum Intake &#x2013; Fulcrum Intake</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.9.min.css" />
<link rel="stylesheet" href="./css/site.css" />
<link rel="stylesheet" href="./css/print.css" media="print" />
<script src="./js/apache-maven-fluido-1.9.min.js"></script>
</head>
<body class="topBarDisabled">
<div class="container-fluid">
<header>
<div id="banner">
<div class="pull-left"><a href="../../" id="bannerLeft" title="Apache Turbine"><img src="../../images/turbine-project.png" alt="Apache Turbine"/></a></div>
<div class="pull-right"></div>
<div class="clear"><hr/></div>
</div>
<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 21 September 2021<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 2.0.1-SNAPSHOT</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../" title="Fulcrum">Fulcrum</a></li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../" title="Turbine">Turbine</a></li>
<li class="pull-right"><a href="https://www.apache.org" class="externalLink" title="Apache">Apache</a></li>
</ul>
</div>
</header>
<div class="row-fluid">
<header id="leftColumn" class="span2">
<nav class="well sidebar-nav">
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
<li><a href="index.html" title="Main"><span class="none"></span>Main</a></li>
<li><a href="howto.html" title="Howto"><span class="none"></span>Howto</a></li>
<li class="nav-header">Project Documentation</li>
<li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
<li><a href="project-reports.html" title="Project Reports"><span class="icon-chevron-down"></span>Project Reports</a>
<ul class="nav nav-list">
<li class="active"><a href="#"><span class="none"></span>Changes</a></li>
<li><a href="apidocs/index.html" title="Javadoc"><span class="none"></span>Javadoc</a></li>
<li><a href="testapidocs/index.html" title="Test Javadoc"><span class="none"></span>Test Javadoc</a></li>
<li><a href="xref/index.html" title="Source Xref"><span class="none"></span>Source Xref</a></li>
<li><a href="xref-test/index.html" title="Test Source Xref"><span class="none"></span>Test Source Xref</a></li>
<li><a href="cpd.html" title="CPD"><span class="none"></span>CPD</a></li>
<li><a href="pmd.html" title="PMD"><span class="none"></span>PMD</a></li>
<li><a href="surefire-report.html" title="Surefire Report"><span class="none"></span>Surefire Report</a></li>
<li><a href="jacoco/index.html" title="JaCoCo"><span class="none"></span>JaCoCo</a></li>
<li><a href="jacoco-aggregate/index.html" title="JaCoCo Aggregate"><span class="none"></span>JaCoCo Aggregate</a></li>
<li><a href="jdepend-report.html" title="JDepend"><span class="none"></span>JDepend</a></li>
<li><a href="rat-report.html" title="Rat Report"><span class="none"></span>Rat Report</a></li>
<li><a href="taglist.html" title="Tag List"><span class="none"></span>Tag List</a></li>
<li><a href="findbugs.html" title="FindBugs"><span class="none"></span>FindBugs</a></li>
</ul></li>
<li class="nav-header">Apache</li>
<li><a href="https://www.apache.org/" class="externalLink" title="Apache Website"><span class="none"></span>Apache Website</a></li>
<li><a href="https://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
<li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works"><span class="none"></span>How the ASF works</a></li>
<li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"><span class="none"></span>Sponsorship</a></li>
<li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
<li><a href="https://www.apache.org/security/" class="externalLink" title="Security"><span class="none"></span>Security</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
<hr />
<div id="poweredBy">
<div class="clear"></div>
<div class="clear"></div>
<div class="clear"></div>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
</div>
</div>
</header>
<main id="bodyColumn" class="span10" >
<section>
<h2><a name="Fulcrum_Intake"></a>Fulcrum Intake</h2><section>
<h3><a name="Release_History"></a>Release History</h3>
<table border="0" class="table table-striped">
<tr class="a">
<th>Version</th>
<th>Date</th>
<th>Description</th></tr>
<tr class="b">
<td><a href="#a2.0.1">2.0.1</a></td>
<td>in Subversion</td>
<td>&#160;</td></tr>
<tr class="a">
<td><a href="#a2.0.0">2.0.0</a></td>
<td>2019-03-25</td>
<td>&#160;</td></tr>
<tr class="b">
<td><a href="#a1.2.3">1.2.3</a></td>
<td>2018-02-11</td>
<td>&#160;</td></tr>
<tr class="a">
<td><a href="#a1.2.2">1.2.2</a></td>
<td>2016-12-07</td>
<td>&#160;</td></tr>
<tr class="b">
<td><a href="#a1.2.1">1.2.1</a></td>
<td>2016-08-27</td>
<td>&#160;</td></tr>
<tr class="a">
<td><a href="#a1.2.0">1.2.0</a></td>
<td>2015-04-18</td>
<td>&#160;</td></tr>
<tr class="b">
<td><a href="#a1.0.6">1.0.6</a></td>
<td>2009-11-02</td>
<td>&#160;</td></tr>
<tr class="a">
<td><a href="#a1.0-alpha-2">1.0-alpha-2</a></td>
<td>02-16-2004</td>
<td>&#160;</td></tr>
<tr class="b">
<td><a href="#a1.0-alpha-1">1.0-alpha-1</a></td>
<td>11-15-2003</td>
<td>&#160;</td></tr></table></section><section>
<h3 id="a2.0.1">Release 2.0.1 &#x2013; in Subversion</h3>
<table border="0" class="table table-striped">
<tr class="a">
<th>Type</th>
<th>Changes</th>
<th>By</th></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Update dependencies testcontainer 1.0.9 (inherits junit)</td>
<td><a href="team-list.html#gk">gk</a></td></tr>
<tr class="a">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Allow Java9+ build by adding dependency</td>
<td><a href="team-list.html#painter">painter</a></td></tr></table></section><section>
<h3 id="a2.0.0">Release 2.0.0 &#x2013; 2019-03-25</h3>
<table border="0" class="table table-striped">
<tr class="b">
<th>Type</th>
<th>Changes</th>
<th>By</th></tr>
<tr class="a">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Update to yaafi 1.0.8, testcontainer 1.0.8</td>
<td><a href="team-list.html#painter">painter</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Derive from Turbine parent POM 5</td>
<td><a href="team-list.html#painter">painter</a></td></tr>
<tr class="a">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Move Field creation to typesafe enum</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Deprecate field type FileItem</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/add.gif" alt="Add" title="Add" /></td>
<td>Add new field type UploadPart to support Servlet 3.1 upload handling</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/remove.gif" alt="Remove" title="Remove" /></td>
<td>Remove dependency on fulcrum-upload</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>INCOMPATIBLE: Update dependency servlet-api to 3.1.0</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Update dependencies fulcrum-parser 2.0.0 (inherits commons-lang3 and commons-pool2)</td>
<td><a href="team-list.html#tv">tv</a></td></tr></table></section><section>
<h3 id="a1.2.3">Release 1.2.3 &#x2013; 2018-02-11</h3>
<table border="0" class="table table-striped">
<tr class="a">
<th>Type</th>
<th>Changes</th>
<th>By</th></tr>
<tr class="b">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Intake's Validator and the BaseValueParser don't parse inputs the same way. Fixes <a class="externalLink" href="https://issues.apache.org/jira/browse/TRB-94">TRB-94</a>. Thanks to Tilo Villwock.</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Update dependencies commons-lang3 3.5, commons-pool2 2.5.0</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Fix FileNotFoundException during parallel deployment with Tomcat</td>
<td><a href="team-list.html#painter">painter</a></td></tr></table></section><section>
<h3 id="a1.2.2">Release 1.2.2 &#x2013; 2016-12-07</h3>
<table border="0" class="table table-striped">
<tr class="a">
<th>Type</th>
<th>Changes</th>
<th>By</th></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Move all post-processing to afterUnmarshal(), privatize a number of fields</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Fix modified JAXB parsing with Java 8</td>
<td><a href="team-list.html#gk">gk</a></td></tr></table></section><section>
<h3 id="a1.2.1">Release 1.2.1 &#x2013; 2016-08-27</h3>
<table border="0" class="table table-striped">
<tr class="b">
<th>Type</th>
<th>Changes</th>
<th>By</th></tr>
<tr class="a">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Fix sizing of group pool</td>
<td><a href="team-list.html#tv">tv</a></td></tr></table></section><section>
<h3 id="a1.2.0">Release 1.2.0 &#x2013; 2015-04-18</h3>
<table border="0" class="table table-striped">
<tr class="b">
<th>Type</th>
<th>Changes</th>
<th>By</th></tr>
<tr class="a">
<td><img src="images/add.gif" alt="Add" title="Add" /></td>
<td>Add validation tests</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Fix parsing of numbers, improve test</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Move to Avalon logging all over the place</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Move to JAXB for parsing and object mapping.</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/add.gif" alt="Add" title="Add" /></td>
<td>Add Intake schema derived from DTD</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Derive from Turbine parent POM 3</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Update dependency servlet-api to 2.5</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Update dependency commons-lang to 2.6</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Update dependency commons-logging to 1.1.3</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Update dependency commons-pool to 2.3</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Update dependency fulcrum-parser to 1.0.3</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Update dependency fulcrum-upload to 1.0.5</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Introduce JDK 1.5 Generics</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Groups were not initialized correctly from a parser.</td>
<td><a href="team-list.html#tv">tv</a></td></tr></table></section><section>
<h3 id="a1.0.6">Release 1.0.6 &#x2013; 2009-11-02</h3>
<table border="0" class="table table-striped">
<tr class="a">
<th>Type</th>
<th>Changes</th>
<th>By</th></tr>
<tr class="b">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Catch only Exceptions that are actually thrown.</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Intake won't use interfaces for the mapTo() method. Fixes <a class="externalLink" href="https://issues.apache.org/jira/browse/TRB-11">TRB-11</a>. Thanks to Evan Koffler.</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>The number validators did not set an invalid number message when initialized with
the default constructor. Fixes <a class="externalLink" href="https://issues.apache.org/jira/browse/TRB-74">TRB-74</a>. Thanks to Susi Berrington.</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/remove.gif" alt="Remove" title="Remove" /></td>
<td>Removed the Intake class. It was duplicating the IntakeServiceFacade.</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Moved the initialization code of the service implementation to initialize()</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Intake did not correctly parse the message of a rule or required-message from intake.xml. Fixes <a class="externalLink" href="https://issues.apache.org/jira/browse/TRB-68">TRB-68</a>. Thanks to Ronny Voelker.</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Removed the dependency on ORO by replacing the regular expression handling
with java.util.regexp. This might have slight implications on the regexp
syntax.</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Use the localize features of the parser to simplify the value assignment
in Intake fields. Made handling of empty values consistent over all number
field types.</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Updated locale handling to use the new localized parameter parser. This
removes the dependency from LocalizationService</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="a">
<td><img src="images/add.gif" alt="Add" title="Add" /></td>
<td>Added locale handling to Intake, added user-defined field types.</td>
<td><a href="team-list.html#tv">tv</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Intake now handles the case where the mapToObject does not map to all
fields in the group. Fixes <a class="externalLink" href="https://issues.apache.org/jira/browse/TRB-9">TRB-9</a>. Thanks to J&#xfc;rgen Hoffmann.</td>
<td><a href="team-list.html#seade">seade</a></td></tr>
<tr class="a">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Intake was not handling empty values correctly. Fixes <a class="externalLink" href="https://issues.apache.org/jira/browse/TRB-9">TRB-9</a>. Thanks to J&#xfc;rgen Hoffmann.</td>
<td><a href="team-list.html#seade">seade</a></td></tr>
<tr class="b">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Intake was not loading the correct Default Validators when the rules for
a field are empty. Fixes <a class="externalLink" href="https://issues.apache.org/jira/browse/TRB-14">TRB-14</a>. Thanks to J&#xfc;rgen Hoffmann.</td>
<td><a href="team-list.html#seade">seade</a></td></tr>
<tr class="a">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Update to Apache License 2.0</td>
<td><a href="team-list.html#epugh">epugh</a></td></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Use inherited getLogger() instead of Log in classes
extending AbstractLogEnabled.</td>
<td><a href="team-list.html#epugh">epugh</a></td></tr></table></section><section>
<h3 id="a1.0-alpha-2">Release 1.0-alpha-2 &#x2013; 02-16-2004</h3>
<table border="0" class="table table-striped">
<tr class="a">
<th>Type</th>
<th>Changes</th>
<th>By</th></tr>
<tr class="b">
<td><img src="images/update.gif" alt="Update" title="Update" /></td>
<td>Merlinized component</td>
<td><a href="team-list.html#epugh">epugh</a></td></tr></table></section><section>
<h3 id="a1.0-alpha-1">Release 1.0-alpha-1 &#x2013; 11-15-2003</h3>
<table border="0" class="table table-striped">
<tr class="a">
<th>Type</th>
<th>Changes</th>
<th>By</th></tr>
<tr class="b">
<td><img src="images/remove.gif" alt="Remove" title="Remove" /></td>
<td>Remove Intake Pull Tool. It should I think be part of Turbine as it is
very Turbine specific right now. I am trying to remove all Turbine requirements
for Intake.</td>
<td><a href="team-list.html#epugh">epugh</a></td></tr>
<tr class="a">
<td><img src="images/add.gif" alt="Add" title="Add" /></td>
<td>Added the Intake class which is a facade to the underlying IntakeService.</td>
<td><a href="team-list.html#epugh">epugh</a></td></tr>
<tr class="b">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>The intake validators were fixed so that fields with required=false
rules no longer attempt to execute the remaining rules when no
input is provided. A minLength &gt; 0 rule is no longer synonymous
with required=true. Patch originally supplied by Colin Chalmers</td>
<td><a href="team-list.html#epugh">epugh</a></td></tr>
<tr class="a">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Intake was fixed so that DateString will use the &quot;formatn&quot; (where n
&gt;= 1) rules to parse the input and then the &quot;format&quot; rule to format
it (the &quot;format&quot; rule is also used to parse the date if there are no
&quot;formatn&quot; rules or they are not able to parse it). In order to
retrieve the correctly formatted DateString value you need to use
$group.foo.StringValue rather than $group.foo.Value
(you can do this for all values, not just DateString).</td>
<td><a href="team-list.html#seade">seade</a></td></tr>
<tr class="b">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Intake now makes use of the the emptyValue attribute from the field
elements when mapping from the group to the object when no value has
been set. This makes it possible to clear values in an existing object
that is being overwritten with Intake data using
group.setProperties(obj) (or you can provide non-null values
in your intake.xml file). Make sure you do not inadvertently include
the primary key for the object in the intake group without actually
setting it to the appropriate value (it shouldn't be in the group
anyway).</td>
<td><a href="team-list.html#seade">seade</a></td></tr>
<tr class="a">
<td><img src="images/fix.gif" alt="Fix" title="Fix" /></td>
<td>Fixed the intake DateString flexible rule so that it applies to the
format rules and not just to the default locale format.</td>
<td><a href="team-list.html#seade">seade</a></td></tr></table></section></section>
</main>
</div>
</div>
<hr/>
<footer>
<div class="container-fluid">
<div class="row-fluid">
<p>&#169; 2005&#x2013;2021
<a href="https://www.apache.org/">The Apache Software Foundation</a>
</p>
</div>
</div>
</footer>
</body>
</html>