AFAIK latest versions of both. Anything broken? ________________________________________ From: Ignasi Barrera [ignasi.barr...@gmail.com] Sent: Thursday, September 04, 2014 11:29 AM To: dev@jclouds.apache.org Subject: Re: svn commit: r1622496 [1/4] - in /jclouds/site-content: ./ blog/ blog/2009/05/13/catching-exceptions-with-less-keystrokes/ blog/2011/10/18/jclouds-1-2-released/ blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and/ blog/2012/05/02/new-to...
Zach wichi version of Jekyll were you using? Did you use the latest version of the script to generate the site? I'm just wondering, why the commit for your blog post modified all those files. In any case, that can be prevented by taking a look at the script output (which should prompt you) and manually adding *only* the relevant files if needed, and discard the rest? On 4 September 2014 17:18, <zac...@apache.org> wrote: > Author: zachsh > Date: Thu Sep 4 15:18:35 2014 > New Revision: 1622496 > > URL: http://svn.apache.org/r1622496 > Log: > deploy jclouds site content > > Added: > jclouds/site-content/blog/2014/09/ > jclouds/site-content/blog/2014/09/03/ > jclouds/site-content/blog/2014/09/03/better-builders/ > jclouds/site-content/blog/2014/09/03/better-builders/index.html > Modified: > > jclouds/site-content/blog/2009/05/13/catching-exceptions-with-less-keystrokes/index.html > jclouds/site-content/blog/2011/10/18/jclouds-1-2-released/index.html > > jclouds/site-content/blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and/index.html > jclouds/site-content/blog/2012/05/02/new-toys-in-1-5-0-alpha-6/index.html > > jclouds/site-content/blog/2012/07/16/fluency-for-paginated-api-lists/index.html > > jclouds/site-content/blog/2012/12/12/jclouds-1-5-4-mistletoe-released/index.html > jclouds/site-content/blog/atom.xml > jclouds/site-content/blog/index.html > jclouds/site-content/blog/page2/index.html > jclouds/site-content/blog/page3/index.html > jclouds/site-content/blog/page4/index.html > jclouds/site-content/blog/page5/index.html > jclouds/site-content/guides/abiquo-cloud/index.html > jclouds/site-content/guides/abiquo/index.html > jclouds/site-content/guides/aws-ebs/index.html > jclouds/site-content/guides/aws-ec2/index.html > jclouds/site-content/guides/aws-sqs/index.html > jclouds/site-content/guides/aws/index.html > jclouds/site-content/guides/azure-storage/index.html > jclouds/site-content/guides/bluelock/index.html > jclouds/site-content/guides/chef/index.html > jclouds/site-content/guides/cloudsigma/index.html > jclouds/site-content/guides/docker/index.html > jclouds/site-content/guides/filesystem/index.html > jclouds/site-content/guides/glacier/index.html > jclouds/site-content/guides/go-grid/index.html > jclouds/site-content/guides/hpcloud/index.html > jclouds/site-content/guides/karaf/index.html > jclouds/site-content/guides/openstack/index.html > jclouds/site-content/guides/rackspace/index.html > jclouds/site-content/guides/vcloud-director/index.html > jclouds/site-content/guides/vcloud/index.html > jclouds/site-content/index.html > jclouds/site-content/reference/configuration/index.html > jclouds/site-content/reference/logging/index.html > jclouds/site-content/reference/troubleshooting/index.html > jclouds/site-content/releasenotes/1.1.0/index.html > jclouds/site-content/releasenotes/1.2/index.html > jclouds/site-content/releasenotes/1.6.1/index.html > jclouds/site-content/releasenotes/1.6.2/index.html > jclouds/site-content/releasenotes/1.6.3/index.html > jclouds/site-content/releasenotes/1.7.0/index.html > jclouds/site-content/releasenotes/1.7.1/index.html > jclouds/site-content/releasenotes/1.7.2/index.html > jclouds/site-content/releasenotes/1.7.3/index.html > jclouds/site-content/releasenotes/atom.xml > jclouds/site-content/start/blobstore/index.html > jclouds/site-content/start/compute/index.html > jclouds/site-content/start/install/index.html > > Modified: > jclouds/site-content/blog/2009/05/13/catching-exceptions-with-less-keystrokes/index.html > URL: > http://svn.apache.org/viewvc/jclouds/site-content/blog/2009/05/13/catching-exceptions-with-less-keystrokes/index.html?rev=1622496&r1=1622495&r2=1622496&view=diff > ============================================================================== > --- > jclouds/site-content/blog/2009/05/13/catching-exceptions-with-less-keystrokes/index.html > (original) > +++ > jclouds/site-content/blog/2009/05/13/catching-exceptions-with-less-keystrokes/index.html > Thu Sep 4 15:18:35 2014 > @@ -154,8 +154,7 @@ > <span class="o">}</span> <span class="k">catch</span> <span > class="o">(</span><span class="n">Exception</span> <span > class="n">e</span><span class="o">)</span> <span class="o">{</span> > <span class="n">Utils</span><span class="o">.<</span><span > class="n">ApplicationException</span><span class="o">></span><span > class="n">rethrowIfRuntimeOrSameType</span><span class="o">(</span><span > class="n">e</span><span class="o">);</span> > <span class="k">throw</span> <span class="k">new</span> <span > class="nf">ApplicationException</span><span class="o">(</span><span > class="s">"Error applying stuff"</span><span class="o">,</span> > <span class="n">e</span><span class="o">);</span> > -<span class="o">}</span> > -</code></pre></div> > +<span class="o">}</span></code></pre></div> > > > <p>This code does what it says, preventing us from unnecessarily nesting > application exceptions or swallowing runtimes.</p> > @@ -170,8 +169,7 @@ > <span class="o">}</span> <span class="k">catch</span> <span > class="o">(</span><span class="n">ClassCastException</span> <span > class="n">throwAway</span><span class="o">)</span> <span class="o">{</span> > <span class="c1">// using cce as there's no way to do instanceof > E in current java</span> > <span class="o">}</span> > -<span class="o">}</span> > -</code></pre></div> > +<span class="o">}</span></code></pre></div> > > > <p>The trick is that we try to force the exception we caught into the > generic type. If that fails, we know it wasn't that type and that we should > wrap, log, etc.</p> > > Modified: jclouds/site-content/blog/2011/10/18/jclouds-1-2-released/index.html > URL: > http://svn.apache.org/viewvc/jclouds/site-content/blog/2011/10/18/jclouds-1-2-released/index.html?rev=1622496&r1=1622495&r2=1622496&view=diff > ============================================================================== > --- jclouds/site-content/blog/2011/10/18/jclouds-1-2-released/index.html > (original) > +++ jclouds/site-content/blog/2011/10/18/jclouds-1-2-released/index.html Thu > Sep 4 15:18:35 2014 > @@ -158,8 +158,7 @@ > > <div class="highlight"><pre><code class="java"><span class="n">future</span> > <span class="o">=</span> <span class="n">client</span><span > class="o">.</span><span class="na">submitScriptOnNode</span><span > class="o">(</span><span class="n">node</span><span class="o">.</span><span > class="na">getId</span><span class="o">(),</span> > <span class="n">AdminAccess</span><span > class="o">.</span><span class="na">builder</span><span > class="o">().</span><span class="na">adminUsername</span><span > class="o">(</span><span class="s">"foo"</span><span > class="o">).</span><span class="na">build</span><span class="o">(),</span> > - <span class="n">nameTask</span><span class="o">(</span><span > class="s">"adminUpdate"</span><span class="o">));</span> > -</code></pre></div> > + <span class="n">nameTask</span><span class="o">(</span><span > class="s">"adminUpdate"</span><span > class="o">));</span></code></pre></div> > > > <p>As always, we keep our <a > href="https://github.com/jclouds/jclouds-examples";>examples site</a> up to > date so you can see how to work this stuff. Next release will be in > approximately 1-months time. Look out for progress including <a > href="http://www.vmware.com/products/vcloud-director/overview.html";>vCloud > 1.5</a>, <a href="http://voxel.net/voxcloud";>Voxel</a>, and <a > href="https://www.virtualbox.org/";>VirtualBox</a>.</p> > > Modified: > jclouds/site-content/blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and/index.html > URL: > http://svn.apache.org/viewvc/jclouds/site-content/blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and/index.html?rev=1622496&r1=1622495&r2=1622496&view=diff > ============================================================================== > --- > jclouds/site-content/blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and/index.html > (original) > +++ > jclouds/site-content/blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and/index.html > Thu Sep 4 15:18:35 2014 > @@ -162,14 +162,12 @@ > <div class="highlight"><pre><code class="clojure"><span > class="p">(</span><span class="nf">use</span> <span > class="o">'</span><span class="ss">'org.jclouds.compute2</span><span > class="p">)</span> > <span class="p">(</span><span class="nb">import </span><span > class="o">'</span><span > class="ss">'org.jclouds.scriptbuilder.statements.login.AdminAccess</span><span > class="p">)</span> > <span class="p">(</span><span class="k">def </span><span > class="nv">compute</span> <span class="p">(</span><span > class="nf">compute-service</span> <span > class="s">"hpcloud-compute"</span> <span > class="s">"tenantId:ACCESSKEY"</span> <span > class="s">"SECRETKEY"</span> <span class="ss">:slf4j</span> > <span class="ss">:sshj</span><span class="p">))</span> > -<span class="p">(</span><span class="nf">create-node</span> <span > class="nv">compute</span> <span class="s">"test"</span> <span > class="p">(</span><span class="nf">build-template</span> <span > class="nv">compute</span> <span class="p">{</span> <span > class="ss">:run-script</span> <span class="p">(</span><span > class="nf">AdminAccess/standard</span><span class="p">)</span> <span > class="p">}</span> <span class="p">))</span> > -</code></pre></div> > +<span class="p">(</span><span class="nf">create-node</span> <span > class="nv">compute</span> <span class="s">"test"</span> <span > class="p">(</span><span class="nf">build-template</span> <span > class="nv">compute</span> <span class="p">{</span> <span > class="ss">:run-script</span> <span class="p">(</span><span > class="nf">AdminAccess/standard</span><span class="p">)</span> <span > class="p">}</span> <span class="p">))</span></code></pre></div> > > > <p>Here's an example of how to do the same on <a > href="https://trystack.org/";>TryStack</a>, authenticating w/ user & pass > as opposed to key, via our <a > href="https://github.com/jclouds/jclouds-examples/tree/master/compute-basics";>java > example</a>:</p> > > -<div class="highlight"><pre><code class="bash">java -jar > target/compute-basics-jar-with-dependencies.jar trystack-nova tenantId:user > password mygroup add > -</code></pre></div> > +<div class="highlight"><pre><code class="bash">java -jar > target/compute-basics-jar-with-dependencies.jar trystack-nova tenantId:user > password mygroup add</code></pre></div> > > > <p>In the group org.jclouds.labs, you'll find two more new and notable > members of the jclouds family:</p> > @@ -182,8 +180,7 @@ > > <p>You can try out virtualbox like any other api. For example, you can use > the clojure above, only changing how you create the connection slightly:</p> > > -<div class="highlight"><pre><code class="clojure"><span > class="p">(</span><span class="k">def </span><span class="nv">compute</span> > <span class="p">(</span><span class="nf">compute-service</span> <span > class="s">"virtualbox"</span> <span > class="s">"administrator"</span> <span > class="s">"12345"</span> <span class="ss">:sshj</span> <span > class="ss">:slf4j</span><span class="p">))</span> > -</code></pre></div> > +<div class="highlight"><pre><code class="clojure"><span > class="p">(</span><span class="k">def </span><span class="nv">compute</span> > <span class="p">(</span><span class="nf">compute-service</span> <span > class="s">"virtualbox"</span> <span > class="s">"administrator"</span> <span > class="s">"12345"</span> <span class="ss">:sshj</span> <span > class="ss">:slf4j</span><span class="p">))</span></code></pre></div> > > > <p>The code in labs will certainly change before we release a beta, but feel > free to check them out. Meanwhile, you can try them out and give us feedback > on #jclouds irc freenode or jclouds-dev google group!</p> > @@ -192,8 +189,7 @@ > > <p>Oh, and don't forget to clean up your nodes :)</p> > > -<div class="highlight"><pre><code class="clojure"><span > class="p">(</span><span class="nf">destroy-nodes-matching</span> <span > class="nv">compute</span> <span class="p">(</span><span class="nb">constantly > </span><span class="nv">true</span><span class="p">))</span> > -</code></pre></div> > +<div class="highlight"><pre><code class="clojure"><span > class="p">(</span><span class="nf">destroy-nodes-matching</span> <span > class="nv">compute</span> <span class="p">(</span><span class="nb">constantly > </span><span class="nv">true</span><span > class="p">))</span></code></pre></div> > > > > > Modified: > jclouds/site-content/blog/2012/05/02/new-toys-in-1-5-0-alpha-6/index.html > URL: > http://svn.apache.org/viewvc/jclouds/site-content/blog/2012/05/02/new-toys-in-1-5-0-alpha-6/index.html?rev=1622496&r1=1622495&r2=1622496&view=diff > ============================================================================== > --- jclouds/site-content/blog/2012/05/02/new-toys-in-1-5-0-alpha-6/index.html > (original) > +++ jclouds/site-content/blog/2012/05/02/new-toys-in-1-5-0-alpha-6/index.html > Thu Sep 4 15:18:35 2014 > @@ -161,8 +161,7 @@ > <span class="k">for</span> <span class="o">(</span><span > class="n">Tenant</span> <span class="n">tenant</span> <span > class="o">:</span> <span class="n">adminClient</span><span > class="o">.</span><span class="na">listTenants</span><span > class="o">())</span> <span class="o">{</span> > <span class="c1">// ...</span> > <span class="o">}</span> > -<span class="o">}</span> > -</code></pre></div> > +<span class="o">}</span></code></pre></div> > > > <p>Also pro, is our new Amazon CloudWatch support from Jeremy Whitlock. This > is our first complete renovation of an AWS api to have the same look/feel as > our new OpenStack stuff. Just add a dependency on > <em>org.jclouds.providers/aws-cloudwatch</em> and you can do this!</p> > @@ -177,8 +176,7 @@ > <span class="k">for</span> <span class="o">(</span><span > class="n">Metric</span> <span class="n">metric</span> <span > class="o">:</span> <span class="n">metricClient</span><span > class="o">.</span><span class="na">listMetrics</span><span > class="o">())</span> <span class="o">{</span> > <span class="c1">// ...</span> > <span class="o">}</span> > -<span class="o">}</span> > -</code></pre></div> > +<span class="o">}</span></code></pre></div> > > > <p>And for the jenkins users, we also have an api for remote job and > computer control, at <em>org.jclouds.labs/jenkins</em>!</p> > @@ -187,8 +185,7 @@ > <span class="n">RestContext</span> <span class="n">localhost</span> <span > class="o">=</span> <span class="n">contextBuilder</span><span > class="o">.</span><span class="na">build</span><span class="o">();</span> > > <span class="n">Node</span> <span class="n">master</span> <span > class="o">=</span> <span class="n">localhost</span><span > class="o">.</span><span class="na">getApi</span><span > class="o">().</span><span class="na">getMaster</span><span > class="o">();</span> > -<span class="n">localhost</span><span class="o">.</span><span > class="na">getJobClient</span><span class="o">().</span><span > class="na">createFromXML</span><span class="o">(</span><span > class="s">"newJob"</span><span class="o">,</span> <span > class="n">xmlAsString</span><span class="o">);</span> > -</code></pre></div> > +<span class="n">localhost</span><span class="o">.</span><span > class="na">getJobClient</span><span class="o">().</span><span > class="na">createFromXML</span><span class="o">(</span><span > class="s">"newJob"</span><span class="o">,</span> <span > class="n">xmlAsString</span><span class="o">);</span></code></pre></div> > > > <p>This is especially helpful with the new <a > href="https://github.com/jenkinsci/jclouds-plugin";>jclouds-plugin</a>, which > uses jclouds to spin up new slaves and publish artifacts to BlobStore. Tons > more in there, too.</p> > > Modified: > jclouds/site-content/blog/2012/07/16/fluency-for-paginated-api-lists/index.html > URL: > http://svn.apache.org/viewvc/jclouds/site-content/blog/2012/07/16/fluency-for-paginated-api-lists/index.html?rev=1622496&r1=1622495&r2=1622496&view=diff > ============================================================================== > --- > jclouds/site-content/blog/2012/07/16/fluency-for-paginated-api-lists/index.html > (original) > +++ > jclouds/site-content/blog/2012/07/16/fluency-for-paginated-api-lists/index.html > Thu Sep 4 15:18:35 2014 > @@ -168,8 +168,7 @@ > > <h3>Lazy advance through all your metrics:</h3> > > -<div class="highlight"><pre><code class="java"><span > class="n">FluentIterable</span><span class="o"><</span><span > class="n">Metric</span><span class="o">></span> <span > class="n">allMetrics</span> <span class="o">=</span> <span > class="n">cloudwatch</span><span class="o">.</span><span > class="na">getMetricApi</span><span class="o">().</span><span > class="na">list</span><span class="o">().</span><span > class="na">concat</span><span class="o">();</span> > -</code></pre></div> > +<div class="highlight"><pre><code class="java"><span > class="n">FluentIterable</span><span class="o"><</span><span > class="n">Metric</span><span class="o">></span> <span > class="n">allMetrics</span> <span class="o">=</span> <span > class="n">cloudwatch</span><span class="o">.</span><span > class="na">getMetricApi</span><span class="o">().</span><span > class="na">list</span><span class="o">().</span><span > class="na">concat</span><span class="o">();</span></code></pre></div> > > > <h3>Â Advance only until we find the load balancer we want:</h3> > @@ -177,14 +176,12 @@ > <div class="highlight"><pre><code class="java"><span > class="n">Optional</span><span class="o"><</span><span > class="n">LoadBalancer</span><span class="o">></span> <span > class="n">firstInterestingLoadBalancer</span> <span class="o">=</span> <span > class="n">elb</span> > <span class="o">.</span><span class="na">getLoadBalancerApi</span><span > class="o">().</span><span class="na">list</span><span class="o">()</span> > <span class="o">.</span><span class="na">concat</span><span > class="o">()</span> > - <span class="o">.</span><span class="na">firstMatch</span><span > class="o">(</span><span class="n">isInterestingLB</span><span > class="o">());</span> > -</code></pre></div> > + <span class="o">.</span><span class="na">firstMatch</span><span > class="o">(</span><span class="n">isInterestingLB</span><span > class="o">());</span></code></pre></div> > > > <h3>Get only the first page of database instances</h3> > > -<div class="highlight"><pre><code class="java"><span > class="n">IterableWithMarker</span><span class="o"><</span><span > class="n">Instance</span><span class="o">></span> <span > class="n">firstPage</span> <span class="o">=</span> <span > class="n">rds</span><span class="o">.</span><span > class="na">getInstanceApi</span><span class="o">().</span><span > class="na">list</span><span class="o">().</span><span > class="na">get</span><span class="o">(</span><span class="mi">0</span><span > class="o">);</span> > -</code></pre></div> > +<div class="highlight"><pre><code class="java"><span > class="n">IterableWithMarker</span><span class="o"><</span><span > class="n">Instance</span><span class="o">></span> <span > class="n">firstPage</span> <span class="o">=</span> <span > class="n">rds</span><span class="o">.</span><span > class="na">getInstanceApi</span><span class="o">().</span><span > class="na">list</span><span class="o">().</span><span > class="na">get</span><span class="o">(</span><span class="mi">0</span><span > class="o">);</span></code></pre></div> > > > <p>The above syntax is being worked through relevant apis. In order to try > it out, grab jclouds 1.5.0-beta.7 (releasing today), and use any of the > following methods:</p> > > Modified: > jclouds/site-content/blog/2012/12/12/jclouds-1-5-4-mistletoe-released/index.html > URL: > http://svn.apache.org/viewvc/jclouds/site-content/blog/2012/12/12/jclouds-1-5-4-mistletoe-released/index.html?rev=1622496&r1=1622495&r2=1622496&view=diff > ============================================================================== > --- > jclouds/site-content/blog/2012/12/12/jclouds-1-5-4-mistletoe-released/index.html > (original) > +++ > jclouds/site-content/blog/2012/12/12/jclouds-1-5-4-mistletoe-released/index.html > Thu Sep 4 15:18:35 2014 > @@ -156,8 +156,7 @@ > > <p>For example, the following syntax can be used in karaf directly, or via > the <a href="https://github.com/jclouds/jclouds-cli";>jclouds cli</a> to start > a node in any supported cloud and bootstrap chef recipes.</p> > > -<div class="highlight"><pre><code class="bash">karaf@root>node-create > --adminAccess --recipe chef/java::openjdk karaf > -</code></pre></div> > +<div class="highlight"><pre><code class="bash">karaf@root>node-create > --adminAccess --recipe chef/java::openjdk karaf</code></pre></div> > > > <h2>What else is in 1.5.4?</h2> > @@ -168,16 +167,14 @@ > > <p><a href="https://github.com/everett-toews";>Everett</a> modernized support > for <strong>rackspace-cloudloadbalancers-us</strong> and <strong>uk</strong> > is now available. This includes syntactic sugar such as auto-pagination and > easy transforms.</p> > > -<div class="highlight"><pre><code class="java"><span > class="n">FluentIterable</span><span class="o"><</span><span > class="n">HostAndPort</span><span class="o">></span> <span > class="n">sockets</span> <span class="o">=</span> <span > class="n">clb</span><span class="o">.</span><span > class="na">getLoadBalancerApiForZone</span><span class="o">(</span><span > class="n">zone</span><span class="o">).</span><span > class="na">list</span><span class="o">().</span><span > class="na">concat</span><span class="o">().</span><span > class="na">transform</span><span class="o">(</span><span > class="n">converter</span><span class="o">);</span> > -</code></pre></div> > +<div class="highlight"><pre><code class="java"><span > class="n">FluentIterable</span><span class="o"><</span><span > class="n">HostAndPort</span><span class="o">></span> <span > class="n">sockets</span> <span class="o">=</span> <span > class="n">clb</span><span class="o">.</span><span > class="na">getLoadBalancerApiForZone</span><span class="o">(</span><span > class="n">zone</span><span class="o">).</span><span > class="na">list</span><span class="o">().</span><span > class="na">concat</span><span class="o">().</span><span > class="na">transform</span><span class="o">(</span><span > class="n">converter</span><span class="o">);</span></code></pre></div> > > > <h3>Nova Server Diagnostics</h3> > > <p>Some implementations of Nova have diagnostic information available. > Thanks to <a href="https://github.com/LeanderBB";>Leander</a>, you can now > discover this capability at runtime.</p> > > -<div class="highlight"><pre><code class="java"><span > class="n">Optional</span><span class="o"><</span><span > class="n">Map</span><span class="o">></span> <span > class="n">diagnosticInfo</span> <span class="o">=</span> <span > class="n">novaApi</span><span class="o">.</span><span > class="na">getServerApiForZone</span><span class="o">(</span><span > class="s">"az-1.region-a.geo-1"</span><span > class="o">).</span><span class="na">getDiagnostics</span><span > class="o">(</span><span class="n">serverId</span><span class="o">);</span> > -</code></pre></div> > +<div class="highlight"><pre><code class="java"><span > class="n">Optional</span><span class="o"><</span><span > class="n">Map</span><span class="o">></span> <span > class="n">diagnosticInfo</span> <span class="o">=</span> <span > class="n">novaApi</span><span class="o">.</span><span > class="na">getServerApiForZone</span><span class="o">(</span><span > class="s">"az-1.region-a.geo-1"</span><span > class="o">).</span><span class="na">getDiagnostics</span><span > class="o">(</span><span class="n">serverId</span><span > class="o">);</span></code></pre></div> > > > <h3>S3 Multi-Object delete</h3> > @@ -185,8 +182,7 @@ > <p><a href="http://maginatics.com/";>Maginatics</a> have BlobStore containers > with over a billion objects in them. S3 containers (buckets) can now be > cleared with 1/1000 the requests, thanks to <a > href="https://twitter.com/andreisavu";>Andrei</a>'s additional support of S3 > multi-delete.</p> > > <div class="highlight"><pre><code class="java"><span > class="n">DeleteResult</span> <span class="n">result</span> <span > class="o">=</span> <span class="n">s3Api</span><span class="o">.</span><span > class="na">deleteObjects</span><span class="o">(</span><span > class="n">container</span><span class="o">,</span> <span > class="n">keys</span><span class="o">);</span> > -<span class="n">assertEquals</span><span class="o">(</span><span > class="n">result</span><span class="o">.</span><span > class="na">size</span><span class="o">(),</span> <span > class="n">keys</span><span class="o">.</span><span > class="na">size</span><span class="o">());</span> > -</code></pre></div> > +<span class="n">assertEquals</span><span class="o">(</span><span > class="n">result</span><span class="o">.</span><span > class="na">size</span><span class="o">(),</span> <span > class="n">keys</span><span class="o">.</span><span > class="na">size</span><span class="o">());</span></code></pre></div> > > > <h2>What's next</h2> > > Added: jclouds/site-content/blog/2014/09/03/better-builders/index.html > URL: > http://svn.apache.org/viewvc/jclouds/site-content/blog/2014/09/03/better-builders/index.html?rev=1622496&view=auto > ============================================================================== > --- jclouds/site-content/blog/2014/09/03/better-builders/index.html (added) > +++ jclouds/site-content/blog/2014/09/03/better-builders/index.html Thu Sep > 4 15:18:35 2014 > @@ -0,0 +1,344 @@ > +<!DOCTYPE html> > +<html lang="en"> > + <head> > + <meta charset="utf-8"> > +<title>Apache jclouds® :: Better Builders with jclouds!</title> > +<meta name="viewport" content="width=device-width, initial-scale=1.0"> > +<meta name="description" content=""> > +<meta name="author" content=""> > + > +<!--link rel="stylesheet/less" href="less/bootstrap.less" type="text/css" > /--> > +<!--link rel="stylesheet/less" href="less/responsive.less" type="text/css" > /--> > +<!--script src="js/less-1.3.3.min.js"></script--> > +<!--append â?~#!watchâ?T to the browser URL, then refresh the page. --> > + > +<link href="/css/bootstrap.min.css" rel="stylesheet"> > +<link href="/css/style.css" rel="stylesheet"> > +<link href="/css/syntax.css" rel="stylesheet"> > + > +<!-- HTML5 shim, for IE6-8 support of HTML5 elements --> > +<!--[if lt IE 9]> > +<script src="js/html5shiv.js"></script> > +<![endif]--> > + > +<!-- Fav and touch icons --> > +<!-- > +<link rel="apple-touch-icon-precomposed" sizes="144x144" > href="/img/apple-touch-icon-144-precomposed.png"> > +<link rel="apple-touch-icon-precomposed" sizes="114x114" > href="/img/apple-touch-icon-114-precomposed.png"> > +<link rel="apple-touch-icon-precomposed" sizes="72x72" > href="/img/apple-touch-icon-72-precomposed.png"> > +<link rel="apple-touch-icon-precomposed" > href="/img/apple-touch-icon-57-precomposed.png"> > +--> > +<link rel="shortcut icon" href="/favicon.ico"> > + > +<link rel="alternate" type="application/atom+xml" href="/blog/atom.xml" > title="Blog Posts Feed"> > +<link rel="alternate" type="application/atom+xml" > href="/releasenotes/atom.xml" title="Release Notes Feed"> > + > +<script type="text/javascript" src="/js/jquery.min.js"></script> > +<script type="text/javascript" src="/js/bootstrap.min.js"></script> > +<script type="text/javascript" src="/js/toc.js"></script> > + > +<script type="text/javascript"> > + var _gaq = _gaq || []; > + _gaq.push(['_setAccount', 'UA-8638379-1']); > + _gaq.push(['_trackPageview']); > + > + (function() { > + var ga = document.createElement('script'); ga.type = 'text/javascript'; > ga.async = true; > + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : > 'http://www') + '.google-analytics.com/ga.js'; > + var s = document.getElementsByTagName('script')[0]; > s.parentNode.insertBefore(ga, s); > + })(); > +</script> > +<script type="text/javascript"> > + > (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ > + (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new > Date();a=s.createElement(o), > + > m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) > + > })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); > + > + ga('create', 'UA-47106724-1', 'jclouds.apache.org'); > + ga('send', 'pageview'); > +</script> > + > + </head> > + <body> > + <nav class="navbar navbar-default navbar-fixed-top" > role="navigation"> > + <div class="container"> > + <div class="navbar-header"> > + <button type="button" class="navbar-toggle" > data-toggle="collapse" data-target="#bs-example-navbar-collapse-1"> > + <span class="sr-only">Toggle navigation</span> > + <span class="icon-bar"></span> > + <span class="icon-bar"></span> > + <span class="icon-bar"></span> > + </button> > + <a class="navbar-brand" href="/">Apache jclouds ®</a> > + </div> > + > + <div class="collapse navbar-collapse" > id="bs-example-navbar-collapse-1"> > + <ul class="nav navbar-nav"> > + <li class="dropdown"> > + <a href="#" class="dropdown-toggle" > data-toggle="dropdown">Getting Started<strong class="caret"></strong></a> > + <ul class="dropdown-menu"> > + <li><a href="/start/what-is-jclouds/">What Is Apache > jclouds?</a></li> > + <li><a href="/start/install/">Installation > Guide</a></li> > + <li class="divider"></li> > + <li><a href="/start/concepts/">Core Concepts</a></li> > + <li><a href="/start/compute/">ComputeService</a></li> > + <li><a href="/start/blobstore/">BlobStore</a></li> > + <li><a > href="http://github.com/jclouds/jclouds-examples";>Examples</a></li> > + </ul> > + </li> > + <li class="dropdown"> > + <a href="#" class="dropdown-toggle" > data-toggle="dropdown">Documentation<strong class="caret"></strong></a> > + <ul class="dropdown-menu"> > + <li><a href="/reference/providers/">Cloud > Providers</a></li> > + <li><a href="/guides">User Guides</a></li> > + <li><a > href="/reference/troubleshooting/">Troubleshooting</a></li> > + <li><a > href="/reference/configuration/">Configuration</a></li> > + <li><a href="/reference/logging/">Logging</a></li> > + <li><a href="/reference/javadoc/">Javadoc</a></li> > + <li class="divider"></li> > + <li class="dropdown-header">Developer Guides</li> > + <li><a > href="http://wiki.apache.org/jclouds/";>Wiki</a></li> > + </ul> > + </li> > + <li class="dropdown"> > + <a href="#" class="dropdown-toggle" > data-toggle="dropdown">Community<strong class="caret"></strong></a> > + <ul class="dropdown-menu"> > + <li><a href="/community/">Get In Touch!</a></li> > + <li><a href="http://www.meetup.com/jclouds/";>Attend > An Event</a></li> > + <li><a href="/community/users/">Who Is Using > jclouds?</a></li> > + <li class="divider"></li> > + <li class="dropdown-header">Contribute</li> > + <li><a href="/reference/report-a-bug/">Report a > Bug</a></li> > + <li><a > href="http://wiki.apache.org/jclouds/How%20to%20Contribute";>How To Contribute > Code</a></li> > + <li><a > href="http://wiki.apache.org/jclouds/How%20to%20Contribute%20Documentation";>How > To Contribute Documentation</a></li> > + </ul> > + </li> > + <li><a href="/blog">Blog</a></li> > + </ul> > + <ul class="nav navbar-nav navbar-right"> > + <li class="dropdown"> > + <a href="#" class="dropdown-toggle" > data-toggle="dropdown">Release Notes<strong class="caret"></strong></a> > + <ul class="dropdown-menu"> > + <!-- only keep the release notes for supported > versions in this list --> > + <li><a href="/releasenotes/1.8.0">1.8.0</a></li> > + <li><a href="/releasenotes/1.7.3">1.7.3</a></li> > + <li><a href="/releasenotes/1.7.2">1.7.2</a></li> > + <li><a href="/releasenotes/1.7.1">1.7.1</a></li> > + <li><a href="/releasenotes/1.7.0">1.7.0</a></li> > + <li class="divider"></li> > + <li class="dropdown-header">Previous releases</li> > + <li><a href="/releasenotes">Release archive</a></li> > + </ul> > + </li> > + <li> > + <div> > + <a class="btn btn-success navbar-btn" > href="/start/install/"> > + <span class="glyphicon > glyphicon-download"></span> > + Install > + </a> > + </div> > + </li> > + </ul> > + </div> > + </div> > +</nav> > + > + <div class="container"> > + <div class="page-header"> > + <h1>Better Builders with jclouds!</h1> > + <span class="text-muted">03 September 2014, by Zack > Shoylev</span> > + </div> > + <p>If you are a new <a href="jclouds.apache.org">jclouds</a> > developer, or even if you are already developing jclouds support for any of > the OpenStack or Rackspace APIs, you have likely seen the domain classes that > are used throughout the the jclouds codebase. > +These classes are used to represent OpenStack resources, particularly the > JSON structures supported by OpenStack APIs.</p> > + > +<!--more--> > + > + > +<p>For example, when listing database users in openstack-trove (the > OpenStack database API), the service returns a JSON response body describing > the existing users. This JSON might look something like this:</p> > + > +<div class="highlight"><pre><code class="json"><span class="p">{</span> > + <span class="nt">"users"</span><span class="p">:</span> <span > class="p">[</span> > + <span class="p">{</span> > + <span class="nt">"databases"</span><span > class="p">:</span> <span class="p">[],</span> > + <span class="nt">"host"</span><span class="p">:</span> > <span class="s2">"%"</span><span class="p">,</span> > + <span class="nt">"name"</span><span class="p">:</span> > <span class="s2">"dbuser1"</span> > + <span class="p">},</span> > + <span class="p">{</span> > + <span class="nt">"databases"</span><span > class="p">:</span> <span class="p">[</span> > + <span class="p">{</span> > + <span class="nt">"name"</span><span > class="p">:</span> <span class="s2">"databaseB"</span> > + <span class="p">},</span> > + <span class="p">{</span> > + <span class="nt">"name"</span><span > class="p">:</span> <span class="s2">"databaseC"</span> > + <span class="p">}</span> > + <span class="p">],</span> > + <span class="nt">"host"</span><span class="p">:</span> > <span class="s2">"%"</span><span class="p">,</span> > + <span class="nt">"name"</span><span class="p">:</span> > <span class="s2">"dbuser2"</span> > + <span class="p">},</span> > + <span class="p">{</span> > + <span class="nt">"databases"</span><span > class="p">:</span> <span class="p">[],</span> > + <span class="nt">"name"</span><span class="p">:</span> > <span class="s2">"dbuser3"</span><span class="p">,</span> > + <span class="nt">"host"</span><span class="p">:</span> > <span class="s2">"%"</span> > + <span class="p">},</span> > + <span class="p">{</span> > + <span class="nt">"databases"</span><span > class="p">:</span> <span class="p">[</span> > + <span class="p">{</span> > + <span class="nt">"name"</span><span > class="p">:</span> <span class="s2">"sampledb"</span> > + <span class="p">}</span> > + <span class="p">],</span> > + <span class="nt">"host"</span><span class="p">:</span> > <span class="s2">"%"</span><span class="p">,</span> > + <span class="nt">"name"</span><span class="p">:</span> > <span class="s2">"demouser"</span> > + <span class="p">}</span> > + <span class="p">]</span> > +<span class="p">}</span></code></pre></div> > + > + > +<p>To parse the response, jclouds uses <a > href="https://github.com/jclouds/jclouds/blob/master/apis/openstack-trove/src/main/java/org/jclouds/openstack/trove/v1/domain/User.java";>domain > classes</a> to represent the JSON data returned by the service. The array of > "users" is unwrapped into individual User domain objects. Conversely, when > creating users, domain objects are transformed into a JSON request body.</p> > + > +<p>Because of the relative simplicity of user creation in trove, jclouds > developers can use a create method in the features package without having to > build an instance of the User class. For example, the developer might use a > method such as</p> > + > +<div class="highlight"><pre><code class="java"><span > class="kt">boolean</span> <span class="nf">create</span><span > class="o">(</span><span class="n">String</span> <span > class="n">userName</span><span class="o">,</span> <span > class="n">String</span> <span class="n">password</span><span > class="o">,</span> <span class="n">String</span> <span > class="n">databaseName</span><span class="o">);</span></code></pre></div> > + > + > +<p>In this case, it was easy to add support for this call by using a <a > href="https://github.com/jclouds/jclouds/blob/master/apis/openstack-trove/src/main/java/org/jclouds/openstack/trove/v1/binders/BindCreateUserToJson.java";>map > binder</a>.</p> > + > +<p>However, some APIs send or receive significantly more complex JSON > structures. Recent work on Neutron has shown that there are benefits to > increased consistency among the domain classes and the OpenStack API calls > that use them.</p> > + > +<p>Current implementations have the following two issues :</p> > + > +<ol> > +<li>Heavy use of map-binders and parsers to transform JSON. Map-binders use > annotation-selected classes to map method data (such as the data in the > create-user call above) to the JSON required by the service. The <a > href="https://github.com/jclouds/jclouds-labs-openstack/blob/master/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/functions/ParseNetworkDetails.java";>parsers</a> > apply the reverse transformation: from JSON to domain objects.</li> > +<li>Lack of consistent, concise, and user-friendly way to use domain objects > in create/update/list methods.</li> > +</ol> > + > + > +<p>In addition to fixing these issues, jclouds wants to provide developers > with some compiler checks and other syntactic sugar (fluent builders), while > also supporting different updating, creating, or listing validation > strategies.</p> > + > +<p>We want to</p> > + > +<ol> > +<li>Ensure object immutability.</li> > +<li>Utilize the fluent builder pattern.</li> > +<li>Ensure that "create" objects can only be used for create; update for > update; and listed resources cannot be directly sent back to the service.</li> > +<li>Reuse code and keep domain classes <a > href="http://en.wikipedia.org/wiki/Don't_repeat_yourself">DRY</a>.</li> > +<li>Allow using different validation strategies (for example, create vs > update).</li> > +</ol> > + > + > +<p>We have been able to identify a pattern that addresses these issues. Here > is some <a > href="https://github.com/jclouds/jclouds-labs-openstack/blob/master/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2/domain/Router.java";>sample > code</a>.</p> > + > +<p>This approach reuses code by having <a > href="https://code.google.com/p/google-gson/";>GSON</a> handle the domain > objects directly, as much as possible, both for serialization and > deserialization, thus eliminating map-binders and parsers in most cases. The > domain classes annotate their member variables using the @Named (for > serialization) and @ConstructorProperties (for deserialization) > annotations.</p> > + > +<p>Many of the JSON attributes in Neutron are optional. GSON's jclouds > configuration supports such optional values by using @Nullable and boxed > types. An alternate supported method, more convoluted, implements Optional<T> > private member variables and getter return types.</p> > + > +<p>To ensure immutability, users have no access to a constructor or setters, > and instead they must instantiate domain objects by using a slightly modified > Builder pattern. The builder pattern also provides proper validation and > user-friendliness.</p> > + > +<p>Some <a > href="https://github.com/jclouds/jclouds-labs-openstack/blob/master/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2/domain/AddressPair.java";>simpler > classes</a> implement the regular fluent builder pattern.</p> > + > +<p>In <a > href="https://github.com/jclouds/jclouds-labs-openstack/blob/master/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2/features/NetworkApi.java";>other > cases</a>, the same domain class has several different purposes, such as > making sure users have different Network-subtype object instances for > updating, creating, and listing networks:</p> > + > +<ol> > +<li>Listing networks returns a Network or a list of Networks.</li> > +<li>Updating a network requires Network.UpdateOptions.</li> > +<li>Creating a network requires Network.CreateOptions.</li> > +</ol> > + > + > +<p>CreateOptions and UpdateOptions extend Network and implement their own > copy constructors, with custom validation, if needed.</p> > + > +<p>To instantiate these create or update-specific objects, developers have > access to CreateBuilder and UpdateBuilder, which both extend the regular > Network builder abstract class. The only code these special builders > implement: the constructor (taking as parameters any required properties), a > build() method returning the create or update object, and also self(). The > self method is needed to make sure we can reuse most of the Builder code, but > still be able to chain the fluent builder methods.</p> > + > +<p>This is how it all works out from the developer's perspective:</p> > + > +<div class="highlight"><pre><code class="java"><span > class="n">Network</span><span class="o">.</span><span > class="na">CreateOptions</span> <span class="n">createNetwork</span> <span > class="o">=</span> <span class="n">Network</span><span > class="o">.</span><span class="na">createOptions</span><span > class="o">(</span><span class="s">"jclouds-wibble"</span><span > class="o">)</span> > + <span class="o">.</span><span class="na">networkType</span><span > class="o">(</span><span class="n">NetworkType</span><span > class="o">.</span><span class="na">LOCAL</span><span class="o">)</span> > + <span class="o">.</span><span class="na">build</span><span > class="o">();</span> > + > +<span class="n">Network</span> <span class="n">network</span> <span > class="o">=</span> <span class="n">networkApi</span><span > class="o">.</span><span class="na">create</span><span class="o">(</span><span > class="n">createNetwork</span><span class="o">);</span> > + > +<span class="n">Network</span><span class="o">.</span><span > class="na">UpdateOptions</span> <span class="n">updateNetwork</span> <span > class="o">=</span> <span class="n">Network</span><span > class="o">.</span><span class="na">updateOptions</span><span > class="o">()</span> > + <span class="o">.</span><span class="na">name</span><span > class="o">(</span><span > class="s">"jclouds-wibble-updated"</span><span class="o">)</span> > + <span class="o">.</span><span class="na">networkType</span><span > class="o">(</span><span class="n">NetworkType</span><span > class="o">.</span><span class="na">LOCAL</span><span class="o">)</span> > + <span class="o">.</span><span class="na">build</span><span > class="o">();</span> > + > +<span class="n">networkApi</span><span class="o">.</span><span > class="na">update</span><span class="o">(</span><span class="s">"some > id"</span><span class="o">,</span> <span > class="n">updateNetwork</span><span class="o">);</span></code></pre></div> > + > + > +<p>This ensures developers get an easy to understand interface, with > validation and compiler checks. It also allows jclouds developers to use > significantly less code when developing complex domain classes that need to > be reused in list/create/update API calls.</p> > + > + > + <div id="comments"> > + <hr/> > + <div id="disqus_thread"></div> > +<script type="text/javascript"> > +var disqus_shortname = 'jclouds'; > +/* * * DON'T EDIT BELOW THIS LINE * * */ > +(function() { > + var dsq = document.createElement('script'); dsq.type = > 'text/javascript'; dsq.async = true; > + dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js'; > + (document.getElementsByTagName('head')[0] || > document.getElementsByTagName('body')[0]).appendChild(dsq); > +})(); > +</script> > +<noscript>Please enable JavaScript to view the <a > href="http://disqus.com/?ref_noscript";>Comments powered by > Disqus.</a></noscript> > +<a href="http://disqus.com"; class="dsq-brlink">Comments powered by <span > class="logo-disqus">Disqus</span></a> > + > + </div> > + > + <div class="row clearfix"> > + <div id="footer" class="col-md-12 column"> > + <div id="footer"> > + <hr/> > + <div class="row clearfix"> > + <div class="col-md-2 column"> > + <p class="text-center"> > + <a class="text-primary" href="/start/">Getting Started</a> > + </p> > + </div> > + <div class="col-md-2 column"> > + <p class="text-center"> > + <a class="text-primary" > href="/reference/report-a-bug/">Report a Bug</a> > + </p> > + </div> > + <div class="col-md-2 column"> > + <p class="text-center"> > + <a > href="https://github.com/jclouds/jclouds-site/edit/master/_posts/2014-09-03-better-builders.md";>Fix > This Page</a><a class="text-primary" > href="https://wiki.apache.org/jclouds/How%20to%20Contribute%20Documentation";><sup>*</sup></a> > + </p> > + </div> > + <div class="col-md-2 column"> > + <p class="text-center"> > + <a class="text-primary" > href="https://wiki.apache.org/jclouds/How%20to%20Contribute";>Contribute > Code</a> > + </p> > + </div> > + <div class="col-md-2 column"> > + <p class="text-center"> > + <a class="text-primary" href="/community/">Contact Us</a> > + </p> > + </div> > + <div class="col-md-2 column"> > + <p class="text-center"> > + <a class="text-primary" > href="https://twitter.com/jclouds";>Follow Us</a> > + </p> > + </div> > + </div> > + <hr style="margin-top: 10px"/> > + <div class="row clearfix"> > + <div class="col-md-12 column"> > + <p class="text-center"> > + Copyright © 2011-2014 <a href="http://www.apache.org";>The > Apache Software Foundation</a>. All Rights Reserved. > + </p> > + <p class="text-center"> > + Apache, jclouds, Apache jclouds, the jclouds logo, and the > Apache feather logos are registered trademarks or trademarks of the Apache > Software Foundation. > + </p> > + <p class="text-center"> > + <img src="/img/feather-small.gif" width="80", height="24"/> > + </p> > + <br/> > + </div> > + </div> > +</div> > + > + </div> > + </div> > + </div> > + </body> > +</html> > > Modified: jclouds/site-content/blog/atom.xml > URL: > http://svn.apache.org/viewvc/jclouds/site-content/blog/atom.xml?rev=1622496&r1=1622495&r2=1622496&view=diff > ============================================================================== > --- jclouds/site-content/blog/atom.xml (original) > +++ jclouds/site-content/blog/atom.xml Thu Sep 4 15:18:35 2014 > @@ -8,6 +8,131 @@ > > > <entry> > + <id>http://jclouds.apache.org/blog/2014/09/03/better-builders</id> > + <title type="html"><![CDATA[Better Builders with jclouds!]]></title> > + <link href="http://jclouds.apache.org/blog/2014/09/03/better-builders"/> > + <updated>2014-09-03T00:00:00Z</updated> > + <content type="html"><![CDATA[<p>If you are a new <a > href="jclouds.apache.org">jclouds</a> developer, or even if you are already > developing jclouds support for any of the OpenStack or Rackspace APIs, you > have likely seen the domain classes that are used throughout the the jclouds > codebase. > +These classes are used to represent OpenStack resources, particularly the > JSON structures supported by OpenStack APIs.</p> > + > +<!--more--> > + > + > +<p>For example, when listing database users in openstack-trove (the > OpenStack database API), the service returns a JSON response body describing > the existing users. This JSON might look something like this:</p> > + > +<div class="highlight"><pre><code class="json"><span class="p">{</span> > + <span class="nt">"users"</span><span class="p">:</span> <span > class="p">[</span> > + <span class="p">{</span> > + <span class="nt">"databases"</span><span > class="p">:</span> <span class="p">[],</span> > + <span class="nt">"host"</span><span class="p">:</span> > <span class="s2">"%"</span><span class="p">,</span> > + <span class="nt">"name"</span><span class="p">:</span> > <span class="s2">"dbuser1"</span> > + <span class="p">},</span> > + <span class="p">{</span> > + <span class="nt">"databases"</span><span > class="p">:</span> <span class="p">[</span> > + <span class="p">{</span> > + <span class="nt">"name"</span><span > class="p">:</span> <span class="s2">"databaseB"</span> > + <span class="p">},</span> > + <span class="p">{</span> > + <span class="nt">"name"</span><span > class="p">:</span> <span class="s2">"databaseC"</span> > + <span class="p">}</span> > + <span class="p">],</span> > + <span class="nt">"host"</span><span class="p">:</span> > <span class="s2">"%"</span><span class="p">,</span> > + <span class="nt">"name"</span><span class="p">:</span> > <span class="s2">"dbuser2"</span> > + <span class="p">},</span> > + <span class="p">{</span> > + <span class="nt">"databases"</span><span > class="p">:</span> <span class="p">[],</span> > + <span class="nt">"name"</span><span class="p">:</span> > <span class="s2">"dbuser3"</span><span class="p">,</span> > + <span class="nt">"host"</span><span class="p">:</span> > <span class="s2">"%"</span> > + <span class="p">},</span> > + <span class="p">{</span> > + <span class="nt">"databases"</span><span > class="p">:</span> <span class="p">[</span> > + <span class="p">{</span> > + <span class="nt">"name"</span><span > class="p">:</span> <span class="s2">"sampledb"</span> > + <span class="p">}</span> > + <span class="p">],</span> > + <span class="nt">"host"</span><span class="p">:</span> > <span class="s2">"%"</span><span class="p">,</span> > + <span class="nt">"name"</span><span class="p">:</span> > <span class="s2">"demouser"</span> > + <span class="p">}</span> > + <span class="p">]</span> > +<span class="p">}</span></code></pre></div> > + > + > +<p>To parse the response, jclouds uses <a > href="https://github.com/jclouds/jclouds/blob/master/apis/openstack-trove/src/main/java/org/jclouds/openstack/trove/v1/domain/User.java";>domain > classes</a> to represent the JSON data returned by the service. The array of > "users" is unwrapped into individual User domain objects. Conversely, when > creating users, domain objects are transformed into a JSON request body.</p> > + > +<p>Because of the relative simplicity of user creation in trove, jclouds > developers can use a create method in the features package without having to > build an instance of the User class. For example, the developer might use a > method such as</p> > + > +<div class="highlight"><pre><code class="java"><span > class="kt">boolean</span> <span class="nf">create</span><span > class="o">(</span><span class="n">String</span> <span > class="n">userName</span><span class="o">,</span> <span > class="n">String</span> <span class="n">password</span><span > class="o">,</span> <span class="n">String</span> <span > class="n">databaseName</span><span class="o">);</span></code></pre></div> > + > + > +<p>In this case, it was easy to add support for this call by using a <a > href="https://github.com/jclouds/jclouds/blob/master/apis/openstack-trove/src/main/java/org/jclouds/openstack/trove/v1/binders/BindCreateUserToJson.java";>map > binder</a>.</p> > + > +<p>However, some APIs send or receive significantly more complex JSON > structures. Recent work on Neutron has shown that there are benefits to > increased consistency among the domain classes and the OpenStack API calls > that use them.</p> > + > +<p>Current implementations have the following two issues :</p> > + > +<ol> > +<li>Heavy use of map-binders and parsers to transform JSON. Map-binders use > annotation-selected classes to map method data (such as the data in the > create-user call above) to the JSON required by the service. The <a > href="https://github.com/jclouds/jclouds-labs-openstack/blob/master/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/functions/ParseNetworkDetails.java";>parsers</a> > apply the reverse transformation: from JSON to domain objects.</li> > +<li>Lack of consistent, concise, and user-friendly way to use domain objects > in create/update/list methods.</li> > +</ol> > + > + > +<p>In addition to fixing these issues, jclouds wants to provide developers > with some compiler checks and other syntactic sugar (fluent builders), while > also supporting different updating, creating, or listing validation > strategies.</p> > + > +<p>We want to</p> > + > +<ol> > +<li>Ensure object immutability.</li> > +<li>Utilize the fluent builder pattern.</li> > +<li>Ensure that "create" objects can only be used for create; update for > update; and listed resources cannot be directly sent back to the service.</li> > +<li>Reuse code and keep domain classes <a > href="http://en.wikipedia.org/wiki/Don't_repeat_yourself">DRY</a>.</li> > +<li>Allow using different validation strategies (for example, create vs > update).</li> > +</ol> > + > + > +<p>We have been able to identify a pattern that addresses these issues. Here > is some <a > href="https://github.com/jclouds/jclouds-labs-openstack/blob/master/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2/domain/Router.java";>sample > code</a>.</p> > + > +<p>This approach reuses code by having <a > href="https://code.google.com/p/google-gson/";>GSON</a> handle the domain > objects directly, as much as possible, both for serialization and > deserialization, thus eliminating map-binders and parsers in most cases. The > domain classes annotate their member variables using the @Named (for > serialization) and @ConstructorProperties (for deserialization) > annotations.</p> > + > +<p>Many of the JSON attributes in Neutron are optional. GSON's jclouds > configuration supports such optional values by using @Nullable and boxed > types. An alternate supported method, more convoluted, implements Optional<T> > private member variables and getter return types.</p> > + > +<p>To ensure immutability, users have no access to a constructor or setters, > and instead they must instantiate domain objects by using a slightly modified > Builder pattern. The builder pattern also provides proper validation and > user-friendliness.</p> > + > +<p>Some <a > href="https://github.com/jclouds/jclouds-labs-openstack/blob/master/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2/domain/AddressPair.java";>simpler > classes</a> implement the regular fluent builder pattern.</p> > + > +<p>In <a > href="https://github.com/jclouds/jclouds-labs-openstack/blob/master/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2/features/NetworkApi.java";>other > cases</a>, the same domain class has several different purposes, such as > making sure users have different Network-subtype object instances for > updating, creating, and listing networks:</p> > + > +<ol> > +<li>Listing networks returns a Network or a list of Networks.</li> > +<li>Updating a network requires Network.UpdateOptions.</li> > +<li>Creating a network requires Network.CreateOptions.</li> > +</ol> > + > + > +<p>CreateOptions and UpdateOptions extend Network and implement their own > copy constructors, with custom validation, if needed.</p> > + > +<p>To instantiate these create or update-specific objects, developers have > access to CreateBuilder and UpdateBuilder, which both extend the regular > Network builder abstract class. The only code these special builders > implement: the constructor (taking as parameters any required properties), a > build() method returning the create or update object, and also self(). The > self method is needed to make sure we can reuse most of the Builder code, but > still be able to chain the fluent builder methods.</p> > + > +<p>This is how it all works out from the developer's perspective:</p> > + > +<div class="highlight"><pre><code class="java"><span > class="n">Network</span><span class="o">.</span><span > class="na">CreateOptions</span> <span class="n">createNetwork</span> <span > class="o">=</span> <span class="n">Network</span><span > class="o">.</span><span class="na">createOptions</span><span > class="o">(</span><span class="s">"jclouds-wibble"</span><span > class="o">)</span> > + <span class="o">.</span><span class="na">networkType</span><span > class="o">(</span><span class="n">NetworkType</span><span > class="o">.</span><span class="na">LOCAL</span><span class="o">)</span> > + <span class="o">.</span><span class="na">build</span><span > class="o">();</span> > + > +<span class="n">Network</span> <span class="n">network</span> <span > class="o">=</span> <span class="n">networkApi</span><span > class="o">.</span><span class="na">create</span><span class="o">(</span><span > class="n">createNetwork</span><span class="o">);</span> > + > +<span class="n">Network</span><span class="o">.</span><span > class="na">UpdateOptions</span> <span class="n">updateNetwork</span> <span > class="o">=</span> <span class="n">Network</span><span > class="o">.</span><span class="na">updateOptions</span><span > class="o">()</span> > + <span class="o">.</span><span class="na">name</span><span > class="o">(</span><span > class="s">"jclouds-wibble-updated"</span><span class="o">)</span> > + <span class="o">.</span><span class="na">networkType</span><span > class="o">(</span><span class="n">NetworkType</span><span > class="o">.</span><span class="na">LOCAL</span><span class="o">)</span> > + <span class="o">.</span><span class="na">build</span><span > class="o">();</span> > + > +<span class="n">networkApi</span><span class="o">.</span><span > class="na">update</span><span class="o">(</span><span class="s">"some > id"</span><span class="o">,</span> <span > class="n">updateNetwork</span><span class="o">);</span></code></pre></div> > + > + > +<p>This ensures developers get an easy to understand interface, with > validation and compiler checks. It also allows jclouds developers to use > significantly less code when developing complex domain classes that need to > be reused in list/create/update API calls.</p> > +]]></content> > + </entry> > + > + <entry> > <id>http://jclouds.apache.org/blog/2014/08/04/1-release-2-committers</id> > <title type="html"><![CDATA[1 release, 2 committers...a busy week for > jclouds!]]></title> > <link > href="http://jclouds.apache.org/blog/2014/08/04/1-release-2-committers"/> > @@ -480,8 +605,7 @@ > > <p>For example, the following syntax can be used in karaf directly, or via > the <a href="https://github.com/jclouds/jclouds-cli";>jclouds cli</a> to start > a node in any supported cloud and bootstrap chef recipes.</p> > > -<div class="highlight"><pre><code class="bash">karaf@root>node-create > --adminAccess --recipe chef/java::openjdk karaf > -</code></pre></div> > +<div class="highlight"><pre><code class="bash">karaf@root>node-create > --adminAccess --recipe chef/java::openjdk karaf</code></pre></div> > > > <h2>What else is in 1.5.4?</h2> > @@ -492,16 +616,14 @@ > > <p><a href="https://github.com/everett-toews";>Everett</a> modernized support > for <strong>rackspace-cloudloadbalancers-us</strong> and <strong>uk</strong> > is now available. This includes syntactic sugar such as auto-pagination and > easy transforms.</p> > > -<div class="highlight"><pre><code class="java"><span > class="n">FluentIterable</span><span class="o"><</span><span > class="n">HostAndPort</span><span class="o">></span> <span > class="n">sockets</span> <span class="o">=</span> <span > class="n">clb</span><span class="o">.</span><span > class="na">getLoadBalancerApiForZone</span><span class="o">(</span><span > class="n">zone</span><span class="o">).</span><span > class="na">list</span><span class="o">().</span><span > class="na">concat</span><span class="o">().</span><span > class="na">transform</span><span class="o">(</span><span > class="n">converter</span><span class="o">);</span> > -</code></pre></div> > +<div class="highlight"><pre><code class="java"><span > class="n">FluentIterable</span><span class="o"><</span><span > class="n">HostAndPort</span><span class="o">></span> <span > class="n">sockets</span> <span class="o">=</span> <span > class="n">clb</span><span class="o">.</span><span > class="na">getLoadBalancerApiForZone</span><span class="o">(</span><span > class="n">zone</span><span class="o">).</span><span > class="na">list</span><span class="o">().</span><span > class="na">concat</span><span class="o">().</span><span > class="na">transform</span><span class="o">(</span><span > class="n">converter</span><span class="o">);</span></code></pre></div> > > > <h3>Nova Server Diagnostics</h3> > > <p>Some implementations of Nova have diagnostic information available. > Thanks to <a href="https://github.com/LeanderBB";>Leander</a>, you can now > discover this capability at runtime.</p> > > -<div class="highlight"><pre><code class="java"><span > class="n">Optional</span><span class="o"><</span><span > class="n">Map</span><span class="o">></span> <span > class="n">diagnosticInfo</span> <span class="o">=</span> <span > class="n">novaApi</span><span class="o">.</span><span > class="na">getServerApiForZone</span><span class="o">(</span><span > class="s">"az-1.region-a.geo-1"</span><span > class="o">).</span><span class="na">getDiagnostics</span><span > class="o">(</span><span class="n">serverId</span><span class="o">);</span> > -</code></pre></div> > +<div class="highlight"><pre><code class="java"><span > class="n">Optional</span><span class="o"><</span><span > class="n">Map</span><span class="o">></span> <span > class="n">diagnosticInfo</span> <span class="o">=</span> <span > class="n">novaApi</span><span class="o">.</span><span > class="na">getServerApiForZone</span><span class="o">(</span><span > class="s">"az-1.region-a.geo-1"</span><span > class="o">).</span><span class="na">getDiagnostics</span><span > class="o">(</span><span class="n">serverId</span><span > class="o">);</span></code></pre></div> > > > <h3>S3 Multi-Object delete</h3> > @@ -509,8 +631,7 @@ > <p><a href="http://maginatics.com/";>Maginatics</a> have BlobStore containers > with over a billion objects in them. S3 containers (buckets) can now be > cleared with 1/1000 the requests, thanks to <a > href="https://twitter.com/andreisavu";>Andrei</a>'s additional support of S3 > multi-delete.</p> > > <div class="highlight"><pre><code class="java"><span > class="n">DeleteResult</span> <span class="n">result</span> <span > class="o">=</span> <span class="n">s3Api</span><span class="o">.</span><span > class="na">deleteObjects</span><span class="o">(</span><span > class="n">container</span><span class="o">,</span> <span > class="n">keys</span><span class="o">);</span> > -<span class="n">assertEquals</span><span class="o">(</span><span > class="n">result</span><span class="o">.</span><span > class="na">size</span><span class="o">(),</span> <span > class="n">keys</span><span class="o">.</span><span > class="na">size</span><span class="o">());</span> > -</code></pre></div> > +<span class="n">assertEquals</span><span class="o">(</span><span > class="n">result</span><span class="o">.</span><span > class="na">size</span><span class="o">(),</span> <span > class="n">keys</span><span class="o">.</span><span > class="na">size</span><span class="o">());</span></code></pre></div> > > > <h2>What's next</h2> > @@ -602,8 +723,7 @@ > > <h3>Lazy advance through all your metrics:</h3> > > -<div class="highlight"><pre><code class="java"><span > class="n">FluentIterable</span><span class="o"><</span><span > class="n">Metric</span><span class="o">></span> <span > class="n">allMetrics</span> <span class="o">=</span> <span > class="n">cloudwatch</span><span class="o">.</span><span > class="na">getMetricApi</span><span class="o">().</span><span > class="na">list</span><span class="o">().</span><span > class="na">concat</span><span class="o">();</span> > -</code></pre></div> > +<div class="highlight"><pre><code class="java"><span > class="n">FluentIterable</span><span class="o"><</span><span > class="n">Metric</span><span class="o">></span> <span > class="n">allMetrics</span> <span class="o">=</span> <span > class="n">cloudwatch</span><span class="o">.</span><span > class="na">getMetricApi</span><span class="o">().</span><span > class="na">list</span><span class="o">().</span><span > class="na">concat</span><span class="o">();</span></code></pre></div> > > > <h3>Â Advance only until we find the load balancer we want:</h3> > @@ -611,14 +731,12 @@ > <div class="highlight"><pre><code class="java"><span > class="n">Optional</span><span class="o"><</span><span > class="n">LoadBalancer</span><span class="o">></span> <span > class="n">firstInterestingLoadBalancer</span> <span class="o">=</span> <span > class="n">elb</span> > <span class="o">.</span><span class="na">getLoadBalancerApi</span><span > class="o">().</span><span class="na">list</span><span class="o">()</span> > <span class="o">.</span><span class="na">concat</span><span > class="o">()</span> > - <span class="o">.</span><span class="na">firstMatch</span><span > class="o">(</span><span class="n">isInterestingLB</span><span > class="o">());</span> > -</code></pre></div> > + <span class="o">.</span><span class="na">firstMatch</span><span > class="o">(</span><span class="n">isInterestingLB</span><span > class="o">());</span></code></pre></div> > > > <h3>Get only the first page of database instances</h3> > > -<div class="highlight"><pre><code class="java"><span > class="n">IterableWithMarker</span><span class="o"><</span><span > class="n">Instance</span><span class="o">></span> <span > class="n">firstPage</span> <span class="o">=</span> <span > class="n">rds</span><span class="o">.</span><span > class="na">getInstanceApi</span><span class="o">().</span><span > class="na">list</span><span class="o">().</span><span > class="na">get</span><span class="o">(</span><span class="mi">0</span><span > class="o">);</span> > -</code></pre></div> > +<div class="highlight"><pre><code class="java"><span > class="n">IterableWithMarker</span><span class="o"><</span><span > class="n">Instance</span><span class="o">></span> <span > class="n">firstPage</span> <span class="o">=</span> <span > class="n">rds</span><span class="o">.</span><span > class="na">getInstanceApi</span><span class="o">().</span><span > class="na">list</span><span class="o">().</span><span > class="na">get</span><span class="o">(</span><span class="mi">0</span><span > class="o">);</span></code></pre></div> > > > <p>The above syntax is being worked through relevant apis. In order to try > it out, grab jclouds 1.5.0-beta.7 (releasing today), and use any of the > following methods:</p> > @@ -655,8 +773,7 @@ > <span class="k">for</span> <span class="o">(</span><span > class="n">Tenant</span> <span class="n">tenant</span> <span > class="o">:</span> <span class="n">adminClient</span><span > class="o">.</span><span class="na">listTenants</span><span > class="o">())</span> <span class="o">{</span> > <span class="c1">// ...</span> > <span class="o">}</span> > -<span class="o">}</span> > -</code></pre></div> > +<span class="o">}</span></code></pre></div> > > > <p>Also pro, is our new Amazon CloudWatch support from Jeremy Whitlock. This > is our first complete renovation of an AWS api to have the same look/feel as > our new OpenStack stuff. Just add a dependency on > <em>org.jclouds.providers/aws-cloudwatch</em> and you can do this!</p> > @@ -671,8 +788,7 @@ > <span class="k">for</span> <span class="o">(</span><span > class="n">Metric</span> <span class="n">metric</span> <span > class="o">:</span> <span class="n">metricClient</span><span > class="o">.</span><span class="na">listMetrics</span><span > class="o">())</span> <span class="o">{</span> > <span class="c1">// ...</span> > <span class="o">}</span> > -<span class="o">}</span> > -</code></pre></div> > +<span class="o">}</span></code></pre></div> > > > <p>And for the jenkins users, we also have an api for remote job and > computer control, at <em>org.jclouds.labs/jenkins</em>!</p> > @@ -681,8 +797,7 @@ > <span class="n">RestContext</span> <span class="n">localhost</span> <span > class="o">=</span> <span class="n">contextBuilder</span><span > class="o">.</span><span class="na">build</span><span class="o">();</span> > > <span class="n">Node</span> <span class="n">master</span> <span > class="o">=</span> <span class="n">localhost</span><span > class="o">.</span><span class="na">getApi</span><span > class="o">().</span><span class="na">getMaster</span><span > class="o">();</span> > -<span class="n">localhost</span><span class="o">.</span><span > class="na">getJobClient</span><span class="o">().</span><span > class="na">createFromXML</span><span class="o">(</span><span > class="s">"newJob"</span><span class="o">,</span> <span > class="n">xmlAsString</span><span class="o">);</span> > -</code></pre></div> > +<span class="n">localhost</span><span class="o">.</span><span > class="na">getJobClient</span><span class="o">().</span><span > class="na">createFromXML</span><span class="o">(</span><span > class="s">"newJob"</span><span class="o">,</span> <span > class="n">xmlAsString</span><span class="o">);</span></code></pre></div> > > > <p>This is especially helpful with the new <a > href="https://github.com/jenkinsci/jclouds-plugin";>jclouds-plugin</a>, which > uses jclouds to spin up new slaves and publish artifacts to BlobStore. Tons > more in there, too.</p> > @@ -710,14 +825,12 @@ > <div class="highlight"><pre><code class="clojure"><span > class="p">(</span><span class="nf">use</span> <span > class="o">'</span><span class="ss">'org.jclouds.compute2</span><span > class="p">)</span> > <span class="p">(</span><span class="nb">import </span><span > class="o">'</span><span > class="ss">'org.jclouds.scriptbuilder.statements.login.AdminAccess</span><span > class="p">)</span> > <span class="p">(</span><span class="k">def </span><span > class="nv">compute</span> <span class="p">(</span><span > class="nf">compute-service</span> <span > class="s">"hpcloud-compute"</span> <span > class="s">"tenantId:ACCESSKEY"</span> <span > class="s">"SECRETKEY"</span> <span class="ss">:slf4j</span> > <span class="ss">:sshj</span><span class="p">))</span> > -<span class="p">(</span><span class="nf">create-node</span> <span > class="nv">compute</span> <span class="s">"test"</span> <span > class="p">(</span><span class="nf">build-template</span> <span > class="nv">compute</span> <span class="p">{</span> <span > class="ss">:run-script</span> <span class="p">(</span><span > class="nf">AdminAccess/standard</span><span class="p">)</span> <span > class="p">}</span> <span class="p">))</span> > -</code></pre></div> > +<span class="p">(</span><span class="nf">create-node</span> <span > class="nv">compute</span> <span class="s">"test"</span> <span > class="p">(</span><span class="nf">build-template</span> <span > class="nv">compute</span> <span class="p">{</span> <span > class="ss">:run-script</span> <span class="p">(</span><span > class="nf">AdminAccess/standard</span><span class="p">)</span> <span > class="p">}</span> <span class="p">))</span></code></pre></div> > > > <p>Here's an example of how to do the same on <a > href="https://trystack.org/";>TryStack</a>, authenticating w/ user & pass > as opposed to key, via our <a > href="https://github.com/jclouds/jclouds-examples/tree/master/compute-basics";>java > example</a>:</p> > > -<div class="highlight"><pre><code class="bash">java -jar > target/compute-basics-jar-with-dependencies.jar trystack-nova tenantId:user > password mygroup add > -</code></pre></div> > +<div class="highlight"><pre><code class="bash">java -jar > target/compute-basics-jar-with-dependencies.jar trystack-nova tenantId:user > password mygroup add</code></pre></div> > > > <p>In the group org.jclouds.labs, you'll find two more new and notable > members of the jclouds family:</p> > @@ -730,8 +843,7 @@ > > <p>You can try out virtualbox like any other api. For example, you can use > the clojure above, only changing how you create the connection slightly:</p> > > -<div class="highlight"><pre><code class="clojure"><span > class="p">(</span><span class="k">def </span><span class="nv">compute</span> > <span class="p">(</span><span class="nf">compute-service</span> <span > class="s">"virtualbox"</span> <span > class="s">"administrator"</span> <span > class="s">"12345"</span> <span class="ss">:sshj</span> <span > class="ss">:slf4j</span><span class="p">))</span> > -</code></pre></div> > +<div class="highlight"><pre><code class="clojure"><span > class="p">(</span><span class="k">def </span><span class="nv">compute</span> > <span class="p">(</span><span class="nf">compute-service</span> <span > class="s">"virtualbox"</span> <span > class="s">"administrator"</span> <span > class="s">"12345"</span> <span class="ss">:sshj</span> <span > class="ss">:slf4j</span><span class="p">))</span></code></pre></div> > > > <p>The code in labs will certainly change before we release a beta, but feel > free to check them out. Meanwhile, you can try them out and give us feedback > on #jclouds irc freenode or jclouds-dev google group!</p> > @@ -740,8 +852,7 @@ > > <p>Oh, and don't forget to clean up your nodes :)</p> > > -<div class="highlight"><pre><code class="clojure"><span > class="p">(</span><span class="nf">destroy-nodes-matching</span> <span > class="nv">compute</span> <span class="p">(</span><span class="nb">constantly > </span><span class="nv">true</span><span class="p">))</span> > -</code></pre></div> > +<div class="highlight"><pre><code class="clojure"><span > class="p">(</span><span class="nf">destroy-nodes-matching</span> <span > class="nv">compute</span> <span class="p">(</span><span class="nb">constantly > </span><span class="nv">true</span><span > class="p">))</span></code></pre></div> > > > > @@ -862,8 +973,7 @@ > > <div class="highlight"><pre><code class="java"><span class="n">future</span> > <span class="o">=</span> <span class="n">client</span><span > class="o">.</span><span class="na">submitScriptOnNode</span><span > class="o">(</span><span class="n">node</span><span class="o">.</span><span > class="na">getId</span><span class="o">(),</span> > <span class="n">AdminAccess</span><span > class="o">.</span><span class="na">builder</span><span > class="o">().</span><span class="na">adminUsername</span><span > class="o">(</span><span class="s">"foo"</span><span > class="o">).</span><span class="na">build</span><span class="o">(),</span> > - <span class="n">nameTask</span><span class="o">(</span><span > class="s">"adminUpdate"</span><span class="o">));</span> > -</code></pre></div> > + <span class="n">nameTask</span><span class="o">(</span><span > class="s">"adminUpdate"</span><span > class="o">));</span></code></pre></div> > > > <p>As always, we keep our <a > href="https://github.com/jclouds/jclouds-examples";>examples site</a> up to > date so you can see how to work this stuff. Next release will be in > approximately 1-months time. Look out for progress including <a > href="http://www.vmware.com/products/vcloud-director/overview.html";>vCloud > 1.5</a>, <a href="http://voxel.net/voxcloud";>Voxel</a>, and <a > href="https://www.virtualbox.org/";>VirtualBox</a>.</p> > @@ -876,41 +986,4 @@ > ]]></content> > </entry> > > - <entry> > - > <id>http://jclouds.apache.org/blog/2009/05/13/catching-exceptions-with-less-keystrokes</id> > - <title type="html"><![CDATA[Catching exceptions with fewer > keystrokes]]></title> > - <link > href="http://jclouds.apache.org/blog/2009/05/13/catching-exceptions-with-less-keystrokes"/> > - <updated>2009-05-13T00:00:00Z</updated> > - <content type="html"><![CDATA[<p>Some of us hate checked exceptions, but > still use them for one reason or another. A common problem we have is > unnecessary exception nesting, or runtime swallowing. This often leads to the > all to familiar and crufty code with a million catch blocks. jclouds has a > slightly different approach that strikes a balance, allowing checked > exceptions to be dealt with, but without the pain of so many lines of > repetitious code.</p> > - > -<div class="highlight"><pre><code class="java"><span class="k">try</span> > <span class="o">{</span> > -<span class="o">}</span> <span class="k">catch</span> <span > class="o">(</span><span class="n">Exception</span> <span > class="n">e</span><span class="o">)</span> <span class="o">{</span> > - <span class="n">Utils</span><span class="o">.<</span><span > class="n">ApplicationException</span><span class="o">></span><span > class="n">rethrowIfRuntimeOrSameType</span><span class="o">(</span><span > class="n">e</span><span class="o">);</span> > - <span class="k">throw</span> <span class="k">new</span> <span > class="nf">ApplicationException</span><span class="o">(</span><span > class="s">"Error applying stuff"</span><span class="o">,</span> > <span class="n">e</span><span class="o">);</span> > -<span class="o">}</span> > -</code></pre></div> > - > - > -<p>This code does what it says, preventing us from unnecessarily nesting > application exceptions or swallowing runtimes.</p> > - > -<p>Now, this code shouldn't work, as current versions of java hava a generic > type erasure problem. The reason it does work is a somewhat hackish line in > the rethrowIfRuntimeOrSameType method:</p> > - > -<div class="highlight"><pre><code class="java"><span class="k">if</span> > <span class="o">(</span><span class="n">e</span> <span > class="k">instanceof</span> <span class="n">RuntimeException</span><span > class="o">)</span> <span class="o">{</span> > - <span class="k">throw</span> <span class="o">(</span><span > class="n">RuntimeException</span><span class="o">)</span> <span > class="n">e</span><span class="o">;</span> > -<span class="o">}</span> <span class="k">else</span> <span class="o">{</span> > - <span class="k">try</span> <span class="o">{</span> > - <span class="k">throw</span> <span class="o">(</span><span > class="n">E</span><span class="o">)</span> <span class="n">e</span><span > class="o">;</span> > - <span class="o">}</span> <span class="k">catch</span> <span > class="o">(</span><span class="n">ClassCastException</span> <span > class="n">throwAway</span><span class="o">)</span> <span class="o">{</span> > - <span class="c1">// using cce as there's no way to do instanceof > E in current java</span> > - <span class="o">}</span> > -<span class="o">}</span> > -</code></pre></div> > - > - > -<p>The trick is that we try to force the exception we caught into the > generic type. If that fails, we know it wasn't that type and that we should > wrap, log, etc.</p> > - > -<p>If nothing else, I hope you enjoy the perspective!</p> > -]]></content> > - </entry> > - > </feed> > > Modified: jclouds/site-content/blog/index.html > URL: > http://svn.apache.org/viewvc/jclouds/site-content/blog/index.html?rev=1622496&r1=1622495&r2=1622496&view=diff > ============================================================================== > --- jclouds/site-content/blog/index.html (original) > +++ jclouds/site-content/blog/index.html Thu Sep 4 15:18:35 2014 > @@ -150,6 +150,12 @@ > <p><a > href="https://wiki.apache.org/jclouds/How%20to%20Contribute%20Documentation";>Write > a guest post!</a></p> > > > +<h3><a class="text-primary" href="/blog/2014/09/03/better-builders">Better > Builders with jclouds!</a></h3> > +<span class="text-muted">03 September 2014, by Zack Shoylev</span> > +<p>If you are a new jclouds developer, or even if you are already developing > jclouds support for any of the OpenStack or Rackspace APIs, you have likely > seen the domain classes that are used throughout the the jclouds codebase. > +These classes are used to represent OpenStack resources, particularly the > JSON structures supported by OpenStack APIs. > +</p> > + > <h3><a class="text-primary" href="/blog/2014/08/04/1-release-2-committers">1 > release, 2 committers...a busy week for jclouds!</a></h3> > <span class="text-muted">04 August 2014, by <a > href="http://blog.xebialabs.com/author/aphillips/";>Andrew Phillips</a></span> > <p>There's a lot going on this week for the jclouds community. Most > importantly, we're really pleased to introduce two new committers: Andrea > Turli and Chris Custine. > @@ -170,11 +176,6 @@ > <p>The Google Summer of Code (GSoC) accepted projects have been announced > and we will have 3 students working on jclouds related projects! > </p> > > -<h3><a class="text-primary" href="/blog/2014/03/04/jclouds-meetup">jclouds > Meetup</a></h3> > -<span class="text-muted">04 March 2014, by <a > href="https://twitter.com/everett_toews";>Everett Toews</a></span> > -<p>Last night we held a jclouds meetup at Cloudera offices in San Francisco. > It was a well attended meetup and there were a number of new faces along with > our more regular group of attendees. We recorded the whole thing with Google > Hangouts on Air and you can get to know everyone in the first 5 minutes! > -</p> > - > > > <ul class="pagination text-center"> > @@ -189,25 +190,25 @@ > > <li> > > - <a class="text-primary" href="/blog/page2">2</a> > + <a class="text-primary" href="blog/page2">2</a> > > </li> > > <li> > > - <a class="text-primary" href="/blog/page3">3</a> > + <a class="text-primary" href="blog/page3">3</a> > > </li> > > <li> > > - <a class="text-primary" href="/blog/page4">4</a> > + <a class="text-primary" href="blog/page4">4</a> > > </li> > > <li> > > - <a class="text-primary" href="/blog/page5">5</a> > + <a class="text-primary" href="blog/page5">5</a> > > </li> > > > Modified: jclouds/site-content/blog/page2/index.html > URL: > http://svn.apache.org/viewvc/jclouds/site-content/blog/page2/index.html?rev=1622496&r1=1622495&r2=1622496&view=diff > ============================================================================== > --- jclouds/site-content/blog/page2/index.html (original) > +++ jclouds/site-content/blog/page2/index.html Thu Sep 4 15:18:35 2014 > @@ -150,6 +150,11 @@ > <p><a > href="https://wiki.apache.org/jclouds/How%20to%20Contribute%20Documentation";>Write > a guest post!</a></p> > > > +<h3><a class="text-primary" href="/blog/2014/03/04/jclouds-meetup">jclouds > Meetup</a></h3> > +<span class="text-muted">04 March 2014, by <a > href="https://twitter.com/everett_toews";>Everett Toews</a></span> > +<p>Last night we held a jclouds meetup at Cloudera offices in San Francisco. > It was a well attended meetup and there were a number of new faces along with > our more regular group of attendees. We recorded the whole thing with Google > Hangouts on Air and you can get to know everyone in the first 5 minutes! > +</p> > + > <h3><a class="text-primary" > href="/blog/2014/03/03/joining-the-asf-new-site-and-jclouds-1-7">Joining the > ASF, new site, and jclouds 1.7!</a></h3> > <span class="text-muted">03 March 2014, by Ignasi Barrera</span> > <p>It's been a while since our last blog post, and lots has happened since > then. There have been many things that have kept us busy, and finally, all > the hard work is starting to show up. During this time, we've: > @@ -170,11 +175,6 @@ > <p>jclouds community is an international group with over 100 contributors > since we started in early 2009. The idea of holidays vary, but we decided > Mistletoe as an appropriate codename for jclouds 1.5.4. Here's why. > </p> > > -<h3><a class="text-primary" > href="/blog/2012/11/17/jclouds-1-5-3-out-the-door">jclouds 1.5.3 out the > door</a></h3> > -<span class="text-muted">17 November 2012, by Adrian Cole</span> > -<p>Released on 2012-11-14, jclouds 1.5.3 includes minor fixes, and a few > important updates. > -</p> > - > > > <ul class="pagination text-center"> > @@ -191,25 +191,25 @@ > > <li> > > - <a class="text-primary" href="/blog/page2">2</a> > + <a class="text-primary" href="blog/page2">2</a> > > </li> > > <li> > > - <a class="text-primary" href="/blog/page3">3</a> > + <a class="text-primary" href="blog/page3">3</a> > > </li> > > <li> > > - <a class="text-primary" href="/blog/page4">4</a> > + <a class="text-primary" href="blog/page4">4</a> > > </li> > > <li> > > - <a class="text-primary" href="/blog/page5">5</a> > + <a class="text-primary" href="blog/page5">5</a> > > </li> > > > Modified: jclouds/site-content/blog/page3/index.html > URL: > http://svn.apache.org/viewvc/jclouds/site-content/blog/page3/index.html?rev=1622496&r1=1622495&r2=1622496&view=diff > ============================================================================== > --- jclouds/site-content/blog/page3/index.html (original) > +++ jclouds/site-content/blog/page3/index.html Thu Sep 4 15:18:35 2014 > @@ -150,6 +150,11 @@ > <p><a > href="https://wiki.apache.org/jclouds/How%20to%20Contribute%20Documentation";>Write > a guest post!</a></p> > > > +<h3><a class="text-primary" > href="/blog/2012/11/17/jclouds-1-5-3-out-the-door">jclouds 1.5.3 out the > door</a></h3> > +<span class="text-muted">17 November 2012, by Adrian Cole</span> > +<p>Released on 2012-11-14, jclouds 1.5.3 includes minor fixes, and a few > important updates. > +</p> > + > <h3><a class="text-primary" > href="/blog/2012/11/09/500-jclouds-builds-on-buildhive-and-counting">500 > jclouds builds on BuildHive and counting...</a></h3> > <span class="text-muted">09 November 2012, by Adrian Cole</span> > <p>At jclouds, we've been running our Jenkins continuous integration jobs in > CloudBees' DEV@cloud for a while now (CloudBees has a FOSS programme). We > also have an active and ever-increasing contributor community, which amongst > others means... lots of pull requests. > @@ -170,11 +175,6 @@ > <p>We are very near beta, I promise! In the mean time, we just cut a new > codebase with a bunch of cool new toys. Here's a few. Thanks to Adam Lowe, we > are getting even deeper into OpenStack with more Keystone support than ever. > Setup your code to pull org.jclouds.labs/openstack-keystone, and you can do > stuff like this. > </p> > > -<h3><a class="text-primary" > href="/blog/2012/03/23/take-a-peek-at-vcloud-director-1-5-openstack-and">Take > a peek at vCloud Director 1.5, OpenStack, and VirtualBox</a></h3> > -<span class="text-muted">23 March 2012, by Adrian Cole</span> > -<p>The jclouds team have been working very hard lately, particularly on a > few new apis. We've decided to cage them no longer and cut jclouds > 1.5.0-alpha.1. Most notably, we've added the openstack-nova api, and three > new providers, all of which discovered via OpenStack Keystone v2.0. > -</p> > - > > > <ul class="pagination text-center"> > @@ -191,25 +191,25 @@ > > <li> > > - <a class="text-primary" href="/blog/page2">2</a> > + <a class="text-primary" href="blog/page2">2</a> > > </li> > > <li> > > - <a class="text-primary" href="/blog/page3">3</a> > + <a class="text-primary" href="blog/page3">3</a> > > </li> > > <li> > > - <a class="text-primary" href="/blog/page4">4</a> > + <a class="text-primary" href="blog/page4">4</a> > > </li> > > <li> > > - <a class="text-primary" href="/blog/page5">5</a> > + <a class="text-primary" href="blog/page5">5</a> > > </li> > > >
