CachedPackUriProvider.java

  1. /*
  2.  * Copyright (C) 2019, Google LLC.
  3.  * and other copyright owners as documented in the project's IP log.
  4.  *
  5.  * This program and the accompanying materials are made available
  6.  * under the terms of the Eclipse Distribution License v1.0 which
  7.  * accompanies this distribution, is reproduced below, and is
  8.  * available at http://www.eclipse.org/org/documents/edl-v10.php
  9.  *
  10.  * All rights reserved.
  11.  *
  12.  * Redistribution and use in source and binary forms, with or
  13.  * without modification, are permitted provided that the following
  14.  * conditions are met:
  15.  *
  16.  * - Redistributions of source code must retain the above copyright
  17.  *   notice, this list of conditions and the following disclaimer.
  18.  *
  19.  * - Redistributions in binary form must reproduce the above
  20.  *   copyright notice, this list of conditions and the following
  21.  *   disclaimer in the documentation and/or other materials provided
  22.  *   with the distribution.
  23.  *
  24.  * - Neither the name of the Eclipse Foundation, Inc. nor the
  25.  *   names of its contributors may be used to endorse or promote
  26.  *   products derived from this software without specific prior
  27.  *   written permission.
  28.  *
  29.  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
  30.  * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
  31.  * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  32.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  33.  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
  34.  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  35.  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  36.  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  37.  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  38.  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  39.  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  40.  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
  41.  * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  42.  */
  43. package org.eclipse.jgit.internal.storage.pack;

  44. import java.io.IOException;
  45. import java.util.Collection;
  46. import org.eclipse.jgit.annotations.Nullable;

  47. /**
  48.  * Provider of URIs corresponding to cached packs. For use with the
  49.  * "packfile-uris" feature.
  50.  * @since 5.5
  51.  */
  52. public interface CachedPackUriProvider {

  53.     /**
  54.      * @param pack the cached pack for which to check if a corresponding URI
  55.      *  exists
  56.      * @param protocolsSupported the protocols that the client has declared
  57.      *  support for; if a URI is returned, it must be of one of these
  58.      *  protocols
  59.      * @throws IOException implementations may throw this
  60.      * @return if a URI corresponds to the cached pack, an object
  61.      *  containing the URI and some other information; null otherwise
  62.      * @since 5.5
  63.      */
  64.     @Nullable
  65.     PackInfo getInfo(CachedPack pack, Collection<String> protocolsSupported)
  66.         throws IOException;

  67.     /**
  68.      * Information about a packfile.
  69.      * @since 5.5
  70.      */
  71.     public static class PackInfo {
  72.         private final String hash;
  73.         private final String uri;

  74.         /**
  75.          * Constructs an object containing information about a packfile.
  76.          * @param hash the hash of the packfile as a hexadecimal string
  77.          * @param uri the URI corresponding to the packfile
  78.          */
  79.         public PackInfo(String hash, String uri) {
  80.             this.hash = hash;
  81.             this.uri = uri;
  82.         }

  83.         /**
  84.          * @return the hash of the packfile as a hexadecimal string
  85.          */
  86.         public String getHash() {
  87.             return hash;
  88.         }

  89.         /**
  90.          * @return the URI corresponding to the packfile
  91.          */
  92.         public String getUri() {
  93.             return uri;
  94.         }
  95.     }
  96. }