http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/.classpath
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/.classpath 
b/com.ibm.team.juno.client/.classpath
index 47a82cf..e4f84a9 100755
--- a/com.ibm.team.juno.client/.classpath
+++ b/com.ibm.team.juno.client/.classpath
@@ -1,10 +1,21 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<classpath>
-       <classpathentry kind="src" path="src"/>
-       <classpathentry kind="lib" 
path="/com.ibm.team.juno.releng/lib/httpclient/httpclient-4.5.jar"/>
-       <classpathentry kind="lib" 
path="/com.ibm.team.juno.releng/lib/httpclient/httpcore-4.4.1.jar"/>
-       <classpathentry kind="lib" 
path="/com.ibm.team.juno.releng/lib/httpclient/httpmime-4.5.jar"/>
-       <classpathentry kind="con" path="org.eclipse.pde.core.requiredPlugins"/>
-       <classpathentry kind="con" 
path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.6"/>
-       <classpathentry kind="output" path="bin"/>
-</classpath>
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+       <classpathentry kind="src" path="src/main/java"/>
+       <classpathentry exported="true" kind="lib" 
path="/org.apache.juneau.releng/lib/httpclient/httpclient-4.5.jar"/>
+       <classpathentry exported="true" kind="lib" 
path="/org.apache.juneau.releng/lib/httpclient/httpcore-4.4.1.jar"/>
+       <classpathentry exported="true" kind="lib" 
path="/org.apache.juneau.releng/lib/httpclient/httpmime-4.5.jar"/>
+       <classpathentry kind="con" path="org.eclipse.pde.core.requiredPlugins"/>
+       <classpathentry kind="con" 
path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.6">
+               <attributes>
+                       <attribute name="maven.pomderived" value="true"/>
+               </attributes>
+       </classpathentry>
+       <classpathentry combineaccessrules="false" kind="src" 
path="/org.apache.juneau.releng"/>
+       <classpathentry combineaccessrules="false" kind="src" 
path="/org.apache.juneau"/>
+       <classpathentry kind="con" 
path="org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER">
+               <attributes>
+                       <attribute name="maven.pomderived" value="true"/>
+               </attributes>
+       </classpathentry>
+       <classpathentry kind="output" path="target/classes"/>
+</classpath>

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/.project
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/.project 
b/com.ibm.team.juno.client/.project
index a037b80..c2c1e69 100755
--- a/com.ibm.team.juno.client/.project
+++ b/com.ibm.team.juno.client/.project
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <projectDescription>
-       <name>com.ibm.team.juno.client</name>
+       <name>org.apache.juneau.client</name>
        <comment></comment>
        <projects>
        </projects>
@@ -15,8 +15,14 @@
                        <arguments>
                        </arguments>
                </buildCommand>
+               <buildCommand>
+                       <name>org.eclipse.m2e.core.maven2Builder</name>
+                       <arguments>
+                       </arguments>
+               </buildCommand>
        </buildSpec>
        <natures>
+               <nature>org.eclipse.m2e.core.maven2Nature</nature>
                <nature>org.eclipse.jem.workbench.JavaEMFNature</nature>
                
<nature>org.eclipse.wst.common.modulecore.ModuleCoreNature</nature>
                <nature>org.eclipse.pde.PluginNature</nature>

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/.settings/org.eclipse.core.resources.prefs
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/.settings/org.eclipse.core.resources.prefs 
b/com.ibm.team.juno.client/.settings/org.eclipse.core.resources.prefs
deleted file mode 100755
index 4824b80..0000000
--- a/com.ibm.team.juno.client/.settings/org.eclipse.core.resources.prefs
+++ /dev/null
@@ -1,2 +0,0 @@
-eclipse.preferences.version=1
-encoding/<project>=UTF-8

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/.settings/org.eclipse.jdt.core.prefs
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/.settings/org.eclipse.jdt.core.prefs 
b/com.ibm.team.juno.client/.settings/org.eclipse.jdt.core.prefs
index 8cb714e..73f18fb 100755
--- a/com.ibm.team.juno.client/.settings/org.eclipse.jdt.core.prefs
+++ b/com.ibm.team.juno.client/.settings/org.eclipse.jdt.core.prefs
@@ -15,6 +15,7 @@ 
org.eclipse.jdt.core.compiler.annotation.nonnullbydefault=org.eclipse.jdt.annota
 
org.eclipse.jdt.core.compiler.annotation.nullable=org.eclipse.jdt.annotation.Nullable
 org.eclipse.jdt.core.compiler.annotation.nullanalysis=disabled
 org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode=enabled
+org.eclipse.jdt.core.compiler.codegen.methodParameters=do not generate
 org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.6
 org.eclipse.jdt.core.compiler.codegen.unusedLocal=preserve
 org.eclipse.jdt.core.compiler.compliance=1.6

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/.settings/org.eclipse.jdt.ui.prefs
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/.settings/org.eclipse.jdt.ui.prefs 
b/com.ibm.team.juno.client/.settings/org.eclipse.jdt.ui.prefs
index ced2c41..d54ca08 100755
--- a/com.ibm.team.juno.client/.settings/org.eclipse.jdt.ui.prefs
+++ b/com.ibm.team.juno.client/.settings/org.eclipse.jdt.ui.prefs
@@ -49,11 +49,11 @@ cleanup.use_this_for_non_static_field_access=false
 cleanup.use_this_for_non_static_field_access_only_if_necessary=true
 cleanup.use_this_for_non_static_method_access=false
 cleanup.use_this_for_non_static_method_access_only_if_necessary=true
-cleanup_profile=_Juno
+cleanup_profile=_Juneau
 cleanup_settings_version=2
 eclipse.preferences.version=1
 editor_save_participant_org.eclipse.jdt.ui.postsavelistener.cleanup=true
-formatter_profile=_Juno
+formatter_profile=_Juneau
 formatter_settings_version=12
 org.eclipse.jdt.ui.exception.name=e
 org.eclipse.jdt.ui.gettersetter.use.is=true
@@ -64,7 +64,7 @@ org.eclipse.jdt.ui.keywordthis=false
 org.eclipse.jdt.ui.ondemandthreshold=1
 org.eclipse.jdt.ui.overrideannotation=true
 org.eclipse.jdt.ui.staticondemandthreshold=1
-org.eclipse.jdt.ui.text.custom_code_templates=<?xml version\="1.0" 
encoding\="UTF-8"?><templates><template autoinsert\="false" 
context\="gettercomment_context" deleted\="false" description\="Comment for 
getter method" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.gettercomment" 
name\="gettercomment">/**\r\n * Bean property getter\:  
&lt;property&gt;${bare_field_name}&lt;/property&gt;.\r\n *\r\n * @return The 
value of the &lt;property&gt;${bare_field_name}&lt;/property&gt; property on 
this bean, or &lt;jk&gt;null&lt;/jk&gt; if it is not set.\r\n 
*/</template><template autoinsert\="false" context\="settercomment_context" 
deleted\="false" description\="Comment for setter method" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.settercomment" 
name\="settercomment">/**\r\n * Bean property setter\:  
&lt;property&gt;${bare_field_name}&lt;/property&gt;.\r\n *\r\n * @param 
${param} The new value for the 
&lt;property&gt;${bare_field_name}&lt;/property&gt; property on th
 is bean.\r\n * @return This object (for method chaining).\r\n 
*/</template><template autoinsert\="false" 
context\="constructorcomment_context" deleted\="false" description\="Comment 
for created constructors" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.constructorcomment" 
name\="constructorcomment">/**\r\n * TODO\r\n * \r\n * ${tags}\r\n 
*/</template><template autoinsert\="true" context\="filecomment_context" 
deleted\="false" description\="Comment for created Java files" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.filecomment" 
name\="filecomment">/**\r\n * \r\n */</template><template autoinsert\="false" 
context\="typecomment_context" deleted\="false" description\="Comment for 
created types" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.typecomment" 
name\="typecomment">/**\r\n * TODO\r\n * &lt;p&gt;\r\n * \r\n * @author James 
Bognar ([email protected])\r\n * ${tags}\r\n */</template><template 
autoinsert\="true" context\="fieldcomment_context
 " deleted\="false" description\="Comment for fields" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.fieldcomment" 
name\="fieldcomment">/**\r\n * \r\n */</template><template autoinsert\="false" 
context\="methodcomment_context" deleted\="false" description\="Comment for 
non-overriding methods" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.methodcomment" 
name\="methodcomment">/**\r\n * TODO\r\n * \r\n * ${tags}\r\n 
*/</template><template autoinsert\="true" context\="overridecomment_context" 
deleted\="false" description\="Comment for overriding methods" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.overridecomment" 
name\="overridecomment">/* (non-Javadoc)\r\n * ${see_to_overridden}\r\n 
*/</template><template autoinsert\="false" context\="delegatecomment_context" 
deleted\="false" description\="Comment for delegate methods" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.delegatecomment" 
name\="delegatecomment">/**\r\n * TODO\r\n * \r\n * $
 {tags}\r\n * ${see_to_target}\r\n */</template><template autoinsert\="true" 
context\="newtype_context" deleted\="false" description\="Newly created files" 
enabled\="true" id\="org.eclipse.jdt.ui.text.codetemplates.newtype" 
name\="newtype">${filecomment}\r\n${package_declaration}\r\n\r\n${typecomment}\r\n${type_declaration}</template><template
 autoinsert\="true" context\="classbody_context" deleted\="false" 
description\="Code in new class type bodies" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.classbody" 
name\="classbody">\r\n</template><template autoinsert\="true" 
context\="interfacebody_context" deleted\="false" description\="Code in new 
interface type bodies" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.interfacebody" 
name\="interfacebody">\r\n</template><template autoinsert\="true" 
context\="enumbody_context" deleted\="false" description\="Code in new enum 
type bodies" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.enumbody" name\="enumbo
 dy">\r\n</template><template autoinsert\="true" 
context\="annotationbody_context" deleted\="false" description\="Code in new 
annotation type bodies" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.annotationbody" 
name\="annotationbody">\r\n</template><template autoinsert\="true" 
context\="catchblock_context" deleted\="false" description\="Code in new catch 
blocks" enabled\="true" id\="org.eclipse.jdt.ui.text.codetemplates.catchblock" 
name\="catchblock">// ${todo} Auto-generated catch 
block\r\n${exception_var}.printStackTrace();</template><template 
autoinsert\="true" context\="methodbody_context" deleted\="false" 
description\="Code in created method stubs" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.methodbody" name\="methodbody">// 
${todo} Auto-generated method stub\r\n${body_statement}</template><template 
autoinsert\="true" context\="constructorbody_context" deleted\="false" 
description\="Code in created constructor stubs" enabled\="true" 
id\="org.eclipse.
 jdt.ui.text.codetemplates.constructorbody" 
