modules/cldc-compact/src/main/java/cc/squirreljme/jvm/suite/ProvidedInfo.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.suite;
  11
  12 import cc.squirreljme.jvm.manifest.JavaManifestAttributes;
  13 import cc.squirreljme.runtime.cldc.annotation.Exported;
  14 import cc.squirreljme.runtime.cldc.util.StringUtils;
  15 import cc.squirreljme.runtime.cldc.util.UnmodifiableIterator;
  16 import java.lang.ref.Reference;
  17 import java.lang.ref.WeakReference;
  18 import java.util.Arrays;
  19 import java.util.Collection;
  20 import java.util.Iterator;
  21 import java.util.LinkedHashSet;
  22 import java.util.Set;
  23
  24 /**
  25  * This contains all of the information for dependencies which are provided
  26  * by an application or library.
  27  *
  28  * @since 2017/11/30
  29  */
  30 @Exported
  31 public final class ProvidedInfo
  32         implements Iterable<MarkedProvided>
  33 {
  34         /** Provided fields. */
  35         private final MarkedProvided[] _provided;
  36
  37         /** String representation. */
  38         private Reference<String> _string;
  39
  40         /**
  41          * Initializes the provided dependency info.
  42          *
  43          * @param __provs The provided set.
  44          * @since 2017/12/31
  45          */
  46         @Exported
  47         public ProvidedInfo(MarkedProvided... __provs)
  48         {
  49                 // Defensive copy
  50                 __provs = (__provs == null ? new MarkedProvided[0] : __provs.clone());
  51
  52                 // Check for nulls
  53                 for (MarkedProvided o : __provs)
  54                         if (o == null)
  55                                 throw new NullPointerException("NARG");
  56
  57                 this._provided = __provs;
  58         }
  59
  60         /**
  61          * Initializes the provided dependency info.
  62          *
  63          * @param __provs The provided set.
  64          * @throws NullPointerException On null arguments.
  65          * @since 2017/12/31
  66          */
  67         @Exported
  68         public ProvidedInfo(Collection<MarkedProvided> __provs)
  69                 throws NullPointerException
  70         {
  71                 this(__provs.<MarkedProvided>toArray(
  72                         new MarkedProvided[__provs.size()]));
  73         }
  74
  75         /**
  76          * {@inheritDoc}
  77          * @since 2017/12/31
  78          */
  79         @Override
  80         public final boolean equals(Object __o)
  81         {
  82                 if (this == __o)
  83                         return true;
  84
  85                 if (!(__o instanceof ProvidedInfo))
  86                         return false;
  87
  88                 return Arrays.equals(this._provided, ((ProvidedInfo)__o)._provided);
  89         }
  90
  91         /**
  92          * {@inheritDoc}
  93          * @since 2017/12/31
  94          */
  95         @Override
  96         public final int hashCode()
  97         {
  98                 return Arrays.asList(this._provided).hashCode();
  99         }
 100
 101         /**
 102          * {@inheritDoc}
 103          * @since 2021/01/31
 104          */
 105         @Override
 106         public Iterator<MarkedProvided> iterator()
 107         {
 108                 return UnmodifiableIterator.of(this._provided);
 109         }
 110
 111         /**
 112          * {@inheritDoc}
 113          * @since 2017/12/31
 114          */
 115         @Override
 116         public final String toString()
 117         {
 118                 Reference<String> ref = this._string;
 119                 String rv;
 120
 121                 if (ref == null || null == (rv = ref.get()))
 122                         this._string = new WeakReference<>(
 123                                 (rv = Arrays.asList(this._provided).toString()));
 124
 125                 return rv;
 126         }
 127
 128         /**
 129          * Parses the given suite information and returns all of the provided
 130          * resolutions for dependencies which are specified in the manifest.
 131          *
 132          * @param __info The suite information to parse.
 133          * @return The parsed provided resolution information.
 134          * @throws InvalidSuiteException If the manifest is not correct.
 135          * @throws NullPointerException On null arguments.
 136          * @since 2017/11/20
 137          */
 138         @Exported
 139         public static ProvidedInfo of(SuiteInfo __info)
 140                 throws InvalidSuiteException, NullPointerException
 141         {
 142                 if (__info == null)
 143                         throw new NullPointerException("NARG");
 144
 145                 Set<MarkedProvided> provided = new LinkedHashSet<>();
 146                 JavaManifestAttributes attr = __info.manifest().getMainAttributes();
 147                 String value;
 148
 149                 // Defined configurations
 150                 value = attr.getValue("X-SquirrelJME-DefinedConfigurations");
 151                 if (value != null)
 152                         for (String s : StringUtils.basicSplit(" \t", value))
 153                                 provided.add(new Configuration(s));
 154
 155                 // Defined profiles
 156                 value = attr.getValue("X-SquirrelJME-DefinedProfiles");
 157                 if (value != null)
 158                         for (String s : StringUtils.basicSplit(" \t", value))
 159                                 provided.add(new Profile(s));
 160
 161                 // Defined standards
 162                 value = attr.getValue("X-SquirrelJME-DefinedStandards");
 163                 if (value != null)
 164                         for (String s : StringUtils.basicSplit(",", value))
 165                                 provided.add(new Standard(s.trim()));
 166
 167                 // Has internal project name?
 168                 String internalname = attr.getValue(
 169                         "X-SquirrelJME-InternalProjectName");
 170                 if (internalname != null)
 171                         provided.add(new InternalName(internalname));
 172
 173                 // This provides a library or otherwise
 174                 provided.add(new TypedSuite(__info.type(), __info.suite()));
 175
 176                 // Initialize
 177                 return new ProvidedInfo(provided);
 178         }
 179 }
 180