org.jaudiotagger.tag.id3
Class ID3v22Tag

java.lang.Object
  extended by org.jaudiotagger.tag.id3.AbstractTagItem
      extended by org.jaudiotagger.tag.id3.AbstractTag
          extended by org.jaudiotagger.tag.id3.AbstractID3Tag
              extended by org.jaudiotagger.tag.id3.AbstractID3v2Tag
                  extended by org.jaudiotagger.tag.id3.ID3v22Tag
All Implemented Interfaces:
Tag

public class ID3v22Tag
extends AbstractID3v2Tag

Represents an ID3v2.2 tag.

Version:
$Id: ID3v22Tag.java,v 1.31 2007/11/13 14:24:30 paultaylor Exp $
Author:
: Paul Taylor, : Eric Farng

Field Summary
static byte MAJOR_VERSION
           
static int MASK_V22_COMPRESSION
          ID3v2.2 Header bit mask
static int MASK_V22_UNSYNCHRONIZATION
          ID3v2.2 Header bit mask
static byte RELEASE
           
static byte REVISION
           
 
Fields inherited from class org.jaudiotagger.tag.id3.AbstractID3v2Tag
frameMap, TAG_HEADER_LENGTH
 
Fields inherited from class org.jaudiotagger.tag.id3.AbstractID3Tag
logger
 
Constructor Summary
ID3v22Tag()
          Creates a new empty ID3v2_2 tag.
ID3v22Tag(AbstractTag mp3tag)
          Constructs a new tag based upon another tag of different version/type
ID3v22Tag(java.nio.ByteBuffer buffer)
          Deprecated. use ID3v22Tag(ByteBuffer,String) instead
ID3v22Tag(java.nio.ByteBuffer buffer, java.lang.String loggingFilename)
          Creates a new ID3v2_2 datatype.
ID3v22Tag(ID3v22Tag copyObject)
          Copy Constructor, creates a new ID3v2_2 Tag based on another ID3v2_2 Tag
 
Method Summary
 ID3v22Frame createFrame(java.lang.String id)
          Create Frame
 void createStructure()
           
 TagField createTagField(ID3v22FieldKey id3Key, java.lang.String value)
          Create Frame for Id3 Key

Only textual data supported at the moment, should only be used with frames that support a simple string argument.

 void deleteTagField(ID3v22FieldKey id3v22FieldKey)
          Delete fields with this id3v22FieldKey
 boolean equals(java.lang.Object obj)
          Is this tag equivalent to another
 java.lang.String getFirst(ID3v22FieldKey id3v22FieldKey)
          Retrieve the first value that exists for this id3v22key
 java.lang.String getIdentifier()
          Get full version
 byte getMajorVersion()
          Retrieve the Major Version
 byte getRelease()
          Retrieve the Release
 byte getRevision()
          Retrieve the Revision
 int getSize()
          Return frame size based upon the sizes of the frames rather than the size including padding recorded in the tag header
 boolean isCompression()
           
 boolean isUnsynchronization()
           
 void read(java.nio.ByteBuffer byteBuffer)
          Read tag from the ByteBuffer
 void write(java.io.File file, long audioStartLocation)
          Write tag to file
 void write(java.nio.channels.WritableByteChannel channel)
          Write tag to channel
 
Methods inherited from class org.jaudiotagger.tag.id3.AbstractID3v2Tag
add, addAlbum, addArtist, addComment, addGenre, addTitle, addTrack, addYear, adjustPadding, createAlbumField, createArtistField, createArtworkField, createCommentField, createGenreField, createLinkedArtworkField, createStructureBody, createStructureHeader, createTagField, createTitleField, createTrackField, createYearField, delete, deleteTagField, get, get, getAlbum, getArtist, getComment, getDuplicateBytes, getDuplicateFrameId, getEmptyFrameBytes, getFieldCount, getFields, getFileReadBytes, getFirst, getFirst, getFirstAlbum, getFirstArtist, getFirstComment, getFirstField, getFirstGenre, getFirstTitle, getFirstTrack, getFirstYear, getFrame, getFrameCount, getFrameOfType, getGenre, getInvalidFrameBytes, getTitle, getTrack, getV2TagSizeIfExists, getYear, hasCommonFields, hasField, hasFrame, hasFrameAndBody, hasFrameOfType, isEmpty, iterator, removeFrame, removeFrameOfType, removeUnsupportedFrames, seek, set, setAlbum, setArtist, setComment, setEncoding, setFrame, setFrame, setGenre, setTitle, setTrack, setYear, write
 
Methods inherited from class org.jaudiotagger.tag.id3.AbstractID3Tag
toString
 
Methods inherited from class org.jaudiotagger.tag.id3.AbstractTagItem
isSubsetOf
 
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.jaudiotagger.tag.Tag
toString
 

