public class ID3v23FrameBodyURLLink extends ID3v23FrameBody
A url link frame body is associated with the ID3v2.3 frames
listed below, which contain dynamic data such as webpages with touring
information, price information or plain ordinary news. All url link frame identifiers begins with "W". Only URL link frame identifiers begins with "W".
The url link frame body contains the following fields:
Field | Description | |
---|---|---|
1. | url | url of a website whose purpose depends on the type of text frame. see the list below. |
Frame Id | Description |
---|---|
WCOM | The Commercial information frame is a URL pointing at a webpage with information such as where the album can be bought. There may be more than one "WCOM" frame in a tag, but not with the same content. |
WCOP | The Copyright/Legal information frame is a URL pointing at a webpage where the terms of use and ownership of the file is described. |
WOAF | The Official audio file webpage frame is a URL pointing at a file specific webpage. |
WOAR | The Official artist/performer webpage frame is a URL pointing at the artists official webpage. There may be more than one "WOAR" frame in a tag if the audio contains more than one performer, but not with the same content. |
WOAS | The Official audio source webpage frame is a URL pointing at the official webpage for the source of the audio file, e.g. a movie. |
WORS | The Official internet radio station homepage contains a URL pointing at the homepage of the internet radio station. |
WPAY | The Payment frame is a URL pointing at a webpage that will handle the process of paying for this file. |
WPUB | The Publishers official webpage frame is a URL pointing at the official wepage for the publisher. |
Constructor and Description |
---|
ID3v23FrameBodyURLLink(FrameType frameType)
This constructor is called when creating a new frame.
|
ID3v23FrameBodyURLLink(FrameType frameType,
java.lang.String url)
This constructor is called when creating a new frame.
|
ID3v23FrameBodyURLLink(java.io.InputStream inputStream,
FrameType frameType,
int frameBodySize)
This constructor is called when reading in an existing frame from an .mp3 file.
|
Modifier and Type | Method and Description |
---|---|
java.lang.String |
getURL()
gets the url.
|
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 |
setURL(java.lang.String url)
sets the url.
|
java.lang.String |
toString()
gets a string representation of the url link 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 ID3v23FrameBodyURLLink(FrameType frameType)
frameType
- It must be one of the following 8 ID3v2.3 URL Link frame types:Frame Type | Frame id | Description | |
---|---|---|---|
1. | COMMERCIAL_INFORMATION | WCOM | commercial information |
2. | COPYRIGHT_LEGAL_INFORMATION | WCOP | copyright/legal information |
3. | OFFICIAL_AUDIO_FILE_WEBPAGE | WOAF | official audio file webpage |
4. | OFFICIAL_ARTIST_WEBPAGE | WOAR | official artist/performer webpage |
5. | OFFICIAL_AUDIO_SOURCE_WEBPAGE | WOAS | official audio source webpage |
6. | OFFICIAL_INTERNET_RADIO_STATION_HOMEPAGE | WORS | official internet radio station homepage |
7. | PAYMENT | WPAY | payment |
8. | PUBLISHERS_OFFICIAL_WEBPAGE | WPUB | publishers official webpage |
public ID3v23FrameBodyURLLink(FrameType frameType, java.lang.String url)
frameType
- one of the 8 ID3v2.3 URL Link frame types. See ID3v23FrameBodyURLLink(FrameType)
url
- URL.public ID3v23FrameBodyURLLink(java.io.InputStream inputStream, FrameType frameType, int frameBodySize) throws java.io.IOException
inputStream
- input stream pointing to a URL link frame body in the .mp3 file.frameType
- the type of ID3v2.3 frame.frameBodySize
- size (in bytes) of the url link 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 ID3v23FrameBody
java.lang.IllegalArgumentException
- if an invalid value is detected while parsing the frame body's raw bytes.public java.lang.String getURL()
setURL(String)
public void setURL(java.lang.String url)
url
- the url.getURL()
public void setBuffer()
setBuffer
in class ID3v23FrameBody
public java.lang.String toString()
toString
in class java.lang.Object