name\="constructorbody">${body_statement}\r\n// ${todo} Auto-generated 
constructor stub</template><template autoinsert\="true" 
context\="getterbody_context" deleted\="false" description\="Code in created 
getters" enabled\="true" id\="org.eclipse.jdt.ui.text.codetemplates.getterbody" 
name\="getterbody">return ${field};</template><template autoinsert\="true" 
context\="setterbody_context" deleted\="false" description\="Code in created 
setters" enabled\="true" id\="org.eclipse.jdt.ui.text.codetemplates.setterbody" 
name\="setterbody">${field} \= ${param};</template></templates>
+org.eclipse.jdt.ui.text.custom_code_templates=<?xml version\="1.0" 
encoding\="UTF-8"?><templates><template autoinsert\="false" 
context\="gettercomment_context" deleted\="false" description\="Comment for 
getter method" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.gettercomment" 
name\="gettercomment">/**\r\n * Bean property getter\:  
&lt;property&gt;${bare_field_name}&lt;/property&gt;.\r\n *\r\n * @return The 
value of the &lt;property&gt;${bare_field_name}&lt;/property&gt; property on 
this bean, or &lt;jk&gt;null&lt;/jk&gt; if it is not set.\r\n 
*/</template><template autoinsert\="false" context\="settercomment_context" 
deleted\="false" description\="Comment for setter method" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.settercomment" 
name\="settercomment">/**\r\n * Bean property setter\:  
&lt;property&gt;${bare_field_name}&lt;/property&gt;.\r\n *\r\n * @param 
${param} The new value for the 
&lt;property&gt;${bare_field_name}&lt;/property&gt; property on th
 is bean.\r\n * @return This object (for method chaining).\r\n 
*/</template><template autoinsert\="false" 
context\="constructorcomment_context" deleted\="false" description\="Comment 
for created constructors" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.constructorcomment" 
name\="constructorcomment">/**\r\n * TODO\r\n * \r\n * ${tags}\r\n 
*/</template><template autoinsert\="true" context\="filecomment_context" 
deleted\="false" description\="Comment for created Java files" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.filecomment" 
name\="filecomment">/**\r\n * \r\n */</template><template autoinsert\="false" 
context\="typecomment_context" deleted\="false" description\="Comment for 
created types" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.typecomment" 
name\="typecomment">/**\r\n * TODO\r\n * &lt;p&gt;\r\n * \r\n * @author James 
Bognar ([email protected])\r\n * ${tags}\r\n */</template><template 
autoinsert\="true" context\="fieldcommen
 t_context" deleted\="false" description\="Comment for fields" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.fieldcomment" 
name\="fieldcomment">/**\r\n * \r\n */</template><template autoinsert\="false" 
context\="methodcomment_context" deleted\="false" description\="Comment for 
non-overriding methods" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.methodcomment" 
name\="methodcomment">/**\r\n * TODO\r\n * \r\n * ${tags}\r\n 
*/</template><template autoinsert\="true" context\="overridecomment_context" 
deleted\="false" description\="Comment for overriding methods" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.overridecomment" 
name\="overridecomment">/* (non-Javadoc)\r\n * ${see_to_overridden}\r\n 
*/</template><template autoinsert\="false" context\="delegatecomment_context" 
deleted\="false" description\="Comment for delegate methods" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.delegatecomment" 
name\="delegatecomment">/**\r\n * TODO\r\n *
  \r\n * ${tags}\r\n * ${see_to_target}\r\n */</template><template 
autoinsert\="true" context\="newtype_context" deleted\="false" 
description\="Newly created files" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.newtype" 
name\="newtype">${filecomment}\r\n${package_declaration}\r\n\r\n${typecomment}\r\n${type_declaration}</template><template
 autoinsert\="true" context\="classbody_context" deleted\="false" 
description\="Code in new class type bodies" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.classbody" 
name\="classbody">\r\n</template><template autoinsert\="true" 
context\="interfacebody_context" deleted\="false" description\="Code in new 
interface type bodies" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.interfacebody" 
name\="interfacebody">\r\n</template><template autoinsert\="true" 
context\="enumbody_context" deleted\="false" description\="Code in new enum 
type bodies" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.enumbody" name
 \="enumbody">\r\n</template><template autoinsert\="true" 
context\="annotationbody_context" deleted\="false" description\="Code in new 
annotation type bodies" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.annotationbody" 
name\="annotationbody">\r\n</template><template autoinsert\="true" 
context\="catchblock_context" deleted\="false" description\="Code in new catch 
blocks" enabled\="true" id\="org.eclipse.jdt.ui.text.codetemplates.catchblock" 
name\="catchblock">// ${todo} Auto-generated catch 
block\r\n${exception_var}.printStackTrace();</template><template 
autoinsert\="true" context\="methodbody_context" deleted\="false" 
description\="Code in created method stubs" enabled\="true" 
id\="org.eclipse.jdt.ui.text.codetemplates.methodbody" name\="methodbody">// 
${todo} Auto-generated method stub\r\n${body_statement}</template><template 
autoinsert\="true" context\="constructorbody_context" deleted\="false" 
description\="Code in created constructor stubs" enabled\="true" id\="org
 .eclipse.jdt.ui.text.codetemplates.constructorbody" 
name\="constructorbody">${body_statement}\r\n// ${todo} Auto-generated 
constructor stub</template><template autoinsert\="true" 
context\="getterbody_context" deleted\="false" description\="Code in created 
getters" enabled\="true" id\="org.eclipse.jdt.ui.text.codetemplates.getterbody" 
name\="getterbody">return ${field};</template><template autoinsert\="true" 
context\="setterbody_context" deleted\="false" description\="Code in created 
setters" enabled\="true" id\="org.eclipse.jdt.ui.text.codetemplates.setterbody" 
name\="setterbody">${field} \= ${param};</template></templates>
 sp_cleanup.add_default_serial_version_id=true
 sp_cleanup.add_generated_serial_version_id=false
 sp_cleanup.add_missing_annotations=true

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/.settings/org.eclipse.wst.common.component
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/.settings/org.eclipse.wst.common.component 
b/com.ibm.team.juno.client/.settings/org.eclipse.wst.common.component
index 1cbcd7b..6f3093f 100755
--- a/com.ibm.team.juno.client/.settings/org.eclipse.wst.common.component
+++ b/com.ibm.team.juno.client/.settings/org.eclipse.wst.common.component
@@ -1,5 +1,5 @@
-<?xml version="1.0" encoding="UTF-8"?><project-modules id="moduleCoreId" 
project-version="1.5.0">
-    <wb-module deploy-name="com.ibm.team.juno.client">
-        <wb-resource deploy-path="/" source-path="/src"/>
-    </wb-module>
-</project-modules>
\ No newline at end of file
+<?xml version="1.0" encoding="UTF-8"?><project-modules id="moduleCoreId" 
project-version="1.5.0">
+    <wb-module deploy-name="org.apache.juneau.client">
+        <wb-resource deploy-path="/" source-path="/src/main/java"/>
+    </wb-module>
+</project-modules>

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/.settings/org.eclipse.wst.common.project.facet.core.xml
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/.settings/org.eclipse.wst.common.project.facet.core.xml
 
b/com.ibm.team.juno.client/.settings/org.eclipse.wst.common.project.facet.core.xml
index 3e8b624..6c4c744 100755
--- 
a/com.ibm.team.juno.client/.settings/org.eclipse.wst.common.project.facet.core.xml
+++ 
b/com.ibm.team.juno.client/.settings/org.eclipse.wst.common.project.facet.core.xml
@@ -1,12 +1,19 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-    Licensed Materials - Property of IBM
-    (c) Copyright IBM Corporation 2014. All Rights Reserved.
-   
-    Note to U.S. Government Users Restricted Rights:  
-    Use, duplication or disclosure restricted by GSA ADP Schedule 
-    Contract with IBM Corp. 
- -->
+ 
***************************************************************************************************************************
+ * Licensed to the Apache Software Foundation (ASF) under one or more 
contributor license agreements.  See the NOTICE file *
+ * distributed with this work for additional information regarding copyright 
ownership.  The ASF licenses this file        *
+ * to you 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.  
                                            *
+ *                                                                             
                                            *
+ 
***************************************************************************************************************************
+-->
 <faceted-project>
   <fixed facet="jst.java"/>
   <fixed facet="jst.utility"/>

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/META-INF/MANIFEST.MF
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/META-INF/MANIFEST.MF 
b/com.ibm.team.juno.client/META-INF/MANIFEST.MF
index a13e895..93db195 100755
--- a/com.ibm.team.juno.client/META-INF/MANIFEST.MF
+++ b/com.ibm.team.juno.client/META-INF/MANIFEST.MF
@@ -1,11 +1,11 @@
 Manifest-Version: 1.0
 Bundle-ManifestVersion: 2
-Bundle-Name: Juno Cloud API - Client
-Bundle-SymbolicName: com.ibm.team.juno.client
+Bundle-Name: Juneau Cloud Tools - Client
+Bundle-SymbolicName: org.apache.juneau.client
 Bundle-Version: 5.2.1000.qualifier
 Bundle-Vendor: IBM
 Require-Bundle: 
- com.ibm.team.juno
+ org.apache.juneau
 Import-Package: 
  org.apache.http,
  org.apache.http.auth,
@@ -32,6 +32,5 @@ Import-Package:
  org.apache.http.protocol,
  org.apache.http.util
 Export-Package: 
- com.ibm.juno.client,
- com.ibm.juno.client.jazz
+ org.apache.juneau.client
 Bundle-RequiredExecutionEnvironment: JavaSE-1.6

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/OSGI-INF/l10n/plugin.properties
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/OSGI-INF/l10n/plugin.properties 
b/com.ibm.team.juno.client/OSGI-INF/l10n/plugin.properties
index ffdfad1..de1ae69 100755
--- a/com.ibm.team.juno.client/OSGI-INF/l10n/plugin.properties
+++ b/com.ibm.team.juno.client/OSGI-INF/l10n/plugin.properties
@@ -1,14 +1,19 @@
-###############################################################################
-#Licensed Materials - Property of IBM
-#(c) Copyright IBM Corporation 2014. All Rights Reserved.
-#
-#Note to U.S. Government Users Restricted Rights:  
-#Use, duplication or disclosure restricted by GSA ADP Schedule 
-#Contract with IBM Corp. 
-###############################################################################
+# 
***************************************************************************************************************************
+# * Licensed to the Apache Software Foundation (ASF) under one or more 
contributor license agreements.  See the NOTICE file
+# * distributed with this work for additional information regarding copyright 
ownership.  The ASF licenses this file
+# * to you 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.
+# *
+# 
***************************************************************************************************************************
 # NLS_ENCODING=UTF-8
 # NLS_MESSAGEFORMAT_VAR
 
 # META-INF/MANIFEST.MF
