File	Doc	Category	Size	Date	Package
ChunkContainer.java	API Doc	Jaudiotagger 2.0.4	6509	Wed Mar 30 16:11:50 BST 2011	org.jaudiotagger.audio.asf.data

ChunkContainer

• java.lang.Object
  • Chunk

Fields Summary
private static final Set	MULTI_CHUNKS Stores the {@link GUID} instances, which are allowed multiple times within an ASF header.
private final Map	chunkTable Stores the {@link Chunk} objects to their {@link GUID}.

Constructors Summary
public ChunkContainer(GUID chunkGUID, long pos, BigInteger length) Creates an instance. param chunkGUID the GUID which identifies the chunk. param pos the position of the chunk within the stream. param length the length of the chunk. super(chunkGUID, pos, length); this.chunkTable = new Hashtable<GUID, List<Chunk>>();

Methods Summary
public void	addChunk(Chunk toAdd) Adds a chunk to the container. param toAdd The chunk which is to be added. throws IllegalArgumentException If a chunk of same type is already added, except for {@link StreamChunk}. final List<Chunk> list = assertChunkList(toAdd.getGuid()); if (!list.isEmpty() && !MULTI_CHUNKS.contains(toAdd.getGuid())) { throw new IllegalArgumentException( "The GUID of the given chunk indicates, that there is no more instance allowed."); //$NON-NLS-1$ } list.add(toAdd); assert chunkstartsUnique(this) : "Chunk has equal start position like an already inserted one."; //$NON-NLS-1$
protected java.util.List	assertChunkList(GUID lookFor) This method asserts that a {@link List} exists for the given {@link GUID} , in {@link #chunkTable}. param lookFor The GUID to get list for. return an already existing, or newly created list. List<Chunk> result = this.chunkTable.get(lookFor); if (result == null) { result = new ArrayList<Chunk>(); this.chunkTable.put(lookFor, result); } return result;
protected static boolean	chunkstartsUnique(org.jaudiotagger.audio.asf.data.ChunkContainer container) Tests whether all stored chunks have a unique starting position among their brothers. param container the container to test. return true if all chunks are located at an unique position. However, no intersection is tested. MULTI_CHUNKS = new HashSet<GUID>(); MULTI_CHUNKS.add(GUID.GUID_STREAM); boolean result = true; final Set<Long> chunkStarts = new HashSet<Long>(); final Collection<Chunk> chunks = container.getChunks(); for (final Chunk curr : chunks) { result &= chunkStarts.add(curr.getPosition()); } return result;
public java.util.Collection	getChunks() Returns a collection of all contained chunks. return all contained chunks final List<Chunk> result = new ArrayList<Chunk>(); for (final List<Chunk> curr : this.chunkTable.values()) { result.addAll(curr); } return result;
protected Chunk	getFirst(GUID lookFor, java.lang.Class instanceOf) Looks for the first stored chunk which has the given GUID. param lookFor GUID to look up. param instanceOf The class which must additionally be matched. return null if no chunk was found, or the stored instance doesn't match. Chunk result = null; final List<Chunk> list = this.chunkTable.get(lookFor); if (list != null && !list.isEmpty()) { final Chunk chunk = list.get(0); if (instanceOf.isAssignableFrom(chunk.getClass())) { result = chunk; } } return result;
public boolean	hasChunkByGUID(GUID lookFor) This method checks if a chunk has been {@linkplain #addChunk(Chunk) added} with specified {@linkplain Chunk#getGuid() GUID}. param lookFor GUID to look up. return true if chunk with specified GUID has been added. return this.chunkTable.containsKey(lookFor);
public java.lang.String	prettyPrint(java.lang.String prefix) {@inheritDoc} return prettyPrint(prefix, "");
public java.lang.String	prettyPrint(java.lang.String prefix, java.lang.String containerInfo) Nearly the same as {@link #prettyPrint(String)} however, additional information can be injected below the {@link Chunk#prettyPrint(String)} output and the listing of the contained chunks. param prefix The prefix to prepend. param containerInfo Information to inject. return Information of current Chunk Object. final StringBuilder result = new StringBuilder(super.prettyPrint(prefix)); result.append(containerInfo); result.append(prefix).append(" |").append(Utils.LINE_SEPARATOR); final ArrayList<Chunk> list = new ArrayList<Chunk>(getChunks()); Collections.sort(list, new ChunkPositionComparator()); for (Chunk curr : list) { result.append(curr.prettyPrint(prefix + " |")); result.append(prefix).append(" |").append(Utils.LINE_SEPARATOR); } return result.toString();