me.ryandw11.ods.internal

Class ODSMem

java.lang.Object

me.ryandw11.ods.internal.ODSMem

All Implemented Interfaces:

ODSInternal

public class ODSMem
extends java.lang.Object
implements ODSInternal

The internal class for memory.

Constructor Summary

Constructors

Constructor and Description
ODSMem() Does not pre-populate.
ODSMem(byte[] data, Compressor compressor) Import in pre-existing data.
ODSMem(java.nio.ByteBuffer buffer, Compressor compressor) Import in pre-existing data.

Method Summary

Modifier and Type	Method and Description
void	append(Tag<?> tag) Append tags to the end of the buffer.
void	appendAll(java.util.List<Tag<?>> tags) Append a list of tags to the end of the buffer.
void	clear() Clear the buffer.
boolean	delete(java.lang.String key) Remove a tag from the list.
byte[]	export(Compressor compressor) Get the array of bytes from the buffer.
boolean	find(java.lang.String key) Find if a key exists within the buffer.
<T extends Tag<?>> T	get(java.lang.String key) Grab a tag based upon an object key.
java.util.List<Tag<?>>	getAll() Get all of the tags in the buffer.
void	importFile(java.io.File file, Compressor compressor) Import a data from an ODS file into the buffer.
boolean	replaceData(java.lang.String key, Tag<?> replacement) Replace a key with another tag.
void	save(java.util.List<? extends Tag<?>> tags) Save tags to the buffer.
void	saveToFile(java.io.File file, Compressor compressor) Save data from the buffer into a file.
void	set(java.lang.String key, Tag<?> value) This method can append, delete, and set tags.

Methods inherited from class java.lang.Object

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

Constructor Detail

ODSMem

public ODSMem(byte[] data,
              Compressor compressor)

Import in pre-existing data.

Parameters:

data - The array of data.

compressor - The compression used.

ODSMem

public ODSMem(java.nio.ByteBuffer buffer,
              Compressor compressor)

Import in pre-existing data.

Parameters:

buffer - The buffer containing the data.

compressor - The compression used.

ODSMem

public ODSMem()

Does not pre-populate.

Method Detail

get

public <T extends Tag<?>> T get(java.lang.String key)

Grab a tag based upon an object key.

This method allows you to directly get sub-objects with little overhead.

get("Object1.Object2.valuetag");

Specified by:

get in interface ODSInternal

Type Parameters:

T - The tag type.

Parameters:

key - The key to use.

Returns:

The object Tag.

This will return null if the requested sub-object does not exist.

getAll

public java.util.List<Tag<?>> getAll()

Get all of the tags in the buffer.

Specified by:

getAll in interface ODSInternal

Returns:

All of the tags.

This will return null if there are no tags.

save

public void save(java.util.List<? extends Tag<?>> tags)

Save tags to the buffer.

This will overwrite the existing buffer. To append tags see append(Tag) and appendAll(List)

Specified by:

save in interface ODSInternal

Parameters:

tags - The list of tags to save.

append

public void append(Tag<?> tag)

Append tags to the end of the buffer.

Specified by:

append in interface ODSInternal

Parameters:

tag - The tag to be appended.

appendAll

public void appendAll(java.util.List<Tag<?>> tags)

Append a list of tags to the end of the buffer.

Specified by:

appendAll in interface ODSInternal

Parameters:

tags - The list of tags.

find

public boolean find(java.lang.String key)

Find if a key exists within the buffer.

Specified by:

find in interface ODSInternal

Parameters:

key - They key to find

Returns:

If the key exists.

delete

public boolean delete(java.lang.String key)

Remove a tag from the list.

Specified by:

delete in interface ODSInternal

Parameters:

key - The key to remove.

Returns:

If the deletion was successfully done.

replaceData

public boolean replaceData(java.lang.String key,
                           Tag<?> replacement)

Replace a key with another tag.

Specified by:

replaceData in interface ODSInternal

Parameters:

key - The key

replacement - The data to replace

Returns:

If the replacement was successful. ODSException is not thrown.

set

public void set(java.lang.String key,
                Tag<?> value)

This method can append, delete, and set tags.

A note on keys when appending:
ObjectOne.ObjectTwo.tagName
When appending data tagName will not be the actual tag name. The tag name written to the file is the name of the specified tag in the value parameter. Any parent objects that do not exist will be created. For example:
ObjectOne.ObjectTwo.NewObject.tagName
If in the example above NewObject does not exist, than the object will be created with the value tag inside of it. Please see the wiki for a more detailed explanation on this.

When value is null, the specified key is deleted. The key MUST exist or an ODSException will be thrown.

Specified by:

set in interface ODSInternal

Parameters:

key - The key of the tag to append, delete, or set.

When appending the key does not need to exist. ObjectTags that don't exist will be created automatically.

When the key is set to "" (An empty string) than it is assumed you want to append to the parent buffer.

Valid Tags:

ObjectOne.tagToDelete
ObjectOne.NewObject.tagToAppend
ObjectOne.tagToSet


value - The tag to append or replace the key with.

If this parameter is null than the key is deleted.

export

public byte[] export(Compressor compressor)

Get the array of bytes from the buffer.

Specified by:

export in interface ODSInternal

Parameters:

compressor - The compression you want to use for the bytes.

Returns:

The bytes.

importFile

public void importFile(java.io.File file,
                       Compressor compressor)

Import a data from an ODS file into the buffer.

Specified by:

importFile in interface ODSInternal

Parameters:

file - The file to import from.

compressor - The compression of that file.

saveToFile

public void saveToFile(java.io.File file,
                       Compressor compressor)

Save data from the buffer into a file.

Specified by:

saveToFile in interface ODSInternal

Parameters:

file - The file to save to.

compressor - The compression to use for that file.

clear

public void clear()

Clear the buffer.

Specified by:

clear in interface ODSInternal