FileDocCategorySizeDatePackage
WOARUrlLinkID3V2Frame.javaAPI Docjid3 0.465068Sun Feb 06 18:11:19 GMT 2005org.blinkenlights.jid3.v2

WOARUrlLinkID3V2Frame

public class WOARUrlLinkID3V2Frame extends UrlLinkID3V2Frame
author
paul Url frame which contains a pointer to the official audio file web page pertaining to artist or performer in the track in this file.

Fields Summary
Constructors Summary
public WOARUrlLinkID3V2Frame(String sOfficialArtistUrl)
Constructor.

param
sOfficialArtistUrl URL pointing to the official artist or performer web page for this track
throws
ID3Exception if the URL passed is null

        super(sOfficialArtistUrl);
    
public WOARUrlLinkID3V2Frame(URL oOfficialArtistUrl)
Constructor.

param
oOfficialArtistUrl URL pointing to the official artist or performer web page for this track
throws
ID3Exception if the URL passed is null

        super(oOfficialArtistUrl);
    
public WOARUrlLinkID3V2Frame(InputStream oIS)

        super(oIS);
    
Methods Summary
public voidaccept(ID3Visitor oID3Visitor)

        oID3Visitor.visitWOARUrlLinkID3V2Frame(this);
    
public booleanequals(java.lang.Object oOther)

        if ((oOther == null) || (!(oOther instanceof WOARUrlLinkID3V2Frame)))
        {
            return false;
        }
        
        WOARUrlLinkID3V2Frame oOtherWOAR = (WOARUrlLinkID3V2Frame)oOther;
        
        return m_sURL.equals(oOtherWOAR.m_sURL);
    
protected byte[]getFrameId()

        return "WOAR".getBytes();
    
public java.lang.StringgetOfficialArtistWebPage()
Get the official artist or performer web page URL for this track. Note, there is no guarantee that this value will in fact be a valid URL.

return
a string containing the set URL

        return m_sURL;
    
public voidsetOfficialArtistWebPage(java.lang.String sOfficialArtistUrl)
Set official artist or performer web page URL for this track.

param
sOfficialArtistUrl a string containing an URL
throws
ID3Exception if the URL string passed is null, or if this frame is contained in a tag which already contains another WOAR frame with the same URL

        String sOrigURL = m_sURL;
        
        if (sOfficialArtistUrl == null)
        {
            throw new ID3Exception("Official artist URL string cannot be null in WOAR frame.");
        }
        
        m_sURL = sOfficialArtistUrl;
        
        // try this update, and reverse it if it generates and error
        try
        {
            notifyID3Observers();
        }
        catch (ID3Exception e)
        {
            m_sURL = sOrigURL;
            
            throw e;
        }
    
public voidsetOfficialArtistWebPage(java.net.URL oOfficialArtistUrl)
Set official artist or performer web page URL for this track.

param
oOfficialArtistUrl an URL
throws
ID3Exception if the URL passed is null, or if this frame is contained in a tag which already contains another WOAR frame with the same URL

        String sOrigURL = m_sURL;
        
        if (oOfficialArtistUrl == null)
        {
            throw new ID3Exception("Official artist URL object cannot be null in WOAR frame.");
        }
        
        m_sURL = oOfficialArtistUrl.toExternalForm();
        
        // try this update, and reverse it if it generates and error
        try
        {
            notifyID3Observers();
        }
        catch (ID3Exception e)
        {
            m_sURL = sOrigURL;
            
            throw e;
        }
    
public java.lang.StringtoString()

        return "Official artist/performer webpage URL: [" + m_sURL + "]";