Class RefList.Builder<T extends Ref>

java.lang.Object
org.eclipse.jgit.util.RefList.Builder<T>
Type Parameters:
T - type of reference being stored.
Enclosing class:
RefList<T extends Ref>

public static class RefList.Builder<T extends Ref> extends Object
Builder to facilitate fast construction of an immutable RefList.
  • Constructor Summary

    Constructors
    Constructor
    Description
    Create an empty list ready for items to be added.
    Builder(int capacity)
    Create an empty list with at least the specified capacity.
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    add(T ref)
    Add the reference to the end of the array.
    void
    addAll(Ref[] src, int off, int cnt)
    Add all items from a source array.
    void
    Add all items from another builder.
    get(int idx)
    Get the reference at a particular index.
    void
    remove(int idx)
    Remove an item at a specific index.
    void
    set(int idx, T ref)
    Replace a single existing element.
    int
    Get size
    void
    Sort the list's backing array in-place.
    Get unmodifiable list based on this list
     

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Constructor Details

    • Builder

      public Builder()
      Create an empty list ready for items to be added.
    • Builder

      public Builder(int capacity)
      Create an empty list with at least the specified capacity.
      Parameters:
      capacity - the new capacity; if zero or negative, behavior is the same as Builder().
  • Method Details

    • size

      public int size()
      Get size
      Returns:
      number of items in this builder's internal collection.
    • get

      public T get(int idx)
      Get the reference at a particular index.
      Parameters:
      idx - the index to obtain. Must be 0 <= idx < size().
      Returns:
      the reference value, never null.
    • remove

      public void remove(int idx)
      Remove an item at a specific index.
      Parameters:
      idx - position to remove the item from.
    • add

      public void add(T ref)
      Add the reference to the end of the array.

      References must be added in sort order, or the array must be sorted after additions are complete using sort().

      Parameters:
      ref - reference to add
    • addAll

      public void addAll(RefList.Builder other)
      Add all items from another builder.
      Parameters:
      other - another builder
      Since:
      5.4
    • addAll

      public void addAll(Ref[] src, int off, int cnt)
      Add all items from a source array.

      References must be added in sort order, or the array must be sorted after additions are complete using sort().

      Parameters:
      src - the source array.
      off - position within src to start copying from.
      cnt - number of items to copy from src.
    • set

      public void set(int idx, T ref)
      Replace a single existing element.
      Parameters:
      idx - index, must have already been added previously.
      ref - the new reference.
    • sort

      public void sort()
      Sort the list's backing array in-place.
    • toRefList

      public RefList<T> toRefList()
      Get unmodifiable list based on this list
      Returns:
      an unmodifiable list using this collection's backing array.
    • toString

      public String toString()
      Overrides:
      toString in class Object