Skip to content

Commit d37ab13

Browse files
elucashelucash
committed
2.9.1 site
1 parent 5e82e89 commit d37ab13

22 files changed

+3791
-3056
lines changed

‎2.8.0-release.html

+95-82
Large diffs are not rendered by default.

‎2.8.1-release.html

+67-68
Original file line numberDiff line numberDiff line change
@@ -31,108 +31,107 @@ <h1>2.8.1 Release Notes <iframe src="https://ghbtns.com/github-btn.html?user=imm
3131
</header>
3232
<aside id="toc"></aside>
3333
<section class="documentation">
34-
<h2>Overview</h2>
34+
<h2 id="overview">Overview</h2>
3535

36-
<p><a href="https://immutables.github.io/">Immutables</a> team is happy to announce Immutables 2.8.1 release. </p>
36+
<p><a href="https://immutables.github.io/">Immutables</a> team is happy to announce Immutables 2.8.1 release.</p>
3737

3838
<p>This release comes one month after <a href="https://github.com/immutables/immutables.github.io/blob/src/2.8.0-release.md">2.8.0</a> and contains
3939
several improvements, bugfixes and new functionalities.</p>
4040

41-
<h1>Notable changes</h1>
42-
43-
<h3>Criteria</h3>
41+
<h1 id="notable-changes">Notable changes</h1>
4442

43+
<h3 id="criteria">Criteria</h3>
4544
<ul>
46-
<li>Generate criteria DSL from existing <a href="https://en.wikipedia.org/wiki/JavaBeans">JavaBeans</a>(<a href="https://www.oracle.com/technetwork/articles/javaee/spec-136004.html">spec</a>) classes. Useful for projects which use JavaBeans for legacy reasons or not yet fully migrated to immutables. See <a href="https://github.com/immutables/immutables/pull/1103">#1103</a></li>
47-
<li>Pluggable ID resolution. Introduce <a href="https://github.com/immutables/immutables/blob/master/criteria/common/src/org/immutables/criteria/backend/IdResolver.java">IdResolver</a> interface to allow users to provide their own annotations (or logic) for ID attribute selection. It complements
48-
default <code>@Criteria.Id</code> annotation.</li>
49-
<li>Initial support for partial updates. Allow partial changes to be applied directly by the backend (if supported).
50-
<code>java
51-
// example
52-
repository.update(person.id.is(123))
53-
.set(person.name, &quot;Changed Name&quot;)
54-
.set(person.age, 33)
55-
.execute()
56-
</code></li>
57-
<li><p>Support top-level <code>count()</code> operation similar to <code>COUNT(*)</code> in SQL
58-
<code>java
59-
repository.findAll().count();
60-
repository.find(person.age.greaterThan(33)).count();
61-
</code></p></li>
62-
<li><p>Add <code>upsert</code> / <code>update</code> operations on entity in Writable interface</p></li>
45+
<li>Generate criteria DSL from existing <a href="https://en.wikipedia.org/wiki/JavaBeans">JavaBeans</a>(<a href="https://www.oracle.com/technetwork/articles/javaee/spec-136004.html">spec</a>) classes. Useful for projects which use JavaBeans for legacy reasons or not yet fully migrated to immutables. See <a href="https://github.com/immutables/immutables/pull/1103">#1103</a></li>
46+
<li>Pluggable ID resolution. Introduce <a href="https://github.com/immutables/immutables/blob/master/criteria/common/src/org/immutables/criteria/backend/IdResolver.java">IdResolver</a> interface to allow users to provide their own annotations (or logic) for ID attribute selection. It complements
47+
default <code class="language-plaintext highlighter-rouge">@Criteria.Id</code> annotation.</li>
48+
<li>Initial support for partial updates. Allow partial changes to be applied directly by the backend (if supported).
49+
<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// example</span>
50+
<span class="n">repository</span><span class="o">.</span><span class="na">update</span><span class="o">(</span><span class="n">person</span><span class="o">.</span><span class="na">id</span><span class="o">.</span><span class="na">is</span><span class="o">(</span><span class="mi">123</span><span class="o">))</span>
51+
<span class="o">.</span><span class="na">set</span><span class="o">(</span><span class="n">person</span><span class="o">.</span><span class="na">name</span><span class="o">,</span> <span class="s">"Changed Name"</span><span class="o">)</span>
52+
<span class="o">.</span><span class="na">set</span><span class="o">(</span><span class="n">person</span><span class="o">.</span><span class="na">age</span><span class="o">,</span> <span class="mi">33</span><span class="o">)</span>
53+
<span class="o">.</span><span class="na">execute</span><span class="o">()</span>
54+
</code></pre></div> </div>
55+
</li>
56+
<li>Support top-level <code class="language-plaintext highlighter-rouge">count()</code> operation similar to <code class="language-plaintext highlighter-rouge">COUNT(*)</code> in SQL
57+
<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">repository</span><span class="o">.</span><span class="na">findAll</span><span class="o">().</span><span class="na">count</span><span class="o">();</span>
58+
<span class="n">repository</span><span class="o">.</span><span class="na">find</span><span class="o">(</span><span class="n">person</span><span class="o">.</span><span class="na">age</span><span class="o">.</span><span class="na">greaterThan</span><span class="o">(</span><span class="mi">33</span><span class="o">)).</span><span class="na">count</span><span class="o">();</span>
59+
</code></pre></div> </div>
60+
</li>
61+
<li>Add <code class="language-plaintext highlighter-rouge">upsert</code> / <code class="language-plaintext highlighter-rouge">update</code> operations on entity in Writable interface</li>
6362
</ul>
6463

