Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<table class="confluenceTable"><tbody>
<tr>
<td class="confluenceTd"><p> Module: </p></td>
<td class="confluenceTd"><p> Versioning Postgis datastore </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> Module Maintainer: </p></td>
<td class="confluenceTd"><p> <a class="confluence-link confluence-userlink" data-username="aaime" href="/display/~aaime" data-linked-resource-id="787" data-linked-resource-type="userinfo" username="aaime" data-linked-resource-default-alias="Andrea Aime" data-base-url="http://docs.codehaus.org">Andrea Aime</a> </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> Email Help: </p></td>
<td class="confluenceTd"><p> Geotools-gt2-users@lists.sourceforge.net </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> Volunteer: </p></td>
<td class="confluenceTd"><p> geotools-devel@lists.sourceforge.net </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> Status: </p></td>
<td class="confluenceTd"><p> <table class="wysiwyg-macro" data-macro-name="excerpt" data-macro-parameters="atlassian-macro-output-type=INLINE" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2V4Y2VycHQ6YXRsYXNzaWFuLW1hY3JvLW91dHB1dC10eXBlPUlOTElORX0&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body"><p> <img class="emoticon emoticon-yellow-star" data-emoticon-name="yellow-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_yellow.png" alt="(star)" title="(star)" /> <img class="emoticon emoticon-yellow-star" data-emoticon-name="yellow-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_yellow.png" alt="(star)" title="(star)" /> <img class="emoticon emoticon-yellow-star" data-emoticon-name="yellow-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_yellow.png" alt="(star)" title="(star)" /> <img class="emoticon emoticon-red-star" data-emoticon-name="red-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_red.png" alt="(red star)" title="(red star)" /> <img class="emoticon emoticon-yellow-star" data-emoticon-name="yellow-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_yellow.png" alt="(star)" title="(star)" /> </p></td></tr></table> </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> Model  </p></td>
<td class="confluenceTd"><p> <a class="confluence-link" href="/display/GEOTOOLS/Versioning+datastore+design" data-linked-resource-id="70155" data-linked-resource-type="page" data-linked-resource-default-alias="Versioning datastore design" data-base-url="http://docs.codehaus.org">Versioning datastore design</a> </p></td>
</tr>
<tr>
<td class="confluenceTd"><p> User guide  </p></td>
<td class="confluenceTd"><p> <a class="confluence-link" href="/display/GEOTOOLS/Versioning+datastore+user+guide" data-linked-resource-id="70143" data-linked-resource-type="page" data-linked-resource-default-alias="Versioning datastore user guide" data-base-url="http://docs.codehaus.org">Versioning datastore user guide</a> </p></td>
</tr>
</tbody></table>

<h1>Gold Star Quality Assurance Check:</h1>

<p><img class="emoticon emoticon-yellow-star" data-emoticon-name="yellow-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_yellow.png" alt="(star)" title="(star)" /> IP Check: review.txt added, all headers are in place<br />
<img class="emoticon emoticon-yellow-star" data-emoticon-name="yellow-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_yellow.png" alt="(star)" title="(star)" /> Releasable: no blocking issues, but feedback from potential users is appreciated<br />
<img class="emoticon emoticon-yellow-star" data-emoticon-name="yellow-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_yellow.png" alt="(star)" title="(star)" /> Quality Assurance: 81.2% test coverage reported by clover<br />
<img class="emoticon emoticon-red-star" data-emoticon-name="red-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_red.png" alt="(red star)" title="(red star)" /> Stability: first release, API may still change in incompatible ways<br />
<img class="emoticon emoticon-yellow-star" data-emoticon-name="yellow-star" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/star_yellow.png" alt="(star)" title="(star)" /> Supported: Documents available. Module maintainer does watches user list, answers email.</p>

<h1>Target</h1>

<p>Versioning Postgis datastore allows to version enabled one or more feature types stored in Postgis, extract features at a specific revision, log changes, rollback them, and extract differences.</p>

<h1>Motivation</h1>

<p><a href="http://www.geoserver.org">Geoserver</a> is leading this effort in order to pursue the <a href="http://geoserver.org/display/GEOS/Versioning+WFS">versioning WFS</a>, a building block in the larger <a href="http://geoserver.org/display/GEOS/GeoCollaborator">GeoCollaboration</a> vision.</p>

<h1>Target Audience</h1>

<p>By being part of the GeoTools library, this datastore allows anyone to enjoy version control at the spatial data level.<br />
In particular, this is compelling for the following use cases:</p>
<ul>
	<li>multiple editor scenarios, where editing cannot be strictly controlled;</li>
	<li>map development, where a stable map needs to be published whilst a new version is being edited;</li>
	<li>high performance or disconnected WFS editing, since versioning allows for checkouts, diffs and delayed changes commit (though not checkout format has been devised).</li>
</ul>

<h1>Quality Assurance</h1>

<p>The module has high level of unit testing code coverage, 81.2% at the time of writing.<br />
The datastore is supposed to handle both versioning and non versioning use cases, and has been designed to make versioning transparent to users, so the unit tests perform:</p>
<ul>
	<li>the same tests as the postgis data store, against a VersionedPostgisDataStore with no versioned feature types;</li>
	<li>the same tests as the postgis data store, against a VersionedPostgisDataStore with all feature types versioned;</li>
	<li>extra test to assess the versioning capabilities (specific version extraction, logs, diffing, rollbacks and the like).</li>
</ul>

<h1>Status</h1>

<p>The module is in good health. No self or transient issues preventing it from compiling and passing tests.<br />
Yet, this is the first release, so API may be subject to changes as we get feeback about what works for users.</p>