Coverage Report - com.jcabi.github.Bulk
 
Classes in this File Line Coverage Branch Coverage Complexity
Bulk
84%
11/13
14%
2/14
2.2
Bulk$1
100%
5/5
N/A
N/A
2.2
Bulk$1$1
60%
6/10
100%
2/2
2.2
 
 1   
 /**
 2   
  * Copyright (c) 2013-2017, jcabi.com
 3   
  * All rights reserved.
 4   
  *
 5   
  * Redistribution and use in source and binary forms, with or without
 6   
  * modification, are permitted provided that the following conditions
 7   
  * are met: 1) Redistributions of source code must retain the above
 8   
  * copyright notice, this list of conditions and the following
 9   
  * disclaimer. 2) Redistributions in binary form must reproduce the above
 10   
  * copyright notice, this list of conditions and the following
 11   
  * disclaimer in the documentation and/or other materials provided
 12   
  * with the distribution. 3) Neither the name of the jcabi.com nor
 13   
  * the names of its contributors may be used to endorse or promote
 14   
  * products derived from this software without specific prior written
 15   
  * permission.
 16   
  *
 17   
  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 18   
  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
 19   
  * NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 20   
  * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
 21   
  * THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
 22   
  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 23   
  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 24   
  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 25   
  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 26   
  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 27   
  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 28   
  * OF THE POSSIBILITY OF SUCH DAMAGE.
 29   
  */
 30   
 package com.jcabi.github;
 31   
 
 32   
 import java.lang.reflect.InvocationHandler;
 33   
 import java.lang.reflect.InvocationTargetException;
 34   
 import java.lang.reflect.Method;
 35   
 import java.lang.reflect.Proxy;
 36   
 import java.util.Iterator;
 37   
 import javax.json.JsonObject;
 38   
 import lombok.EqualsAndHashCode;
 39   
 
 40   
 /**
 41   
  * Bulk items, with pre-saved JSON.
 42   
  *
 43   
  * <p>This class should be used as a decorator for object obtained
 44   
  * from Github, when you want to keep their JSON values in memory. For
 45   
  * example:
 46   
  *
 47   
  * <pre> Iterable&lt;Issue&gt; issues = repo.issues().iterate(
 48   
  *   new HashMap&lt;String, String&gt;()
 49   
  * );
 50   
  * for (Issue issue : issues) {
 51   
  *   System.out.println(new Issue.Smart(issue).title());
 52   
  * }</pre>
 53   
  *
 54   
  * <p>Let's say, there are 50 issues in Github's repo. This code will
 55   
  * make 52 HTTP requests to Github. The first one will fetch the first
 56   
  * 30 issues in JSON array. Then, for every one of them, in order
 57   
  * to retrieve issue title a separate HTTP request will be made. Then,
 58   
  * one more page will be fetched, with 20 issues. And again, 20 new
 59   
  * HTTP requests to get their titles.
 60   
  *
 61   
  * <p>Class {@code Bulk} helps us to reduce the amount of this extra work:
 62   
  *
 63   
  * <pre> Iterable&lt;Issue&gt; issues = new Bulk&lt;Issue&gt;(
 64   
  *   repo.issues().iterate(
 65   
  *     new HashMap&lt;String, String&gt;()
 66   
  *   )
 67   
  * );</pre>
 68   
  *
 69   
  * <p>Now, there will be just two HTTP requests.
 70   
  *
 71   
  * @author Yegor Bugayenko (yegor@tpc2.com)
 72   
  * @version $Id: 6db3339b902ff2aaa71820c94cb3c701141bec7b $
 73   
  * @since 0.4
 74   
  * @param <T> Type of iterable objects
 75   
  * @see <a href="http://developer.github.com/v3/#pagination">Pagination</a>
 76   
  */
 77  0 
 @EqualsAndHashCode(of = "origin")
 78   
 public final class Bulk<T extends JsonReadable> implements Iterable<T> {
 79   
 
 80   
     /**
 81   
      * Original iterable.
 82   
      */
 83   
     private final transient Iterable<T> origin;
 84   
 
 85   
     /**
 86   
      * Public ctor.
 87   
      * @param items Items original
 88   
      * @checkstyle AnonInnerLength (50 lines)
 89   
      */
 90   
     @SuppressWarnings("unchecked")
 91  2 
     public Bulk(final Iterable<T> items) {
 92  2 
         if (items instanceof RtPagination) {
 93  1 
             final RtPagination<T> page = RtPagination.class.cast(items);
 94  1 
             final RtValuePagination.Mapping<T, JsonObject> mapping =
 95  1 
                 page.mapping();
 96  1 
             this.origin = new RtPagination<T>(
 97  1 
                 page.request(),
 98  2 
                 new RtValuePagination.Mapping<T, JsonObject>() {
 99   
                     @Override
 100   
                     public T map(final JsonObject object) {
 101  1 
                         final T item = mapping.map(object);
 102  1 
                         return (T) Proxy.newProxyInstance(
 103  1 
                             Thread.currentThread().getContextClassLoader(),
 104  1 
                             item.getClass().getInterfaces(),
 105  1 
                             new InvocationHandler() {
 106   
                                 @Override
 107   
                                 @SuppressWarnings("PMD.UseVarargs")
 108   
                                 public Object invoke(final Object proxy,
 109   
                                     final Method method, final Object[] args) {
 110   
                                     final Object result;
 111  2 
                                     if ("json".equals(method.getName())) {
 112  1 
                                         result = object;
 113   
                                     } else {
 114   
                                         try {
 115  1 
                                             result = method.invoke(item, args);
 116  0 
                                         } catch (
 117   
                                             final IllegalAccessException ex
 118   
                                         ) {
 119  0 
                                             throw new IllegalStateException(ex);
 120  0 
                                         } catch (
 121   
                                             final InvocationTargetException ex
 122   
                                         ) {
 123  0 
                                             throw new IllegalStateException(ex);
 124  1 
                                         }
 125   
                                     }
 126  2 
                                     return result;
 127   
                                 }
 128   
                             }
 129   
                         );
 130   
                     }
 131   
                 }
 132   
             );
 133  1 
         } else {
 134  1 
             this.origin = items;
 135   
         }
 136  2 
     }
 137   
 
 138   
     @Override
 139   
     public String toString() {
 140  0 
         return this.origin.toString();
 141   
     }
 142   
 
 143   
     @Override
 144   
     public Iterator<T> iterator() {
 145  2 
         return this.origin.iterator();
 146   
     }
 147   
 
 148   
 }
Report generated by Cobertura 2.1.1 on 6/20/18 11:26 AM.