Merge pull request #229 from gmessner/feature/228-add-request-response-logging

Add request and response logging

Author: jgoldhammer

README.md

@@ -11,7 +11,7 @@ To utilize the GitLab API for Java in your project, simply add the following dep
 ```java
 dependencies {
     ...
-    compile group: 'org.gitlab4j', name: 'gitlab4j-api', version: '4.8.38'
+    compile group: 'org.gitlab4j', name: 'gitlab4j-api', version: '4.8.39'
 }
 ```
 
@@ -20,7 +20,7 @@ dependencies {
 <dependency>
     <groupId>org.gitlab4j</groupId>
     <artifactId>gitlab4j-api</artifactId>
-    <version>4.8.38</version>
+    <version>4.8.39</version>
 </dependency>
 ```
 
@@ -96,6 +96,23 @@ GitLabApi gitLabApi = new GitLabApi(ApiVersion.V3, "http://your.gitlab.server.co
 As of GitLab 11.0 support for the GitLab API v3 has been removed (see https://about.gitlab.com/2018/06/01/api-v3-removal-impending/). Support for GitLab API v3 will be removed from this library in January 2019. If you are utilizing the v3 support, please update your code before January 2019.
 
 
+---
+## Logging of API Requests and Responses
+As of GitLab4J-API 4.8.39 support has been added to log the requests to and the responses from the
+GitLab API.  Enable logging using one of the following methods on the GitLabApi instance:
+```java
+GitLabApi gitLabApi = new GitLabApi("http://your.gitlab.server.com", "YOUR_PRIVATE_TOKEN");
+
+// Log using the shared logger and default level of FINE
+gitLabApi.enableRequestResponseLogging();
+
+// Log using the shared logger and the INFO level
+gitLabApi.enableRequestResponseLogging(java.util.logging.Level.INFO);
+
+// Log using the specified logger and the INFO level
+gitLabApi.enableRequestResponseLogging(youtLoggerInstance, java.util.logging.Level.INFO);
+```
+
 ---
 ## Results Paging
 GitLab4J-API provides an easy to use paging mechanism to page through lists of results from the GitLab API.

pom.xml

@@ -46,6 +46,7 @@
 		<junit.version>4.12</junit.version>
 		<mockito.version>2.19.0</mockito.version>
 		<hamcrest.version>1.3</hamcrest.version>
+		<systemRules.version>1.18.0</systemRules.version>
 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 		<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
 	</properties>
@@ -258,6 +259,12 @@
 			<version>${hamcrest.version}</version>
 			<scope>test</scope>
 		</dependency>
+		<dependency>
+			<groupId>com.github.stefanbirkner</groupId>
+			<artifactId>system-rules</artifactId>
+			<version>${systemRules.version}</version>
+			<scope>test</scope>
+		</dependency>
 	</dependencies>
 
 </project>

src/main/java/org/gitlab4j/api/GitLabApi.java

@@ -4,6 +4,7 @@
 import java.util.Map;
 import java.util.Optional;
 import java.util.WeakHashMap;
+import java.util.logging.Level;
 import java.util.logging.Logger;
 
 import javax.ws.rs.core.MediaType;
@@ -23,7 +24,7 @@
  */
 public class GitLabApi {
 
-    private final static Logger LOG = Logger.getLogger(GitLabApi.class.getName());
+    private final static Logger LOGGER = Logger.getLogger(GitLabApi.class.getName());
 
     /** GitLab4J default per page.  GitLab will ignore anything over 100. */
     public static final int DEFAULT_PER_PAGE = 100;
@@ -85,7 +86,7 @@ public String getApiNamespace() {
      * @return the GitLab4J shared Logger instance
      */
     public static final Logger getLogger() {
-        return (LOG);
+        return (LOGGER);
     }
 
     /**
@@ -638,6 +639,69 @@ public GitLabApi(ApiVersion apiVersion, String hostUrl, TokenType tokenType, Str
         apiClient = new GitLabApiClient(apiVersion, hostUrl, tokenType, authToken, secretToken, clientConfigProperties);
     }
 
+    /**
+     * Enable the logging of the requests to and the responses from the GitLab server API
+     * using the GitLab4J shared Logger instance and Level.FINE as the level.
+     *
+     * @return this GitLabApi instance
+     */
+    public GitLabApi withRequestResponseLogging() {
+        enableRequestResponseLogging();
+        return (this);
+    }
+
+    /**
+     * Enable the logging of the requests to and the responses from the GitLab server API
+     * using the GitLab4J shared Logger instance.
+     *
+     * @param level the logging level (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST)
+     * @return this GitLabApi instance
+     */
+    public GitLabApi withRequestResponseLogging(Level level) {
+        enableRequestResponseLogging(level);
+        return (this);
+    }
+
+    /**
+     * Enable the logging of the requests to and the responses from the GitLab server API.
+     *
+     * @param logger the Logger instance to log to
+     * @param level the logging level (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST)
+     * @return this GitLabApi instance
+     */
+    public GitLabApi withRequestResponseLogging(Logger logger, Level level) {
+        enableRequestResponseLogging(logger, level);
+        return (this);
+    }
+
+    /**
+     * Enable the logging of the requests to and the responses from the GitLab server API
+     * using the GitLab4J shared Logger instance and Level.FINE as the level.
+     */
+    public void enableRequestResponseLogging() {
+        enableRequestResponseLogging(LOGGER, Level.FINE);
+    }
+
+    /**
+     * Enable the logging of the requests to and the responses from the GitLab server API
+     * using the GitLab4J shared Logger instance.
+     *
+     * @param level the logging level (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST)
+     */
+    public void enableRequestResponseLogging(Level level) {
+        enableRequestResponseLogging(LOGGER, level);
+    }
+
+    /**
+     * Enable the logging of the requests to and the responses from the GitLab server API.
+     *
+     * @param logger the Logger instance to log to
+     * @param level the logging level (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST)
+     */
+    public void enableRequestResponseLogging(Logger logger, Level level) {
+        this.apiClient.enableRequestResponseLogging(logger, level);
+    }
+
     /**
      * Sets up all future calls to the GitLab API to be done as another user specified by sudoAsUsername.
      * To revert back to normal non-sudo operation you must call unsudo(), or pass null as the username.
@@ -1413,5 +1477,4 @@ public WikisApi getWikisApi() {
 
         return wikisApi;
     }
-
 }

src/main/java/org/gitlab4j/api/GitLabApiClient.java

@@ -12,6 +12,8 @@
 import java.security.cert.X509Certificate;
 import java.util.List;
 import java.util.Map;
+import java.util.logging.Level;
+import java.util.logging.Logger;
 
 import javax.net.ssl.HostnameVerifier;
 import javax.net.ssl.SSLContext;
@@ -36,6 +38,7 @@
 import org.glassfish.jersey.apache.connector.ApacheConnectorProvider;
 import org.glassfish.jersey.client.ClientConfig;
 import org.glassfish.jersey.client.ClientProperties;
+import org.glassfish.jersey.logging.LoggingFeature;
 import org.glassfish.jersey.media.multipart.FormDataMultiPart;
 import org.glassfish.jersey.media.multipart.MultiPart;
 import org.glassfish.jersey.media.multipart.MultiPartFeature;
@@ -237,6 +240,24 @@ public GitLabApiClient(ApiVersion apiVersion, String hostUrl, TokenType tokenTyp
         clientConfig.register(MultiPartFeature.class);
     }
 
+    /**
+     * Enable the logging of the requests to and the responses from the GitLab server API.
+     *
+     * @param logger the Logger instance to log to
+     * @param level the logging level (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST)
+     */
+    void enableRequestResponseLogging(Logger logger, Level level) {
+
+        LoggingFeature loggingFeature = new LoggingFeature(
+            logger, level, LoggingFeature.Verbosity.PAYLOAD_TEXT, LoggingFeature.DEFAULT_MAX_ENTITY_SIZE);
+        clientConfig.register(loggingFeature);
+
+        // Recreate the Client instance if already created.
+        if (apiClient != null) {
+            createApiClient();
+        }
+    }
+
     /**
      * Get the auth token being used by this client.
      *
@@ -629,18 +650,22 @@ protected Invocation.Builder invocation(URL url, MultivaluedMap<String, String>
         return (invocation(url, queryParams, MediaType.APPLICATION_JSON));
     }
 
+    protected Client createApiClient() {
+
+        ClientBuilder clientBuilder = ClientBuilder.newBuilder().withConfig(clientConfig);
+
+        if (ignoreCertificateErrors) {
+            clientBuilder.sslContext(openSslContext).hostnameVerifier(openHostnameVerifier);
+        }
+
+        apiClient = clientBuilder.build();
+        return (apiClient);
+    }
+
     protected Invocation.Builder invocation(URL url, MultivaluedMap<String, String> queryParams, String accept) {
 
         if (apiClient == null) {
-            if (ignoreCertificateErrors) {
-                apiClient = ClientBuilder.newBuilder()
-                        .withConfig(clientConfig)
-                        .sslContext(openSslContext)
-                        .hostnameVerifier(openHostnameVerifier)
-                        .build();
-            } else {
-                apiClient = ClientBuilder.newBuilder().withConfig(clientConfig).build();
-            }
+            createApiClient();
         }
 
         WebTarget target = apiClient.target(url.toExternalForm()).property(ClientProperties.FOLLOW_REDIRECTS, true);

src/main/java/org/gitlab4j/api/systemhooks/SystemHookManager.java

@@ -9,6 +9,7 @@
 
 import javax.servlet.http.HttpServletRequest;
 
+import org.gitlab4j.api.GitLabApi;
 import org.gitlab4j.api.GitLabApiException;
 import org.gitlab4j.api.HookManager;
 import org.gitlab4j.api.utils.HttpRequestUtils;
@@ -21,7 +22,7 @@ public class SystemHookManager extends HookManager {
 
     public static final String SYSTEM_HOOK_EVENT = "System Hook";
 
-    private final static Logger LOG = Logger.getLogger(SystemHookManager.class.getName());
+    private final static Logger LOGGER = GitLabApi.getLogger();
     private final JacksonJson jacksonJson = new JacksonJson();
 
     // Collection of objects listening for System Hook events.
@@ -55,27 +56,27 @@ public void handleEvent(HttpServletRequest request) throws GitLabApiException {
 
         if (!isValidSecretToken(request)) {
             String message = "X-Gitlab-Token mismatch!";
-            LOG.warning(message);
+            LOGGER.warning(message);
             throw new GitLabApiException(message);
         }
 
         String eventName = request.getHeader("X-Gitlab-Event");
-        LOG.info("handleEvent: X-Gitlab-Event=" + eventName);
+        LOGGER.info("handleEvent: X-Gitlab-Event=" + eventName);
         if (!SYSTEM_HOOK_EVENT.equals(eventName)) {
             String message = "Unsupported X-Gitlab-Event, event Name=" + eventName;
-            LOG.warning(message);
+            LOGGER.warning(message);
             throw new GitLabApiException(message);
         }
 
         try {
 
             SystemHookEvent event;
-            if (LOG.isLoggable(Level.FINE)) {
-                LOG.fine(HttpRequestUtils.getShortRequestDump("System Hook", true, request));
+            if (LOGGER.isLoggable(Level.FINE)) {
+                LOGGER.fine(HttpRequestUtils.getShortRequestDump("System Hook", true, request));
                 String postData = HttpRequestUtils.getPostDataAsString(request);
-                LOG.fine("Raw POST data:\n" + postData);
+                LOGGER.fine("Raw POST data:\n" + postData);
                 event = jacksonJson.unmarshal(SystemHookEvent.class, postData);
-                LOG.fine(event.getEventName() + "\n" + jacksonJson.marshal(event) + "\n");
+                LOGGER.fine(event.getEventName() + "\n" + jacksonJson.marshal(event) + "\n");
             } else {
                 InputStreamReader reader = new InputStreamReader(request.getInputStream());
                 event = jacksonJson.unmarshal(SystemHookEvent.class, reader);
@@ -84,7 +85,7 @@ public void handleEvent(HttpServletRequest request) throws GitLabApiException {
             fireEvent(event);
 
         } catch (Exception e) {
-            LOG.warning("Error processing JSON data, exception=" +
+            LOGGER.warning("Error processing JSON data, exception=" +
                     e.getClass().getSimpleName() + ", error=" + e.getMessage());
             throw new GitLabApiException(e);
         }
@@ -98,10 +99,10 @@ public void handleEvent(HttpServletRequest request) throws GitLabApiException {
      */
     public void handleEvent(SystemHookEvent event) throws GitLabApiException {
         if (event != null) {
-            LOG.info("handleEvent:" + event.getClass().getSimpleName() + ", eventName=" + event.getEventName());
+            LOGGER.info("handleEvent:" + event.getClass().getSimpleName() + ", eventName=" + event.getEventName());
             fireEvent(event);
         } else {
-            LOG.warning("handleEvent: provided event cannot be null!");
+            LOGGER.warning("handleEvent: provided event cannot be null!");
         }
     }
 
@@ -154,7 +155,7 @@ public void fireEvent(SystemHookEvent event) throws GitLabApiException {
             fireRepositoryEvent((RepositorySystemHookEvent) event);
         } else {
             String message = "Unsupported event, event_named=" + event.getEventName();
-            LOG.warning(message);
+            LOGGER.warning(message);
             throw new GitLabApiException(message);
         }
     }