entagged.audioformats
Class AudioFileIO

java.lang.Object
  entagged.audioformats.AudioFileIO

public class AudioFileIO
extends Object

The main entry point for the Tag Reading/Writing operations, this class will select the appropriate reader/writer for the given file.

It selects the appropriate reader/writer based on the file extension (case ignored).

Here is an simple example of use:

AudioFile audioFile = AudioFileIO.read(new File("audiofile.mp3")); //Reads the given file.
int bitrate = audioFile.getBitrate(); //Retreives the bitrate of the file.
String artist = audioFile.getTag().getArtist(); //Retreive the artist name.
audioFile.getTag().setGenre("Progressive Rock"); //Sets the genre to Prog. Rock, note the file on disk is still unmodified.
AudioFileIO.write(audioFile); //Write the modifications in the file on disk.

You can also use the commit() method defined for AudioFiles to achieve the same goal as AudioFileIO.write(File), like this:

AudioFile audioFile = AudioFileIO.read(new File("audiofile.mp3"));
audioFile.getTag().setGenre("Progressive Rock");
audioFile.commit(); //Write the modifications in the file on disk.


Since:

v0.01

Version:

$Id: AudioFileIO.java,v 1.1 2007/03/23 14:16:55 nicov1 Exp $

Author:

Raphael Slinckx ; Nicolas Velin

See Also:

AudioFile, Tag

Constructor Summary

AudioFileIO()
Creates an instance.

Method Summary

void	addAudioFileModificationListener(AudioFileModificationListener listener) Adds an listener for all file formats.
static AudioFileIO	getDefaultAudioFileIO() This method returns the default isntance for static use.
static AudioFile	read(File f) Read the tag contained in the given file.
AudioFile	readFile(File f) Read the tag contained in the given file.
void	removeAudioFileModificationListener(AudioFileModificationListener listener) Removes an listener for all file formats.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AudioFileIO

public AudioFileIO()

Creates an instance.

Method Detail

getDefaultAudioFileIO

public static AudioFileIO getDefaultAudioFileIO()

This method returns the default isntance for static use.

Returns:

The default instance.

read

public static AudioFile read(File f)
                      throws CannotReadException

Read the tag contained in the given file.

Parameters:

f - The file to read.

Returns:

The AudioFile with the file tag and the file encoding infos.

Throws:

CannotReadException - If the file could not be read, the extension wasn't recognized, or an IO error occured during the read.

addAudioFileModificationListener

public void addAudioFileModificationListener(AudioFileModificationListener listener)

Adds an listener for all file formats.

Parameters:

listener - listener

readFile

public AudioFile readFile(File f)
                   throws CannotReadException

Read the tag contained in the given file.

Parameters:

f - The file to read.

Returns:

The AudioFile with the file tag and the file encoding infos.

Throws:

CannotReadException - If the file could not be read, the extension wasn't recognized, or an IO error occured during the read.

removeAudioFileModificationListener

public void removeAudioFileModificationListener(AudioFileModificationListener listener)

Removes an listener for all file formats.

Parameters:

listener - listener