package com.atlassian.marketplace.client.api;
   
   import com.atlassian.fugue.Either;
   import com.atlassian.fugue.Option;
   
   import static com.atlassian.fugue.Option.some;
   
   /**
    * Encapsulates parameters that can be passed to {@link Addons#getVersion}.
   * @since 2.0.0
   */
  public final class AddonVersionSpecifier
  {
      private final Option<Either<String, Integer>> nameOrBuild;
      
      private AddonVersionSpecifier(Option<Either<String, Integer>> nameOrBuild)
      {
          this.nameOrBuild = nameOrBuild;
      }
      
      /**
       * Searches for an add-on version by build number.
       */
      public static AddonVersionSpecifier buildNumber(int buildNumber)
      {
          return new AddonVersionSpecifier(some(Either.<String, Integer>right(buildNumber)));
      }
      
      /**
       * Searches for an add-on version by name (version string, e.g. "1.0.0").
       */
      public static AddonVersionSpecifier versionName(String name)
      {
          return new AddonVersionSpecifier(some(Either.<String, Integer>left(name))); 
      }
      
      /**
       * Searches for the latest version (which may be constrained by criteria such as compatibility
       * if specified with {@link AddonVersionsQuery}).
       */
      public static AddonVersionSpecifier latest()
      {
          return new AddonVersionSpecifier(Option.<Either<String, Integer>>none());
      }
      
      /**
       * Used internally to access the previously set details of the specifier.  
       */
      public Option<Either<String, Integer>> getSpecifiedVersion()
      {
          return nameOrBuild;
      }
      
      @Override
      public String toString()
      {
          for (Either<String, Integer> vob: nameOrBuild)
          {
              for (Integer b: vob.right())
              {
                  return "buildNumber(" + b + ")";
              }
              for (String n: vob.left())
              {
                  return "name(" + n + ")";
              }
          }
          return "latest";
      }
      
      @Override
      public boolean equals(Object other)
      {
          return (other instanceof AddonVersionSpecifier) && ((AddonVersionSpecifier) other).nameOrBuild.equals(this.nameOrBuild);
      }
      
      @Override
      public int hashCode()
      {
          return nameOrBuild.hashCode();
      }
  }