public class ID3v24FrameBodyEncryptionMethodRegistration extends ID3v24FrameBody
An encryption method registration frame body is associated with an ID3v2.4 ENCR
frame
which is used to identify with which method a frame
has been encrypted. Thus, the encryption method must be registered so that the encrypted frame(s) can be decrypyted at a later time. The encryption method registration frame body contains the
following fields:
Field | Description | |
---|---|---|
1. | ownerId | URL containing an e-mail address, or a link to a location where an e-mail address can be found, that belongs to the organization responsible for this specific encryption method. Questions regarding the encryption method should be sent to the indicated e-mail address. |
2. | methodSymbol | encryption method id. Values below 0x80 are reserved. |
3. | data | This is an optional field that, if specified, contains encryption data specific to this encryption method. |
There may be more than one encrypted method registration frame in an ID3v2.4 tag
, but only one with the same method
symbol and only one containing the same owner identifier. The encryption method must be used somewhere in the tag.
buffer, dirty, frameType
nextNullTerminatorIndex, nullTerminatorIndex
Constructor and Description |
---|
ID3v24FrameBodyEncryptionMethodRegistration()
The default constructor is called when creating a new frame.
|
ID3v24FrameBodyEncryptionMethodRegistration(java.io.InputStream inputStream,
int frameBodySize)
constructor.
|
ID3v24FrameBodyEncryptionMethodRegistration(java.lang.String ownerId,
byte methodSymbol,
byte[] data)
This constructor is called when creating a new frame.
|
Modifier and Type | Method and Description |
---|---|
byte[] |
getData()
gets the data specific to the encryption method so that is used to encrypt/decrypt frames.
|
byte |
getMethodSymbol()
gets the id of the encryption method.
|
java.lang.String |
getOwnerId()
gets the owner id of the frame.
|
void |
parse()
parses the raw bytes of the frame body and stores the parsed values in the frame's fields.
|
void |
setBuffer()
If the frame body's values have been modified, then resize the raw binary buffer and store the new values there.
|
void |
setData(byte[] data)
sets the data specific to the encryption method so that is used to encrypt/decrypt frames.
|
void |
setMethodSymbol(byte methodSymbol)
sets the id of encryption method.
|
void |
setOwnerId(java.lang.String ownerId)
sets the owner id, which is a URL containing an e-mail address, or a link to a location where an e-mail address can be found, that belongs to the
organization responsible for the frame.
|
java.lang.String |
toString()
gets a string representation of the encryption method registration frame body showing all of the frame's fields and their values.
|
getFrameType, getNextNullTerminator, getSize, isDirty, save, save
getNextNullTerminator, pricesToString, stringToBytes
bytesToInt, bytesToInt, bytesToShort, bytesToShort, bytesToSynchsafeInt, bytesToSynchsafeShort, formateDate, hex, hex, hex, intToBytes, littleEndianBytesToInt, pad, shortToBytes, synchsafeIntToBytes
public ID3v24FrameBodyEncryptionMethodRegistration()
public ID3v24FrameBodyEncryptionMethodRegistration(java.lang.String ownerId, byte methodSymbol, byte[] data)
ownerId
- a URL containing an e-mail address, or a link to a location where an e-mail address can be found, that belongs to the organization responsible for this specific encryption method.methodSymbol
- id of encryption method.data
- raw binary encryption data.public ID3v24FrameBodyEncryptionMethodRegistration(java.io.InputStream inputStream, int frameBodySize) throws java.io.IOException
inputStream
- input stream pointing to an encryption method registration frame body in the .mp3 file.frameBodySize
- size (in bytes) of the frame's body.java.io.IOException
- if there is an error while reading the frame body.public void parse() throws java.lang.IllegalArgumentException
parse
in class ID3v24FrameBody
java.lang.IllegalArgumentException
- if an invalid value is detected while parsing the frame body's raw bytes.public java.lang.String getOwnerId()
setOwnerId(String)
public void setOwnerId(java.lang.String ownerId)
ownerId
- the id of the owner of the data.getOwnerId()
public byte getMethodSymbol()
setMethodSymbol(byte)
public void setMethodSymbol(byte methodSymbol)
methodSymbol
- the id of the encryption method.getMethodSymbol()
public byte[] getData()
setData(byte[])
public void setData(byte[] data)
data
- the binary encryption data.getData()
public void setBuffer()
setBuffer
in class ID3v24FrameBody
public java.lang.String toString()
toString
in class java.lang.Object