Class CharacterManager

code/src/java/pcgen/system/CharacterManager.java:59–533

This class stores the characters that are currently opened by PCGen. It also handles creating new characters and opening characters from files. The getCharacters method returns a listenable list that allows users of this class to not only see what characters are open but to easily track any changes

 * changes to the list of available characters.
 */
public final class CharacterManager
{

	private static final PartyFacadeImpl CHARACTERS;
	private static final RecentFileList RECENT_CHARACTERS;
	private static final RecentFileList RECENT_PARTIES;
	private static final PCGenMessageHandler MESSAGE_HANDLER;

	static
	{
		CHARACTERS = new PartyFacadeImpl();
		RECENT_CHARACTERS = new RecentFileList(PCGenSettings.RECENT_CHARACTERS);
		RECENT_PARTIES = new RecentFileList(PCGenSettings.RECENT_PARTIES);
		MESSAGE_HANDLER = PluginManager.getInstance().getPostbox();
	}

	private CharacterManager()
	{
	}

	/**
	 * Create a new character using the supplied data sets.
	 * @param delegate the UIDelegate that this character will use.
	 * @param dataset the dataset that this will be loaded with.
	 * @return The character that was created.
	 */
	public static CharacterFacade createNewCharacter(UIDelegate delegate, DataSetFacade dataset)
	{
		@SuppressWarnings("rawtypes")
		List campaigns = ListFacades.wrap(dataset.getCampaigns());
		try
		{
			@SuppressWarnings("unchecked")
			PlayerCharacter pc = new PlayerCharacter(campaigns);
			Globals.getPCList().add(pc);
			CharacterFacade character = new CharacterFacadeImpl(pc, delegate, dataset);
			String name = createNewCharacterName();
			character.setName(name);
			CHARACTERS.addElement(character);
			Logging.log(Logging.INFO, "Created new character " + name + '.'); //$NON-NLS-1$
			MESSAGE_HANDLER.handleMessage(new PlayerCharacterWasLoadedMessage(delegate, pc));
			return character;
		}
		catch (final Exception e)
		{
			Logging.errorPrint("Unable to create character with data " //$NON-NLS-1$
				+ dataset, e);
			delegate.showErrorMessage(LanguageBundle.getString("in_cmCreateErrorTitle"), //$NON-NLS-1$
				LanguageBundle.getFormattedString("in_cmCreateErrorMessage", //$NON-NLS-1$
					e.getMessage()));
			return null;
		}

	}

	public static ListFacade<File> getRecentCharacters()
	{
		return RECENT_CHARACTERS;