Package VASSAL.build.module.metadata

Class AbstractMetaData

java.lang.Object

VASSAL.build.module.metadata.AbstractMetaData

Direct Known Subclasses:

ExtensionMetaData, ImportMetaData, ModuleMetaData, SaveMetaData

public abstract class AbstractMetaData
extends Object

Base class representing the metadata for a Saved Game, Module or Extension.

Since:

3.1.0

Author:

Brent Easton

Field Summary

Fields

Modifier and Type	Field	Description
protected static final String	BUG_11929_VASSAL_FIX_VERSION
protected static final String	BUILDFILE_EXTENSION_ELEMENT
protected static final String	BUILDFILE_MODULE_ELEMENT1
protected static final String	BUILDFILE_MODULE_ELEMENT2
protected static final String	CHECKSUM_ELEMENT
protected static final String	DATE_SAVED_ELEMENT
protected static final String	DESCRIPTION_ATTR
protected static final String	DESCRIPTION_ELEMENT
protected VASSAL.build.module.metadata.AbstractMetaData.Attribute	descriptionAttr
protected static final String	EXTENSION_ATTR
protected String	extra1
protected static final String	EXTRA1_ELEMENT
protected String	extra2
protected static final String	EXTRA2_ELEMENT
protected static final String	FALSE
protected static final String	LANG_ATTR
protected String	lastSaved
protected static final String	MODULE_NAME_ATTR
protected static final String	MODULE_NAME_ELEMENT
protected static final String	MODULE_VERSION_ATTR
protected static final String	MODULE_VERSION_ELEMENT
protected static final String	NAME_ATTR
protected static final String	NAME_ELEMENT
protected static final XMLReader	parser	This is the shared parser for all subclasses of AbstractMetaData.
protected static final String	ROOT_ELEMENT
protected static final String	TRUE
protected static final String	VASSAL_VERSION_ATTR
protected static final String	VASSAL_VERSION_ELEMENT
protected String	vassalVersion
protected String	version
protected static final String	VERSION_ATTR
protected static final String	VERSION_ELEMENT

Constructor Summary

Constructors

Constructor	Description
AbstractMetaData()

Method Summary

Modifier and Type	Method	Description
protected abstract void	addElements(Document doc, Element root)	Add elements specific to a MetaData subclass
void	copyModuleMetadata(ArchiveWriter archive)	Copy the Module metadata from the current module into the specified archive.
void	copyModuleMetadata(FileArchive archive)
void	copyModuleMetadata(ZipWriter zw)
String	formatLastSaved()
String	getDescription()
String	getExtra1()
String	getExtra2()
String	getLastSaved()
String	getLocalizedDescription()
abstract String	getMetaDataVersion()	Return the version of the metadata structure
String	getVassalVersion()
String	getVersion()
abstract String	getZipEntryName()	Return the Entry name for the metadata file
static boolean	isPreBug11929(String version)
protected void	save(OutputStream out)
void	save(ArchiveWriter archive)	Write common metadata to the specified Archive.
void	save(FileArchive archive)
void	save(ZipWriter zw)
void	setDescription(String desc)
void	setDescription(VASSAL.build.module.metadata.AbstractMetaData.Attribute desc)
void	setExtra1(String s)
void	setExtra2(String s)
void	setLastSaved(String lastSaved)
void	setVassalVersion(String s)
void	setVersion(String s)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

TRUE

protected static final String TRUE

See Also:

• Constant Field Values

FALSE

protected static final String FALSE

See Also:

• Constant Field Values

NAME_ATTR

protected static final String NAME_ATTR

See Also:

• Constant Field Values

VERSION_ATTR

protected static final String VERSION_ATTR

See Also:

• Constant Field Values

VASSAL_VERSION_ATTR

protected static final String VASSAL_VERSION_ATTR

See Also:

• Constant Field Values

DESCRIPTION_ATTR

protected static final String DESCRIPTION_ATTR

See Also:

• Constant Field Values

EXTENSION_ATTR

protected static final String EXTENSION_ATTR

See Also:

• Constant Field Values

MODULE_NAME_ATTR

protected static final String MODULE_NAME_ATTR

See Also:

• Constant Field Values

MODULE_VERSION_ATTR

protected static final String MODULE_VERSION_ATTR

See Also:

• Constant Field Values

LANG_ATTR

protected static final String LANG_ATTR

See Also:

• Constant Field Values

ROOT_ELEMENT

protected static final String ROOT_ELEMENT

See Also:

• Constant Field Values