Field Detail

MASK_V22_UNSYNCHRONIZATION

public static final int MASK_V22_UNSYNCHRONIZATION
ID3v2.2 Header bit mask

See Also:
Constant Field Values

MASK_V22_COMPRESSION

public static final int MASK_V22_COMPRESSION
ID3v2.2 Header bit mask

See Also:
Constant Field Values

RELEASE

public static final byte RELEASE
See Also:
Constant Field Values

MAJOR_VERSION

public static final byte MAJOR_VERSION
See Also:
Constant Field Values

REVISION

public static final byte REVISION
See Also:
Constant Field Values
Constructor Detail

ID3v22Tag

public ID3v22Tag()
Creates a new empty ID3v2_2 tag.


ID3v22Tag

public ID3v22Tag(ID3v22Tag copyObject)
Copy Constructor, creates a new ID3v2_2 Tag based on another ID3v2_2 Tag


ID3v22Tag

public ID3v22Tag(AbstractTag mp3tag)
Constructs a new tag based upon another tag of different version/type


ID3v22Tag

public ID3v22Tag(java.nio.ByteBuffer buffer,
                 java.lang.String loggingFilename)
          throws TagException
Creates a new ID3v2_2 datatype.

Parameters:
buffer -
loggingFilename -
Throws:
TagException

ID3v22Tag

public ID3v22Tag(java.nio.ByteBuffer buffer)
          throws TagException
Deprecated. use ID3v22Tag(ByteBuffer,String) instead

Creates a new ID3v2_2 datatype.

Parameters:
buffer -
Throws:
TagException
Method Detail

getRelease

public byte getRelease()
Retrieve the Release

Specified by:
getRelease in class AbstractID3Tag

getMajorVersion

public byte getMajorVersion()
Retrieve the Major Version

Specified by:
getMajorVersion in class AbstractID3Tag

getRevision

public byte getRevision()
Retrieve the Revision

Specified by:
getRevision in class AbstractID3Tag

getIdentifier

public java.lang.String getIdentifier()
Description copied from class: AbstractID3Tag
Get full version

Overrides:
getIdentifier in class AbstractID3Tag
Returns:
an indentifier of the tag type

getSize

public int getSize()
Return frame size based upon the sizes of the frames rather than the size including padding recorded in the tag header

Overrides:
getSize in class AbstractID3v2Tag
Returns:
size

equals

public boolean equals(java.lang.Object obj)
Description copied from class: AbstractID3v2Tag
Is this tag equivalent to another

Overrides:
equals in class AbstractID3v2Tag
Parameters:
obj -
Returns:
equality

read

public void read(java.nio.ByteBuffer byteBuffer)
          throws TagException
Read tag from the ByteBuffer

Specified by:
read in class AbstractTagItem
Parameters:
byteBuffer - to read the tag from
Throws:
TagException
TagNotFoundException

write

public void write(java.io.File file,
                  long audioStartLocation)
           throws java.io.IOException
Write tag to file

Overrides:
write in class AbstractID3v2Tag
Parameters:
file - The file to write to
Throws:
java.io.IOException

write

public void write(java.nio.channels.WritableByteChannel channel)
           throws java.io.IOException
Write tag to channel

Overrides:
write in class AbstractID3v2Tag
Parameters:
channel -
Throws:
java.io.IOException

createStructure

public void createStructure()
Overrides:
createStructure in class AbstractID3v2Tag

isUnsynchronization

public boolean isUnsynchronization()
Returns:
is tag unsynchronized

isCompression

public boolean isCompression()
Returns:
is tag compressed

createFrame

public ID3v22Frame createFrame(java.lang.String id)
Create Frame

Specified by:
createFrame in class AbstractID3v2Tag
Parameters:
id - frameid
Returns:

createTagField

public TagField createTagField(ID3v22FieldKey id3Key,
                               java.lang.String value)
                        throws KeyNotFoundException,
                               FieldDataInvalidException
Create Frame for Id3 Key

Only textual data supported at the moment, should only be used with frames that support a simple string argument.

Parameters:
id3Key -
value -
Returns:
Throws:
KeyNotFoundException
FieldDataInvalidException

getFirst

public java.lang.String getFirst(ID3v22FieldKey id3v22FieldKey)
                          throws KeyNotFoundException
Retrieve the first value that exists for this id3v22key

Parameters:
id3v22FieldKey -
Returns:
Throws:
KeyNotFoundException

deleteTagField

public void deleteTagField(ID3v22FieldKey id3v22FieldKey)
                    throws KeyNotFoundException
Delete fields with this id3v22FieldKey

Parameters:
id3v22FieldKey -
Throws:
KeyNotFoundException