modules/cldc-compact/src/main/java/cc/squirreljme/jvm/manifest/JavaManifestKey.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.jvm.manifest;
  11
  12 import cc.squirreljme.runtime.cldc.annotation.Exported;
  13
  14 /**
  15  * This represents a key which is used in a manifest, it is case insensitive
  16  * when it comes to ASCII values.
  17  *
  18  * @since 2016/05/29
  19  */
  20 @Exported
  21 public final class JavaManifestKey
  22 {
  23         /** The used string. */
  24         @Exported
  25         protected final String string;
  26
  27         /** The actual input string. */
  28         @Exported
  29         protected final String inputString;
  30
  31         /**
  32          * Initializes the manifest key using the given string.
  33          *
  34          * @param __s The string to use for the manifest key.
  35          * @throws NullPointerException On null arguments.
  36          * @since 2016/05/29
  37          */
  38         @Exported
  39         public JavaManifestKey(String __s)
  40                 throws NullPointerException
  41         {
  42                 // Check
  43                 if (__s == null)
  44                         throw new NullPointerException("NARG");
  45
  46                 // Lower-case all letters
  47                 StringBuilder sb = new StringBuilder();
  48                 for (int i = 0, n = __s.length(); i < n; i++)
  49                         sb.append(JavaManifestKey.__toLower(__s.charAt(i)));
  50                 this.string = sb.toString();
  51
  52                 // Remember input string for case purposes
  53                 this.inputString = __s;
  54         }
  55
  56         /**
  57          * {@inheritDoc}
  58          * @since 2016/05/29
  59          */
  60         @Override
  61         public boolean equals(Object __o)
  62         {
  63                 // Is another key?
  64                 if (__o instanceof JavaManifestKey)
  65                         return this.__equals(((JavaManifestKey)__o).string);
  66                 return false;
  67         }
  68
  69         /**
  70          * {@inheritDoc}
  71          * @since 2016/05/29
  72          */
  73         @Override
  74         public int hashCode()
  75         {
  76                 return this.string.hashCode();
  77         }
  78
  79         /**
  80          * Returns the input string which was passed to this key, this string
  81          * cannot be used for comparative purposes and it intended to be used
  82          * for case matching in the output manifest.
  83          *
  84          * @return The input string.
  85          * @since 2017/11/26
  86          */
  87         @Exported
  88         public String inputString()
  89         {
  90                 return this.inputString;
  91         }
  92
  93         /**
  94          * {@inheritDoc}
  95          * @since 2016/05/29
  96          */
  97         @Override
  98         public String toString()
  99         {
 100                 return this.string;
 101         }
 102
 103         /**
 104          * Compares two strings checking for case insensitivity in the basic
 105          * ASCII range.
 106          *
 107          * @param __b The other string to compare against.
 108          * @return {@code true} if the strings are equal.
 109          * @throws NullPointerException On null arguments.
 110          * @since 2016/05/29
 111          */
 112         private boolean __equals(String __b)
 113                 throws NullPointerException
 114         {
 115                 // Check
 116                 if (__b == null)
 117                         throw new NullPointerException("NARG");
 118
 119                 // Cache
 120                 String a = this.string;
 121
 122                 // Get their lengths
 123                 int na = a.length(),
 124                         nb = __b.length();
 125
 126                 // Would not be equal
 127                 if (na != nb)
 128                         return false;
 129
 130                 // Check characters
 131                 for (int i = 0; i < na; i++)
 132                         if (JavaManifestKey.__toLower(a.charAt(i)) != JavaManifestKey
 133                                 .__toLower(__b.charAt(i)))
 134                                 return false;
 135
 136                 // Matches
 137                 return true;
 138         }
 139
 140         /**
 141          * Converts the specified character to lower case.
 142          *
 143          * @param __c The character to lower case.
 144          * @return The lowercased character or {@code __c} if it cannot be
 145          * lowercased.
 146          * @since 2016/05/29
 147          */
 148         private static char __toLower(char __c)
 149         {
 150                 if (__c >= 'A' && __c <= 'Z')
 151                         return (char)('a' + (__c - 'A'));
 152                 return __c;
 153         }
 154 }
 155