org.anarres.qemu.image

Class QEmuImage

java.lang.Object

org.anarres.qemu.image.QEmuImage

public class QEmuImage
extends Object

An abstraction around a QEmu image.

The underlying image file may or may not exist; this class allows for simple creation, inspection and deletion.

Constructor Summary

Constructors

Constructor and Description
QEmuImage(File file)
QEmuImage(String path)

Method Summary

Modifier and Type	Method and Description
void	create(QEmuImageFormat format, File backingFile) Creates this image.
void	create(QEmuImageFormat format, long size) Creates this image.
void	delete() Deletes the file underlying this image, if it exists.
File	getFile()
QEmuImageInfo	query()

Methods inherited from class java.lang.Object

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

Constructor Detail

QEmuImage

public QEmuImage(@Nonnull
                 File file)

QEmuImage

public QEmuImage(@Nonnull
                 String path)

Method Detail

getFile

@Nonnull
public File getFile()

Returns:

the file underlying this QEmuImage.

query

@Nonnull
public QEmuImageInfo query()
                             throws IOException

Throws:

IOException

create

public void create(@Nonnull
                   QEmuImageFormat format,
                   @Nonnegative
                   long size)
            throws IOException

Creates this image.

Parameters:

format - The image format for the new image.

size - The virtual size of the new image.

Throws:

IOException

create

public void create(@Nonnull
                   QEmuImageFormat format,
                   @Nonnull
                   File backingFile)
            throws IOException

Creates this image.

The size of the new image is derived from the existing backing file.

backingFile is referenced by a relative path. If you want it referenced absolutely, canonicalize the argument with File.getAbsoluteFile() before calling this method.

Parameters:

format - The image format for the new image.

backingFile - The backing file for the new image.

Throws:

IOException

delete

public void delete()
            throws IOException

Deletes the file underlying this image, if it exists.

Throws:

IOException