-bundle.name = Juno Cloud API - REST client component
+bundle.name = Juneau Cloud Tools - REST client component
 bundle.vendor = IBM

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/AllowAllRedirects.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/AllowAllRedirects.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/AllowAllRedirects.class
deleted file mode 100644
index b656df4..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/AllowAllRedirects.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/DateHeader.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/bin/com/ibm/juno/client/DateHeader.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/DateHeader.class
deleted file mode 100644
index 1912e6a..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/DateHeader.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/HttpMethod.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/bin/com/ibm/juno/client/HttpMethod.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/HttpMethod.class
deleted file mode 100644
index 7143804..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/HttpMethod.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/NameValuePairs.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/NameValuePairs.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/NameValuePairs.class
deleted file mode 100644
index cd7bbfc..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/NameValuePairs.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/ResponsePattern.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/ResponsePattern.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/ResponsePattern.class
deleted file mode 100644
index 7d0c974..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/ResponsePattern.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall$1.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall$1.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall$1.class
deleted file mode 100644
index a3ebe89..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall$1.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall$2.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall$2.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall$2.class
deleted file mode 100644
index cb8a11f..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall$2.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall$3.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall$3.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall$3.class
deleted file mode 100644
index 6780731..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall$3.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall.class
deleted file mode 100644
index 04fbcc8..0000000
Binary files a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCall.class 
and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCallException.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCallException.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCallException.class
deleted file mode 100644
index 0e50295..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCallException.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCallInterceptor.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCallInterceptor.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCallInterceptor.class
deleted file mode 100644
index 4fa44a6..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCallInterceptor.class 
and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCallLogger.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCallLogger.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCallLogger.class
deleted file mode 100644
index 595b9e0..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestCallLogger.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient$1.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient$1.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient$1.class
deleted file mode 100644
index fb7c203..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient$1.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient$2.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient$2.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient$2.class
deleted file mode 100644
index b3979e3..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient$2.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient$3.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient$3.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient$3.class
deleted file mode 100644
index c90175e..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient$3.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient.class
deleted file mode 100644
index bac2450..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestClient.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestRequestEntity.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestRequestEntity.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestRequestEntity.class
deleted file mode 100644
index 02aeb23..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RestRequestEntity.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RetryOn$1.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RetryOn$1.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RetryOn$1.class
deleted file mode 100644
index ec43d14..0000000
Binary files a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RetryOn$1.class 
and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/RetryOn.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RetryOn.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/RetryOn.class
deleted file mode 100644
index 9b2daca..0000000
Binary files a/com.ibm.team.juno.client/bin/com/ibm/juno/client/RetryOn.class 
and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/SSLOpts$CertValidate.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/SSLOpts$CertValidate.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/SSLOpts$CertValidate.class
deleted file mode 100644
index e92f288..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/SSLOpts$CertValidate.class 
and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/SSLOpts$HostVerify.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/SSLOpts$HostVerify.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/SSLOpts$HostVerify.class
deleted file mode 100644
index 6914fd5..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/SSLOpts$HostVerify.class and 
/dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/SSLOpts.class
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/bin/com/ibm/juno/client/SSLOpts.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/SSLOpts.class
deleted file mode 100644
index b7c1b3c..0000000
Binary files a/com.ibm.team.juno.client/bin/com/ibm/juno/client/SSLOpts.class 
and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/SerializedNameValuePair.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/SerializedNameValuePair.class
 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/SerializedNameValuePair.class
deleted file mode 100644
index c3d0cfc..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/SerializedNameValuePair.class
 and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/SimpleX509TrustManager.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/SimpleX509TrustManager.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/SimpleX509TrustManager.class
deleted file mode 100644
index 89aadde..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/SimpleX509TrustManager.class 
and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/CertificateStore.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/CertificateStore.class
 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/CertificateStore.class
deleted file mode 100644
index bcd4fbc..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/CertificateStore.class
 and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ICertificateValidator$Trust.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ICertificateValidator$Trust.class
 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ICertificateValidator$Trust.class
deleted file mode 100644
index 033a284..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ICertificateValidator$Trust.class
 and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ICertificateValidator.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ICertificateValidator.class
 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ICertificateValidator.class
deleted file mode 100644
index fb9bf78..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ICertificateValidator.class
 and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ITrustStoreProvider.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ITrustStoreProvider.class
 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ITrustStoreProvider.class
deleted file mode 100644
index 4ac7d83..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ITrustStoreProvider.class
 and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/LenientCertificateValidator.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/LenientCertificateValidator.class
 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/LenientCertificateValidator.class
deleted file mode 100644
index 4ff59aa..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/LenientCertificateValidator.class
 and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/SharedTrustStoreProvider.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/SharedTrustStoreProvider.class
 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/SharedTrustStoreProvider.class
deleted file mode 100644
index b44f35c..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/SharedTrustStoreProvider.class
 and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ValidatingX509TrustManager.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ValidatingX509TrustManager.class
 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ValidatingX509TrustManager.class
deleted file mode 100644
index 1d7aca6..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/deprecated/ValidatingX509TrustManager.class
 and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/jazz/JazzRestClient.class
----------------------------------------------------------------------
diff --git 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/jazz/JazzRestClient.class 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/jazz/JazzRestClient.class
deleted file mode 100644
index 61d8191..0000000
Binary files 
a/com.ibm.team.juno.client/bin/com/ibm/juno/client/jazz/JazzRestClient.class 
and /dev/null differ

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/jazz/package.html
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/bin/com/ibm/juno/client/jazz/package.html 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/jazz/package.html
deleted file mode 100755
index fce9248..0000000
--- a/com.ibm.team.juno.client/bin/com/ibm/juno/client/jazz/package.html
+++ /dev/null
@@ -1,187 +0,0 @@
-<!DOCTYPE HTML>
-<!--
-    Licensed Materials - Property of IBM
-    (c) Copyright IBM Corporation 2014. All Rights Reserved.
-   
-    Note to U.S. Government Users Restricted Rights:  
-    Use, duplication or disclosure restricted by GSA ADP Schedule 
-    Contract with IBM Corp. 
- -->
-<html>
-<head>
-       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-       <style type="text/css">
-               /* For viewing in Page Designer */
-               @IMPORT url("../../../../../../javadoc.css");
-
-               /* For viewing in REST interface */
-               @IMPORT url("../htdocs/javadoc.css");
-               body { 
-                       margin: 20px; 
-               }       
-       </style>
-       <script>
-               /* Replace all @code and @link tags. */ 
-               window.onload = function() {
-                       document.body.innerHTML = 
document.body.innerHTML.replace(/\{\@code ([^\}]+)\}/g, '<code>$1</code>');
-                       document.body.innerHTML = 
document.body.innerHTML.replace(/\{\@link (([^\}]+)\.)?([^\.\}]+)\}/g, 
'<code>$3</code>');
-               }
-       </script>
-</head>
-<body>
-<p>Jazz REST client API</p>
-
-<script>
-       function toggle(x) {
-               var div = x.nextSibling;
-               while (div != null && div.nodeType != 1)
-                       div = div.nextSibling;
-               if (div != null) {
-                       var d = div.style.display;
-                       if (d == 'block' || d == '') {
-                               div.style.display = 'none';
-                               x.className += " closed";
-                       } else {
-                               div.style.display = 'block';
-                               x.className = 
x.className.replace(/(?:^|\s)closed(?!\S)/g , '' );
-                       }
-               }
-       }
-</script>
-
-<a id='TOC'></a><h5 class='toc'>Table of Contents</h5>
-<ol class='toc'>
-       <li><p><a class='doclink' href='#RestClient'>Jazz REST client 
API</a></p>
-</ol>
-
-<!-- 
========================================================================================================
 -->