65-
<h3>Mongo jackson adapter</h3>
66-
64+
<h3 id="mongo-jackson-adapter">Mongo jackson adapter</h3>
6765
<ul>
68-
<li>Support BSON <code>undefined</code> type which is converted to java <code>null</code> (<a href="https://github.com/immutables/immutables/commit/9a64881">9a64881</a>)</li>
69-
<li>Support BSON binary data (<a href="https://github.com/immutables/immutables/commit/76fb7b44">76fb7b44</a>)</li>
70-
<li>Lazily read values from bson stream (<a href="https://github.com/immutables/immutables/commit/1c07466">1c07466</a>). Potentially a performance improvement since values don&#39;t have to be deserialized unless required by deserializer. Allows faster <code>skipChildren()</code> calls. </li>
71-
<li>Make BsonGenerator null safe on strings and numbers (<a href="https://github.com/immutables/immutables/commit/ba78d7">ba78d7</a>)</li>
66+
<li>Support BSON <code class="language-plaintext highlighter-rouge">undefined</code> type which is converted to java <code class="language-plaintext highlighter-rouge">null</code> (<a href="https://github.com/immutables/immutables/commit/9a64881">9a64881</a>)</li>
67+
<li>Support BSON binary data (<a href="https://github.com/immutables/immutables/commit/76fb7b44">76fb7b44</a>)</li>
68+
<li>Lazily read values from bson stream (<a href="https://github.com/immutables/immutables/commit/1c07466">1c07466</a>). Potentially a performance improvement since values don’t have to be deserialized unless required by deserializer. Allows faster <code class="language-plaintext highlighter-rouge">skipChildren()</code> calls.</li>
69+
<li>Make BsonGenerator null safe on strings and numbers (<a href="https://github.com/immutables/immutables/commit/ba78d7">ba78d7</a>)</li>
7270
</ul>
7371

74-
<h3>Mongo repositories</h3>
75-
72+
<h3 id="mongo-repositories">Mongo repositories</h3>
7673
<p>Changes related to <a href="https://immutables.github.io/mongo.html">mongo repositories</a> (predecessor to criteria).</p>
7774

