Add an example of how to use Fluent builders.

Author: brendandburns

.gitignore

@@ -26,3 +26,6 @@ hs_err_pid*
 *.iml
 
 .DS_Store
+
+# generated stuff
+kubernetes/bin

examples/src/main/java/io/kubernetes/client/examples/FluentExample.java

@@ -0,0 +1,74 @@
+/*
+Copyright 2018 The Kubernetes Authors.
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+    http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+package io.kubernetes.client.examples;
+
+import io.kubernetes.client.ApiClient;
+import io.kubernetes.client.ApiException;
+import io.kubernetes.client.Configuration;
+import io.kubernetes.client.apis.CoreV1Api;
+import io.kubernetes.client.models.V1Container;
+import io.kubernetes.client.models.V1ObjectMeta;
+import io.kubernetes.client.models.V1Pod;
+import io.kubernetes.client.models.V1PodBuilder;
+import io.kubernetes.client.models.V1PodList;
+import io.kubernetes.client.models.V1PodSpec;
+import io.kubernetes.client.util.Config;
+import java.io.IOException;
+import java.util.Arrays;
+
+/**
+ * A simple example of how to use the Java API
+ *
+ * <p>Easiest way to run this: mvn exec:java
+ * -Dexec.mainClass="io.kubernetes.client.examples.FluentExample"
+ *
+ * <p>From inside $REPO_DIR/examples
+ */
+public class FluentExample {
+  public static void main(String[] args) throws IOException, ApiException {
+    ApiClient client = Config.defaultClient();
+    Configuration.setDefaultApiClient(client);
+
+    CoreV1Api api = new CoreV1Api();
+
+    V1Pod pod =
+        new V1PodBuilder()
+            .withNewMetadata()
+            .withName("apod")
+            .endMetadata()
+            .withNewSpec()
+            .addNewContainer()
+            .withName("www")
+            .withImage("nginx")
+            .endContainer()
+            .endSpec()
+            .build();
+
+    api.createNamespacedPod("default", pod, null);
+
+    V1Pod pod2 =
+        new V1Pod()
+            .metadata(new V1ObjectMeta().name("anotherpod"))
+            .spec(
+                new V1PodSpec()
+                    .containers(Arrays.asList(new V1Container().name("www").image("nginx"))));
+
+    api.createNamespacedPod("default", pod2, null);
+
+    V1PodList list =
+        api.listNamespacedPod("default", null, null, null, null, null, null, null, null, null);
+    for (V1Pod item : list.getItems()) {
+      System.out.println(item.getMetadata().getName());
+    }
+  }
+}