-<a id="RestClient"></a>
-<h2 class='topic' onclick='toggle(this)'>1 - Jazz REST client API</h2>
-<div class='topic'>
-       <p>
-               Juno provides a default REST client implementation for working 
with Jazz servers. 
-               The client automatically detects and handles BASIC and FORM 
authentication and basic certificate authentication.
-       </p>
-       <p>
-               The following code shows the Jazz REST client being used for 
querying and creating server messages on 
-                       a Jazz server.  The <code>ServerMessage</code> and 
<code>CreateServerMessage</code> classes
-                       are nothing more than simple beans that get serialized 
over the connection and reconstituted on 
-                       the server.
-       </p>
-       <p class='bcode'>
-       System.<jsf>out</jsf>.println(<js>"Adding sample messages"</js>);
-
-       DateFormat df = <jk>new</jk> 
SimpleDateFormat(<js>"yyyy-MM-dd'T'HH:mm:ssZ"</js>);
-       String url = <js>"https://localhost:9443/jazz";</js>;
-       String sms = url + <js>"/serverMessages"</js>;
-       CreateServerMessage m;
-       ServerMessage m2;
-       String s1;
-       ServerMessage[] messages;
-       
-       <jc>// Serializer for debug messages.</jc>
-       WriterSerializer serializer = JsonSerializer.<jsf>DEFAULT</jsf>;
-       
-       <jc>// Create clients to handle JSON and XML requests and 
responses.</jc>
-       RestClient jsonClient = <jk>new</jk> JazzRestClient(url, 
<js>"ADMIN"</js>, <js>"ADMIN"</js>)
-               .setSerializer(JsonSerializer.<jk>class</jk>)
-               .setParser(<jk>new</jk> 
JsonParser().addFilters(DateFilter.<jsf>ISO8601DTZ</jsf>.<jk>class</jk>));
-       
-       RestClient xmlClient = <jk>new</jk> JazzRestClient(url, 
<js>"ADMIN"</js>, <js>"ADMIN"</js>, XmlSerializer.<jk>class</jk>, 
XmlParser.<jk>class</jk>);
-       
-       <jc>// Delete any existing messages.</jc>
-       messages = jsonClient
-               .doGet(sms)
-               .getResponse(ServerMessage[].<jk>class</jk>);
-       
-       <jk>for</jk> (ServerMessage message : messages) {
-               <jk>int</jk> rc = jsonClient
-                       .doDelete(message.getUri())
-                       .execute();
-               System.<jsf>out</jsf>.println(rc);      <jc>// Prints 200.</jc>
-       }
-       
-       <jc>// Create an active server message.</jc>
-       m = <jk>new</jk> CreateServerMessage(
-               <jsf>INFO</jsf>,
-               <js>"Test message #1"</js>,
-               <js>"subTypeFoo"</js>,
-               df.parse(<js>"2012-01-01T12:34:56EST"</js>),
-               df.parse(<js>"2013-01-01T12:34:56EST"</js>));
-       
-       <jc>// POST the message, get response as string.</jc>
-       s1 = jsonClient
-               .doPost(sms, m)
-               .getResponseAsString(); 
-       System.<jsf>out</jsf>.println(<js>"TEST1: response="</js> + s1);
-
-       <jc>// POST another message, get response as ServerMessage</jc>
-       m = <jk>new</jk> CreateServerMessage(
-               <jsf>INFO</jsf>,
-               <js>"Test message #2"</js>,
-               <js>"subTypeFoo"</js>,
-               df.parse(<js>"2012-01-01T12:34:56EST"</js>),
-               df.parse(<js>"2013-01-01T12:34:56EST"</js>));
-
-       m2 = jsonClient
-               .doPost(sms, m)
-               .getResponse(ServerMessage.<jk>class</jk>); 
-       System.<jsf>out</jsf>.println(<js>"TEST2: response="</js> + 
serializer.serialize(m2));
-       
-       <jc>// Create a future server message.</jc>
-       m = <jk>new</jk> CreateServerMessage(
-               <jsf>INFO</jsf>,
-               <js>"Test message #3"</js>,
-               <js>"subTypeFoo"</js>,
-               df.parse(<js>"2013-01-01T12:34:56EST"</js>),
-               df.parse(<js>"2014-01-01T12:34:56EST"</js>));
-       
-       m2 = jsonClient
-               .doPost(sms, m)
-               .getResponse(ServerMessage.<jk>class</jk>); 
-       System.<jsf>out</jsf>.println(<js>"TEST3: response="</js> + 
serializer.serialize(m2));
-       System.<jsf>out</jsf>.println(<js>"TEST3: id="</js> + 
m2.getItemId().getUuidValue());
-
-       <jc>// Create a future server message using XML on both request and 
response.</jc>
-       m = <jk>new</jk> CreateServerMessage(
-               <jsf>INFO</jsf>,
-               <js>"Test message #4"</js>,
-               <js>"subTypeFoo"</js>,                                  
-               df.parse(<js>"2013-01-01T12:34:56EST"</js>),
-               df.parse(<js>"2014-01-01T12:34:56EST"</js>));
-       
-       s1 = xmlClient
-               .doPost(sms, m)
-               .getResponseAsString();
-       System.<jsf>out</jsf>.println(<js>"TEST4: response="</js> + s1);
-
-       <jc>// Get all the messages</jc>
-       messages = jsonClient
-               .doGet(sms)
-               .getResponse(ServerMessage[].<jk>class</jk>);
-       System.<jsf>out</jsf>.println(<js>"TEST5: response="</js> + 
serializer.serialize(messages)); 
-
-       <jc>// Get the first ID</jc>
-       URI firstMessageUrl = messages[0].getUri();
-       
-       
System.<jsf>out</jsf>.println(<js>"firstMessageUrl=["</js>+firstMessageUrl+<js>"]"</js>);
-       
-       <jc>// Get the Date of the first ID.</jc>
-       Date startDate = jsonClient
-               .doGet(firstMessageUrl + <js>"/startDate"</js>)
-               .getResponse(Date.<jk>class</jk>);  
-       System.<jsf>out</jsf>.println(<js>"TEST5: 
response.startDate="</js>+startDate);
-       
-       <jc>// Change the start and end dates on first message</jc>
-       m = <jk>new</jk> CreateServerMessage(
-               <jsf>INFO</jsf>,
-               <js>"Test message #3 overwritten"</js>,
-               <js>"subTypeFooBar"</js>,
-               df.parse(<js>"2023-01-01T12:34:56EST"</js>),
-               df.parse(<js>"2024-01-01T12:34:56EST"</js>));
-       s1 = jsonClient.doPut(firstMessageUrl, m).getResponseAsString();
-       System.<jsf>out</jsf>.println(<js>"TEST6: response="</js>+s1);
-       </p>
-</div>
-</body>
-</html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/30947fd7/com.ibm.team.juno.client/bin/com/ibm/juno/client/package.html
----------------------------------------------------------------------
diff --git a/com.ibm.team.juno.client/bin/com/ibm/juno/client/package.html 
b/com.ibm.team.juno.client/bin/com/ibm/juno/client/package.html
deleted file mode 100755
index 407ef7c..0000000
--- a/com.ibm.team.juno.client/bin/com/ibm/juno/client/package.html
+++ /dev/null
@@ -1,850 +0,0 @@
-<!DOCTYPE HTML>
-<!--
-    Licensed Materials - Property of IBM
-    (c) Copyright IBM Corporation 2014. All Rights Reserved.
-   
-    Note to U.S. Government Users Restricted Rights:  
-    Use, duplication or disclosure restricted by GSA ADP Schedule 
-    Contract with IBM Corp. 
- -->
-<html>
-<head>
-       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-       <style type="text/css">
-               /* For viewing in Page Designer */
-               @IMPORT url("../../../../../javadoc.css");
-
-               /* For viewing in REST interface */
-               @IMPORT url("../htdocs/javadoc.css");
-               body { 
-                       margin: 20px; 
-               }       
-       </style>
-       <script>
-               /* Replace all @code and @link tags. */ 
-               window.onload = function() {
-                       document.body.innerHTML = 
document.body.innerHTML.replace(/\{\@code ([^\}]+)\}/g, '<code>$1</code>');
-                       document.body.innerHTML = 
document.body.innerHTML.replace(/\{\@link (([^\}]+)\.)?([^\.\}]+)\}/g, 
'<code>$3</code>');
-               }
-       </script>
-</head>
-<body>
-<p>REST client API</p>
-
-<script>
-       function toggle(x) {
-               var div = x.nextSibling;
-               while (div != null && div.nodeType != 1)
-                       div = div.nextSibling;
-               if (div != null) {
-                       var d = div.style.display;
-                       if (d == 'block' || d == '') {
-                               div.style.display = 'none';
-                               x.className += " closed";
-                       } else {
-                               div.style.display = 'block';
-                               x.className = 
x.className.replace(/(?:^|\s)closed(?!\S)/g , '' );
-                       }
-               }
-       }
-</script>
-
-<a id='TOC'></a><h5 class='toc'>Table of Contents</h5>
-<ol class='toc'>
-       <li><p><a class='doclink' href='#RestClient'>REST Client API</a></p>
-       <ol>
-               <li><p><a class='doclink' href='#SSL'>SSL Support</a></p>
-               <ol>
-                       <li><p><a class='doclink' href='#SSLOpts'>SSLOpts 
Bean</a></p>
-               </ol>
-               <li><p><a class='doclink' 
href='#Authentication'>Authentication</a></p>
-               <ol>
-                       <li><p><a class='doclink' href='#BASIC'>BASIC 
Authentication</a></p>
-                       <li><p><a class='doclink' href='#FORM'>FORM-based 
Authentication</a></p>
-                       <li><p><a class='doclink' href='#OIDC'>OIDC 
Authentication</a></p>
-               </ol>
-               <li><p><a class='doclink' href='#ResponsePatterns'>Using 
Response Patterns</a></p>
-               <li><p><a class='doclink' href='#PipingOutput'>Piping Response 
Output</a></p>
-               <li><p><a class='doclink' href='#Logging'>Logging</a></p>
-               <li><p><a class='doclink' 
href='#Interceptors'>Interceptors</a></p>
-               <li><p><a class='doclink' href='#Remoteable'>Remoteable 
Proxies</a></p>
-               <li><p><a class='doclink' href='#Other'>Other Useful 
Methods</a></p>
-       </ol>
-</ol>
-
-<!-- 
========================================================================================================
 -->