7875
<ul>
79-
<li>Enable <code>_id</code> initialization in MongoDB (<a href="https://github.com/immutables/immutables/pull/1074">#1074</a>). PR from <a href="https://github.com/arouel">André Rouél</a></li>
80-
<li><code>bson4gson</code> adapter. Support BSON <code>undefined</code> type translated to java <code>null</code> </li>
81-
<li><code>bson4gson</code> adapter. Friendlier type conversion between BSON temporal types and java numbers (int / long etc.)</li>
82-
<li><code>bson4gson</code> adapter. Fix <code>peek()</code> method in JsonReader (<a href="https://github.com/immutables/immutables/commit/6f1247">6f1247</a>)</li>
83-
<li>Require Java 8</li>
76+
<li>Enable <code class="language-plaintext highlighter-rouge">_id</code> initialization in MongoDB (<a href="https://github.com/immutables/immutables/pull/1074">#1074</a>). PR from <a href="https://github.com/arouel">André Rouél</a></li>
77+
<li><code class="language-plaintext highlighter-rouge">bson4gson</code> adapter. Support BSON <code class="language-plaintext highlighter-rouge">undefined</code> type translated to java <code class="language-plaintext highlighter-rouge">null</code></li>
78+
<li><code class="language-plaintext highlighter-rouge">bson4gson</code> adapter. Friendlier type conversion between BSON temporal types and java numbers (int / long etc.)</li>
79+
<li><code class="language-plaintext highlighter-rouge">bson4gson</code> adapter. Fix <code class="language-plaintext highlighter-rouge">peek()</code> method in JsonReader (<a href="https://github.com/immutables/immutables/commit/6f1247">6f1247</a>)</li>
80+
<li>Require Java 8</li>
8481
</ul>
8582

86-
<h3>Codegen</h3>
87-
83+
<h3 id="codegen">Codegen</h3>
8884
<ul>
89-
<li>Support <a href="https://immutables.github.io/immutable.html#lazy-computation-of-hashcode">lazy hashing</a> via <code>lazyhash</code> attribute. Contrary to existing <a href="https://immutables.github.io/immutable.html#lazy-computation-of-hashcode">prehash</a>, lazyhash would compute hashcode on first access to <code>hashCode()</code> method.</li>
90-
<li>Changed how <code>META-INF/annotations/org.immutables.value.immutable</code> is read - disabled URLConnection caching. <a href="https://github.com/immutables/immutables/issues/1060">PR-1060</a> from <a href="https://github.com/canayozel">Canay ÖZEL</a></li>
91-
<li>Set optBits for Modifiable, Default maps. <a href="https://github.com/immutables/immutables/pull/1086">PR-1086</a> from <a href="https://github.com/dwragge">Dylan Wragge</a></li>
85+
<li>Support <a href="https://immutables.github.io/immutable.html#lazy-computation-of-hashcode">lazy hashing</a> via <code class="language-plaintext highlighter-rouge">lazyhash</code> attribute. Contrary to existing <a href="https://immutables.github.io/immutable.html#lazy-computation-of-hashcode">prehash</a>, lazyhash would compute hashcode on first access to <code class="language-plaintext highlighter-rouge">hashCode()</code> method.</li>
86+
<li>Changed how <code class="language-plaintext highlighter-rouge">META-INF/annotations/org.immutables.value.immutable</code> is read - disabled URLConnection caching. <a href="https://github.com/immutables/immutables/issues/1060">PR-1060</a> from <a href="https://github.com/canayozel">Canay ÖZEL</a></li>
87+
<li>Set optBits for Modifiable, Default maps. <a href="https://github.com/immutables/immutables/pull/1086">PR-1086</a> from <a href="https://github.com/dwragge">Dylan Wragge</a></li>
9288
</ul>
9389

94-
<h3>Third party library upgrades and other dependencies</h3>
95-
90+
<h3 id="third-party-library-upgrades-and-other-dependencies">Third party library upgrades and other dependencies</h3>
9691
<ul>
97-
<li>Jackson databind 2.8.11.3 -&gt; 2.8.11.4 (<a href="https://github.com/immutables/immutables/commit/9ea18">9ea18</a>)</li>
98-
<li>Mongo java (sync) driver 3.10.1 -&gt; 3.11.0 (<a href="https://github.com/immutables/immutables/commit/33f98d4">33f98d4</a>)</li>
99-
<li>Mongo reactive streams 1.11 -&gt; 1.12 (<a href="https://github.com/immutables/immutables/commit/fed2e07">fed2e07</a>)</li>
100-
<li>rxjava2 2.2.10 -&gt; 2.2.12 (<a href="https://github.com/immutables/immutables/commit/c6e06ce">c6e06ce</a>)</li>
101-
<li>ErrorProne 2.3.2 -&gt; 2.3.3 (<a href="https://github.com/immutables/immutables/commit/b62fab4f">b62fab4f</a>)</li>
102-
<li>Remove <code>utility</code> maven module (<a href="https://github.com/immutables/immutables/issues/1089">1089</a>). All modules will
92+
<li>Jackson databind 2.8.11.3 -&gt; 2.8.11.4 (<a href="https://github.com/immutables/immutables/commit/9ea18">9ea18</a>)</li>
93+
<li>Mongo java (sync) driver 3.10.1 -&gt; 3.11.0 (<a href="https://github.com/immutables/immutables/commit/33f98d4">33f98d4</a>)</li>
94+
<li>Mongo reactive streams 1.11 -&gt; 1.12 (<a href="https://github.com/immutables/immutables/commit/fed2e07">fed2e07</a>)</li>
95+
<li>rxjava2 2.2.10 -&gt; 2.2.12 (<a href="https://github.com/immutables/immutables/commit/c6e06ce">c6e06ce</a>)</li>
96+
<li>ErrorProne 2.3.2 -&gt; 2.3.3 (<a href="https://github.com/immutables/immutables/commit/b62fab4f">b62fab4f</a>)</li>
97+
<li>Remove <code class="language-plaintext highlighter-rouge">utility</code> maven module (<a href="https://github.com/immutables/immutables/issues/1089">1089</a>). All modules will
10398
declare dependencies explicitly.</li>
10499
</ul>
105100

106-
<p>Thanks to all contributors. In no particular order:
107-
- <a href="https://github.com/dwragge">Dylan Wragge</a>
108-
- <a href="https://github.com/canayozel">Canay ÖZEL</a>
109-
- <a href="https://github.com/arouel">André Rouél</a></p>
101+
<p>Thanks to all contributors. In no particular order:</p>
102+
<ul>
103+
<li><a href="https://github.com/dwragge">Dylan Wragge</a></li>
104+
<li><a href="https://github.com/canayozel">Canay ÖZEL</a></li>
105+
<li><a href="https://github.com/arouel">André Rouél</a></li>
106+
</ul>
107+
110108

111109
</section>
112110
<footer class="jumbotron">
113111
<div class="container">
114-
<h2>Guides</h2>
112+
<h2 id="guides">Guides</h2>
115113

116114
<ul>
117-
<li><a href="/getstarted.html">Get started!</a></li>
118-
<li><a href="/intro.html">Inception</a></li>
119-
<li><a href="/immutable.html">Immutable objects</a></li>
120-
<li><a href="/factory.html">Factory builders</a></li>
121-
<li><a href="/functional.html">Functions and Predicates (for Java 7)</a></li>
122-
<li><a href="/style.html">Style customization</a></li>
123-
<li><a href="/json.html">JSON serialization</a></li>
124-
<li><a href="/criteria.html">Criteria</a></li>
125-
<li><a href="/mongo.html">MongoDB repositories</a></li>
126-
<li><a href="/encoding.html">Encoding: Customizing attributes and builders (experimental)</a></li>
127-
<li><a href="/apt.html">Using annotation processor in IDE</a></li>
115+
<li><a href="/getstarted.html">Get started!</a></li>
116+
<li><a href="/intro.html">Inception</a></li>
117+
<li><a href="/immutable.html">Immutable objects</a></li>
118+
<li><a href="/factory.html">Factory builders</a></li>
119+
<li><a href="/functional.html">Functions and Predicates (for Java 7)</a></li>
120+
<li><a href="/style.html">Style customization</a></li>
121+
<li><a href="/json.html">JSON serialization</a></li>
122+
<li><a href="/criteria.html">Criteria</a></li>
123+
<li><a href="/mongo.html">MongoDB repositories</a></li>
124+
<li><a href="/dynamodb.html">DynamoDB integration</a></li>
125+
<li><a href="/encoding.html">Encoding: Customizing attributes and builders (experimental)</a></li>
126+
<li><a href="/apt.html">Using annotation processor in IDE</a></li>
128127
</ul>
129128

130-
<h2>Get involved</h2>
129+
<h2 id="get-involved">Get involved</h2>
131130

132131
<ul>
133-
<li>Clone source repository, contribute bug reports and fixes on <a href="https://github.com/immutables/immutables">GitHub immutables/immutables</a></li>
134-
<li>Issue reports, questions and feedback is welcome on issue tracker <a href="https://github.com/immutables/immutables/issues">GitHub immutables/immutables/issues</a></li>
135-
<li>News and announcements on twitter <a href="https://twitter.com/ImmutablesOrg">@ImmutablesOrg</a></li>
132+
<li>Clone source repository, contribute bug reports and fixes on <a href="https://github.com/immutables/immutables">GitHub immutables/immutables</a></li>
133+
<li>Issue reports, questions and feedback is welcome on issue tracker <a href="https://github.com/immutables/immutables/issues">GitHub immutables/immutables/issues</a></li>
134+
<li>News and announcements on twitter <a href="https://twitter.com/ImmutablesOrg">@ImmutablesOrg</a></li>
136135
</ul>
137136

138137
<p><a href="/license.html">Apache License 2.0</a></p>

0 commit comments

Comments
 (0)