[infinispan-dev] jclouds wire logging examples

Hi, guys. I'm polishing up jclouds for release. I'd like some feedback on logging, especially as relates to integration with other libraries. In this case, I'm referring to wire logging, where we trace the inputs and outputs to the cloud service into a separate log file. Wire logging is extremely important when troubleshooting with cloud vendors, as they can read the stacks without knowing java. Wire logging is course optional, and removes redundant content logging from other parts of the code. The design is largely borrowed from apache hc wire logging. It differs in implementation, where we make it asynchronous and portable across http engines. In other words, java, nio, and whatever engines we come up with next will have identical output like below [1]. This specific logging is controlled by categories jclouds.http.headers (for headers) and jclouds.http.wire (for content). Note that these are not org.jclouds categories on purpose, so as to avoid accidentally turning them on with wildcards. Please let me know what you think. Cheers, -Adrian [1] 2009-10-10 00:44:37,566 DEBUG [jclouds.http.headers] (pool-1-thread-2) >> POST https://node1.nirvanix.com/Upload.ashx?output=json&uploadToken=40Z0PF... rPath=container&sessionToken=61b0ca55-3782-44f8-bdf1-177a9d118d28 HTTP/1.1 2009-10-10 00:44:37,566 DEBUG [jclouds.http.headers] (pool-1-thread-2) >> Content-Length: 141 2009-10-10 00:44:37,566 DEBUG [jclouds.http.headers] (pool-1-thread-2) >> Content-Type: multipart/form-data; boundary=--JCLOUDS-- 2009-10-10 00:44:37,751 DEBUG [jclouds.http.wire] (pool-1-thread-1) >> "----JCLOUDS--[\r][\n]" 2009-10-10 00:44:37,751 DEBUG [jclouds.http.wire] (pool-1-thread-1) >> "Content-Disposition: form-data; name="key"; filename="key"[\r][\n]" 2009-10-10 00:44:37,751 DEBUG [jclouds.http.wire] (pool-1-thread-1) >> "Content-Type: application/octet-stream[\r][\n]" 2009-10-10 00:44:37,751 DEBUG [jclouds.http.wire] (pool-1-thread-1) >> "[\r][\n]" 2009-10-10 00:44:37,751 DEBUG [jclouds.http.wire] (pool-1-thread-1) >> "value[\r][\n]" 2009-10-10 00:44:37,751 DEBUG [jclouds.http.wire] (pool-1-thread-1) >> "----JCLOUDS----[\r][\n]" 2009-10-10 00:44:37,926 DEBUG [jclouds.http.headers] (pool-1-thread-2) << HTTP/1.1 200 OK 2009-10-10 00:44:37,926 DEBUG [jclouds.http.headers] (pool-1-thread-2) << Content-Length: 152 2009-10-10 00:44:37,926 DEBUG [jclouds.http.headers] (pool-1-thread-2) << X-Powered-By: Nirvanix SDN 2009-10-10 00:44:37,926 DEBUG [jclouds.http.headers] (pool-1-thread-2) << X-Powered-By: ASP.NET 2009-10-10 00:44:37,926 DEBUG [jclouds.http.headers] (pool-1-thread-2) << Expires: -1 2009-10-10 00:44:37,926 DEBUG [jclouds.http.headers] (pool-1-thread-2) << X-AspNet-Version: 2.0.50727 2009-10-10 00:44:37,927 DEBUG [jclouds.http.headers] (pool-1-thread-2) << Date: Sat, 10 Oct 2009 07:46:25 GMT 2009-10-10 00:44:37,927 DEBUG [jclouds.http.headers] (pool-1-thread-2) << Pragma: no-cache 2009-10-10 00:44:37,927 DEBUG [jclouds.http.headers] (pool-1-thread-2) << Content-Type: text/xml; charset=utf-8 2009-10-10 00:44:37,927 DEBUG [jclouds.http.headers] (pool-1-thread-2) << Server: Nirvanix IMFS 2009-10-10 00:44:37,927 DEBUG [jclouds.http.headers] (pool-1-thread-2) << Server: Microsoft-IIS/6.0 2009-10-10 00:44:37,927 DEBUG [jclouds.http.headers] (pool-1-thread-2) << Cache-Control: no-cache