modules/cldc-compact/src/main/java/cc/squirreljme/jvm/suite/Profile.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 java.lang.ref.Reference;
  13 import java.lang.ref.WeakReference;
  14 import java.util.Objects;
  15
  16 /**
  17  * This represents a profile that may be implemented, such as MIDP.
  18  *
  19  * @since 2016/12/14
  20  */
  21 public final class Profile
  22         implements Comparable<Profile>, MarkedDependency, MarkedProvided
  23 {
  24         /** Name. */
  25         protected final APIName name;
  26
  27         /** Version. */
  28         protected final SuiteVersion version;
  29
  30         /** String representation. */
  31         private Reference<String> _string;
  32
  33         /**
  34          * Initializes the profile using the given API name and version.
  35          *
  36          * @param __n The name to use.
  37          * @param __v The version of the suite, this is optional.
  38          * @throws NullPointerException If no name was specified.
  39          * @since 2017/11/30
  40          */
  41         public Profile(APIName __n, SuiteVersion __v)
  42                 throws NullPointerException
  43         {
  44                 if (__n == null)
  45                         throw new NullPointerException("NARG");
  46
  47                 this.name = __n;
  48                 this.version = __v;
  49         }
  50
  51         /**
  52          * Initializes the profile by parsing the given string.
  53          *
  54          * @param __n The string to parse.
  55          * @throws NullPointerException On null arguments.
  56          * @since 2017/11/30
  57          */
  58         public Profile(String __n)
  59                 throws NullPointerException
  60         {
  61                 if (__n == null)
  62                         throw new NullPointerException("NARG");
  63
  64                 // No version specified
  65                 int n = __n.length(),
  66                         dx = __n.lastIndexOf('-');
  67                 char c;
  68                 if (dx < 0 || dx + 1 >= n || (c = __n.charAt(dx + 1)) < '0' || c > '9')
  69                 {
  70                         this.name = new APIName(__n);
  71                         this.version = null;
  72                 }
  73
  74                 // There is a version
  75                 else
  76                 {
  77                         this.name = new APIName(__n.substring(0, dx));
  78                         this.version = new SuiteVersion(__n.substring(dx + 1));
  79                 }
  80         }
  81
  82         /**
  83          * Returns the API name.
  84          *
  85          * @return The API name.
  86          * @since 2022/02/28
  87          */
  88         public APIName apiName()
  89         {
  90                 return this.name;
  91         }
  92
  93         /**
  94          * {@inheritDoc}
  95          * @since 2017/11/30
  96          */
  97         @Override
  98         public int compareTo(Profile __o)
  99         {
 100                 int rv = this.name.compareTo(__o.name);
 101                 if (rv != 0)
 102                         return rv;
 103
 104                 SuiteVersion a = this.version,
 105                         b = __o.version;
 106                 if ((a == null) != (b == null))
 107                         return (a == null ? -1 : 1);
 108                 else if (a != null)
 109                         return a.compareTo(b);
 110                 return 0;
 111         }
 112
 113         /**
 114          * {@inheritDoc}
 115          * @since 2017/11/30
 116          */
 117         @Override
 118         public boolean equals(Object __o)
 119         {
 120                 if (this == __o)
 121                         return true;
 122
 123                 if (!(__o instanceof Profile))
 124                         return false;
 125
 126                 Profile o = (Profile)__o;
 127                 return this.name.equals(o.name) &&
 128                         Objects.equals(this.version, o.version);
 129         }
 130
 131         /**
 132          * {@inheritDoc}
 133          * @since 2017/11/30
 134          */
 135         @Override
 136         public int hashCode()
 137         {
 138                 return this.name.hashCode() ^
 139                         Objects.hashCode(this.version);
 140         }
 141
 142         /**
 143          * {@inheritDoc}
 144          * @since 2017/12/31
 145          */
 146         @Override
 147         public boolean isOptional()
 148         {
 149                 return false;
 150         }
 151
 152         /**
 153          * {@inheritDoc}
 154          * @since 2017/12/31
 155          */
 156         @Override
 157         public boolean matchesProvided(MarkedProvided __mp)
 158                 throws NullPointerException
 159         {
 160                 if (__mp == null)
 161                         throw new NullPointerException("NARG");
 162
 163                 return this.equals(__mp);
 164         }
 165
 166         /**
 167          * {@inheritDoc}
 168          * @since 2017/11/30
 169          */
 170         @Override
 171         public String toString()
 172         {
 173
 174                 Reference<String> ref = this._string;
 175                 String rv;
 176
 177                 if (ref == null || null == (rv = ref.get()))
 178                         this._string = new WeakReference<>((rv = "Profile " +
 179                                 this.name + ":" + this.version));
 180
 181                 return rv;
 182         }
 183
 184         /**
 185          * Returns the version of this profile.
 186          *
 187          * @return The profile version.
 188          * @since 2017/12/05
 189          */
 190         public SuiteVersion version()
 191         {
 192                 return this.version;
 193         }
 194 }
 195