-<a id="RestClient"></a>
-<h2 class='topic' onclick='toggle(this)'>1 - REST Client API</h2>
-<div class='topic'>
-       <p>
-               Juno provides an HTTP client API that makes it extremely simple 
to connect to remote REST interfaces and 
-               seemlessly send and receive serialized POJOs in requests and 
responses.  
-       </p>
-       <h6 class='notes'>Features:</h6>
-       <ul class='notes'>
-               <li>Converts POJOs directly to HTTP request message bodies 
using {@link com.ibm.juno.core.serializer.Serializer} classes.
-               <li>Converts HTTP response message bodies directly to POJOs 
using {@link com.ibm.juno.core.parser.Parser} classes.
-               <li>Exposes the full functionality of the Apache HttpClient API 
by exposing all methods defined on the 
-                       {@link org.apache.http.impl.client.HttpClientBuilder} 
class.
-               <li>Provides various convenience methods for setting up common 
SSL and authentication methods.
-               <li>Provides a fluent interface that allows you to make complex 
REST calls in a single line of code.
-       </ul>   
-       <p>
-               The client API is designed to work as a thin layer on top of 
the proven Apache HttpClient API.  
-               By leveraging the HttpClient library, details such as SSL 
certificate negotiation, proxies, encoding, etc...
-                       are all handled in Apache code. 
-       </p>
-       <p>
-               The Juno client API prereq's Apache HttpClient 4.1.2+. 
-               At a mimimum, the following jars are required:
-       </p>
-       <ul>
-               <li><code>httpclient-4.5.jar</code>
-               <li><code>httpcore-4.4.1.jar</code>
-               <li><code>httpmime-4.5.jar</code>
-       </ul>
-       <h6 class='topic'>Examples</h6>
-       <p class='bcode'>
-       <jc>// Examples below use the Juno Address Book resource example</jc>
-
-       <jc>// Create a reusable client with JSON support</jc>
-       RestClient client = <jk>new</jk> 
RestClient(JsonSerializer.<jk>class</jk>, JsonParser.<jk>class</jk>);
-       
-       <jc>// GET request, ignoring output</jc>
-       <jk>try</jk> {
-               <jk>int</jk> rc = 
client.doGet(<js>"http://localhost:9080/sample/addressBook";</js>).execute();
-               <jc>// Succeeded!</jc>
-       } <jk>catch</jk> (RestCallException e) {
-               <jc>// Failed!</jc>
-               System.<jsf>err</jsf>.println(
-                       String.<jsm>format</jsm>(<js>"status=%s, 
message=%s"</js>, e.getResponseStatus(), e.getResponseMessage())
-               );
-       }
-                       
-       <jc>// Remaining examples ignore thrown exceptions.</jc>                
-                       
-       <jc>// GET request, secure, ignoring output</jc>
-       
client.doGet(<js>"https://localhost:9443/sample/addressBook";</js>).execute();
-                       
-       <jc>// GET request, getting output as a String.  No POJO parsing is 
performed.
-       // Note that when calling one of the getX() methods, you don't need to 
call connect() or disconnect(), since
-       //      it's automatically called for you.</jc>
-       String output = 
client.doGet(<js>"http://localhost:9080/sample/addressBook";</js>)
-               .getResponseAsString();
-                       
-       <jc>// GET request, getting output as a Reader</jc>
-       Reader r = 
client.doGet(<js>"http://localhost:9080/sample/addressBook";</js>)
-               .getReader();
-                       
-       <jc>// GET request, getting output as an ObjectMap</jc>
-       <jc>// Input must be an object (e.g. "{...}")</jc>
-       ObjectMap m = 
client.doGet(<js>"http://localhost:9080/sample/addressBook/0";</js>)
-               .getResponse(ObjectMap.<jk>class</jk>);
-                       
-       <jc>// GET request, getting output as a ObjectList</jc>
-       <jc>// Input must be an array (e.g. "[...]")</jc>
-       ObjectList l = 
client.doGet(<js>"http://localhost:9080/sample/addressBook";</js>)
-               .getResponse(ObjectList.<jk>class</jk>);
-                       
-       <jc>// GET request, getting output as a parsed bean</jc>
-       <jc>// Input must be an object (e.g. "{...}")</jc>
-       <jc>// Note that you don't have to do any casting!</jc>
-       Person p = 
client.doGet(<js>"http://localhost:9080/sample/addressBook/0";</js>)
-               .getResponse(Person.<jk>class</jk>);
-                       
-       <jc>// GET request, getting output as a parsed bean</jc>
-       <jc>// Input must be an array of objects (e.g. "[{...},{...}]")</jc>
-       Person[] pa = 
client.doGet(<js>"http://localhost:9080/sample/addressBook";</js>)
-               .getResponse(Person[].<jk>class</jk>);
-                       
-       <jc>// Same as above, except as a List&lt;Person&gt;</jc>
-       ClassMeta cm = 
BeanContext.<jsf>DEFAULT</jsf>.getCollectionClassMeta(LinkedList.<jk>class</jk>,
 Person.<jk>class</jk>);
-       List&lt;Person&gt; pl = 
client.doGet(<js>"http://localhost:9080/sample/addressBook";</js>)
-               .getResponse(cm);
-                       
-       <jc>// GET request, getting output as a parsed string</jc>
-       <jc>// Input must be a string (e.g. "&lt;string&gt;foo&lt;/string&gt;" 
or "'foo'")</jc>
-       String name = 
client.doGet(<js>"http://localhost:9080/sample/addressBook/0/name";</js>)
-               .getResponse(String.<jk>class</jk>);
-                       
-       <jc>// GET request, getting output as a parsed number</jc>
-       <jc>// Input must be a number (e.g. "&lt;number&gt;123&lt;/number&gt;" 
or "123")</jc>
-       <jk>int</jk> age = 
client.doGet(<js>"http://localhost:9080/sample/addressBook/0/age";</js>)
-               .getResponse(Integer.<jk>class</jk>);
-                       
-       <jc>// GET request, getting output as a parsed boolean</jc>
-       <jc>// Input must be a boolean (e.g. 
"&lt;boolean&gt;true&lt;/boolean&gt;" or "true")</jc>
-       <jk>boolean</jk> isCurrent = 
client.doGet(<js>"http://localhost:9080/sample/addressBook/0/addresses/0/isCurrent";</js>)
-               .getResponse(Boolean.<jk>class</jk>);
-                       
-       <jc>// GET request, getting a filtered object</jc>
-       
client.getParser().addFilters(CalendarFilter.<jsf>ISO8601</jsf>.<jk>class</jk>);
-       Calendar birthDate = 
client.doGet(<js>"http://localhost:9080/sample/addressBook/0/birthDate";</js>)
-               .getResponse(GregorianCalendar.<jk>class</jk>);
-
-       <jc>// PUT request on regular field</jc>
-       String newName = <js>"John Smith"</js>;
-       <jk>int</jk> rc = 
client.doPut(<js>"http://localhost:9080/addressBook/0/name";</js>, 
newName).execute();
-       
-       <jc>// PUT request on filtered field</jc>
-       Calendar newBirthDate = <jk>new</jk> GregorianCalendar(1, 2, 3, 4, 5, 
6);
-       rc = 
client.doPut(<js>"http://localhost:9080/sample/addressBook/0/birthDate";</js>, 
newBirthDate).execute();
-       
-       <jc>// POST of a new entry to a list</jc>
-       Address newAddress = <jk>new</jk> Address(<js>"101 Main St"</js>, 
<js>"Anywhere"</js>, <js>"NY"</js>, 12121, <jk>false</jk>);
-       rc = 
client.doPost(<js>"http://localhost:9080/addressBook/0/addresses";</js>, 
newAddress).execute();     
-       </p>
-       
-       <h6 class='notes'>Notes:</h6>
-       <ul class='notes'>
-               <li><p>The {@link com.ibm.juno.client.RestClient} class exposes 
all the builder methods on the Apache HttpClient {@link 
org.apache.http.impl.client.HttpClientBuilder} class.
-                       Use these methods to provide any customized HTTP client 
behavior..</p>
-       </ul>
-       
-       <!-- 
========================================================================================================
 -->
