modules/cldc-compact/src/main/java/cc/squirreljme/jvm/suite/SuiteDependencyLevel.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 Mozilla Public License Version 2.0.
   7 // See license.mkd for licensing and copyright information.
   8 // ---------------------------------------------------------------------------
   9
  10 package cc.squirreljme.jvm.suite;
  11
  12 import cc.squirreljme.runtime.cldc.debug.Debugging;
  13
  14 /**
  15  * This represents the level of the dependency.
  16  *
  17  * @since 2017/02/22
  18  */
  19 public enum SuiteDependencyLevel
  20 {
  21         /** Required. */
  22         REQUIRED,
  23
  24         /** Optional. */
  25         OPTIONAL,
  26
  27         /** End. */
  28         ;
  29
  30         /**
  31          * Is this an optional dependency level?
  32          *
  33          * @return {@code true} if this is an optional dependency level.
  34          * @since 2017/11/22
  35          */
  36         public boolean isOptional()
  37         {
  38                 return this == SuiteDependencyLevel.OPTIONAL;
  39         }
  40
  41         /**
  42          * Is this an required dependency level?
  43          *
  44          * @return {@code true} if this is an required dependency level.
  45          * @since 2017/11/22
  46          */
  47         public boolean isRequired()
  48         {
  49                 return this == SuiteDependencyLevel.REQUIRED;
  50         }
  51
  52         /**
  53          * {@inheritDoc}
  54          * @since 2017/02/22
  55          */
  56         @Override
  57         public String toString()
  58         {
  59                 // Convert string
  60                 switch (this)
  61                 {
  62                         case REQUIRED:  return "required";
  63                         case OPTIONAL:  return "optional";
  64                         default:
  65                                 throw Debugging.oops();
  66                 }
  67         }
  68
  69         /**
  70          * Returns the dependency level based on the input string.
  71          *
  72          * @param __s The input string to parse.
  73          * @return The dependency level for the given string.
  74          * @throws IllegalArgumentException If the level is not valid.
  75          * @throws NullPointerException On null arguments.
  76          * @since 2017/02/22
  77          */
  78         public static SuiteDependencyLevel of(String __s)
  79                 throws IllegalArgumentException, NullPointerException
  80         {
  81                 // Check
  82                 if (__s == null)
  83                         throw new NullPointerException("NARG");
  84
  85                 // Depends
  86                 switch (__s.trim())
  87                 {
  88                         case "required":        return SuiteDependencyLevel.REQUIRED;
  89                         case "optional":        return SuiteDependencyLevel.OPTIONAL;
  90
  91                                 /* {@squirreljme.error DG82 Invalid dependency level. (Level)} */
  92                         default:
  93                                 throw new IllegalArgumentException(String.format(
  94                                         "DG82 %s", __s));
  95                 }
  96         }
  97 }
  98