buildSrc/src/main/java/cc/squirreljme/plugin/multivm/ProjectAndTaskName.java

   1 // -*- Mode: Java; indent-tabs-mode: t; tab-width: 4 -*-
   2 // ---------------------------------------------------------------------------
   3 // SquirrelJME
   4 //     Copyright (C) Stephanie Gawroriski <xer@multiphasicapps.net>
   5 // ---------------------------------------------------------------------------
   6 // SquirrelJME is under the GNU General Public License v3+, or later.
   7 // See license.mkd for licensing and copyright information.
   8 // ---------------------------------------------------------------------------
   9
  10 package cc.squirreljme.plugin.multivm;
  11
  12 import org.gradle.api.Project;
  13 import org.gradle.api.Task;
  14
  15 /**
  16  * This holds the name of a project and task and is used for storing them
  17  * for resolution as needed.
  18  *
  19  * This class is immutable.
  20  *
  21  * @since 2020/08/15
  22  */
  23 public final class ProjectAndTaskName
  24 {
  25         /** The project name. */
  26         protected final String project;
  27
  28         /** The task name. */
  29         protected final String task;
  30
  31         /**
  32          * Initializes the holder.
  33          *
  34          * @param __project The project name.
  35          * @param __task The task name.
  36          * @throws NullPointerException On null arguments.
  37          * @since 2020/08/15
  38          */
  39         public ProjectAndTaskName(String __project, String __task)
  40                 throws NullPointerException
  41         {
  42                 if (__project == null || __task == null)
  43                         throw new NullPointerException("NARG");
  44
  45                 this.project = __project;
  46                 this.task = __task;
  47         }
  48
  49         /**
  50          * {@inheritDoc}
  51          * @since 2020/08/15
  52          */
  53         @Override
  54         public int hashCode()
  55         {
  56                 return this.project.hashCode() ^
  57                         this.task.hashCode();
  58         }
  59
  60         /**
  61          * {@inheritDoc}
  62          * @since 2020/08/15
  63          */
  64         @Override
  65         public boolean equals(Object __o)
  66         {
  67                 if (__o == this)
  68                         return true;
  69
  70                 if (!(__o instanceof ProjectAndTaskName))
  71                         return false;
  72
  73                 ProjectAndTaskName o = (ProjectAndTaskName)__o;
  74                 return this.project.equals(o.project) &&
  75                         this.task.equals(o.task);
  76         }
  77
  78         /**
  79          * {@inheritDoc}
  80          * @since 2020/08/15
  81          */
  82         @Override
  83         public String toString()
  84         {
  85                 return this.project + ":" + this.task;
  86         }
  87
  88         /**
  89          * Maps the project and task name.
  90          *
  91          * @param __project The project to get from.
  92          * @param __task The task to use.
  93          * @return The project and task name.
  94          * @throws NullPointerException On null arguments.
  95          * @since 2020/08/15
  96          */
  97         public static ProjectAndTaskName of(Project __project, String __task)
  98                 throws NullPointerException
  99         {
 100                 if (__project == null || __task == null)
 101                         throw new NullPointerException("NARG");
 102
 103                 return new ProjectAndTaskName(__project.getPath(), __task);
 104         }
 105
 106         /**
 107          * Maps from a task.
 108          *
 109          * @param __task The task to use.
 110          * @return The project and task name.
 111          * @throws NullPointerException On null arguments.
 112          * @since 2020/08/15
 113          */
 114         public static ProjectAndTaskName of(Task __task)
 115                 throws NullPointerException
 116         {
 117                 if (__task == null)
 118                         throw new NullPointerException("NARG");
 119
 120                 return ProjectAndTaskName.of(__task.getProject(), __task.getName());
 121         }
 122 }