-       <a id="SSL"></a>
-       <h3 class='topic' onclick='toggle(this)'>1.1 - SSL Support</h3>
-       <div class='topic'>
-               <p>
-                       The simplest way to enable SSL support in the client is 
to use the {@link com.ibm.juno.client.RestClient#enableSSL(SSLOpts)} method
-                       and one of the predefined {@link 
com.ibm.juno.client.SSLOpts} instances:
-                       <ul>
-                               <li>{@link com.ibm.juno.client.SSLOpts#DEFAULT} 
- Normal certificate and hostname validation.
-                               <li>{@link com.ibm.juno.client.SSLOpts#LAX} - 
Allows for self-signed certificates.
-                       </ul>
-               </p>
-               <h6 class='topic'>Example:</h6>
-               <p class='bcode'>
-       <jc>// Create a client that ignores self-signed or otherwise invalid 
certificates.</jc>
-       RestClient restClient = <jk>new</jk> RestClient() 
-               .enableSSL(SSLOpts.<jsf>LAX</jsf>);
-               
-       <jc>// ...or...</jc>
-       RestClient restClient = <jk>new</jk> RestClient() 
-               .enableLaxSSL();
-               </p>
-               <p>
-                       This is functionally equivalent to the following:
-               </p>
-               <p class='bcode'>
-       RestClient restClient = <jk>new</jk> RestClient();
-       
-       HostnameVerifier hv = <jk>new</jk> NoopHostnameVerifier();
-       TrustManager tm = <jk>new</jk> SimpleX509TrustManager(<jk>true</jk>);
-
-       <jk>for</jk> (String p : <jk>new</jk> 
String[]{<js>"SSL"</js>,<js>"TLS"</js>,<js>"SSL_TLS"</js>}) {
-               SSLContext ctx = SSLContext.<jsm>getInstance</jsm>(p);
-               ctx.init(<jk>null</jk>, <jk>new</jk> TrustManager[] { tm }, 
<jk>null</jk>);
-               SSLConnectionSocketFactory sf = <jk>new</jk> 
SSLConnectionSocketFactory(ctx, hv);
-               restClient.setSSLSocketFactory(sf);
-               Registry&lt;ConnectionSocketFactory&gt; r = 
RegistryBuilder.&lt;ConnectionSocketFactory&gt;<jsm>.create</jsm>().register(<js>"https"</js>,
 sf).build();
-               restClient.setConnectionManager(<jk>new</jk> 
PoolingHttpClientConnectionManager(r));
-       }
-               </p>
-               <p>
-                       More complex SSL support can be enabled through the 
various {@link org.apache.http.impl.client.HttpClientBuilder} methods defined 
on the class.
-               </p>
-               
-               <!-- 
========================================================================================================
 -->
-               <a id="SSLOpts"></a>
-               <h4 class='topic' onclick='toggle(this)'>1.1.1 - SSLOpts 
Bean</h4>
-               <div class='topic'>
-       <p>
-                               The {@link com.ibm.juno.client.SSLOpts} class 
itself is a bean that can be created by the parsers.
-                               For example, SSL options can be specified in a 
config file and retrieved as a bean using the {@link 
com.ibm.juno.core.ini.ConfigFile} class.
-       </p>
-                       <h6 class='figure'>Contents of 
<code>MyConfig.cfg</code></h6>
-                       <p class='bcode'>
-               
<jc>#================================================================================
-               # My Connection Settings
-               
#================================================================================</jc>
-               [Connection]
-               url = https://myremotehost:9443
-               ssl = {certValidate:'LAX',hostVerify:'LAX'}
-                       </p>
-                       <h6 class='figure'>Code that reads an 
<code>SSLOpts</code> bean from the config file</h6>
-                       <p class='bcode'>
-               <jc>// Read config file and set SSL options based on what's in 
that file.</jc>
-               ConfigFile cf = 
ConfigMgr.<jsf>DEFAULT</jsf>.get(<js>"MyConfig.cfg"</js>);
-               SSLOpts ssl = cf.getObject(SSLOpts.<jk>class</jk>, 
<js>"Connection/ssl"</js>);
-               RestClient rc = <jk>new</jk> RestClient().enableSSL(ssl);
-                       </p>
-               </div>
-       </div>  
-
-       <!-- 
========================================================================================================
 -->
-       <a id="Authentication"></a>
-       <h3 class='topic' onclick='toggle(this)'>1.2 - Authentication</h3>
-       <div class='topic'>
-
-               <!-- 
========================================================================================================
 -->
-               <a id="BASIC"></a>
-               <h4 class='topic' onclick='toggle(this)'>1.2.1 - BASIC 
Authentication</h4>
-               <div class='topic'>
-                       <p>
-                               The {@link 
com.ibm.juno.client.RestClient#setBasicAuth(String,int,String,String)} method 
can be used to quickly enable
-                               BASIC authentication support.
-                       </p>
-                       <h6 class='topic'>Example:</h6>
-                       <p class='bcode'>
-       <jc>// Create a client that performs BASIC authentication using the 
specified user/pw.</jc>
-       RestClient restClient = <jk>new</jk> RestClient() 
-               .setBasicAuth(<jsf>HOST</jsf>, <jsf>PORT</jsf>, 
<jsf>USER</jsf>, <jsf>PW</jsf>);
-               </p>
-               <p>
-                       This is functionally equivalent to the following:
-               </p>
-               <p class='bcode'>
-       RestClient restClient = <jk>new</jk> RestClient();
-       AuthScope scope = <jk>new</jk> AuthScope(<jsf>HOST</jsf>, 
<jsf>PORT</jsf>);
-       Credentials up = <jk>new</jk> 
UsernamePasswordCredentials(<jsf>USER</jsf>, <jsf>PW</jsf>);
-       CredentialsProvider p = <jk>new</jk> BasicCredentialsProvider();
-       p.setCredentials(scope, up);
-       restClient.setDefaultCredentialsProvider(p);
-                       </p>
-               </div>
-       
-               <!-- 
========================================================================================================
 -->
-               <a id="FORM"></a>
-               <h4 class='topic' onclick='toggle(this)'>1.2.2 - FORM-based 
Authentication</h4>
-               <div class='topic'>
-                       <p>
-                               The {@link com.ibm.juno.client.RestClient} 
class does not itself provide FORM-based authentication since there
-                               is no standard way of providing such support. 
-                               Typically, to perform FORM-based or other types 
of authentication, you'll want to create your own
-                               subclass of {@link 
com.ibm.juno.client.RestClient} and override the {@link 
com.ibm.juno.client.RestClient#createHttpClient()}
-                               method to provide an authenticated client.
-                       </p>
-                       <p>
-                               The following example shows how the {@link 
com.ibm.juno.client.jazz.JazzRestClient} class provides
-                               FORM-based authentication support.
-                       </p>
-                       <p class='bcode'>
-       <jd>/**
-        * Constructor.
-        */</jd>
-       <jk>public</jk> JazzRestClient(URI jazzUri, String user, String pw) 
<jk>throws</jk> IOException {
-               ...
-       }
-
-       <jd>/**
-        * Override the createHttpClient() method to return an authenticated 
client.
-        */</jd>
-       <ja>@Override</ja> <jc>/* RestClient */</jc>
-       <jk>protected</jk> CloseableHttpClient createHttpClient() 
<jk>throws</jk> Exception {
-               CloseableHttpClient client = <jk>super</jk>.createHttpClient();
-               formBasedAuthenticate(client);
-               visitAuthenticatedURL(client);
-               <jk>return</jk> client;
-       }
-
-       <jc>/*
-        * Performs form-based authentication against the Jazz server.
-        */</jc>
-       <jk>private void</jk> formBasedAuthenticate(HttpClient client) 
<jk>throws</jk> IOException {
-
-               URI uri2 = 
<jf>jazzUri</jf>.resolve(<js>"j_security_check"</js>);
-               HttpPost request = <jk>new</jk> HttpPost(uri2);
-               
request.setConfig(RequestConfig.<jsm>custom</jsm>().setRedirectsEnabled(<jk>false</jk>).build());
-               
-               <jc>// Charset must explicitly be set to UTF-8 to handle 
user/pw with non-ascii characters.</jc>
-               request.addHeader(<js>"Content-Type"</js>, 
<js>"application/x-www-form-urlencoded; charset=utf-8"</js>);
-
-               NameValuePairs params = <jk>new</jk> NameValuePairs()
-                       .append(<jk>new</jk> 
BasicNameValuePair(<js>"j_username""</js>, <jf>user</jf>))
-                       .append(<jk>new</jk> 
BasicNameValuePair(<js>"j_password"</js>, <jf>pw</jf>));
-               request.setEntity(<jk>new</jk> UrlEncodedFormEntity(params));
-
-               HttpResponse response = client.execute(request);
-               <jk>try</jk> {
-                       <jk>int</jk> rc = 
response.getStatusLine().getStatusCode();
-
-                       Header authMsg = 
response.getFirstHeader(<js>"X-com-ibm-team-repository-web-auth-msg"</js>);
-                       <jk>if</jk> (authMsg != <jk>null</jk>)
-                               <jk>throw new</jk> 
IOException(authMsg.getValue());
-
-                       <jc>// The form auth request should always respond with 
a 200 ok or 302 redirect code</jc>
-                       <jk>if</jk> (rc == <jsf>SC_MOVED_TEMPORARILY</jsf>) {
-                               <jk>if</jk> 
(response.getFirstHeader(<js>"Location"</js>).getValue().matches(<js>"^.*/auth/authfailed.*$"</js>))
-                                       <jk>throw new</jk> 
IOException(<js>"Invalid credentials."</js>);
-                       } <jk>else if</jk> (rc != <jsf>SC_OK</jsf>) {
-                               <jk>throw new</jk> IOException(<js>"Unexpected 
HTTP status: "</js> + rc);
-                       }
-               } <jk>finally</jk> {
-                       EntityUtils.<jsm>consume</jsm>(response.getEntity());
-               }
-       }
-
-       <jc>/*
-        * This is needed for Tomcat because it responds with SC_BAD_REQUEST 
when the j_security_check URL is visited before an
-        * authenticated URL has been visited. This same URL must also be 
visited after authenticating with j_security_check
-        * otherwise tomcat will not consider the session authenticated
-        */</jc>
-       <jk>private int</jk> visitAuthenticatedURL(HttpClient httpClient) 
<jk>throws</jk> IOException {
-               HttpGet authenticatedURL = <jk>new</jk> 
HttpGet(<jf>jazzUri</jf>.resolve(<js>"authenticated/identity"</js>));
-               HttpResponse response = httpClient.execute(authenticatedURL);
-               <jk>try</jk> {
-                       <jk>return</jk> 
response.getStatusLine().getStatusCode();
-               } <jk>finally</jk> {
-                       EntityUtils.<jsm>consume</jsm>(response.getEntity());
-               }
-       }
-                       </p>
-               </div>
-               
-               <!-- 
========================================================================================================
 -->
-               <a id="OIDC"></a>
-               <h4 class='topic' onclick='toggle(this)'>1.2.3 - OIDC 
Authentication</h4>
-               <div class='topic'>
-                       <p>
-                               The following example shows how the {@link 
com.ibm.juno.client.jazz.JazzRestClient} class provides
-                               OIDC authentication support.
-                       </p>
-       <p class='bcode'>
-       <jd>/**
-        * Constructor.
-        */</jd>
-       <jk>public</jk> JazzRestClient(URI jazzUri, String user, String pw) 
<jk>throws</jk> IOException {
-               ...
-       }
-
-       <jd>/**
-        * Override the createHttpClient() method to return an authenticated 
client.
-        */</jd>
-       <ja>@Override</ja> <jc>/* RestClient */</jc>
-       <jk>protected</jk> CloseableHttpClient createHttpClient() 
<jk>throws</jk> Exception {
-               CloseableHttpClient client = <jk>super</jk>.createHttpClient();
-               oidcAuthenticate(client);
-                       <jk>return</jk> client;
-               }
-
-       <jk>private void</jk> oidcAuthenticate(HttpClient client) 
<jk>throws</jk> IOException {
-
-               HttpGet request = <jk>new</jk> HttpGet(<jf>jazzUri</jf>);
-               
request.setConfig(RequestConfig.<jsm>custom</jsm>().setRedirectsEnabled(<jk>false</jk>).build());
-               
-               <jc>// Charset must explicitly be set to UTF-8 to handle 
user/pw with non-ascii characters.</jc>
-               request.addHeader(<js>"Content-Type"</js>, 
<js>"application/x-www-form-urlencoded; charset=utf-8"</js>);
-
-               HttpResponse response = client.execute(request);
-               <jk>try</jk> {
-                       <jk>int</jk> code = 
response.getStatusLine().getStatusCode();
-
-                       <jc>// Already authenticated</jc>
-                       <jk>if</jk> (code == <jsf>SC_OK</jsf>)
-                               <jk>return</jk>;
-
-                       <jk>if</jk> (code != <jsf>SC_UNAUTHORIZED</jsf>)
-                               <jk>throw new</jk> 
RestCallException(<js>"Unexpected response during OIDC authentication: "</js> + 
response.getStatusLine());
-
-                       <jc>// x-jsa-authorization-redirect</jc>
-                       String redirectUri = getHeader(response, 
<js>"X-JSA-AUTHORIZATION-REDIRECT"</js>);
-
-                       <jk>if</jk> (redirectUri == <jk>null</jk>)
-                               <jk>throw new</jk> 
RestCallException(<js>"Expected a redirect URI during OIDC authentication: 
"</js> + response.getStatusLine());
-
-                       <jc>// Handle Bearer Challenge</jc>
-                       HttpGet method = <jk>new</jk> HttpGet(redirectUri + 
<js>"&prompt=none"</js>);
-                       addDefaultOidcHeaders(method);
-
-                       response = client.execute(method);
-
-                       code = response.getStatusLine().getStatusCode();
-
-                       <jk>if</jk> (code != <jsf>SC_OK</jsf>)
-                               <jk>throw new</jk> 
RestCallException(<js>"Unexpected response during OIDC authentication phase 2: 
"</js> + response.getStatusLine());
-
-                       String loginRequired = getHeader(response, 
<js>"X-JSA-LOGIN-REQUIRED"</js>);
-
-                       <jk>if</jk> (! <js>"true"</js>.equals(loginRequired))
-                               <jk>throw new</jk> 
RestCallException(<js>"X-JSA-LOGIN-REQUIRED header not found on response during 
OIDC authentication phase 2: "</js> + response.getStatusLine());
-
-                       method = <jk>new</jk> HttpGet(redirectUri + 
<js>"&prompt=none"</js>);
-
-                       addDefaultOidcHeaders(method);
-                       response = client.execute(method);
-
-                       code = response.getStatusLine().getStatusCode();
-
-                       <jk>if</jk> (code != <jsf>SC_OK</jsf>)
-                               <jk>throw new</jk> 
RestCallException(<js>"Unexpected response during OIDC authentication phase 3: 
"</js> + response.getStatusLine());
-
-                       <jc>// Handle JAS Challenge</jc>
-                       method = <jk>new</jk> HttpGet(redirectUri);
-                       addDefaultOidcHeaders(method);
-
-                       response = client.execute(method);
-
-                       code = response.getStatusLine().getStatusCode();
-
-                       <jk>if</jk> (code != <jsf>SC_OK</jsf>)
-                               <jk>throw new</jk> 
RestCallException(<js>"Unexpected response during OIDC authentication phase 4: 
"</js> + response.getStatusLine());
-
-                       <jf>cookie</jf> = getHeader(response, 
<js>"Set-Cookie"</js>);
-
-                       Header[] defaultHeaders = <jk>new</jk> Header[] {
-                               <jk>new</jk> BasicHeader(<js>"User-Agent"</js>, 
<js>"Jazz Native Client"</js>),
-                               <jk>new</jk> 
BasicHeader(<js>"X-com-ibm-team-configuration-versions"</js>, 
<js>"com.ibm.team.rtc=6.0.0,com.ibm.team.jazz.foundation=6.0"</js>),
-                               <jk>new</jk> BasicHeader(<js>"Accept"</js>, 
<js>"text/json"</js>),
-                               <jk>new</jk> 
BasicHeader(<js>"Authorization"</js>, <js>"Basic "</js> + 
StringUtils.<jsm>base64EncodeToString</jsm>(<jf>user</jf> + <js>":"</js> + 
<jf>pw</jf>)),
-                               <jk>new</jk> BasicHeader(<js>"Cookie"</js>, 
cookie)
-       };
-
-                       
setDefaultHeaders(Arrays.<jsm>asList</jsm>(defaultHeaders));
-
-               } <jk>finally</jk> {
-                       EntityUtils.<jsm>consume</jsm>(response.getEntity());
-               }
-       }
-
-       <jk>private void</jk> addDefaultOidcHeaders(HttpRequestBase method) {
-               method.addHeader(<js>"User-Agent"</js>, <js>"Jazz Native 
Client"</js>);
-               
method.addHeader(<js>"X-com-ibm-team-configuration-versions"</js>, 
<js>"com.ibm.team.rtc=6.0.0,com.ibm.team.jazz.foundation=6.0"</js>);
-               method.addHeader(<js>"Accept"</js>, <js>"text/json"</js>);
-
-               <jk>if</jk> (<jf>cookie</jf> != <jk>null</jk>) {
-                       method.addHeader(<js>"Authorization"</js>, <js>"Basic 
"</js> + StringUtils.<jsm>base64EncodeToString</jsm>(<jf>user</jf> + 
<js>":"</js> + <jf>pw</jf>));
-                       method.addHeader(<js>"Cookie"</js>, cookie);
-               }
-       }
-                       </p>    
-               </div>
-       </div>
-
-       <!-- 
========================================================================================================
 -->
-       <a id="ResponsePatterns"></a>
-       <h3 class='topic' onclick='toggle(this)'>1.3 - Using Response 
Patterns</h3>
-       <div class='topic'>
-               <p>
-                       One issue with REST (and HTTP in general) is that the 
HTTP response code must be set as a header before the 
-                       body of the request is sent.  This can be problematic 
when REST calls invoke long-running processes, pipes
-                       the results through the connection, and then fails 
after an HTTP 200 has already been sent.
-               </p>
-               <p>
-                       One common solution is to serialize some text at the 
end to indicate whether the long-running process succeeded (e.g. 
<js>"FAILED"</js> or <js>"SUCCEEDED"</js>).
-               </p>
-               <p>
-                       The {@link com.ibm.juno.client.RestClient} class has 
convenience methods for scanning the response without
-                       interfering with the other methods used for retrieving 
output.  
-               </p>
-               <p>
-                       The following example shows how the {@link 
com.ibm.juno.client.RestCall#successPattern(String)} method can be used
-                       to look for a SUCCESS message in the output:
-               </p>    
-               <h6 class='topic'>Example:</h6>
-               <p class='bcode'>
-       <jc>// Throw a RestCallException if SUCCESS is not found in the 
output.</jc>
-       restClient.doPost(<jsf>URL</jsf>)
-               .successPattern(<js>"SUCCESS"</js>)
-               .run();
-               </p>
-               <p>
-                       The {@link 
com.ibm.juno.client.RestCall#failurePattern(String)} method does the opposite.  
-                       It throws an exception if a failure message is detected.
-               </p>    
-               <h6 class='topic'>Example:</h6>
-               <p class='bcode'>
-       <jc>// Throw a RestCallException if FAILURE or ERROR is found in the 
output.</jc>
-       restClient.doPost(<jsf>URL</jsf>)
-               .failurePattern(<js>"FAILURE|ERROR"</js>)
-               .run();
-               </p>
-               <p>
-                       These convenience methods are specialized methods that 
use the {@link com.ibm.juno.client.RestCall#addResponsePattern(ResponsePattern)}
-                               method which uses regular expression matching 
against the response body.
-                       This method can be used to search for arbitrary 
patterns in the response body.
-               </p>
-               <p>
-                       The following example shows how to use a response 
pattern finder to find and capture patterns for <js>"x=number"</js> and 
<js>"y=string"</js>
-                               from a response body.
-               </p>    
-               <h6 class='topic'>Example:</h6>
-               <p class='bcode'>
-       <jk>final</jk> List&lt;Number&gt; xList = <jk>new</jk> 
ArrayList&lt;Number&gt;();
-       <jk>final</jk> List&lt;String&gt; yList = <jk>new</jk> 
ArrayList&lt;String&gt;();
-       
-       String responseText = restClient.doGet(<jsf>URL</jsf>)
-               .addResponsePattern(
-                       <jk>new</jk> ResponsePattern(<js>"x=(\\d+)"</js>) {
-                               <ja>@Override</ja>
-                               <jk>public void</jk> onMatch(RestCall restCall, 
Matcher m) <jk>throws</jk> RestCallException {
-                                       
xList.add(Integer.<jsm>parseInt</jsm>(m.group(1)));
-                               }
-                               <ja>@Override</ja>
-                               <jk>public void</jk> onNoMatch(RestCall 
restCall) <jk>throws</jk> RestCallException {
-                                       <jk>throw new</jk> 
RestCallException(<js>"No X's found!"</js>);
-                               }
-                       }
-               )
-               .addResponsePattern(
-                       <jk>new</jk> ResponsePattern(<js>"y=(\\S+)"</js>) {
-                               <ja>@Override</ja>
-                               <jk>public void</jk> onMatch(RestCall restCall, 
Matcher m) <jk>throws</jk> RestCallException {
-                                       yList.add(m.group(1));
-                               }
-                               <ja>@Override</ja>
-                               <jk>public void</jk> onNoMatch(RestCall 
restCall) <jk>throws</jk> RestCallException {
-                                       <jk>throw new</jk> 
RestCallException(<js>"No Y's found!"</js>);
-                               }
-                       }
-               )
-               .getResponseAsString();
-               </p>
-               <p>
-                       Using response patterns does not affect the 
functionality of any of the other methods
-                       used to retrieve the response such as {@link 
com.ibm.juno.client.RestCall#getResponseAsString()} or {@link 
com.ibm.juno.client.RestCall#getResponse(Class)}.<br>
-                       HOWEVER, if you want to retrieve the entire text of the 
response from inside the match methods,
-                       use {@link 
com.ibm.juno.client.RestCall#getCapturedResponse()} since this method will not 
absorb the response for those other methods.
-               </p>
-       </div>
-       
-       <!-- 
========================================================================================================
 -->
-       <a id="#PipingOutput"></a>
-       <h3 class='topic' onclick='toggle(this)'>1.4 - Piping Response 
Output</h3>
-       <div class='topic'>
-               <p>
-                       The {@link com.ibm.juno.client.RestCall} class provides 
various convenience <code>pipeTo()</code> methods 
-                       to pipe output to output streams and writers.
-               </p>
-               <p>
-                       If you want to pipe output without any intermediate 
buffering, you can use the {@link com.ibm.juno.client.RestCall#byLines()} 
method.  
-                       This will cause the output to be piped and flushed 
after every line.  
-                       This can be useful if you want to display the results 
in real-time from a long running process producing
-                               output on a REST call.
-               </p>
-               <h6 class='topic'>Example:</h6>
-               <p class='bcode'>
-       <jc>// Pipe output from REST call to System.out in real-time.</jc>
-       restClient.doPost(<jsf>URL</jsf>).byLines().pipeTo(<jk>new</jk> 
PrintWriter(System.<jk>out</jk>)).run();
-               </p>
-       </div>  
-       
-       <!-- 
========================================================================================================
 -->
-       <a id="Logging"></a>
-       <h3 class='topic' onclick='toggle(this)'>1.5 - Logging</h3>
-       <div class='topic'>
-               <p>
-                       Use the {@link 
com.ibm.juno.client.RestClient#logTo(Level,Logger)} and {@link 
com.ibm.juno.client.RestCall#logTo(Level,Logger)} methods
-                       to log HTTP calls.
-                       These methods will cause the HTTP request and response 
headers and body to be logged to the specified logger.  
-               </p>
-               <h6 class='topic'>Example:</h6>
-               <p class='bcode'>
-       <jc>// Log the HTTP request/response to the specified logger.</jc>
-       <jk>int</jk> rc = 
restClient.doGet(<jsf>URL</jsf>).logTo(<jsf>INFO</jsf>, getLogger()).run();
-               </p>
-               <p>
-                       The method call is ignored if the logger level is below 
the specified level.
-               </p>
-               <p>
-                       Customized logging can be handled by subclassing the 
{@link com.ibm.juno.client.RestCallLogger} class and using the 
-                       {@link 
com.ibm.juno.client.RestCall#addInterceptor(RestCallInterceptor)} method.
-               </p>
-       </div>
-       
-       <!-- 
========================================================================================================
 -->
-       <a id="Interceptors"></a>
-       <h3 class='topic' onclick='toggle(this)'>1.6 - Interceptors</h3>
-       <div class='topic'>
-               <p>
-                       The {@link 
com.ibm.juno.client.RestClient#addInterceptor(RestCallInterceptor)} and {@link 
com.ibm.juno.client.RestCall#addInterceptor(RestCallInterceptor)} methods
-                       can be used to intercept responses during specific 
connection lifecycle events.
-               </p>
-               <p>
-                       The {@link com.ibm.juno.client.RestCallLogger} class is 
an example of an interceptor that uses the various lifecycle methods
-                               to log HTTP requests.
-               </p>
-               <p class='bcode'>
-       <jd>/**
-        * Specialized interceptor for logging calls to a log file.
-        */</jd>
-       <jk>public class</jk> RestCallLogger <jk>extends</jk> 
RestCallInterceptor {
-       
-               <jk>private</jk> Level <jf>level</jf>;
-               <jk>private</jk> Logger <jf>log</jf>;
-       
-               <jd>/**
-                * Constructor.
-                *
-                * <ja>@param</ja> level The log level to log messages at.
-                * <ja>@param</ja> log The logger to log to.
-                */</jd>
-               <jk>protected</jk> RestCallLogger(Level level, Logger log) {
-                       <jk>this</jk>.<jf>level</jf> = level;
-                       <jk>this</jk>.<jf>log</jf> = log;
-               }
-       
-               <ja>@Override</ja> <jc>/* RestCallInterceptor */</jc>
-               <jk>public void</jk> onInit(RestCall restCall) {
-                       <jk>if</jk> (<jf>log</jf>.isLoggable(<jf>level</jf>))
-                               restCall.captureResponse();
-               }
-       
-               <ja>@Override</ja> <jc>/* RestCallInterceptor */</jc>
-               <jk>public void</jk> onConnect(RestCall restCall, <jk>int</jk> 
statusCode, HttpRequest req, HttpResponse res) {
-                       <jc>// Do nothing.</jc>
-               }
-       
-               <ja>@Override</ja> <jc>/* RestCallInterceptor */</jc>
-               <jk>public void</jk> onRetry(RestCall restCall, <jk>int</jk> 
statusCode, HttpRequest req, HttpResponse res) {
-                       <jk>if</jk> (<jf>log</jf>.isLoggable(<jf>level</jf>))
-                               <jf>log</jf>.log(level, 
MessageFormat.<jsm>format</jsm>(<js>"Call to {0} returned {1}.  Will 
retry."</js>, req.getRequestLine().getUri(), statusCode)); 
-               }
-       
-               <ja>@Override</ja> <jc>/* RestCallInterceptor */</jc>
-               <jk>public void</jk> onClose(RestCall restCall) <jk>throws</jk> 
RestCallException {
-                       <jk>try</jk> {
-                               <jk>if</jk> 
(<jf>log</jf>.isLoggable(<jf>level</jf>)) {
-                                       String output = 
restCall.getCapturedResponse();
-                                       StringBuilder sb = <jk>new</jk> 
StringBuilder();
-                                       HttpUriRequest req = 
restCall.getRequest();
-                                       HttpResponse res = 
restCall.getResponse();
-                                       <jk>if</jk> (req != <jk>null</jk>) {
-                                               sb.append(<js>"\n=== HTTP Call 
=================================================================="</js>);
-       
-                                               sb.append(<js>"\n=== REQUEST 
===\n"</js>).append(req);
-                                               sb.append(<js>"\n---request 
headers---"</js>);
-                                               <jk>for</jk> (Header h : 
req.getAllHeaders())
-                                                       
sb.append(<js>"\n"</js>).append(h);
-                                               <jk>if</jk> (req 
<jk>instanceof</jk> HttpEntityEnclosingRequestBase) {
-                                                       
sb.append(<js>"\n---request entity---"</js>);
-                                                       
HttpEntityEnclosingRequestBase req2 = (HttpEntityEnclosingRequestBase)req;
-                                                       HttpEntity e = 
req2.getEntity();
-                                                       <jk>if</jk> (e == 
<jk>null</jk>)
-                                                               
sb.append(<js>"\nEntity is null"</js>);
-                                                       <jk>else</jk> {
-                                                               <jk>if</jk> 
(e.getContentType() != <jk>null</jk>)
-                                                                       
sb.append(<js>"\n"</js>).append(e.getContentType());
-                                                               <jk>if</jk> 
(e.getContentEncoding() != <jk>null</jk>)
-                                                                       
sb.append(<js>"\n"</js>).append(e.getContentEncoding());
-                                                               <jk>if</jk> 
(e.isRepeatable()) {
-                                                                       
<jk>try</jk> {
-                                                                               
sb.append(<js>"\n---request 
content---\n"</js>).append(EntityUtils.<jsm>toString</jsm>(e));
-                                                                       } 
<jk>catch</jk> (Exception ex) {
-                                                                               
<jk>throw new</jk> RuntimeException(ex);
-                                                                       }
-                                                               }
-                                                       }
-                                               }
-                                       }
-                                       <jk>if</jk> (res != <jk>null</jk>) {
-                                               sb.append(<js>"\n=== RESPONSE 
===\n"</js>).append(res.getStatusLine());
-                                               sb.append(<js>"\n---response 
headers---"</js>);
-                                               <jk>for</jk> (Header h : 
res.getAllHeaders())
-                                                       
sb.append(<js>"\n"</js>).append(h);
-                                               sb.append(<js>"\n---response 
content---\n"</js>).append(output);
-                                               sb.append(<js>"\n=== END 
========================================================================"</js>);
-                                       }
-                                       <jf>log</jf>.log(<jf>level</jf>, 
sb.toString());
-                               }
-                       } <jk>catch</jk> (IOException e) {
-                               <jf>log</jf>.log(Level.<jsf>SEVERE</jsf>, 
e.getLocalizedMessage(), e);
-                       }
-               }
-       }
-               </p>
-       </div>
-
-       <!-- 
========================================================================================================
 -->
-       <a id="Remoteable"></a>
-       <h3 class='topic' onclick='toggle(this)'>1.7 - Remotable Proxies</h3>
-       <div class='topic'>
-               <p>
-                       Juno provides the capability of calling methods on 
POJOs on a server through client-side proxy interfaces.
-                       It offers a number of advantages over other similar 
remote proxy interfaces, such as being much simpler to 
-                               use and allowing much more flexibility.
-               </p>
-               <p>
-                       Proxy interfaces are retrieved using the {@link 
com.ibm.juno.client.RestClient#getRemoteableProxy(Class)} method.
-                       The {@link 
com.ibm.juno.client.RestClient#setRemoteableServletUri(String)} method is used 
to specify the location
-                               of the remoteable services servlet running on 
the server.
-                       The remoteable servlet is a specialized subclass of 
{@link com.ibm.juno.server.RestServlet} that provides a full-blown
-                               REST interface for calling interfaces remotely. 
-               </p>
-               <p>
-                       In this example, we have the following interface 
defined that we want to call from the client side against
-                               a POJO on the server side (i.e. a Remoteable 
Service)...
-               <p class='bcode'>
-       <jk>public interface</jk> IAddressBook {
-               Person createPerson(CreatePerson cp) <jk>throws</jk> Exception;
-       }
-               </p>                    
-               <p>
-                       The client side code for invoking this method is shown 
below...
-               </p>
-               <p class='bcode'>
-       <jc>// Create a RestClient using JSON for serialization, and point to 
the server-side remoteable servlet.</jc>
-       RestClient client = <jk>new</jk> 
RestClient(JsonSerializer.<jk>class</jk>, JsonParser.<jk>class</jk>)
-               
.setRemoteableServletUri(<js>"https://localhost:9080/juno/sample/remoteable";</js>);
-       
-       <jc>// Create a proxy interface.</jc>
-       IAddressBook ab = 
client.getRemoteableProxy(IAddressBook.<jk>class</jk>);
-       
-       <jc>// Invoke a method on the server side and get the returned 
result.</jc>
-       Person p = ab.createPerson(
-               <jk>new</jk> CreatePerson(<js>"Test Person"</js>,
-                       AddressBook.<jsm>toCalendar</jsm>(<js>"Aug 1, 
1999"</js>),
-                       <jk>new</jk> CreateAddress(<js>"Test street"</js>, 
<js>"Test city"</js>, <js>"Test state"</js>, 12345, <jk>true</jk>))
-       );
-               </p>
-               <p>
-                       The requirements for a method to be callable through a 
remoteable service are:
-                       <ul>
-                               <li>The method must be public.
-                               <li>The parameter and return types must be <a 
href='../../../../com/ibm/juno/core/package-summary.html#PojoCategories'><u>serializable
 and parsable</u></a>.
-                       </ul>
-               </p>
-               <p>
-                       One significant feature is that the remoteable services 
servlet is a full-blown REST interface.  
-                       Therefore, in cases where the interface classes are not 
available on the client side,
-                               the same method calls can be made through pure 
REST calls.  
-                       This can also aid significantly in debugging since 
calls to the remoteable service
-                               can be called directly from a browser with no 
code involved.
-               </p>
-               <p>
-                       See {@link com.ibm.juno.server.remoteable} for more 
information.
-               </p> 
-       </div>
-
-       <!-- 
========================================================================================================
 -->
-       <a id="Other"></a>
-       <h3 class='topic' onclick='toggle(this)'>1.8 - Other Useful Methods</h3>
-       <div class='topic'>
-               <p>
-                       The {@link 
com.ibm.juno.client.RestClient#setRootUrl(String)} method can be used to 
specify a root URL on 
-                               all requests so that you don't have to use 
absolute paths on individual calls.
-               </p>
-               <p class='bcode'>
-       <jc>// Create a rest client with a root URL</jc>
-       RestClient rc = <jk>new</jk> 
RestClient().setRootUrl(<js>"http://localhost:9080/foobar";</js>);
-       String r = rc.doGet(<js>"/baz"</js>).getResponseAsString();  <jc>// 
Gets "http://localhost:9080/foobar/baz";</jc>
-               </p>
-               <p>
-                       The {@link 
com.ibm.juno.client.RestClient#setProperty(String,Object)} method can be used 
to set serializer
-                       and parser properties.
-                       For example, if you're parsing a response into POJOs 
and you want to ignore fields that aren't on the
-                       POJOs, you can use the {@link 
com.ibm.juno.core.BeanContextProperties#BEAN_ignoreUnknownBeanProperties} 
property.
-               </p>
-               <p class='bcode'>
-       <jc>// Create a rest client that ignores unknown fields in the 
response</jc>
-       RestClient rc = <jk>new</jk> RestClient(JsonSerializer.<jk>class</jk>, 
JsonParser.<jk>class</jk>)
-               .setProperty(<jsf>BEAN_ignoreUnknownBeanProperties</jsf>, 
<jk>true</jk>);
-       MyPojo myPojo = 
rc.doGet(<jsf>URL</jsf>).getResponse(MyPojo.<jk>class</jk>);
-               </p>
-               <p>
-                       The {@link 
com.ibm.juno.client.RestCall#setRetryable(int,long,RetryOn)} method can be used 
to automatically
-                               retry requests on failures.
-                       This can be particularly useful if you're attempting to 
connect to a REST resource that may be in
-                               the process of still initializing.
-               </p>
-               <p class='bcode'>
-       <jc>// Create a rest call that retries every 10 seconds for up to 30 
minutes as long as a connection fails
-       // or a 400+ is received.</jc>
-       restClient.doGet(<jsf>URL</jsf>)
-               .setRetryable(180, 10000, RetryOn.<jsf>DEFAULT</jsf>)
-               .run();
-       </p>
-       </div>
-</div>
-</body>
-</html>
\ No newline at end of file


Reply via email to