Class AbilitySelection

code/src/java/pcgen/cdom/content/AbilitySelection.java:36–230

import pcgen.rules.context.LoadContext;

public class AbilitySelection extends Selection<Ability, String> implements Comparable<AbilitySelection>, Reducible
{

	public AbilitySelection(Ability obj, String sel)
	{
		super(obj, sel);
	}

	/**
	 * Decodes the given String into an AbilitySelection. The String format to
	 * be passed into this method is defined solely by the return result of the
	 * getPersistentFormat method. There is no guarantee that the encoding is
	 * human readable, simply that the encoding is uniquely identifying such
	 * that this method is capable of decoding the String into an
	 * AbilitySelection.
	 * 
	 * @param persistentFormat
	 *            The String which should be decoded to provide an
	 *            AbilitySelection.
	 * 
	 * @return An AbilitySelection that was encoded in the given String.
	 */
	public static AbilitySelection getAbilitySelectionFromPersistentFormat(LoadContext context, String persistentFormat)
	{
		if (!persistentFormat.contains(Constants.PIPE))
		{
			return decodeFeatSelectionChoice(context, persistentFormat);
		}
		StringTokenizer st = new StringTokenizer(persistentFormat, Constants.PIPE);
		String catString = st.nextToken();
		if (!catString.startsWith("CATEGORY="))
		{
			throw new IllegalArgumentException("String in getAbilitySelectionFromPersistentFormat "
				+ "must start with CATEGORY=, found: " + persistentFormat);
		}
		String cat = catString.substring(9);
		AbilityCategory ac = SettingsHandler.getGameAsProperty().get().getAbilityCategory(cat);
		if (ac == null)
		{
			throw new IllegalArgumentException(
				"Category in getAbilitySelectionFromPersistentFormat " + "must exist found: " + cat);
		}
		String ab = st.nextToken();
		Ability a = context.getReferenceContext().getManufacturerId(ac).getActiveObject(ab);
		if (a == null)
		{
			throw new IllegalArgumentException("Second argument in String in getAbilitySelectionFromPersistentFormat "
				+ "must be an Ability, but it was not found: " + persistentFormat);
		}
		String sel = null;
		if (st.hasMoreTokens())
		{
			/*
			 * No need to check for MULT:YES/NO here, as that is checked
			 * implicitly in the construction of AbilitySelection below
			 */
			sel = st.nextToken();
		}