VERSION_ELEMENT

protected static final String VERSION_ELEMENT

See Also:

• Constant Field Values

EXTRA1_ELEMENT

protected static final String EXTRA1_ELEMENT

See Also:

• Constant Field Values

EXTRA2_ELEMENT

protected static final String EXTRA2_ELEMENT

See Also:

• Constant Field Values

VASSAL_VERSION_ELEMENT

protected static final String VASSAL_VERSION_ELEMENT

See Also:

• Constant Field Values

MODULE_NAME_ELEMENT

protected static final String MODULE_NAME_ELEMENT

See Also:

• Constant Field Values

MODULE_VERSION_ELEMENT

protected static final String MODULE_VERSION_ELEMENT

See Also:

• Constant Field Values

DESCRIPTION_ELEMENT

protected static final String DESCRIPTION_ELEMENT

See Also:

• Constant Field Values

NAME_ELEMENT

protected static final String NAME_ELEMENT

See Also:

• Constant Field Values

DATE_SAVED_ELEMENT

protected static final String DATE_SAVED_ELEMENT

See Also:

• Constant Field Values

CHECKSUM_ELEMENT

protected static final String CHECKSUM_ELEMENT

See Also:

• Constant Field Values

BUILDFILE_MODULE_ELEMENT1

protected static final String BUILDFILE_MODULE_ELEMENT1

See Also:

• Constant Field Values

BUILDFILE_MODULE_ELEMENT2

protected static final String BUILDFILE_MODULE_ELEMENT2

See Also:

• Constant Field Values

BUILDFILE_EXTENSION_ELEMENT

protected static final String BUILDFILE_EXTENSION_ELEMENT

See Also:

• Constant Field Values

BUG_11929_VASSAL_FIX_VERSION

protected static final String BUG_11929_VASSAL_FIX_VERSION

See Also:

• Constant Field Values

version

protected String version

vassalVersion

protected String vassalVersion

descriptionAttr

protected VASSAL.build.module.metadata.AbstractMetaData.Attribute descriptionAttr

lastSaved

protected String lastSaved

extra1

protected String extra1

extra2

protected String extra2

parser

protected static final XMLReader parser

This is the shared parser for all subclasses of AbstractMetaData. We use a shared parser. All uses of this parser must be wrapped in a block synchronized on the parser itself.

Constructor Details

AbstractMetaData

public AbstractMetaData()

Method Details

isPreBug11929

public static boolean isPreBug11929(String version)

getVersion

public String getVersion()

setVersion

public void setVersion(String s)

getExtra1

public String getExtra1()

setExtra1

public void setExtra1(String s)

getExtra2

public String getExtra2()

setExtra2

public void setExtra2(String s)

getVassalVersion

public String getVassalVersion()

setVassalVersion

public void setVassalVersion(String s)

setDescription

public void setDescription(VASSAL.build.module.metadata.AbstractMetaData.Attribute desc)

setDescription

public void setDescription(String desc)

getDescription

public String getDescription()

getLocalizedDescription

public String getLocalizedDescription()

getLastSaved

public String getLastSaved()

setLastSaved

public void setLastSaved(String lastSaved)

formatLastSaved

public String formatLastSaved()

save

public void save(FileArchive archive)
          throws IOException

Throws:

IOException

save

protected void save(OutputStream out)
             throws IOException

Throws:

IOException

save

public void save(ArchiveWriter archive)
          throws IOException

Write common metadata to the specified Archive. Call addElements to add elements specific to particular concrete subclasses.

Parameters:

archive - Extension Archive

Throws:

IOException - If anything goes wrong

save

public void save(ZipWriter zw)
          throws IOException

Throws:

IOException

copyModuleMetadata

public void copyModuleMetadata(ArchiveWriter archive)
                        throws IOException

Copy the Module metadata from the current module into the specified archive.

Parameters:

archive - Archive to copy into

Throws:

IOException - exception

copyModuleMetadata

public void copyModuleMetadata(FileArchive archive)
                        throws IOException

Throws:

IOException

copyModuleMetadata

public void copyModuleMetadata(ZipWriter zw)
                        throws IOException

Throws:

IOException

getZipEntryName

public abstract String getZipEntryName()

Return the Entry name for the metadata file

Returns:

Zip Entry name

getMetaDataVersion

public abstract String getMetaDataVersion()

Return the version of the metadata structure

Returns:

version

addElements

protected abstract void addElements(Document doc,
 Element root)

Add elements specific to a MetaData subclass

Parameters:

doc - Document

root - Root element